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 orquestación. Si se producen errores fuera de los escenarios, la ejecución de orquestación falla y no puede reanudarla. Consulte Reanudación de una orquestación fallida en la ejecución de orquestación.
La reanudación requiere que un administrador solucione el error o flujo subyacente y luego reanude la ejecución de orquestación. Este enfoque difiere de las rutas de fallo, que un diseñador de orquestación configura en tiempo de diseño. Las rutas de fallo gestionan los errores correctamente y proporcionan mecanismos de recuperación o pasos de intervención manual para los usuarios finales.
Cuando falla una ejecución de orquestación, Salesforce envía un correo electrónico de error al administrador que modificó por última vez la orquestación o a destinatarios de correo electrónico de excepción Apex. El correo electrónico de error proporciona detalles acerca de la ejecución de orquestación, incluyendo qué elementos se ejecutaron y qué flujos hicieron referencia a los pasos. Para una orquestación activa, el correo electrónico 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 correos electrónicos 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, ya que las orquestaciones fallidas no necesariamente revierten todos los cambios de registro anteriores.
Errores no gestionados y cambios de estado
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 | Suspendido |
| Ejecución de etapa | La etapa o un paso dentro de la etapa provocó 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 | Suspendido |
Estrategias de gestión de errores para orquestaciones
La gestión de errores en orquestaciones gestiona fallos de modo que los procesos comerciales 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 introduce 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 traducida. 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 de 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 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 provisión 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 en la etapa de activación del servicio.
Limitaciones de gestión de errores
- No puede agregar la gestión de errores para errores a 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 Final gestiona errores cambiando el estado de ejecución de orquestación a
Completed. Este enfoque suprime el error sin resolverlo. Salesforce no envía correos electrónicos 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.
