Humano

Nodo humano para pausar un proceso y asignar una tarea para revisión, aprobación o entrada humana.

El nodo humano detiene el proceso y asigna una tarea a una persona, luego reanuda el proceso una vez que lo completa. Úsalo cuando un proceso necesite revisión, aprobación o entrada humana antes de poder continuar.

Cuándo utilizar humano frente a decisión

Usa el nodo humano cuando una persona necesite revisar información y responder antes de que el proceso continúe. Usa el nodo de decisión cuando la rama se pueda resolver automáticamente a partir de los datos existentes, sin intervención humana.

El nodo humano enruta en el resultado elegido del asignado a través de sus propios controladores de salida. Alcance de una decisión cuando la rama se deriva de los datos existentes en lugar de la elección de una persona.

Tipos de nodos humanos

La tarea presentada al humano puede crearse a través de dos mecanismos: formulario rápido y aplicación de acción.

Formulario rápido

Crea y depura un formulario ligero directamente en el nodo. Defines los campos que ve el usuario asignado, las entradas que debe proporcionar y los resultados que puede elegir. Este es el valor predeterminado y el más adecuado para las aprobaciones y la recopilación de datos sencilla.

Aplicación de acción

Las aplicaciones de acción proporcionan una interfaz más rica y totalmente personalizada para la tarea asignada al humano. Se pueden crear visualmente en UiPath App Studio o Studio Web, o como una aplicación de acción codificada: una aplicación React o Angular personalizada. Se selecciona una aplicación codificada en Aplicación de acción y sus entradas se asignan en el momento de la configuración. Consulta Acerca de las Apps de acción codificada.

	Formulario rápido	Aplicación de acción
IU definida	En el nodo, versionado con el proceso	Aplicación independiente, implementada en Orchestrator
Reutilizar en todos los procesos	Sí, copiando y pegando JSON	Sí
Coste	Sin unidades adicionales, sin dependencia de Apps	Requiere la implementación de la aplicación
Diseño	Permite diseños de varias columnas y varios anchos, comportamiento de campo	Control total
Datos en tiempo de renderización	Solo variables/expresiones de proceso vinculadas	SDK: activos, depósitos, conexiones, Data Fabric, desencadenar procesos
Pruebas	Depuración en línea desde el lienzo	Compilar → implementar → ejecutar
Desarrollar las habilidades necesarias	Ninguno	App Studio o React/Angular para Apps codificadas

Consejo:

Comienza con un formulario rápido. Cambia a una aplicación de Action cuando necesites reutilizar la misma interfaz en todos los procesos, mostrar datos que el proceso no lleva o crear una IU que un formulario no pueda expresar.

La creación de la aplicación en sí se trata en la documentación de Action Apps. A partir de este momento, esta página cubre el tipo de tarea Formulario rápido . Para obtener una descripción práctica, consulta Añadir aprobación humana a un flujo de trabajo.

Configuración

Campo	Obligatorio	Predeterminado	Descripción
Criterios de asignación	Sí	Usuario único	Controla cómo el nodo humano elige a la persona que recibe la tarea. Elige entre Usuario único, Todos los usuarios, Round Robin, Carga de trabajo o Personalizado.
Esquema	Sí	Enviar resultado	Estructura del formulario, incluidos los campos que ve o rellena el usuario asignado y los resultados que puede seleccionar. Consulta Esquema para ver la estructura completa.
Canales de entrega	—	Establecer a nivel de tenant	De solo lectura en el nodo: los canales disponibles se heredan de la configuración a nivel de tenant y se muestran como casillas de verificación deshabilitadas. Consulta Canales de entrega para obtener más información.
Título de tarea	No	Ninguno	Título que se muestra al asignado en su lista de tareas.
Prioridad	No	Ninguno	Prioridad mostrada en Action Center: Baja, Media o Alta.
Etiquetas	No	Ninguno	Etiquetas separadas por comas para organizar tareas, por ejemplo finance,approval.

Criterios de asignación

Los criterios de asignación controlan qué persona o personas reciben la tarea. Al seleccionar un criterio cambia el segundo campo para que coincida: un selector de usuario para Usuario único, un selector de grupo para los criterios basados en grupos.

Criterios	Quién recibe la tarea	Úsalo cuando
Usuario único	Una persona nombrada.	Una persona específica es propietaria de esta decisión: un aprobador designado, un revisor único
Todos los usuarios	Todos los miembros del grupo a la vez. La primera persona en completarla cierra la tarea para todos.	Te importa la velocidad sobre la propiedad. El que esté libre lo recoge
Carga de trabajo	El miembro del grupo con menos tareas abiertas	Desea que la cola se distribuya de manera uniforme en un equipo
Round robin	Miembros del grupo por turno, recorriendo la lista de miembros	Desea que cada miembro tome una parte igual, independientemente de lo rápido que trabajen
Personalizar	El miembro con el menor número de tareas abiertas, elegido de una lista de usuarios que proporcionas en runtime en lugar de entre la membresía completa de un grupo.	Cambios de elegibilidad por ejecución: omitir a las personas que están fuera de la oficina, fuera de turno o fuera del rol o región correctos.

Requisitos y límites

Importante:

La carga de trabajo y Round Robin requieren un grupo local. Los grupos de Active Directory se rechazan para ambos. Utiliza Usuario único o Todos los usuarios si tus asignados están en un grupo de Active Directory (AD).

En la depuración, la asignación de grupos no funciona desde un espacio de trabajo personal. Las ejecuciones de depuración crean la tarea en tu espacio de trabajo personal, al que los miembros del grupo no pueden acceder, por lo que la tarea se crea pero permanece Sin asignar y no se envían notificaciones. Esto es lo esperado, no un defecto. Implemente la solución en una carpeta compartida para probar la asignación de grupos correctamente. La asignación de usuario único funciona normalmente en depuración.

