Usted está aquí:
Tratamiento de errores en orquestaciones
La gestión de errores gestiona problemas inesperados que se producen en etapas durante una ejecución de orquestación. Configure rutas de fallo para etapas para definir acciones de recuperación cuando se producen errores de etapa, garantizando que las orquestaciones se completen correctamente en vez de fallar.
Ediciones necesarias
| Vea ediciones compatibles para Orquestación de flujos. |
General
Cuando una ejecución de orquestación encuentra un error, el sistema establece su estado como Error. Muchos errores que se producen en etapas son recuperables. Para estos errores, tiene hasta 14 días para solucionar el error y reanudar la ejecución de la orquestación. Si se producen errores fuera de las etapas, la ejecución de la orquestación falla y no puede reanudarla. Consulte Reanudación de una orquestación fallida en Ejecución de orquestación.
La reanudación requiere que un administrador solucione el error o el flujo subyacente y luego reanude la ejecución de orquestación. Este enfoque difiere de las rutas de fallo, que un diseñador de orquestaciones configura en tiempo de diseño. Las rutas de fallo gestionan los errores con gracia y proporcionan mecanismos de recuperación o pasos de intervención manual para usuarios finales.
Cuando una ejecución de orquestación falla, Salesforce envía un email de error al administrador que modificó por última vez la orquestación o a destinatarios de email de excepción Apex. El email de error proporciona detalles acerca de la ejecución de la orquestación, incluyendo qué elementos se ejecutaron y qué flujos hacen referencia a los pasos. Para una orquestación activa, el email también incluye un vínculo para ver los detalles de la ejecución de orquestación fallida en Flow Builder. Si un flujo llamado por la orquestación causa el fallo, los destinatarios reciben dos emails de error: uno para la orquestación y otro para el flujo llamado.
Cuando una ruta de fallo gestiona un error y se completa correctamente, la orquestación no envía notificaciones de error. Sin embargo, puede agregar un paso en segundo plano a la ruta de fallo que notifica a las partes interesadas cuando se produce un fallo.
Para gestionar errores, configure rutas de fallo para etapas en su orquestación. Si una etapa o cualquier paso dentro de ella encuentra un error, estas rutas definen acciones alternativas para minimizar los fallos del proceso.
Diseñe y depure sus orquestaciones en un entorno sandbox antes de implementar en producción, porque las orquestaciones con fallos no necesariamente revierten todos los cambios de registro anteriores.
Errores y cambios de estado no gestionados
Se produce un error no gestionado cuando una ejecución de orquestación encuentra un problema durante la ejecución y no existe ningún mecanismo de recuperación. Para orquestaciones, se produce un error no gestionado cuando una etapa o un paso encuentra un error y la etapa no tiene ninguna ruta de fallo configurada.
| Elemento | Condición | Estado |
|---|---|---|
| Ejecución de orquestación | Se produjo cualquier error | Error |
| Ejecución de etapa | La etapa estaba en curso cuando se produjo un error a nivel de ejecución de orquestación | Descontinuada |
| Ejecución de etapa | La etapa o un paso dentro de la etapa causó el error | Error |
| Ejecución de paso | El paso dentro de la etapa provocó el error | Error |
| Ejecución de paso | El paso dentro de la etapa no se inició antes de que se produjera el error | No iniciado |
| Ejecución de paso | El paso dentro de la etapa estaba en curso cuando se produjo el error | Descontinuada |
Estrategias de tratamiento de errores para orquestaciones
La gestión de errores en orquestaciones gestiona los fallos de modo que los procesos de negocio se completen correctamente o se recuperen correctamente. Utilice rutas de fallo para gestionar errores desde etapas y pasos. Puede utilizar rutas de fallo individuales para la recuperación dirigida o una ruta de fallo centralizada para la gestión integral de errores.
Las rutas de fallo son útiles en escenarios donde los usuarios finales pueden proporcionar intervención manual cuando la ejecución de orquestación encuentra un error. Por ejemplo, una integración externa o llamada de API falla porque un extremo está inactivo. Una ruta de fallo puede incluir un paso interactivo donde el asignado ingresa manualmente los datos requeridos.
Una ruta de fallo puede estar vacía o contener elementos de decisión y elementos de etapa. Cada etapa en una ruta de fallo requiere al menos un paso y puede contener múltiples pasos. Estos pasos incluyen pasos en segundo plano, pasos interactivos o una combinación de ambos. Las rutas de fallo también admiten conectores Ir a. Un conector Ir a vincula con otro elemento en la misma ruta de fallo, una ruta de fallo diferente o la ruta principal de la orquestación.
Rutas de fallo individuales. Configure una ruta de fallo separada para cada etapa en una orquestación. Estas rutas individuales contienen elementos y etapas con pasos que gestionan errores específicos de cada etapa. Este enfoque proporciona una resolución de errores altamente localizada. Por ejemplo, en una orquestación de procesamiento de pedidos, la etapa de verificación de inventario encuentra un error debido a un tiempo de espera de conexión. La ruta del fallo puede volver a ejecutar el paso de verificación, enviar una notificación a operaciones o enrutar a una etapa de revisión manual.
Ruta de fallo centralizada. Configure una ruta de fallo central que sirva como un mecanismo de gestión de errores consolidado. Normalmente, este enfoque comienza con un elemento de decisión que evalúa variables y resultados automáticos relacionados con la ejecución de orquestación. La decisión identifica la etapa específica donde se produjo el error. Los elementos de la ruta de resultados asociada solucionan el fallo. Conecte la ruta de fallo de cada etapa con el primer elemento de decisión en la ruta de fallo central. Este enfoque proporciona una resolución de errores integral.
Por ejemplo, en una orquestación de incorporación de clientes, la ruta de fallo centralizada comienza con un elemento de decisión. Esta decisión evalúa qué etapa encontró un error y determina la acción de recuperación apropiada.
Si el estado de la etapa Crear cuenta de cliente no es Completed, la ruta del resultado de la decisión incluye una etapa con un paso en segundo plano. Este paso notifica al gestor de cuentas sobre el problema. Si el paso Configurar acceso a servicios en la etapa Sistemas de aprovisionamiento falla, la ruta del resultado de la decisión incluye una etapa con dos pasos. Un paso en segundo plano crea un ticket de asistencia. Un paso interactivo asigna la configuración del sistema al equipo de TI. Después de que TI complete la configuración, la orquestación continúa a la etapa de activación del servicio.
Limitaciones de tratamiento de errores
- No puede agregar la gestión de errores para errores de nivel de ejecución de orquestación.
- Puede ver detalles de depuración para una ejecución de orquestación fallida solo en 14 días desde el fallo.
- Una ruta de fallo que contiene solo un elemento Fin gestiona errores cambiando el estado de ejecución de orquestación a
Completed. Este enfoque suprime el error sin resolverlo. Salesforce no envía emails de notificación de error cuando el estado de ejecución de orquestación es Completado. Sin embargo, el paso y la etapa que encontraron originalmente el error permanecen en el estado Error, aunque el estado de ejecución de orquestación sea Completado.
