Humano

Nó humano para pausar um processo e atribuir uma tarefa para revisão, aprovação ou entrada humana.

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

Quando usar Humano vs Decisão

Use o nó Humano 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ó Humano 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 nós humanos

A tarefa apresentada ao humano pode ser criada por meio de dois mecanismos: Formulário rápido e Aplicativo de ação.

Formulário rápido

Crie e depure um formulário leve diretamente no nó. Você define os campos que o destinatário vê, as entradas que ele precisa fornecer e os resultados que pode escolher. Esse é o padrão e o melhor ajuste para aprovações e coleta de dados direta.

App de ação

Os aplicativos de ação fornecem uma interface mais rica e totalmente personalizada para a tarefa atribuída ao humano. Eles podem ser criados visualmente no UiPath App Studio ou Studio Web, ou como um aplicativo de ação codificada — um aplicativo React ou Angular personalizado. Um aplicativo codificado é selecionado em Aplicativo de ação e suas entradas são mapeadas no tempo de configuração. Consulte Sobre Coded Action Apps.

	Formulário rápido	App de ação
Interface gráfica definida	No nó, com versão com o processo	Aplicativo separado, implantado no Orchestrator
Reutilizar entre processos	Sim, copiando e colando JSON	Sim
Custo	Sem unidades adicionais, sem dependência do Apps	Requer implantação de aplicativo
Layout	Permite layouts de várias colunas e várias larguras, comportamento do campo	Controle total
Dados no tempo de renderização	Apenas variáveis/expressões de processo vinculadas	SDK: ativos, buckets, conexões, Data Fabric, disparar processos
Teste	Depuração em linha a partir da tela	Criar → implantar → executar
Desenvolva as habilidades necessárias	Nenhum	App Studio ou React/Angular para Apps codificados

Dica:

Comece com um formulário rápido. Mova para um aplicativo de Ação quando você precisar reutilizar a mesma interface entre processos, mostrar dados que o processo ainda não carrega ou criar uma interface gráfica que um formulário não possa expressa.

A criação do próprio aplicativo é abordada na documentação do Action Apps. A partir deste ponto, esta página abrange o tipo de tarefa Formulário rápido . Para um guia prático, consulte Adicionar aprovação humana a um fluxo de trabalho.

Configuração

Campo	Required	Padrão	Description
Critérios de atribuição	Sim	Usuário único	Controla como o nó Humano escolhe a pessoa 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. Consulte o Esquema para ver a estrutura completa.
Canais de entrega	—	Definir no nível do tenant	Somente leitura no nó — os canais disponíveis são herdados da configuração no nível do tenant e mostrados como caixas de seleção desabilitadas. Consulte Canais de entrega para obter 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 qual pessoa ou pessoas 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	Uma pessoa nomeada.	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 pessoa 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 pessoas 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 em um espaço de trabalho pessoal. As execuções de depuração criam a tarefa em seu espaço de trabalho pessoal, que os membros do grupo não podem acessar — então, a tarefa é criada, mas permanece Não atribuída e nenhuma notificação é enviada. Isso é esperado, não um defeito. Implante a solução em uma pasta compartilhada para testar a atribuição de grupos corretamente. 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. Consulte as tarefas Formulário rápido para obter a referência completa do esquema JSON. 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. Consulte Ramificação no resultado.

Canais de entrega

As tarefas são entregues a:

• Action Center
• Email
• Slack
• Microsoft Teams

Importante:

Os canais de entrega só podem ser modificados no nível do tenant, nas Configurações de administrador. As caixas de seleção no nó são desabilitadas e refletem a configuração atual do tenant.

O Slack e o Microsoft Teams exigem uma conexão do Integration Service. Consulte Notificações acionáveis para 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ó Humano. 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
  ├─ 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ó Humano.

Observações

Observação:

Para testar sem um destinatário real, use Saída simulada para simular uma resposta status e output. Consulte Adicionar aprovação humana a um fluxo de trabalho para obter 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, a tarefa com um aplicativo de Ação em vez de um Formulário rápido.

Páginas relacionadas

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