Tarefa humana

Pause um processo para atribuir uma tarefa para revisão, aprovação ou entrada humana.

O nó Tarefa Humana pausa o processo e atribui uma tarefa a uma pessoa, em seguida, retoma após a conclusão dela. Use-a quando um processo precisar de revisão humana, aprovação ou entrada antes de poder continuar.

Esta página abrange o tipo de tarefa Formulário rápido , no qual você cria o formulário diretamente no nó. Para um guia prático, consulte Adicionar aprovação humana a um fluxo de trabalho.

Quando usar Tarefa Humana vs. Decisão

Use o nó Tarefa Humana quando uma pessoa precisar revisar as informações e responder antes que o processo continue. Use o nó Decisão quando a ramificação puder ser resolvida automaticamente a partir de dados existentes, sem envolvimento humano.

O nó da Tarefa Humana roteia no resultado escolhido do destinatário por meio de seus próprios identificadores de saída. Obter uma decisão quando a ramificação segue de dados existentes em vez de uma escolha de pessoa.

Tipos de tarefas

O campo Tipo controla como a tarefa é apresentada ao destinatário.

Formulário rápido

Crie o formulário diretamente no nó. Você define os campos que o destinatário vê e os resultados que ele pode escolher. Esse é o padrão e o melhor ajuste para aprovações e coleta de dados direta. O restante desta página documenta o Formulário rápido.

Aplicativo personalizado

Suporte à tarefa com um Action App codificado para uma interface mais rica e personalizada. Selecione o aplicativo em Aplicativo de ação e mapeie suas entradas. A criação do próprio aplicativo é abordada na documentação do Action Apps.

Configuração

Campo	Required	Padrão	Description
Tipo	Sim	Formulário rápido	Modo de apresentação da tarefa. Formulário rápido apresenta um formulário definido no nó; O aplicativo personalizado apresenta um aplicativo de ação codificado.
Canais de entrega	Sim	Action Center e email, atribuídos a um grupo	Destinos e destinatário da entrega da tarefa. Os canais compatíveis são Action Center, Email, Slack e Microsoft Teams; O Slack e o Microsoft Teams exigem uma conexão do Integration Service.
Esquema da tarefa	Sim	Enviar resultado	Estrutura do formulário, incluindo campos que o destinatário vê ou preenche e resultados que pode selecionar. Consulte Esquema: campos e resultados para a estrutura completa.
Título da Tarefa	Não	Nenhum	Título mostrado para o destinatário na sua lista de tarefas.
Prioridade	Não	Nenhum	Prioridade exibida no Action Center: Baixa, Média ou Alta.
Rótulos	Não	Nenhum	Rótulos separados por vírgulas para organizar tarefas, por finance,approval.

Esquema: campos e resultados

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

Campos

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

• Os campos de entrada são contexto somente leitura para o destinatário, associados a um valor de processo, por $vars.start.output.employeeName.
• Os campos de saída são preenchidos pelo destinatário e retornados ao processo.
• Os campos In/Out fazem as duas coisas: eles mostram ao destinatário um valor de processo como um ponto de partida, e o destinatário pode editá-lo antes que ele retorne ao processo.

Cada campo tem um tipo. Tipos disponíveis:

• text
• number
• date
• boolean
• file

Resultados

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 principal.

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. Consulte Ramificação no resultado.

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 com os valores que o destinatário enviou, codificados por campo de saída. Leia um único campo com $vars.<nodeName>.output.<fieldId>. O objeto também carrega uma propriedade Action definida para o resultado selecionado.

status

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

Ramificando no resultado

Cada resultado que você define adiciona um identificador de saída ao nó Tarefa Humana. 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.

Human Task
  ├─ Approve → continue processing
  └─ Reject  → notify the requester and terminate

Leia um campo enviado em qualquer nó downstream 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>.status se você precisar dele em uma expressão.

Problemas comuns

A tarefa não aparece para o destinatário

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

Um valor de saída está ausente na saída

Confirme que o campo está definido no Esquema de Tarefa 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ó Tarefa Humana.

Observações

Observação:

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

• Se o destinatário for um grupo, qualquer membro desse grupo pode reivindicar e concluir a tarefa.
• Para uma interface mais rica do que um formulário, defina Tipo como Aplicativo personalizado e suporta a tarefa com um Aplicativo de ação.

Páginas relacionadas

• Adicionar aprovação humana a um fluxo de trabalho
• Decisão
• Terminate