AutoflowGuia do implantador
0 / 60
Buscar

Trilha 05 · Área da empresa

Formulários de tarefa

O formulário é o que a pessoa vê quando abre a tarefa — e cada campo vira uma variável que o fluxo usa para decidir caminhos. Um bom formulário reduz erro na origem; um ruim gera retrabalho no processo inteiro.

Para que serve

Cada tarefa de usuárioTarefa de usuário — Atividade feita por uma pessoa no sistema. No Autoflow aparece na caixa de tarefas. (e o evento de início) pode ter um formulário. Ele coleta os dados daquela etapa. O ponto mais importante desta lição:

A chave do campo é o nome da variável do processo

Se o campo “Valor do pedido” tem a chave valor, depois de concluída a tarefa o processo tem uma variávelVariável de processo — Dado guardado na instância (ex.: valor, tipoVenda). Vem dos campos dos formulários e das regras; usado nas condições dos gateways. valor. Os gateways usam essa variável (${valor > 5000}), as regras DMN a recebem como entrada, o cartão da caixa de tarefas a exibe e as métricas a somam. Escolher bem as chaves é decidir o vocabulário do processo. Combine com o cliente e documente.

Fica em Administração › Modelagem › Formulários (process.model; publicar e arquivar exigem process.publish). O editor e o renderizador são nativos do Autoflow, no visual do sistema, e o formato é o JSON do Camunda Forms.

A lista

Filtros: Buscar, Processo, Situação (Todos / Ativos / Arquivados / Órfãos / Sem uso). Colunas: Nome, Chave, Processo, User task, Versão, Uso, Autor, Atualizado em. Ações: Duplicar, Arquivar/Reativar, Excluir (só se nunca foi usado).

Criar um formulário

  1. Clique em Novo formulário.
  2. Chave do formulário e Nome. A chave segue o padrão letra inicial + letras, números, _ ou - (3 a 64). Convenção útil: F_PROCESSO_ETAPA, ex.: F_REEMBOLSO_APROVAR. O prefixo documents: é reservado.
  3. Vincule em Processo e em User task / start event. Isso documenta onde o formulário é usado e alimenta os avisos do editor.
  4. Na aba Desenho, escolha “Novo campo” e clique em Adicionar. Configure cada campo.
  5. Confira a aba Preview em Desktop e Mobile.
  6. Clique em Publicar versão.
  7. Republique o fluxo. Use o atalho Republicar processos que usam este formulário. Sem isso, nada muda em execução.

Tipos de campo

Tipo na tela Vira variável? Uso típico
Texto sim Nome, número de protocolo. Aceita máscara
Área de texto sim Justificativa, parecer
Número sim Formatos Livre, Inteiro, Decimal, Moeda (R$), Percentual; casas decimais
Lista sim Escolha única em lista suspensa
Opções (radio) sim Escolha única visível (bom para decisões: aprovar/devolver)
Caixa de seleção sim (booleano) “Li e aceito”, “Possui veículo usado?”
Data sim Data, Data e hora, ou Hora
Participante externo sim Informa a pessoa externa de um papel; grava pf_external_<papel>
Registro de base sim Autocomplete de uma Base de dados; exporta campos para o fluxo
Texto estático, Botão, Espaço, Separador não Layout e instruções

Não existe campo de upload: arquivo sempre passa pela Solicitação de documentos. Também não há grupos de campos aninhados.

Propriedades comuns

Rótulo, Chave, Descrição, Obrigatório, Desabilitado e Largura na linha (grade de 16 colunas). Opções de Lista e Radio são escritas como rótulo=valor, uma por linha:

Aprovar=aprovar
Devolver com pendência=pendencia
Cliente desistiu=desistencia
Compare o valor, não o rótulo

O gateway compara o valor: ${acao == 'pendencia'}. Se alguém mudar o rótulo para “Devolver para correção”, o fluxo continua funcionando. Se mudar o valor, quebra. Por isso: valores curtos, sem acento, em minúsculas, e nunca mude depois que estiver em uso.

Máscaras

  • Para todos os clientes: CPF, CNPJ, CPF ou CNPJ, Telefone, CEP.
  • Segmento Concessionária: Placa de veículo, RENAVAM, Chassi.
  • Segmento Advocacia: Número de processo (CNJ), Inscrição na OAB.

