Formulário rápido

Pause um fluxo de trabalho e peça a um humano para revisar, aprovar ou preencher um formulário que você cria no nó e, em seguida, continue com a resposta.

Formulário rápido pausa o fluxo de trabalho e atribui uma tarefa a um humano: um formulário que você cria diretamente no nó. O humano revisa, preenche e seleciona um resultado, como Aprovar ou Rejeitar, e o fluxo de trabalho continua no caminho desse resultado. Está na categoria Humana do painel Adicionar nó .

Use o Formulário rápido para aprovações e coleta de dados direta. Quando você precisar de uma interface mais rica, reutilize uma em fluxos de trabalho ou mostre dados que o fluxo de trabalho ainda não carrega, use um Action App . Adicionar aprovação humana a um fluxo de trabalho percorre um Formulário rápido passo a passo.

Quando usar Formulário rápido vs Decisão

Use o Formulário rápido quando um ser humano precisar revisar as informações e responder antes que o fluxo de trabalho continue. Use Decisão quando a ramificação puder ser resolvida automaticamente a partir de dados existentes, sem um humano.

Configuração

Campo	Required	Padrão	Description
Critérios de atribuição	Sim	Usuário único	Controla como o nó escolhe o usuário que recebe a tarefa. Escolha entre Usuário único, Todos os usuários, Round Robin, Carga de trabalho ou Personalizado.
Esquema	Sim	Enviar resultado	Estrutura do formulário, incluindo campos que o destinatário vê ou preenche e resultados que pode selecionar. A seção Esquema descreve a estrutura completa.
Canais de entrega	—	Definir pelo administrador	Somente leitura no nó. Os canais disponíveis vêm das configurações do seu administrador e aparecem como caixas de seleção desabilitadas. A seção Canais de entrega tem detalhes.
Título da Tarefa	Não	Nenhum	Título mostrado para o destinatário em sua lista de tarefas.
Prioridade	Não	Nenhum	Prioridade mostrada no Action Center: Baixa, Média ou Alta.
Rótulos	Não	Nenhum	Rótulos separados por vírgulas para organizar tarefas, por exemplo, finance,approval.

Critérios de atribuição

Os critérios de atribuição controlam quais usuários recebem a tarefa. A seleção de um critério altera o segundo campo para correspondência — um seletor de usuário para Usuário Único, um seletor de grupo para os critérios baseados em grupo.

Critérios	Quem recebe a tarefa	Use-o ao
Usuário único	Um usuário nomeado.	Uma pessoa específica é a proprietária da decisão — um aprovador nomeado, um único revisor
Todos os usuários	Todos os membros do grupo de uma só vez. A primeira a concluí-la fecha a tarefa para todos.	Você se preocupa com a velocidade do que com a propriedade. Quem estiver gratuito o aceita
Carga de trabalho	O membro do grupo com menos tarefas abertas	Você deseja que a fila se distribua uniformemente por uma equipe
Round Robin	Membros do grupo por vez, percorrendo a lista de associações	Você quer que cada membro tenha uma participação igual, independentemente da velocidade de trabalho
Personalizado	O membro com menos tarefas abertas, escolhido de uma lista de usuários que você fornece no runtime em vez de da associação completa de um grupo.	Alterações de elegibilidade por execução — ignorando usuários que estão ausentes do escritório, fora do turno ou fora da função ou região correta.

Requisitos e limites

Importante:

A carga de trabalho e o Round Robin exigem um grupo local. Os grupos do Active Directory são rejeitados para ambos. Use Usuário único ou Todos os usuários se seus destinatários estiverem em um grupo do Active Directory (AD).

Na depuração, a atribuição de grupos não funciona. Uma execução de teste cria a tarefa onde apenas você pode vê-la, para que os membros do grupo não possam abri-la. A tarefa permanece Unassigned e nenhuma notificação é enviada. Isso é esperado. Para testar a atribuição de grupos, implante o fluxo de trabalho e inicie uma execução. A atribuição de usuário único funciona normalmente na depuração.

Erros que você pode ver:

Erro	Significado
NoUsersFoundInLocalGroup	O grupo selecionado não tem membros.
NoEligibleUsersFoundInGroup	Cada membro foi excluído, então não há mais ninguém para atribuir.

Esquema

O Esquema define o que o destinatário vê e o que ele retorna ao processo. Ele tem duas partes: campos e resultados.

Campos

O Esquema também pode ser editado diretamente como JSON. A referência completa do esquema JSON está em Tarefas de formulário rápido. Na visualização de formulário, cada campo tem estas configurações:

