Compartir a través de


Uso de la actividad Error para hacer que la ejecución de la canalización falle con un mensaje de error personalizado y un código de error

En ocasiones, es posible que quiera producir un error en una canalización intencionadamente. Una actividad de búsqueda podría no devolver datos coincidentes o una actividad de script de podría terminar con un error interno. Sea cual sea el motivo, ahora puede usar una actividad Error en una canalización y personalizar su código y su mensaje de error.

Cuándo usar la actividad Fail

La actividad Fail se usa normalmente en escenarios condicionales en los que desea que se produzca un error en la canalización en función de condiciones específicas:

  • Errores de validación de datos: cuando los datos no cumplen los estándares de calidad
  • Infracciones de lógica de negocios: cuando no se cumplen las reglas de negocios
  • Comprobaciones de dependencias: cuando los recursos o orígenes de datos necesarios no están disponibles
  • Control de errores personalizado: si desea proporcionar información de error específica en lugar de errores genéricos del sistema

Normalmente, la actividad Fail está conectada a otras actividades mediante lógica condicional (actividad If Condition) o se coloca después de las actividades que podrían producir condiciones de error.

Prerrequisitos

Para empezar, debe completar los siguientes requisitos previos:

Adición de una actividad Error a una canalización mediante la interfaz de usuario

Para usar una actividad Error en una canalización, complete los pasos siguientes:

  1. Cree una canalización en el área de trabajo.

  2. Busque la actividad Error en el panel Actividades de la canalización y selecciónela para agregarla al lienzo de la canalización. Es posible que sea necesario expandir la lista de actividades en el lado derecho del panel o el icono de Outlook se puede comprimir sin etiquetarlo debajo, como se muestra en esta imagen, en función del ancho de la ventana del explorador.

    Captura de pantalla de la interfaz de usuario de Fabric con el panel Actividades y la actividad Error resaltada.

  3. Seleccione la nueva actividad Error en el lienzo si aún no está seleccionada.

    Captura de pantalla que muestra la pestaña Configuración general de la actividad Error.

    Consulte la guía de Configuración general para configurar la pantalla de configuración General.

  4. Seleccione la pestaña Configuración y proporcione el mensaje de error personalizado y el código de error que desea que la canalización indique cuando se invoque la actividad. Estos valores se mostrarán en el historial de ejecución de la canalización y los registros cuando se ejecute la actividad Fail, lo que le ayudará a identificar la condición de error específica que provocó un error en la canalización.

    Captura de pantalla que muestra la pestaña Configuración de la actividad Error con la pestaña resaltada.

Guardado y ejecución o programación de la canalización

La actividad Error se usa normalmente con otras actividades. Después de configurar las demás actividades necesarias para la canalización, cambie a la pestaña Inicio en la parte superior del editor de canalizaciones y seleccione el botón Guardar para guardar la canalización. Seleccione Ejecutar para ejecutarla directamente o Programar para programarla. También puede ver el historial de ejecución aquí o configurar otras opciones.

Captura de pantalla que muestra la pestaña Inicio en el editor de canalizaciones con los botones Guardar, Ejecutar y Programación resaltados.

Ejemplo: Error de canalización condicional

Este es un patrón común para generar errores en una canalización en función de las condiciones personalizadas:

  1. Utilice una actividad If Condition para evaluar su condición de error personalizada
  2. En la rama True de la condición If, agregue la actividad Fail.
  3. Configure la actividad Fail con el mensaje de error personalizado que describe la condición específica que se ha cumplido.
  4. En la rama False, continuar con la ejecución normal de la canalización.

Este patrón permite que la canalización falle de manera controlada con mensajes de error significativos cuando se encuentren condiciones específicas del negocio o de los datos.

Cómo supervisar las ejecuciones de canalizaciones