O editor só oferece as máscaras do núcleo e do segmento do cliente. O servidor valida a máscara (erro field_invalid) e os obrigatórios — caixa de seleção obrigatória exige estar marcada.

Mostrar dado de etapa anterior

Para o aprovador ver o que o solicitante preencheu, coloque no formulário dele um campo com a mesma chave e marque Desabilitado. Ele aparece preenchido e somente leitura. É assim que o fluxo de venda mostra os dados do cliente em todas as etapas.

Simule: como o formulário vira variáveis

Preencha o formulário de exemplo e veja, ao lado, as variáveis que o processo receberia e qual caminho o gateway seguiria.

SimulaçãoFormulário → variáveis → gateway
Decisão (Opções radio) *
Variáveis gravadas no processo
{
  "solicitante": "Maria Souza",
  "cpf": "12345678909",
  "valor": 7200,
  "categoria": "viagem",
  "acao": "aprovar",
  "urgente": false,
  "dataDespesa": "2026-10-20"
}
Gateway seguinte
${acao == 'pendencia'} → devolver
${acao == 'recusar'} → fim recusado
${valor > 1000} → diretoria
padrão → pagamento
Caminho: Aprovação da diretoria
A máscara formata na tela; a variável guarda o valor. O número vai como número (sem "R$"), por isso ${valor > 1000} funciona.

Versões e o vínculo com o fluxo

O formulário tem versões próprias. O painel Versões permite Restaurar uma versão antiga (isso cria uma nova versão com aquele conteúdo). Formulário arquivado fica somente leitura. Também dá para Importar e Baixar o .json.

A ligação com o fluxo é do tipo deploymentBinding deployment — O formulário fica preso à versão do fluxo. Publicar formulário novo só vale após republicar o fluxo.: ao publicar o fluxo, o Autoflow anexa a versão atual de cada formulário e “prende” essa combinação. Consequências práticas:

  1. Publicar formulário não muda processo em execução.
  2. Republicar o fluxo cria nova versão do fluxo (mesmo que o BPMN não tenha mudado).
  3. Processos antigos continuam com o formulário antigo até o fim.
  4. A lista de fluxos mostra o selo Formulários desatualizados quando há versão de formulário não publicada no fluxo.
Por que é assim?

Imagine um processo que começou com um formulário de 5 campos e, no meio, o formulário passa a exigir um sexto campo obrigatório que as etapas anteriores nunca preencheram. O processo quebraria. Prender o formulário à versão do fluxo garante que cada processo é coerente do início ao fim.

Boas práticas de consultor

  • Um formulário por etapa, com o mínimo necessário para aquela decisão. Formulário gigante na abertura é a principal causa de abandono.
  • Obrigatório só o que bloqueia o próximo passo. O resto, opcional.
  • Use Opções (radio) para decisões que alimentam gateway; é mais claro que Lista.
  • Descrição em todo campo ambíguo. Ex.: “Valor total com impostos”.
  • Teste no Mobile — fiscais, vistoriadores e vendedores usam celular.
  • Documente o dicionário de variáveis (chave, tipo, origem, quem usa) no documento de configuração.
No setor público

Em órgãos públicos, alinhe os campos com os formulários oficiais já existentes (requerimentos padrão) e com a LGPD: colete só o necessário para a finalidade. Marque tipos de documento sensíveis e evite pedir dados pessoais em texto livre.

Resumo

  • A chave do campo é o nome da variável do processo — escolha com cuidado.
  • Tipos: texto, área, número (com formatos), lista, radio, caixa, data, participante externo, registro de base e elementos de layout. Arquivo é sempre via Solicitação de documentos.
  • Opções são rótulo=valor; gateways comparam o valor.
  • Publicar formulário só vale após republicar o fluxo, e só para processos novos.
QuizVerifique seu entendimento0/3 respondidas · 0 certas
1.O gateway testa ${acao == 'pendencia'}. Alguém mudou a opção de "Devolver=pendencia" para "Devolver=devolver". O que acontece?
2.Como mostrar ao aprovador o valor que o solicitante digitou, sem deixá-lo editar?
3.O cliente quer que o formulário de abertura peça a cópia do RG. Como fazer?
AnteriorFluxos: modelar e publicar