El activador de programación te permite ejecutar la integración de forma periódica en intervalos específicos. Este activador es útil cuando deseas ejecutar la integración de manera automática sin ninguna intervención manual. Por ejemplo, puedes considerar usar el activador de programación para el siguiente tipo de tareas:
- Subir archivos de un sistema a otro sistema a intervalos regulares
- Enviar recordatorios periódicos por correo electrónico
- Sincronizar la base de datos a intervalos regulares
Antes de comenzar
Asegúrate de asignar el rol de IAM Invocador de integración de Apigee al agente del servicio de Apigee (
service-PROJECT_ID
@gcp-sa-apigee.iam.gserviceaccount.com
) en tu proyecto de Google Cloud.
Para obtener más información sobre cómo asignar roles de IAM, consulta Administra el acceso en Google Cloud.
Agrega un activador de programación
Para agregar un Activador de programación a una integración nueva o existente, realiza los siguientes pasos:- En la IU de Apigee, selecciona tu organización de Apigee.
- Haz clic en Desarrollar > Integraciones.
- Selecciona una integración existente o crea una nueva haciendo clic en Crear integración.
Si creas una integración nueva, haz lo siguiente:
- Ingresa un nombre y una descripción en el diálogo Crear integración.
- En la lista de regiones compatibles, selecciona Región para la integración.
- Haz clic en Crear.
Esto abrirá la integración en la página del diseñador de integración.
- En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > Activadores para ver la lista de activadores disponibles.
- Haz clic en el elemento activador de Salesforce y arrástralo al diseñador.
Configura un activador de programación
Haz clic en el elemento activador de programación en el editor de integración para ver el panel de configuración del activador.
Puedes configurar el activador de programación mediante uno de los siguientes modos:
- Básico: Proporciona una interfaz de usuario para configurar la frecuencia de la ejecución.
- Avanzado: Usa una expresión de cron para configurar la frecuencia de la ejecución.
En el modo Básico, puedes optar por ejecutar la integración en un momento específico o a intervalos de hora. Si deseas ejecutar la integración en un momento específico, selecciona la opción Ejecutar en un momento específico del menú desplegable Horarios y configura las siguientes propiedades:
- Time: la hora (en formato de 24 horas) en la que se debe ejecutar la integración.
- Days: lo días en los que se debe ejecutar la integración. Puedes seleccionar ejecutar la integración todos los días, en días específicos de la semana, en un día específico del mes, etcétera.
- Months: los meses en los que se debe ejecutar la integración. Puedes ejecutar la integración todos los meses o elegir meses específicos.
En el modo Avanzado, puedes especificar la frecuencia de la ejecución mediante una expresión de cron. La expresión de cron tiene cinco valores que se deben especificar en el siguiente orden:
- Minuto (de 0 a 59)
- Hora (de 0 a 23)
- Día del mes (de 1 a 31)
- Mes, cualquiera de los siguientes valores:
- Un número de 1 al 12
- Una abreviatura del mes de tres letras (p. ej., ene., feb., mar., etcétera.)
- Día de la semana, cualquiera de los siguientes valores:
- Un número del 0 al 6 que comience con domingo como 0
- Abreviatura de tres letras (por ejemplo, lun, mar, mié, etcétera.)
Por ejemplo, para ejecutar la integración el primer día de cada mes, usa la expresión de cron * * 1 * *.
Prácticas recomendadas
Como práctica recomendada, desactiva los activadores de programación cuando ya no sean necesarios. Si dejas activo un activador de programación redundante, este seguirá activando la integración de forma automática.
Para desactivar un activador de programación, puedes realizar una de las siguientes acciones:
- Anula la publicación de la integración que contiene el activador de programación. Tu integración ya no estará activa y el activador no se ejecutará.
- Reemplaza el activador de programación por otro activador y vuelve a publicar la integración. La versión activa y que se volvió a publicar de la integración no usará el activador de programación.
- Borra la versión actual de la integración. Puedes encontrar la opción Delete en la lista de versiones junto al nombre de la integración.