Intentar capturar

La actividad Intentar capturar proporciona un manejo estructurado de excepciones dentro de los flujos de trabajo. Úsalo para definir acciones alternativas para fallos de API, datos no válidos o errores inesperados.

Utilizar la actividad Intentar capturar

Para añadir una actividad Intentar capturar a tu flujo de trabajo:

1. En el lienzo del diseñador de flujo de trabajo de la API, selecciona el icono más (+). Aparecerá el menú Añadir actividad .
2. Selecciona Más... y luego Intentar capturar.
3. En el panel Propiedades , proporciona un nombre para tu error.
4. Añade actividades al bloque Intentar . Estas son las actividades supervisadas en busca de errores.
5. Define la lógica de gestión de errores en el bloque Capturar . Si falla algún paso del bloque Intentar , la ejecución pasa al flujo Capturar .
6. Depura el flujo de trabajo para ejecutar la actividad y generar campos de salida para su uso posterior.

Acceder a los detalles del error

Cuando se produce un error en el bloque Intentar , la actividad Intentar capturar expone los detalles estructurados del error. Para acceder a los detalles del error, utiliza $context.outputs.Try_Catch_X.error o $error.

El objeto de error mantiene una estructura coherente, de la siguiente manera:

"Try_Catch_1": {
        "error": {
          "type": "<runtime error source>",
          "title": "<summary error message>",
          "status": <response status code>,
          "detail": "<detailed error message",
          "data": {},
        }
      }

Los detalles del error son:

• tipo : indica el origen del error en tiempo de ejecución.
• title : proporciona un resumen de error conciso.
• status—El código de estado HTTP (si corresponde).
• detalle : ofrece una explicación detallada del error.
• datos : incluye metadatos adicionales sobre la tarea fallida. Es posible que este campo no siempre se complete.

Puedes hacer referencia a estas propiedades para crear respuestas de error estructuradas o desencadenar alertas.