Definições de Processo

Nível de acesso requerido

Admin ou Super Admin

O que é uma definição?

Uma definição é o modelo de processo (BPMN) ou caso (CMMN) publicado na plataforma. A plataforma os divide entre escopo Global e Local.

Definições Locais (Processos do Tenant): O Admin do Tenant pode importar, ver e gerenciar configurações específicas daquele processo dentro da sua empresa (Tipos Documentais locais, Variáveis locais, instâncias de teste e relatórios). A visualização ocorre em Administração → Definições Locais.

Catálogo de Processos Globais: O Admin do Tenant também visualiza uma vitrine com os processos globais disponíveis na plataforma:

• Ele não pode criar, editar modelos ou visualizar as configurações internas de desenvolvimento dos templates globais.
• Ele pode ativar ou desativar (usando o toggle switch) qualquer processo global para o seu próprio ambiente. Um processo desativado não aparecerá para os usuários iniciarem instâncias no portal ou via API naquele tenant específico.
• Rascunhos: Processos globais que ainda não foram oficialmente publicados aparecerão com o toggle desabilitado. O Admin não conseguirá utilizá-los até que o Super Admin finalize a publicação.

Publicando uma nova definição

A plataforma oferece duas formas de criar uma definição.

Opção A — Modelador visual (recomendado)

1. Acesse Processos → Definições
2. Clique em + Nova definição e escolha o tipo:
   • BPMN — abre o modelador BPMN com painel de propriedades
   • CMMN — abre o modelador CMMN (canvas)
3. Modele o processo e clique em Deploy para publicar na plataforma

SUPER_ADMIN — Templates DMN

Usuários SUPER_ADMIN também podem criar Templates DMN pelo mesmo botão. Templates são globais e servem de base para os tenants implantarem suas próprias tabelas de decisão.

Opção B — Upload de arquivo

1. Acesse Processos → Definições
2. Clique em Publicar definição
3. Faça o upload do arquivo .bpmn ou .cmmn
4. Confirme a publicação

Editando uma definição existente

Para criar uma nova versão de uma definição já publicada:

1. Localize a definição na lista e clique em Versões
2. Clique em Nova versão na linha da versão atual
3. O modelador abrirá com o XML da versão anterior pré-carregado
4. Faça as alterações e clique em Deploy para publicar a nova versão

Versionamento

Ao publicar um arquivo com a mesma chave de processo, uma nova versão é criada automaticamente. Instâncias em andamento continuam na versão anterior; novas instâncias usam a versão mais recente.

Exportando o XML de uma versão

Em qualquer versão, clique em Exportar XML para baixar o arquivo .bpmn ou .cmmn da versão específica.

Papéis de processo

Cada processo pode declarar papéis específicos (ex.: Solicitante, Aprovador). Após publicar a definição, você pode visualizar os papéis extraídos automaticamente do arquivo BPMN/CMMN.

Esses papéis são usados para atribuir tarefas às pessoas corretas em cada execução. Membros do tenant com o papel de processo correspondente receberão as tarefas automaticamente.

Bases de Conhecimento (RAG)

Na página de detalhes de um processo, você terá acesso à aba Base de Conhecimento. Nela, é possível visualizar todas as bases geradas pelos administradores (KBs Globais ou restritas ao Tenant) e habilitá-las para este processo específico.

Ao fazer essa vinculação explícita (Toggling), qualquer agente de IA que atuar nesse processo passará a ter seu System Prompt retroalimentado com as regras das bases habilitadas. Isso previne que a IA aplique regras do setor financeiro num processo do RH, por exemplo.