Formulario rápido

Pausa un flujo de trabajo y pide a un humano que revise, apruebe o rellene un formulario que creas en el nodo, y luego continúa con su respuesta.

Formulario rápido detiene el flujo de trabajo y asigna una tarea a un humano: un formulario que creas directamente en el nodo. El humano lo revisa, lo rellena y selecciona un resultado, como Aprobar o Rechazar, y el flujo de trabajo continúa en la ruta de ese resultado. Está en la categoría Humano del panel Añadir nodo .

Utiliza el formulario rápido para aprobaciones y recopilación de datos sencilla. Cuando necesites una interfaz más rica, reutilice una en todos los flujos de trabajo o muestre datos que el flujo de trabajo aún no transporta, utiliza una aplicación de acción en su lugar. Añadir aprobación humana a un flujo de trabajo recorre un formulario rápido paso a paso.

Cuándo utilizar el formulario rápido frente a la decisión

Usa Formulario rápido cuando un humano necesite revisar información y responder antes de que continúe el flujo de trabajo. Usa Decisión cuando la rama se pueda resolver automáticamente a partir de los datos existentes, sin intervención humana.

Configuración

Campo	Obligatorio	Predeterminado	Descripción
Criterios de asignación	Sí	Usuario único	Controla cómo el nodo elige al usuario 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. La sección Esquema describe la estructura completa.
Canales de entrega	—	Establecido por su administrador	De solo lectura en el nodo. Los canales disponibles provienen de la configuración de tu administrador y se muestran como casillas de verificación deshabilitadas. La sección Canales de entrega tiene más detalles.
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é usuarios 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	Un usuario nombrado.	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. El primero 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 los usuarios 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. Una ejecución de prueba crea la tarea donde solo tú puedes verla, por lo que los miembros del grupo no pueden abrirla. La tarea permanece Sin asignar y no se envían notificaciones. Esto es lo esperado. Para probar la asignación de grupos, implementa el flujo de trabajo e inicia una ejecución. 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. La referencia completa del esquema JSON está en Tareas de formulario rápido. 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. La sección Ramificar en el resultado muestra cómo.

Canales de entrega

Las tareas se entregan a:

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

Importante:

Solo un administrador puede cambiar los canales de entrega, en Configuración de administrador. Las casillas de verificación del nodo están deshabilitadas y muestran la configuración actual.

Slack y Microsoft Teams necesitan una conexión. Las notificaciones procesables cubren 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. 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.

Quick Form
  ├─ 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.

Notas

Nota:

Para probar sin un asignado real, utiliza Salida simulada para simular una respuesta status y output . Añadir aprobación humana a un flujo de trabajo tiene los siguientes 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, utiliza una aplicación de acción en su lugar.

Próximos pasos

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