AutoflowGuia do implantador
0 / 60
Buscar

Trilha 04 · Autoflow visão geral

Do fluxo à tarefa: ciclo de vida

Rascunho, versão, processo, tarefa, incidente. Cada coisa no Autoflow nasce, muda de estado e termina segundo regras precisas. Quem domina esse ciclo sabe responder na hora perguntas como "se eu mudar o formulário, o que acontece com os pedidos em andamento?".

A linha do tempo de um fluxo

1 · Rascunho

Só no seu navegador

Enquanto você desenha, o rascunho fica salvo localmente no navegador (por chave do fluxo). O motor não sabe que ele existe. Dá para importar e baixar o .bpmn.

2 · Publicação

Vira versão no motor

Publicar no Camunda (Ctrl+S) valida o desenho e cria uma versão imutável: v1, v2, v3…

3 · Execução

Processos nascem na última versão ativa

Cada Novo processo cria uma instância na última versão não desativada. Ela fica nessa versão até o fim.

Faça o laboratório: publique, inicie dois processos, avance um, publique a v2, inicie outro, desative a v1. Observe o que acontece com cada processo.

LaboratórioRascunho → versão → processos em execução
1 · Fluxo (modelo)
Solicitação de férias
SOLICITACAO_FERIAS
Rascunho local
2 · Versões no motor
Nenhuma versão ainda.
3 · Processos (instâncias)
Nenhum processo iniciado.
O que aconteceu: Comece publicando o fluxo. Enquanto não é publicado, ele é só um rascunho salvo no seu navegador — o motor não o conhece.
Por que versões são imutáveis

Imagine que um processo está na etapa 3 de 5 e alguém apaga a etapa 4 do desenho. O que o motor faria? Para não ter essa pergunta, o Camunda (e o Autoflow) nunca altera uma versão publicada. Cada mudança cria uma versão nova, e cada processo segue o desenho com o qual nasceu. É mais seguro e auditável — o preço é que não há “correção retroativa”.

O que a publicação leva junto

Ao publicar, o Autoflow não envia só o desenho. Ele:

  1. roda o validador (erros bloqueiam; avisos perguntam “Publicar com avisos?”);
  2. anexa a versão atual de cada formulário referenciado e “prende” esses formulários à versão do fluxo;
  3. registra quais requisitos de documentos e regras o fluxo usa (para o sistema saber o que está “em uso”).

Republicar sem mudar nada não cria versão nova. Qualquer mudança — inclusive só num formulário — cria.

Três coisas que NÃO ficam presas à versão

Item Vínculo Consequência
Formulários Presos à versão do fluxo (binding “deployment”) Publicar formulário novo não muda processos em andamento nem novos: é preciso republicar o fluxo
Regras de negócio “latest” A versão publicada vale na próxima avaliação de todos os processos, inclusive os em andamento
Solicitação de documentos Subprocesso “latest”; a política (itens, validadores, prazo) é congelada ao abrir cada solicitação Mudar o requisito afeta as próximas solicitações, não as já abertas
Anexos permitidos Valem na hora Inclusive para processos em andamento
O erro mais comum depois do go-live

O cliente pede um campo novo no formulário. Você publica a versão nova do formulário e avisa que está pronto. Nada muda. Motivo: formulários estão presos à versão do fluxo. O Autoflow avisa (“Versão 3 salva. Para valer em execução, publique o processo…”), mostra o selo Formulários desatualizados na lista de fluxos e oferece o botão Republicar processos que usam este formulário. Use-o.

Ciclo de vida de um processo (instância)

Diagrama de estadosEstados de um processo
SuspenderReativarfalha técnicaRetentar / Pularchega ao fimCancelar (motivo)Em andamentoSuspensoCom incidenteConcluídoCancelado
Em andamento: O processo tem tokens ativos: tarefas esperando pessoas, esperas por retorno externo, timers. É o estado normal. (clique nos estados)

Ciclo de vida de uma tarefa

Diagrama de estadosEstados de uma tarefa de usuário
AssumirDevolverConcluir tarefaConcluirReatribuirNa filaAssumidaDo iniciadorConcluída
Na fila: A tarefa tem grupos candidatos (cargo e/ou departamento) e nenhum responsável. Aparece em "Disponíveis" para todos os candidatos, com badges dos grupos. (clique nos estados)

Além disso: Encaminhar passa a tarefa para um colega da unidade (permissão Encaminhar) e Reatribuir muda o responsável de qualquer tarefa (permissão de supervisor, que também libera a aba Todas).

Por que é preciso assumir

Se duas analistas do mesmo cargo abrissem e preenchessem a mesma tarefa ao mesmo tempo, uma perderia o trabalho. Assumir é a “trava”: deixa claro quem está com o caso. Explique isso no treinamento — usuários novos estranham o clique extra.

Incidentes: quando o motor não consegue seguir

Um incidenteIncidente — Falha técnica que parou um processo (ex.: integração fora do ar, gateway sem saída). Aparece em Monitoramento › Incidentes e pode ser retentado. acontece quando uma etapa automática falha: o sistema do despachante não respondeu, uma regra deu erro, um gateway não tinha saída, uma tarefa de serviço tem um tópico sem tratador. O processo fica parado naquele ponto.

Onde ver e agir:

  • Monitoramento › Incidentes e a aba Incidentes do processo: Retentar, Pular (só etapas automáticas) e Corrigir variáveis.
  • No Console Super, o painel de saúde mostra incidentes por organização, e a investigação de processo mostra a causa provável.

Erros de integração tratáveis (o parceiro recusou os dados) não precisam virar incidente: modele um evento de borda de erro para desviar o fluxo para uma tarefa de correção.

O que dá e o que não dá para fazer depois

Pergunta do cliente Resposta
Posso mudar uma etapa de um processo que já está rodando? Não. Ele termina na versão em que nasceu. “Migrar processos…” existe na tela, mas está desabilitado pendente.
Posso apagar uma versão errada? Não. Desative a versão (ninguém mais inicia nela). Opcionalmente, suspenda os processos dela.
Posso excluir um fluxo? Só se nunca teve processo. Caso contrário, desative.
Posso voltar um processo uma etapa? Não pelo produto. Modele caminhos de devolução no fluxo (“pendência volta para quem devolveu”).
Mudei a regra; os processos antigos usam a nova? Os que ainda vão passar pela regra, sim. Os que já passaram, não.

Resumo

  • Rascunho é local; publicar cria uma versão imutável; processos nascem na última versão ativa e ficam nela.
  • Formulários são presos à versão: depois de publicar formulário, republique o fluxo.
  • Regras valem “latest”; a política de documentos congela por solicitação; anexos permitidos valem na hora.
  • Processo: em andamento → suspenso / concluído / cancelado; incidentes param etapas automáticas.
  • Tarefa: na fila → assumida → concluída; tarefas do iniciador só saem por reatribuição.
QuizVerifique seu entendimento0/4 respondidas · 0 certas
1.Há 40 processos na v2. Você publica a v3 com uma etapa a menos. O que acontece com os 40?
2.Você publicou a versão 4 do formulário de abertura, mas novos processos continuam com o formulário antigo. Por quê?
3.Uma tarefa atribuída a ${initiator} precisa ir para outra pessoa porque o vendedor saiu de férias. O que fazer?
4.O sistema do despachante ficou fora do ar e um processo parou. Onde aparece?