Tarea Aprobación

La tarea Aprobación te permite configurar integraciones basadas en aprobaciones. También te permite controlar el flujo de una integración.

Puedes usar la tarea de aprobación para enviar correos electrónicos de solicitud de aprobación a uno o más usuarios de integración. El correo electrónico incluye un vínculo a la integración en el que los usuarios pueden aprobar o rechazar la solicitud de forma manual.

Durante una ejecución de integración, cuando el control alcanza la tarea de aprobación, se detiene la ejecución, y todas las tareas después de la tarea de aprobación se suspenden. La integración reanuda la ejecución solo cuando un usuario aprueba o rechaza de forma manual la solicitud de aprobación.

Una tarea de aprobación se puede usar para los siguientes fines:

  • Para suspender y ramificar una integración basada en la aprobación o el rechazo del usuario.
  • Suspender una integración hasta una duración específica.
  • Se usa como interrupción para depurar la integración.

Compara las tareas de aprobación, de suspensión y de temporizador

Las tres tareas (Aprobación, Suspender y Temporizador) realizan una función similar de pausar y reanudar una integración. Sin embargo, hay diferencias sutiles entre ellas. En la siguiente tabla, se describen las diferencias entre las tres tareas.

Tarea Aprobación Tarea Suspender Tarea Temporizador
No admite la reanudación automática de una integración y requiere intervención manual para reanudarla. Admite la reanudación manual y automática de una integración. Si no hay una intervención manual para revocar la suspensión, la integración reanudará de forma automática la ejecución después del vencimiento del límite de tiempo de suspensión. Solo admite la reanudación automática de una integración. La ejecución de la integración se reanuda automáticamente después de que se venza el límite de tiempo de suspensión.
No puede reanudar una integración a través de una llamada a la API. Debes resolver manualmente la suspensión mediante la IU de integraciones. Puede reanudar una integración mediante la API de Suspensions para las integraciones. Solo admite la reanudación automática de una integración.
Los usuarios reciben una notificación cuando se detiene una integración (suspendida). Los usuarios no reciben ninguna notificación cuando se detiene una integración (suspendida). Los usuarios no reciben ninguna notificación cuando se detiene una integración (suspendida).
Admite una variable de salida (booleana), que te permite realizar verificaciones condicionales antes de reanudar una integración. Sin embargo, la variable de salida solo puede tener el valor de true o false. Admite una variable de salida (string), que te permite realizar verificaciones condicionales antes de reanudar una integración. Puedes establecer cualquier valor en la variable de salida. No admite ninguna variable de salida.

Configura la tarea Aprobación

Para configurar la tarea Aprobación, sigue estos pasos:

  1. En la IU de Apigee, selecciona tu organización de Apigee.
  2. Haz clic en Desarrollar > Integraciones.
  3. Elige una integración existente o crea una nueva haciendo clic en Crear integración.

    Si creas una integración nueva, haz lo siguiente:

    1. Escribe un nombre y una descripción en el diálogo Crear integración.
    2. En la lista de regiones compatibles, elige Región para la integración.
    3. Haz clic en Crear.

    Esto abrirá la integración en la página del diseñador de integración.

  4. En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > Tareas para ver la lista de tareas disponibles.
  5. Haz clic y coloca el elemento de tarea Aprobación en el editor de integración.
  6. Haz clic en el elemento de tarea Approval en el diseñador para abrir el panel de configuración de la tarea Approval.
  7. Configura los campos que se muestran mediante las propiedades de configuración de la tarea, como se detalla en la siguiente tabla.

    Los cambios en las propiedades se guardan de forma automática.

Propiedades de configuración

En la siguiente tabla, se describen las propiedades de configuración de la tarea Aprobación.

Propiedad Tipo de datos Descripción
Recipients Arreglo de strings Direcciones de correo electrónico a las que se envía la notificación cuando la tarea está suspendida Ingresa varias direcciones de correo electrónico separadas por una coma.
Custom notification message String Mensaje personalizado para incluir en la notificación por correo electrónico cuando se suspende la tarea. El valor puede ser un literal o una variable. Si el mensaje personalizado está disponible en una variable, haz clic en VAR y selecciona la variable.
Reminder frequency (in hours) Entero Frecuencia de las notificaciones de recordatorios.

Si la suspensión está en estado no resuelto, puede enviar notificaciones por correo electrónico con recordatorios para solicitar que los usuarios autorizados resuelvan la suspensión.

Time until expiration (in hours) Entero Período de la suspensión.

Si la suspensión no se resuelve dentro del plazo establecido, se rechaza de forma predeterminada.

On expiration Booleano Acción que se debe realizar después del vencimiento de la suspensión.

Puedes rechazar la suspensión o anularla. De forma predeterminada, se rechaza la suspensión.

isApproved (Approval) Booleano Variable de salida que tiene el estado de la suspensión después de la resolución.

La variable isApproved se establece en True si se aprueba la suspensión y se establece en False si se rechaza.

Estrategia de manejo de errores

Una estrategia de manejo de errores de una tarea específica la acción que se debe realizar si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de manejo de errores y conocer los diferentes tipos de estrategias de manejo de errores, consulta Estrategias de manejo de errores.