- Introducción
- Primeros pasos
- Crear en cualquier lienzo
- Crear con caso
- Referencia
- Definir claves de caso (de sistema o externo)
- Establecer contratos de entrada/salida y de escritura diferida de tareas
- Modelar las etapas principal y secundaria
- Iniciar un caso desde Data Fabric
- Implementar perfiles y permisos a nivel de etapa
- Establecer SLA y reglas de escalado automatizadas
- Configurar un bucle de reprocesamiento (reingreso)
- Configurar y probar el agente de Case Manager (vista previa)
- Crear con flujo
- Crear con BPMN
- En funcionamiento
- Supervisión
- Optimizando
- Información de referencia
Administración de errores
Controladores de error por nodo en Flujo que enrutan los fallos de nodo a una ruta independiente y exponen los detalles del error a través de variables.
Qué es
La gestión de errores en Flow es un mecanismo por nodo que te permite controlar lo que sucede cuando un nodo falla durante la ejecución. De forma predeterminada, un nodo fallido detiene todo el proceso. Puedes anular esto activando la gestión de errores para el nodo y conectando su controlador de errores para enrutar los fallos a una ruta independiente donde inspeccionas y respondes al error.
Cómo funciona
Cada nodo que admite la gestión de errores tiene una pestaña Gestión de errores en su panel de propiedades. La alternancia Habilitar gestión de errores en esa pestaña añade un controlador de error al nodo: un segundo conector de salida etiquetado como Error, debajo del controlador de salida principal, que se activa cuando el nodo falla. La mayoría de los nodos admiten la gestión de errores.
Cuando falla un nodo con un identificador de error conectado, la ejecución enruta a la ruta de error en lugar de detener el proceso. Los detalles del error están disponibles como una variable que puedes leer en los nodos posteriores.
Cuando falla un nodo sin un controlador de errores conectado, todo el proceso falla inmediatamente. El error aparece en el panel de ejecución en la pestaña Incidentes .
Reintentos de solicitud HTTP
El nodo de solicitud HTTP admite reintentos configurables. Cuando se configuran los reintentos, el nodo intenta la solicitud el número de veces especificado antes de desencadenar el controlador de error. Si todos los reintentos fallan y se conecta un controlador de errores, la ejecución enruta a la ruta de error. Si no se conecta ningún controlador de errores, el proceso falla.
Errores del sistema del proveedor
Los nodos de conector y las solicitudes HTTP que pasan por Integration Service fallan cuando el sistema del proveedor responde con un estado de error, es decir, cualquier cosa distinta de 2xx. El error tiene el código IntSvcVendorRequestFailed (102021) y un mensaje en el formulario Received failure from vendor system on API - <url>: HTTP Status: <code> - <vendor message>. El error status es el estado del proveedor, por lo que puedes bifurcarlo en la ruta de error. Un estado 4xx no se vuelve a intentar, y otros estados sí.
Configurar controladores de error
Activar Habilitar gestión de errores en la pestaña Gestión de errores del panel de propiedades añade el controlador de errores al nodo. Conectar el controlador de error a otro nodo en el lienzo conecta la ruta de error. Un nodo sin una pestaña Gestión de errores no admite la gestión de errores, por lo que cualquier fallo detiene el proceso.
El objeto de error
Cuando se conecta un controlador de error y el nodo falla, los detalles del error están disponibles como $vars.<nodeName>.error. Este objeto tiene los siguientes campos:
code
Un código de error legible por máquina que identifica el tipo de fallo.
Mensaje
Una descripción legible por humanos de lo que salió mal. Utilízalo para registrar o mostrar información de error.
Detalles
Una descripción técnica detallada del fallo, incluidos los seguimientos de pila o información específica del servicio cuando esté disponible.
Categoría
La categoría de error, que agrupa los tipos de error relacionados.
estado
El código de estado HTTP asociado con el error. Se rellena para fallos relacionados con HTTP (por ejemplo, 404 o 500).
El objeto de error solo está disponible en la ruta de error. Acceder $vars.<nodeName>.error en la ruta de éxito devuelve indefinido.
Ejemplo práctico
Este ejemplo utiliza un nodo de solicitud HTTP para llamar a una API externa, con un nodo de script en la ruta de error que devuelve los detalles del fallo.
Se coloca un nodo de solicitud HTTP en el lienzo y se configura con la URL de destino. Su manipulador de errores está conectado a un nodo de Script . El nodo Script lee el objeto de error de la siguiente manera:
const error = $vars.httpRequest1.error;
return {
failed: true,
reason: error.message,
httpStatus: error.status,
detail: error.detail
};
const error = $vars.httpRequest1.error;
return {
failed: true,
reason: error.message,
httpStatus: error.status,
detail: error.detail
};
Cuando la solicitud HTTP tiene éxito, la ejecución sigue la ruta de éxito y se omite el nodo Script. Cuando la solicitud falla (después de cualquier reintento configurado), la ejecución se enruta al nodo Script, que recibe el objeto de error completo.
Patrones
Estos son enfoques comunes para gestionar, registrar, reintentar y escalar errores. Todos se basan en el controlador de error por nodo descrito anteriormente: un controlador de error conectado enruta los fallos a una ruta independiente, donde el objeto de error está disponible en $vars.<node>.error.
Devolver detalles del error y continuar
Este patrón se adapta a las operaciones no críticas en las que el flujo de trabajo debe continuar incluso si falla un paso. El manipulador de errores del nodo se conecta a un nodo de Script que devuelve el mensaje de error y luego se vuelve a unir a la ruta principal para que la ejecución continúe.
// Script node on the error path
return {
message: "Error raised: " + $vars.step1.error.message,
result: null // downstream nodes handle a null result
};
// Script node on the error path
return {
message: "Error raised: " + $vars.step1.error.message,
result: null // downstream nodes handle a null result
};
Reintentar con límite
Este patrón se ajusta a fallos transitorios probables, como tiempos de espera de la red, límites de tasa o interrupciones temporales del servicio. Para el nodo de solicitud HTTP , el recuento de reintentos integrado vuelve a intentar la solicitud antes de desencadenar el controlador de error, y solo el fallo final enruta a la ruta de error. La configuración de reintento pertenece solo a operaciones idempotentes.
Alertar y finalizar
Este patrón se ajusta a errores irrecuperables que requieren atención humana. En la ruta de error, se envía una notificación (a través de una solicitud HTTP o un nodo de integración), luego un nodo Terminar con estado Failed y un mensaje descriptivo como $vars.step1.error.message finaliza el flujo de trabajo.
Valor alternativo
Este patrón se ajusta a las operaciones que pueden fallar pero tienen un valor predeterminado seguro que permite que el flujo de trabajo continúe de forma significativa. En la ruta de error, un nodo de Script establece la salida esperada en un valor predeterminado y luego se vuelve a unir a la ruta principal como si la operación se hubiera realizado correctamente.
Errores comunes
- Tragar errores de forma silenciosa : los errores en la ruta de error siempre deben registrarse, incluso cuando el flujo de trabajo continúa. Los fallos silenciosos son difíciles de diagnosticar más tarde.
- Reintentar operaciones no idempotentes : las operaciones con efectos secundarios (escribir datos, enviar un mensaje) pueden producir duplicados si se reintentan. La configuración de reintento pertenece solo a operaciones que pueden ejecutarse más de una vez sin crear duplicados.
- Dejar los controladores de error desconectados : un nodo cuyo controlador de error no está conectado falla todo el proceso en caso de error. Los flujos de trabajo que deben continuar más allá de un error necesitan una ruta de error conectada.
Páginas relacionadas
- Gestionar errores : tarea paso a paso: crear una ruta de error de extremo a extremo
- El lienzo : descripción general del espacio de trabajo, incluido el panel de ejecución
- Variables y flujo de datos : cómo pasan los datos entre nodos utilizando
$vars - Depurar de forma efectiva : consejos para inspeccionar errores en modo de depuración
- Qué es
- Cómo funciona
- Reintentos de solicitud HTTP
- Errores del sistema del proveedor
- Configurar controladores de error
- El objeto de error
- code
- Mensaje
- Detalles
- Categoría
- estado
- Ejemplo práctico
- Patrones
- Devolver detalles del error y continuar
- Reintentar con límite
- Alertar y finalizar
- Valor alternativo
- Errores comunes
- Páginas relacionadas