Tabelas do Banco de Dados Fluig: O Guia Completo
Descubra a estrutura das principais tabelas do banco de dados TOTVS Fluig. Facilite suas consultas SQL e ganhe tempo no seu desenvolvimento.
Conhecer as tabelas do banco de dados do Fluig é fundamental para fazer extração de dados, criar relatórios customizados, depurar problemas em processos e construir datasets personalizados. Este artigo reúne as principais tabelas do banco de dados do TOTVS Fluig com suas respectivas descrições.
Por que conhecer o banco de dados do Fluig?
O TOTVS Fluig armazena todas as informações da plataforma em um banco de dados relacional. Processos BPM em andamento, formulários preenchidos, datasets customizados, documentos publicados e eventos de sistema — tudo passa pelo banco.
Para o desenvolvedor Fluig, entender a estrutura do banco de dados é essencial em situações como:
- Criação de datasets customizados que consultam dados de processos ou formulários diretamente
- Extração de dados para relatórios em ferramentas como Power BI ou planilhas
- Diagnóstico de erros em processos parados ou formulários com comportamento inesperado
- Construção de integrações entre o Fluig e sistemas externos, como o TOTVS RM
Principais Tabelas do Fluig
| Objetivo | Tabela |
|---|---|
| Armazena os eventos de formulário do Fluig | EVENT_FICHA |
| Armazena os eventos de processos do Fluig | EVENT_PROCES |
| Lista todas as tabelas criadas a partir de datasets e formulários | META_LISTA |
| Controla os processos do sistema | PROCES_WORKFLOW |
| Controla a versão ativa de um dataset de formulário | DOCUMENTO |
| Comentários dos processos | PROCESS_OBSERVATION |
| Controla a estrutura principal e a hierarquia PAI × FILHO dos formulários | FICHARIO |
| Controla quais campos cada versão de um formulário possui | FICHARIO_CAMPO |
| Lista os datasets internos e datasets customizados | SERV_DATASET |
Entendendo as Tabelas META_LISTA
Quando você cria um formulário no Fluig, a plataforma gera automaticamente uma tabela para armazenar os dados preenchidos. Todo campo input do HTML é interpretado como fonte de dados e ganha uma coluna nessa tabela.
As tabelas seguem o padrão de nomenclatura: ML [EMPRESA] [SEQUENCIAL]
Onde ML é o prefixo fixo, EMPRESA é o código da empresa e SEQUENCIAL é um número gerado automaticamente pelo Fluig na ordem de criação dos formulários.
Exemplos: ML001001, ML002050
Cada ambiente Fluig terá uma sequência própria — dificilmente dois ambientes terão as mesmas tabelas META_LISTA.
Observação: não é possível definir o tipo de dado de cada campo diretamente no HTML do formulário. Todos os campos são armazenados como texto, o que exige tratamento de tipo no nível de programação em todos os pontos de entrada e saída de dados.
Tabelas de Processos: PROCES_WORKFLOW e PROCESS_OBSERVATION
A tabela PROCES_WORKFLOW é uma das mais consultadas no dia a dia do desenvolvedor Fluig. É nela que estão registradas todas as instâncias de processos BPM — desde a abertura até o encerramento. Por meio dela é possível identificar processos em andamento, responsáveis por atividades e histórico de movimentações.
Já a PROCESS_OBSERVATION complementa essa visão armazenando os comentários feitos pelos usuários durante a execução de cada atividade do processo. Essas duas tabelas juntas formam a base para qualquer relatório gerencial de processos no Fluig.
Tabelas de Formulários: FICHARIO e FICHARIO_CAMPO
O Fluig organiza os formulários através das tabelas FICHARIO e FICHARIO_CAMPO. A FICHARIO define a estrutura principal de cada formulário, incluindo o relacionamento PAI × FILHO — essencial para quem trabalha com formulários compostos por múltiplos níveis de dados.
A FICHARIO_CAMPO, por sua vez, registra todos os campos de cada versão publicada do formulário. É através dela que é possível entender a estrutura de uma META_LISTA sem precisar abrir o formulário no ambiente.
Eventos de Formulário e Processo: EVENT_FICHA e EVENT_PROCES
As tabelas de eventos armazenam o código JavaScript associado a cada formulário (EVENT_FICHA) e a cada processo (EVENT_PROCES). Para desenvolvedores que trabalham com manutenção de soluções legadas no Fluig, essas tabelas podem ser úteis para inspecionar eventos diretamente no banco quando o acesso ao ambiente de desenvolvimento não está disponível.
Datasets e Documentos: SERV_DATASET e DOCUMENTO
A tabela SERV_DATASET lista todos os datasets disponíveis na plataforma, sejam eles nativos do Fluig ou customizados pelo time de desenvolvimento. É a referência para entender quais datasets existem em um determinado ambiente sem precisar navegar pela interface.
A tabela DOCUMENTO controla todos os documentos publicados na plataforma — incluindo formulários, arquivos e widgets. Ela indica qual é a versão ativa de cada documento, sendo importante para auditorias e para rastrear a evolução de formulários ao longo do tempo.
Boas Práticas ao Trabalhar com o Banco do Fluig
Consultar o banco de dados do Fluig diretamente é uma prática comum em ambientes de desenvolvimento e suporte, mas exige cuidado:
- Não escreva diretamente nas tabelas do Fluig. Sempre utilize os serviços e APIs da plataforma para alterações. Modificações diretas no banco podem corromper o estado interno e causar comportamentos inesperados nos processos.
- Prefira datasets customizados para encapsular as consultas ao banco e reutilizá-las dentro da própria plataforma.
- Documente as consultas utilizadas em cada projeto. A estrutura do banco pode mudar entre versões do Fluig.
Se quiser trocar experiências sobre desenvolvimento Fluig, participe da comunidade Fluig no WhatsApp.