Configuración de detección de errores
Los conectores se utilizan con las páginas de datos para leer datos (como datos relacionados con la póliza de seguros y con el cliente) de un sistema externo. Cuando una página de datos invoca a un conector, la detección de errores identifica y aborda cualquier error de integración. Cada conector incluye un flujo de manejo de errores.
Errores de origen de datos
Las páginas de datos se cargan según la demanda. Pueden generarse errores cuando se recuperan datos desde un origen de datos.
Entre los ejemplos de errores, se encuentran los siguientes:
- Time out (Tiempo agotado): Un sistema origen o una base de datos no funciona
- Invalid request (Solicitud no válida): Autenticación o solicitud de datos no válida
- System error (Error de sistema): Un error durante la carga o en el sistema externo
El tipo de origen de datos que se utiliza para cargar la página de datos afecta el modo en el que los errores se detectan y se manejan. Los errores de origen de datos deben manejarse como parte del mecanismo de carga de una página de datos.
Cuando las páginas de datos invocan un conector, las prácticas recomendadas son las siguientes:
- Agregar la detección de errores a todas las páginas de datos
- Invocar a un data transform de gestión de errores reutilizable para identificar y abordar los errores
Nota: Pega Platform™ proporciona una plantilla para un data transform llamado pxErrorHandlingTemplate, un data transform de gestión de errores reutilizable. El data transform pxErrorHandlingTemplate está en la clase básica.
Lógica de manejo de errores
Diseñe su lógica de manejo de errores en función de las necesidades del negocio y en los tipos de errores que ocurren. Las tres situaciones que debe tener en cuenta son las siguientes:
- Cuando el usuario puede solucionar un error
- Cuando el usuario no puede solucionar un error, pero el procesamiento puede continuar (por ejemplo, si los datos no son obligatorios para el proceso)
- Cuando el usuario no puede solucionar un error, y el procesamiento del caso debe detenerse
Detección temprana de errores
Para garantizar la mejor experiencia de usuario, identifique los errores tan temprano como sea posible durante el proceso. Diríjase al usuario con mensajes de error claros que le expliquen qué sucedió y qué debe hacer a continuación. Siempre que sea posible, incluya un flujo de proceso alternativo para cuando el caso no pueda continuar, como por ejemplo, que se abra un chat de asistencia o que se envíe un correo electrónico para confirmarle al usuario que se creó un caso de resolución de errores.
Data transform de respuesta
Las opciones de origen de datos Connector, Report definition y Lookup de una página de datos requieren un Response data transform. Siga la práctica recomendada de verificar si hay errores directamente en el data transform de respuesta con la condición when para comprobar si hay algún mensaje de error en la página de datos. Si hay errores, llame a otro Error handling data transform.
Mensajes de error
Si hay algún problema, se muestra un mensaje de error en el portapapeles. Si al error lo puede corregir el usuario, muestre un mensaje de error para explicarle cómo corregirlo.
Flujo de manejo de errores
La herramienta de flujo de gestión de errores identifica los errores que no se detectan en una página de datos o en un data transform. Pega Platform invoca de forma automática al Flujo de manejo de errores si otro mecanismo no aborda el error. Esta herramienta siempre está habilitada y le permite implementar un proceso para manejar el error. Por lo general, se utiliza cuando la respuesta del conector no se necesita de inmediato, por ejemplo, cuando se actualiza un sistema heredado.
Nota: El flujo de gestión de errores no se ejecuta si el error se detecta en el data transform de respuesta.
Puede configurar el Flujo de manejo de errores para el conector en la pestaña Service (Servicio). Los conectores utilizan el flujo estándar ConnectionProblem de forma predeterminada. El flujo puede copiarse y personalizarse. Además, puede elegir crear un flujo de manejo de errores alternativo.
Cuando ocurre un error, se pausa la ejecución del flujo original. El control se transfiere al flujo de manejo de errores. Si el recurso no está disponible, es posible que un error temporal esté impidiendo el procesamiento. Si no hay un error temporal, se vuelve a probar el conector, y el procesamiento continúa en un flujo llamado FlowProblems.
El flujo FlowProblems enruta el objeto de trabajo a un pozo de trabajo de flujo de problemas o notifica a un operador sobre el problema.
El operador puede realizar las siguientes acciones:
- Volver a probar el conector
- Reanudar el flujo sin volver a probar el conector
- Reiniciar el flujo inicial
- Cancelar el flujo de manejo de errores
Nota: Una práctica recomendada es notificar al usuario sobre el error y, siempre que sea posible, volver a enrutar a un proceso alternativo para que el usuario no quede estancado frente a la pantalla esperando que algo suceda.
Data transform de manejo de errores
La plantilla para data transform de gestión de errores incluye ejemplos de llamadas a funciones de utilidades estándar. Puede configurar el data transform para personalizar el comportamiento de manejo de errores, como mostrar mensajes de error más comprensibles para el usuario.
En la siguiente imagen, haga clic en los íconos + para obtener más información sobre la plantilla de data transform de manejo de errores:
Volver a probar un conector invocado desde una página de datos
Si el error devuelto es temporal, ofrézcale al usuario la opción de volver a probar el conector. Para realizar esta acción, configure la estrategia de actualización de la página de datos:
- Cree una condición when que devuelva el resultado “true” cuando no haya mensajes de error.
- Configure el parámetro Do not reload when para que la página de datos no se vuelva a cargar si no hay mensajes de error.
Nota: Cuando se requiera más de un sistema o paso de persistencia, planifique con cuidado el manejo de errores. El manejo de errores en esta situación debe tener en cuenta la posibilidad de un error en cualquiera de las transacciones individuales, la disponibilidad de acciones para compensar (como las API de reversión) cualquier transacción que ya se haya completado y si el caso puede continuar y cómo.
Manejo de respuestas a los errores devueltos
Si existe la necesidad inmediata de que el servicio invocado devuelva una respuesta, además de mostrar un mensaje de error al usuario, debería ingresar el error en el archivo del registro. Escribir un mensaje en el archivo del registro ayuda a solucionar los errores. Por ejemplo, usted analiza el archivo de registro para identificar patrones relacionados con un error específico. En el mensaje del registro, incluya detalles sobre la solicitud del conector para ayudar a identificar la causa del error.
Tip: Para obtener más información sobre los detalles que se brindan en el registro de errores, consulte Errores en los orígenes de datos. Además de escribir el error en un archivo de registro, considere generar un correo electrónico con detalles sobre el error para notificar al administrador de sistemas o a otra parte interesada.
Compruebe sus conocimientos con la siguiente actividad:
This Topic is available in the following Module:
If you are having problems with your training, please review the Pega Academy Support FAQs.
¿Quiere ayudarnos a mejorar este contenido?