📊 Datasets no Fluig

📌 O que são Datasets?

Datasets no Fluig são estruturas utilizadas para consulta e manipulação de dados dentro da plataforma.

Eles funcionam como uma camada de acesso a dados, permitindo buscar informações de:

• Banco de dados
• Sistemas externos
• APIs
• Serviços internos do Fluig

👉 Em outras palavras:
são a principal forma de obter e trabalhar com dados no Fluig.

⚙️ Característica importante

Os datasets são estruturas de backend e utilizam uma versão antiga do JavaScript.

👉 Isso significa que:

• Não suportam recursos modernos (ex: arrow functions, template strings)
• Utilizam sintaxe mais tradicional
• Exigem maior atenção com compatibilidade

🧠 Relação com BPM e Processos

No contexto de BPM:

• O processo (workflow) define o fluxo
• Os eventos controlam a lógica
• Os datasets fornecem os dados

👉 Exemplo:

• Um processo precisa validar um produto
• O evento chama um dataset
• O dataset consulta o banco
• O processo decide o próximo passo

👉 Resumindo:

Sem dataset, o processo não tem informação para tomar decisão

🔄 Quando utilizar Datasets?

Datasets são utilizados sempre que for necessário:

• Buscar dados externos
• Validar informações
• Preencher campos automaticamente
• Integrar sistemas
• Listar dados em formulários (zoom/autocomplete)

🔷 Tipos de Datasets

🟢 Dataset Interno

Dados já existentes no Fluig.

Exemplo:

• Usuários
• Grupos
• Documentos (GED)

🟡 Dataset de Formulário

Dados armazenados em formulários do Fluig.

Exemplo:

• Formulário de solicitação
• Tabela pai x filho

🔵 Dataset Customizado

Criado via script (JavaScript).

👉 Permite:

• Consultar banco externo
• Consumir APIs
• Aplicar regras de negócio

🟣 Dataset via Serviço (SOAP/REST)

Integração com sistemas externos via serviços.

👉 Muito usado para:

• ERP (Protheus, RM, etc.)
• Sistemas legados
• APIs externas

🔷 Exemplos de Datasets

Alguns exemplos comuns no Fluig:

• colleague
• workflowProcess
• document
• dataset
• cadastro_produtos
• consulta_clientes
• integra_erp

👉 Os nomes podem variar conforme o projeto.

🎯 Para que servem?

Os datasets são utilizados para:

✔ Consulta de dados

• Buscar informações no banco
• Listar registros

✔ Integração

• Conectar com sistemas externos
• Consumir APIs

✔ Validação

• Conferir regras de negócio
• Validar dados antes de avançar

✔ Alimentação de formulários

• Preencher campos automaticamente
• Popular campos zoom

✔ Suporte a processos

• Fornecer dados para decisões no workflow

💡 Boas práticas

• Nomeie datasets de forma clara
• Evite consultas desnecessárias
• Trate erros de integração
• Utilize logs para debug
• Centralize regras no dataset quando fizer sentido

🚀 Resumo

• Datasets são a camada de acesso a dados do Fluig
• São executados no backend com JavaScript antigo
• Permitem consulta, validação e integração
• São essenciais para funcionamento dos processos

👉 Sem dataset: processo sem dados
👉 Com dataset: processo inteligente e integrado