Configuração	O que faz
Label	O nome de exibição mostrado para o destinatário.
Tipo	Controla a validação e como a entrada é renderizada. Tipos disponíveis: Texto, Número, Número decimal, Data, Data e hora, Sim ou não, Seleção única, Seleção múltipla, Array, Arquivo.
Associação	Uma expressão que preenche previamente o campo, por $vars.requestAmt exemplo. Aceita qualquer expressão de fluxo de trabalho, não apenas uma referência de variável.
Editável	O cadeado ao lado do valor. Bloqueado significa que o destinatário pode ler o valor, mas não alterá-lo.
Variável	Exibido como um selo (x) ao lado do nome do campo. Herdado automaticamente dos campos Rótulo para Saída e In/Out, expondo o valor como uma variável de processo nomeada além de.$vars.<nodeName>.output.<fieldId> Não presente nos campos de entrada.

Direções do campo

Os campos transportam dados para dentro e para fora da tarefa. Cada campo tem uma direção.

• Os campos de Entrada são contexto SomenteLeitura para o destinatário, vinculados a um valor de processo, por exemplo $vars.start.output.employeeName.
• O destinatário preenche os campos de Saída e os retorna para o processo.
• Os campos In/Out fazem ambas as coisas: eles mostram ao destinatário um valor de processo como ponto de partida, e o destinatário pode editá-lo antes de devolvê-lo ao processo.

A direção de um campo não é uma configuração separada. É o resultado de dois controles: se o campo está vinculado, determina se ele chega pré-preenchido, e se ele está desbloqueado, determina se o destinatário pode alterá-lo.

Associação	Cadeado	Direction	O destinatário vê	Editável & amp; Retornado
DEFINIR	Bloqueado 🔒	Entrada	O valor vinculado	Não
DEFINIR	Desbloqueado 🔓	In/Out	O valor vinculado	Sim
Nenhum	Desbloqueado 🔓	Saída	Um campo vazio	Sim
Nenhum	Bloqueado 🔒	Inválido	Um campo vazio	Não

Resultados

Os resultados são os botões que o destinatário usa para concluir a tarefa, por exemplo, Aprovar e Rejeitar. O esquema padrão tem um único resultado de Enviar. O primeiro resultado é marcado como a ação primária.

Cada resultado adiciona seu próprio identificador de saída ao nó. Quando o destinatário seleciona um resultado, o processo continua a partir do identificador desse resultado, para que você possa rotear cada resultado para um caminho diferente. A seção Ramificação no resultado mostra como.

Canais de entrega

As tarefas são entregues a:

• Action Center
• Email
• Slack
• Microsoft Teams

Importante:

Apenas um administrador pode alterar os canais de entrega em Configurações do administrador. As caixas de seleção no nó são desabilitadas e mostram as configurações atuais.

O Slack e o Microsoft Teams precisam de uma conexão. As notificações acionáveis abrangem a configuração do conector.

Saída

Acesse a saída do nó em $vars.<nodeName>.output e o resultado selecionado em $vars.<nodeName>.status.

saída

O resultado da tarefa: um objeto que contém os valores que o destinatário enviou, indexados por campo de saída. Leia um único campo com $vars.<nodeName>.output.<fieldId>. O objeto também carrega uma propriedade Action definida como o resultado selecionado.

status

O resultado que o destinatário selecionou, por exemplo, Approve. Ramifique com base nesse valor para rotear o processo.

Ramificação no resultado

Cada resultado que você define adiciona um identificador de saída ao nó. Quando o destinatário conclui a tarefa, o processo continua a partir do identificador para o resultado selecionado. Conecte cada identificador de resultado ao nó que deve ser executado para esse caminho. Você não precisa de um nó de decisão para dividir o resultado.

Quick Form
  ├─ Approve → continue processing
  └─ Reject  → notify the requester and terminate

Leia um campo enviado em qualquer nó subsequente com$vars.<nodeName>.output.<fieldId>:

// In a Script node on one of the outcome paths
return $vars.approval.output.comment;

O resultado selecionado também está disponível como $vars.<nodeName>.statusse você precisar dele em uma expressão.

Problemas comuns

A tarefa não aparece para o destinatário

Verifique se o destinatário, seja ele um usuário ou um grupo, está correto e tem acesso ao Action Center.

Um valor de saída está ausente

Confirme que o campo está definido no Esquema com a direção Output.

Um resultado roteia para o caminho errado

Confirme que o identificador de saída de cada resultado está conectado ao nó que você pretende. Cada resultado que você define no esquema tem seu próprio identificador no nó.

Observações

Observação:

Para testar sem um destinatário real, use a saída Simulação para simular uma resposta status e output . Adicionar aprovação humana a um fluxo de trabalho tem as etapas.

• Se o destinatário for um grupo, qualquer membro desse grupo poderá reivindicar e concluir a tarefa.
• Para uma interface mais rica do que um formulário, use um aplicativo de ação .

Próximas Etapas

• Adicione aprovação humana a um fluxo de trabalho
• App de ação
• Decisão
• Terminate
• Tarefas de formulário rápido