AutoflowTrilha 02 · BPMN na prática
Tarefas e atividades
Atividades são o trabalho do processo. Escolher o tipo certo — pessoa, sistema, regra ou subprocesso — define quem executa e como o Autoflow vai se comportar.
Os tipos que importam
Tarefa de usuário
Uma pessoa faz, no sistema. Vira tarefa na caixa de Início.
Tarefa de serviço
Um sistema faz, sozinho: integração, cálculo, notificação.
Tarefa de regra de negócio
Consulta uma tabela de decisão (DMN) e devolve o resultado.
Atividade de chamada
Chama outro processo. No Autoflow: a Solicitação de documentos.
O tipo não é detalhe estético. Uma tarefa genérica (sem ícone) é atravessada pelo motor sem fazer nada — ninguém recebe trabalho. Uma tarefa de usuário cria trabalho para alguém. Uma de serviço precisa de um tópico que algum programa saiba executar. Errar o tipo é a causa mais comum de “a tarefa não apareceu para ninguém”.
Tarefa de usuário em detalhe
É o tipo que você mais vai usar. No Autoflow, cada tarefa de usuário tem quatro configurações:
| Configuração | O que define | Exemplo |
|---|---|---|
| Nome | O que aparece no cartão da caixa | “Autorizar a proposta” (verbo + objeto) |
| Responsável | Quem recebe | ${initiator} (quem iniciou) ou grupo candidato |
| Formulário | O que a pessoa preenche | F_VENDA_AUTORIZAR |
| Prazo | Até quando | ${prazoFim} vindo do bloco Calcular prazo |
Responsável: as duas formas
- Responsável direto (
assignee): a tarefa já nasce com dono. O uso típico é${initiator}— “devolve para quem pediu”. Aparece em Minhas. Não pode ser devolvida para fila, só reatribuída por um supervisor. - Grupo candidato (
candidateGroups): a tarefa vai para uma fila. Todos que se encaixam veem em Disponíveis; quem Assumir primeiro fica com ela.
O grupo candidato aceita estes formatos:
| Formato | Quem recebe |
|---|---|
pos:GERENCIA_COMERCIAL |
Todos com o cargo, na unidade do processo |
dept:<id> |
Todos do departamento |
dept:<id>+pos:ANALISTA |
Só analistas daquele departamento |
pos:A,pos:B |
Quem tiver qualquer um dos cargos |
${responsavel} |
Cargo decidido por uma regra de negócio anterior |
Uma tarefa sem formulário e sem responsável gera aviso no editor (userTask.unassigned). Ela não chega a ninguém de forma útil. Sempre defina quem faz.
A tarefa respeita o escopo da unidade: um processo iniciado na Filial Centro só aparece para quem tem o cargo naquela filial (ou em uma unidade acima dela, como a matriz). Por isso o mesmo fluxo funciona para várias filiais sem duplicar nada.
Tarefa de serviço
No Autoflow, toda tarefa de serviço é uma external task com um tópico: a API do Autoflow busca trabalho no motor e executa. Você não precisa configurar isso à mão — os blocos da paleta fazem por você:
| Bloco no editor | O que faz |
|---|---|
| Enviar a sistema externo | Chama a API de outro sistema com um payload montado a partir das variáveis e documentos |
| Calcular prazo (dias úteis) | Soma dias úteis com o calendário da unidade e grava prazo e prazoFim |
| Notificação | Envia uma notificação (tópico notification.send) |
Uma tarefa de serviço com tópico que ninguém trata fica parada ou vira incidente. O editor avisa quando o tópico é desconhecido. Use sempre os blocos prontos.
Tarefa de regra de negócio
Avalia uma tabela DMN cadastrada em Modelagem › Regras. Cada saída da regra vira uma variável do processo. Exemplo real do pacote Advocacia: o bloco “Prazo por ato” lê tipoAto e grava prazoDias, que o bloco seguinte usa para calcular o prazo em dias úteis.
Você vai aprofundar isso na trilha de DMN.
Atividade de chamada: a Solicitação de documentos
Documentos no Autoflow nunca são um campo de upload no formulário. Eles passam pelo bloco Solicitação de documentos, que chama um subprocesso de sistema que:
- cria a tarefa Anexar documentos para quem deve anexar;
- cria as tarefas de validação para os validadores definidos no requisito (em sequência ou em paralelo);
- devolve só o documento reprovado para correção, quantas rodadas forem necessárias;
- termina com o desfecho
APPROVEDouCANCELLEDna variáveldocumentGateOutcome.
Depois de uma Solicitação de documentos, coloque um gateway exclusivo testando ${documentGateOutcome == 'CANCELLED'} para tratar a desistência. É o padrão dos fluxos reais.
Nomeando atividades
| Ruim | Bom | Por quê |
|---|---|---|
| Gestor | Analisar pedido | Atividade é ação, não pessoa |
| Aprovação | Aprovar reembolso | Verbo no infinitivo + objeto |
| Etapa 3 | Conferir documentação fiscal | Diz o que fazer |
| Analisar e aprovar e enviar ao financeiro | Analisar pedido → (gateway) → … | Uma atividade, uma responsabilidade |
Resumo
- Escolha o tipo pela pergunta “quem faz?”: pessoa, sistema, regra ou outro processo.
- Tarefa de usuário: nome, responsável (
${initiator}ou grupo candidato), formulário e prazo. - Tarefas de serviço no Autoflow vêm dos blocos prontos (integração, prazo, notificação).
- Documentos sempre pela Solicitação de documentos, seguida de gateway para tratar cancelamento.
- Nome = verbo no infinitivo + objeto.