⚙️ Scripts de Workflow (Eventos de Processo) no Fluig

📌 O que são Eventos de Workflow?

Os eventos de processo no Fluig são scripts em JavaScript executados automaticamente em pontos específicos do workflow.

Eles funcionam como gatilhos que permitem interferir no comportamento do processo durante sua execução.

👉 Em outras palavras:
são responsáveis por adicionar lógica, validações e automações ao fluxo definido no diagrama.

🧠 Relação com BPM e Diagramas

• O BPM define como o processo deve funcionar
• O diagrama (BPMN) representa visualmente esse fluxo
• O Fluig executa o processo
• Os eventos aplicam as regras e comportamentos

👉 Resumindo:

Diagramas mostram o caminho, eventos controlam o que acontece em cada etapa

🔄 Quando os eventos são utilizados?

Os eventos são acionados automaticamente em momentos como:

• Criação de um processo
• Entrada em uma atividade
• Saída de uma atividade
• Salvamento de formulário
• Movimentação de tarefas
• Finalização ou cancelamento

👉 Cada ação dentro do workflow pode disparar um ou mais eventos.

🔷 Exemplos de Eventos (principais)

Alguns dos eventos mais utilizados no Fluig:

• beforeTaskSave
• afterTaskSave
• beforeStateEntry
• afterStateEntry
• beforeTaskCreate
• afterTaskCreate
• beforeStateLeave
• afterStateLeave
• afterProcessCreate
• afterProcessFinish
• beforeCancelProcess
• afterCancelProcess
• validateAvailableStates
• beforeSendData
• onNotify

👉 Para detalhes completos de cada evento, consulte a documentação oficial.

🎯 Para que servem?

Os eventos são utilizados para implementar regras e automações no processo, como:

✔ Validações

• Garantir preenchimento de campos obrigatórios
• Validar regras de negócio antes de avançar

✔ Controle de fluxo

• Direcionar caminhos do processo
• Alterar dinamicamente próximas etapas

✔ Integrações

• Consumir APIs
• Consultar ou atualizar datasets
• Integrar com sistemas externos

✔ Automação

• Preencher campos automaticamente
• Executar cálculos
• Atualizar informações

✔ Auditoria e logs

• Registrar ações do processo
• Monitorar execução

💡 Boas práticas

• Escolha o evento certo para cada necessidade
• Use eventos "before" para validações
• Evite lógica pesada em eventos finais
• Utilize logs para facilitar o debug
• Mantenha o código organizado e reutilizável

🚀 Resumo

• Eventos são scripts que rodam automaticamente no workflow
• São responsáveis pela lógica do processo
• Estão diretamente ligados ao BPM
• Permitem validação, automação e integração
• IMPORTANTE: Os scripts executam no back end do Fluig. Utiliza hAPI como ferramenta para getValue e setValue. Veja documentação: https://tdn.totvs.com/display/public/fluig/hAPI (opens in a new tab)

👉 Sem eventos: fluxo básico
👉 Com eventos: processo inteligente e automatizado

🔗 Documentação oficial

https://tdn.totvs.com/display/public/fluig/Eventos+de+Processos (opens in a new tab)