Errores que puedes ver:

Error	Significado
NoUsersFoundInLocalGroup	El grupo seleccionado no tiene miembros.
NoEligibleUsersFoundInGroup	Se excluyeron todos los miembros, por lo que no queda nadie a quien asignar.

Esquema

El esquema define lo que ve el usuario asignado y lo que devuelve al proceso. Tiene dos partes: campos y resultados.

Campos

El esquema también se puede editar directamente como JSON. Consulta Tareas de formulario rápido para obtener la referencia completa del esquema JSON. En la vista Formulario, cada campo tiene estos ajustes:

Configuración	Lo que hace
Etiqueta	El nombre para mostrar que se muestra al usuario asignado.
Tipo	Controla la validación y cómo se representa la entrada. Tipos disponibles: texto, número, número decimal, fecha, fecha y hora, sí o no, selección única, selección múltiple, matriz, archivo.
Vinculación	Una expresión que rellena previamente el campo, por ejemplo $vars.requestAmt. Acepta cualquier expresión de flujo de trabajo, no solo una referencia de variable.
Editable	El candado junto al valor. Bloqueado significa que el usuario asignado puede leer el valor pero no cambiarlo.
Variable	Se muestra como una insignia (x) junto al nombre del campo. Derivado automáticamente de los campos Etiqueta para Salida y Entrada/Salida, exponiendo el valor como una variable de proceso nombrada además de $vars.<nodeName>.output.<fieldId>. No presente en los campos de entrada.

Direcciones de campo

Los campos transportan datos dentro y fuera de la tarea. Cada campo tiene una dirección.

• Los campos de entrada son contexto de solo lectura para el usuario asignado, vinculados a un valor de proceso, por ejemplo $vars.start.output.employeeName.
• Los campos de salida son rellenados por el usuario asignado y devueltos al proceso.
• Los campos de entrada/salida hacen ambas cosas: muestran al destinatario un valor de proceso como punto de partida, y el destinatario puede editarlo antes de que se devuelva al proceso.

La dirección de un campo no es una configuración independiente. Es el resultado de dos controles: si el campo está vinculado determina si llega rellenado previamente, y si está desbloqueado determina si el usuario asignado puede cambiarlo.

Vinculación	Candado	Dirección	El asignado ve	Editable & Devuelto
ESTABLECER	Bloqueado 🔒	Entrada	El valor vinculado	No
ESTABLECER	Desbloqueado 🔓	In/Out	El valor vinculado	Sí
Ninguno	Desbloqueado 🔓	Salida	Un campo vacío	Sí
Ninguno	Bloqueado 🔒	No válido	Un campo vacío	No

Resultados

Los resultados son los botones que utiliza el usuario asignado para completar la tarea, por ejemplo Aprobar y Rechazar. El esquema predeterminado tiene un único resultado Enviar . El primer resultado se marca como la acción principal.

Cada resultado añade su propio identificador de salida al nodo. Cuando el usuario asignado selecciona un resultado, el proceso continúa desde el identificador de ese resultado, para que puedas enrutar cada resultado a una ruta diferente. Consulta Ramificar en el resultado.

Canales de entrega

Las tareas se entregan a:

• Action Center
• Correo electrónico
• Slack
• Microsoft Teams

Importante:

Los canales de entrega solo se pueden modificar en el nivel de tenant, desde Configuración de administrador. Las casillas de verificación del nodo están deshabilitadas y reflejan la configuración actual del tenant.

Slack y Microsoft Teams requieren una conexión de Integration Service. Consulta Notificaciones accionables para la configuración del conector.

Salida

Accede a la salida del nodo en $vars.<nodeName>.output y al resultado seleccionado en $vars.<nodeName>.status.

salida

El resultado de la tarea: un objeto que contiene los valores que el usuario asignado envió, introducidos por el campo de salida. Leer un solo campo con $vars.<nodeName>.output.<fieldId>. El objeto también lleva una propiedad Action establecida en el resultado seleccionado.

estado

El resultado seleccionado por el usuario asignado, por ejemplo Approve. Ramifica en este valor para enrutar el proceso.

Ramificación en el resultado

Cada resultado que defines añade un identificador de salida al nodo humano. Cuando el usuario asignado completa la tarea, el proceso continúa desde el manipulador para el resultado que ha seleccionado. Conecta cada identificador de resultado al nodo que debe ejecutarse para esa ruta. No necesitas un nodo de decisión para dividir en el resultado.

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

Leer un campo enviado en cualquier nodo posterior con $vars.<nodeName>.output.<fieldId>:

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

El resultado seleccionado también está disponible como $vars.<nodeName>.status si lo necesitas en una expresión.

Problemas comunes

La tarea no aparece para el usuario asignado

Verifique que el asignado, ya sea un usuario o un grupo, sea correcto y tenga acceso a Action Center.

Falta un valor de salida

Confirma que el campo está definido en el Esquema con salida de dirección.

Un resultado redirige a la ruta incorrecta

Confirme que el identificador de salida de cada resultado está conectado al nodo deseado. Cada resultado que defines en el esquema tiene su propio identificador en el nodo humano.

Notas

Nota:

Para probar sin un asignado real, utiliza Salida simulada para simular una respuesta status y output . Consulta Añadir aprobación humana a un flujo de trabajo para ver los pasos.

• Si el asignado es un grupo, cualquier miembro de ese grupo puede reclamar y completar la tarea.
• Para una interfaz más rica que un formulario, realiza la tarea con una aplicación de acción en lugar de un formulario rápido.

Páginas relacionadas

• Añadir aprobación humana a un flujo de trabajo
• Decisión
• Terminate
• Tareas de formulario rápido