Programas de operación en Jitterbit Integration Studio

Introducción

Configura operaciones para que se ejecuten automáticamente utilizando programas que definen cuándo se ejecutan. Puedes crear programas flexibles como cada viernes a las 5 p.m., el último viernes de cada trimestre, o cada hora en días específicos.

Cuando una operación programada incluye acciones de operación, cualquier operación posterior se ejecuta automáticamente también.

Crea y gestiona programas directamente en Integration Studio o a través de la página de Proyectos en la Consola de Administración, donde puedes ver todos los programas de proyectos y habilitarlos o deshabilitarlos según sea necesario.

Al desplegar un programa que ya ha sido desplegado en la nube de Harmony, se te presentan opciones para seleccionar qué programas utilizar. Esto se cubre en Seleccionar programas y variables de proyecto en Despliegue de proyectos.

Otras formas de ejecutar operaciones incluyen ejecutar operaciones manualmente o usar un desencadenador de API, como se cubre en Despliegue y ejecución de operaciones.

Crear un nuevo programa o abrir un programa existente

Los programas de operación se pueden acceder desde el panel del proyecto, la configuración de la operación o el lienzo de diseño, dependiendo de si estás creando un nuevo programa o editando un programa existente. Después de crear un programa o abrir un programa existente para editar, consulta Configurar programas de operación más adelante en esta página para la configuración.

Se puede crear un nuevo programa desde la pestaña Componentes del panel del proyecto utilizando la opción Crear Nuevo en la categoría Programas (consulta Menú de acciones de la pestaña Componentes en Pestaña Componentes del panel del proyecto). Los nuevos programas se crean con el nombre predeterminado Nuevo Programa. Los programas nuevos subsiguientes con nombres predeterminados se les añade un número incrementado entre paréntesis.

Un horario existente se puede editar desde la pestaña Componentes del panel del proyecto utilizando la opción Ver/Editar en un componente de horario (ver Menú de acciones del componente en Pestaña Componentes del panel del proyecto).

Para editar un horario existente que ya está asignado a una operación, haga clic en el ícono de horario en la barra de acciones de la operación para mostrar la pestaña Horarios de la configuración de la operación.

La pestaña Horarios de la Configuración de la operación también se puede acceder desde estas ubicaciones:

• La pestaña Flujos de trabajo del panel del proyecto (ver Menú de acciones del componente en Pestaña Flujos de trabajo del panel del proyecto).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones de la pestaña de componentes y Menú de acciones del componente en Pestaña Componentes del panel del proyecto).
• El lienzo de diseño (ver Menú de acciones del componente en Lienzo de diseño).
• El lienzo de diseño haciendo doble clic en la operación (abre Configuración directamente).

Configurar horarios de operación

En la pestaña Horarios de la configuración de la operación, se pueden aplicar horarios existentes que han sido creados ya sea en Integration Studio o en la Consola de Administración a las operaciones. Desde aquí también se pueden crear nuevos horarios, editar horarios existentes y disociar horarios de las operaciones. Cada opción se describe a continuación.

• Condición: El primer menú debería mostrar ya la selección como En Programa, indicando que la condición bajo la cual se activará la operación es un horario. No hay otras condiciones que se puedan establecer en este momento.

• Horario: Utiliza este menú para seleccionar el horario existente que deseas aplicar a la operación. Si el horario que deseas usar aún no existe, haz clic en el enlace Crear Nuevo Horario para crear un nuevo horario. Esta opción se cubre a continuación.

• Asignar: Haz clic en Asignar para aplicar el horario seleccionado a la operación. Ten en cuenta que solo se puede aplicar un horario a cada operación, y que el horario asignado no tendrá efecto hasta que el proyecto haya sido desplegado.

  Cuando una operación tiene un horario asignado, los campos Horario, Asignar y Crear Nuevo Horario se reemplazan con opciones para establecer la política de horario y un resumen del horario asignado. Además, aparece un ícono de en la operación en el lienzo de diseño, que al hacer clic vuelve a abrir la pantalla de horarios de la operación.

  Consejo

  Cuando aplicas un horario a una operación, se recomienda establecer una acción de operación en caso de fallo para activar una notificación por correo electrónico en la operación programada.

  

• Política de horario: Establece la política de horario, una de Siempre ejecutar o Saltar si ya se está ejecutando:

  • Siempre ejecutar: Selecciona para ejecutar la operación según lo programado en caso de que una ejecución anterior de la operación aún esté en curso. Esta opción debe seleccionarse solo si tienes un requisito especial para hacerlo. Al usar esta opción, asegúrate de que tener operaciones concurrentes no sea perjudicial al procesar potencialmente los mismos registros de datos de origen múltiples veces.

  • Saltar si ya se está ejecutando: Selecciona para omitir una ejecución programada de la operación en caso de que una ejecución anterior de la misma operación aún esté en curso (predeterminado).

• Horario asignado: Cuando una operación tiene un horario asignado, se muestra un resumen del horario asignado con estas opciones:

  • Editar: Para editar el horario asignado, haz clic en el ícono de editar para abrir la pantalla de configuración del horario y realizar los cambios necesarios. Los horarios existentes también se pueden acceder desde el panel del proyecto. En la pestaña Componentes, para editar un horario, pasa el cursor sobre el nombre del horario, luego haz clic en el ícono del menú de acciones y selecciona Ver/Editar en el menú.

    Nota

    Si el mismo horario está asignado a otras operaciones, las ediciones afectan el horario para todas las operaciones a las que está asignado.

  • Eliminar: Para disociar el horario de la operación, haz clic en el ícono de eliminar . Ten en cuenta que el horario en sí no se elimina, sino que simplemente se desasigna de la operación.

• Crear nuevo horario: Para crear un nuevo horario, haz clic en el enlace para Crear nuevo horario. Esto abre la pantalla de configuración del horario.

  Nota

  El horario no se crea hasta que hayas configurado y guardado el nuevo horario. Después de que se crea el horario, debes seleccionarlo del menú Horario disponible y hacer clic en Asignar para aplicarlo a la operación.

  

  • Nombre del horario: Ingresa un nombre para el horario. Puede que desees darle al horario un nombre que refleje la frecuencia del horario o, si se utiliza para una operación específica, que refleje el propósito del horario (por ejemplo, "Cada 5 minutos" o "Sincronización de contactos"). El nombre no debe comenzar ni terminar con un espacio.

  • Ocurrencia: Usa el menú para seleccionar una de tres opciones para los días en los que el horario debe iniciar la(s) operación(es) a las que está asignado:

    • Diario: El horario activará la operación todos los días, o cada pocos días. Cuando se selecciona esta opción, estos campos se vuelven disponibles para configurar:

      • Cada [#] Día(s): Ingresa un número de día(s) entre las ejecuciones de la operación.

    • Semanal: El horario activará la operación durante un conjunto específico de días de la semana. Cuando se selecciona esta opción, estos campos se vuelven disponibles para configurar:

      • Cada [#] Semana(s): Ingresa un número de semana(s) entre las ejecuciones de la operación.
      • [Dom, Lun, Mar, Mié, Jue, Vie, Sáb]: Haz clic para seleccionar el(los) día(s) de la semana en el que deseas que se ejecute la operación. Debe seleccionarse al menos un día.

    • Mensual: El horario activará la operación de forma mensual. Cuando se selecciona esta opción, elige una de las dos opciones que se vuelven disponibles para configurar:

      • Día [#] de Cada [#] Mes(es): Ingresa el día del mes y el número de mes(es) entre las ejecuciones de la operación.
      • El [1ro, 2do, 3ro, 4to, o Último] [Día de la Semana] de Cada [#] Mes: Usa los menús para seleccionar qué día del mes y ingresa el número de mes(es) entre las ejecuciones de la operación.

  • Frecuencia: Selecciona una de las dos opciones para los momentos en los que el horario debe iniciar la operación en los días que se ejecuta:

    • Ocurre Una Vez a las [hh:mm:ss] [AM/PM]: El horario activará la operación solo una vez a la hora especificada. Especifica la hora ingresando la hora y el minuto (en formato HH:MM) y el período de tiempo (AM o PM).

    • Ocurre Cada [#] [Minuto(s)/Hora(s)] Comenzando a las [hh:mm:ss] [AM/PM] y Terminando a las [hh:mm:ss] [AM/PM]: El horario reactivará repetidamente la operación durante el intervalo y período de tiempo especificados a lo largo del día. Especifica el intervalo y el período de tiempo en el que deseas limitar la ejecución de la operación. Ingresa la hora y el minuto (en formato HH:MM) y el período de tiempo (AM o PM).

      Nota

      Las zonas horarias se discuten a continuación en Zonas horarias de operación.

  • Duración: Configura las fechas de duración para el horario.

    Nota

    Las fechas de inicio y fin en un horario son inclusivas, lo que significa que el horario estará activo durante el resto del día tanto en la fecha de inicio como en la fecha de fin.

    • Fecha de inicio: Por defecto, el horario estará activo a partir de la fecha actual. Si deseas que el horario comience en otro día, utiliza el selector de fecha/hora para seleccionar la fecha de inicio deseada.
    • Agregar fecha de fin: Por defecto, la(s) operación(es) a las que se asigna el horario se ejecutarán indefinidamente según el horario. Si deseas especificar una fecha de fin, primero haz clic en el enlace para Agregar fecha de fin para añadir el campo de Fecha de fin. Luego utiliza el selector de fecha/hora para establecer una fecha en la que deseas que termine el horario. El horario estará activo hasta el final de la fecha de fin.
    • Eliminar fecha de fin: Este enlace aparece una vez que se añade el campo de Fecha de fin. Para eliminar el campo de Fecha de fin, haz clic en el enlace para Eliminar fecha de fin.

  • Guardar: Haz clic para guardar y cerrar la configuración del horario.

Zonas horarias de operación

Al configurar un horario, el campo Frecuencia no muestra la zona horaria en la que se ejecutará la operación. La zona horaria en la que se ejecutará la operación depende del agente que esté ejecutando la operación, a menos que la configuración Anular la zona horaria del agente del horario esté habilitada en las políticas de tu organización:

• Zona horaria del agente

  • Agentes en la nube: Todos los agentes en la nube están en UTC.
  • Agentes privados: Las zonas horarias de los agentes privados se determinan por la zona horaria del sistema operativo del agente privado. Se recomienda encarecidamente que todos los agentes en un grupo de agentes privados estén funcionando en la misma zona horaria, o los momentos en que un horario configurado inicia la operación pueden ser impredecibles dependiendo del agente específico que se esté utilizando.

  Al usar la versión del agente 10.85 / 11.23 o posterior, y el agente está utilizando una zona horaria que observa el horario de verano, estas acciones ocurren durante un cambio de horario de verano:

  • Cuando se establece un horario diario entre las 2 y 3 AM, la operación programada se ejecutará a las 3 AM el segundo domingo de marzo.

  • Cuando se establece un horario diario entre la 1 y 2 AM, la operación programada se ejecutará en la segunda instancia de la 1 AM el primer domingo de noviembre.

  Existe un problema conocido para los escenarios anteriores al usar la versión 10.84 / 11.22 del agente y versiones anteriores.

  Consejo

  Para la consistencia del horario, se recomienda usar una zona horaria que no observe el horario de verano, como UTC (los agentes en la nube usan UTC por defecto). Si se utiliza un agente privado, se puede usar la configuración de Sobrescribir la zona horaria del agente de programación y seleccionar Etc/UTC.

• Sobrescribir la zona horaria del agente de programación

  • Si la configuración de Sobrescribir la zona horaria del agente de programación está habilitada en las políticas de su organización, la zona horaria seleccionada determinará la zona horaria en la que se ejecutarán todos los horarios actuales y futuros en toda la organización.

Menú de acciones de programación

Después de crear un horario, las acciones del menú para ese horario son accesibles desde la pestaña Componentes del panel del proyecto (ver Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).

Cada una de estas acciones del menú está disponible:

Elemento del menú	Descripción
	Ver/Editar abre la pantalla de configuración del horario (ver Configurar horarios de operación más arriba en esta página). Nota Las ediciones del horario entran en efecto en todas las operaciones a las que están asignadas.
	Cortar coloca una copia del horario en su portapapeles y elimina el horario original del proyecto (ver Reutilización de componentes).
	Copiar coloca una copia del horario en su portapapeles (ver Reutilización de componentes).
	Duplicar crea un nuevo horario no referenciado utilizando la misma configuración que el componente original (ver Reutilización de componentes).
	Renombrar posiciona el cursor en el nombre del horario para que pueda hacer las ediciones necesarias.
	Ver Dependencias cambia la vista en el panel del proyecto para mostrar cualquier otra parte del proyecto de la que dependa el horario (ver Dependencias de componentes, eliminación y remoción).
	Agregar a Grupo abre un diálogo para crear un nuevo grupo personalizado o para agregar el horario a un grupo existente (ver Grupos de componentes).
	Eliminar elimina permanentemente el horario (ver Dependencias de componentes, eliminación y remoción).
	Remover no está actualmente funcional.

Usar scripts para programar operaciones

Si las opciones disponibles en la interfaz de usuario, como se describe en Configurar horarios de operación, no satisfacen tus necesidades, puedes crear horarios más complejos utilizando scripts.

Como ejemplo, un caso de uso común podría ser crear un horario para ejecutar la operación el último día del mes. Estos pasos describen este caso de uso:

1. Crear una operación que contenga un único script como componente del proyecto.

2. Configurar el script como un Script de Jitterbit que contenga la lógica del script que verifica si es el último día del mes y ejecuta una operación si es verdadero. Asegúrate de reemplazar la referencia de la operación con la de la operación que deseas ejecutar en el horario.

   <trans>
   if(DayOfMonth(LastDayOfMonth(Now()))==DayOfMonth(Now()),
   RunOperation("<TAG>operation:Scheduled Operation</TAG>");
   );
   </trans>
   

3. Crear un horario que se ejecute todos los días a la hora deseada y aplicarlo a la operación que contiene el script que acabas de crear.

4. La cadena de operaciones debería verse similar a esto una vez que se completen estos pasos:

   

Administrar horarios de operación

Cuando aplicas un horario a una operación, el horario se habilita por defecto. Puedes deshabilitar o volver a habilitar horarios de forma remota a través de la Consola de Administración en la página de Proyectos.

Habilitar y deshabilitar horarios

La página de Proyectos proporciona dos formas de controlar el estado de los horarios. Puedes usar la pestaña Operaciones o la pestaña Horarios:

• Operaciones individuales: En la pestaña de Operaciones, utiliza el interruptor en la columna Estado de la operación para habilitar o deshabilitar un horario para una sola operación.

• Todas las operaciones: En la pestaña de Horarios, utiliza el interruptor en la columna Estado del horario para habilitar o deshabilitar un horario en todas las operaciones que utilizan ese horario.

Cuando deshabilitas un horario a nivel de proyecto, esto anula la configuración de operaciones individuales. El Estado efectivo se muestra como deshabilitado incluso cuando has habilitado el horario para operaciones específicas. Para instrucciones detalladas, consulta los Proyectos de la Consola de Administración.

Indicadores visuales

Las operaciones con horarios habilitados muestran un ícono de Configuraciones de operación de horario:

Cuando pasas el cursor sobre este ícono, aparece un resumen del horario:

Desde este resumen, puedes hacer clic en Editar horario para modificar configuraciones o en Eliminar horario para quitar el horario de la operación.

Solucionar problemas de horarios

Si un horario no está funcionando como se esperaba, verifica estos elementos al solucionar el problema:

• ¿Has desplegado la operación a la que se asignó el horario?
  En Integration Studio, los horarios deben estar asignados a una operación y luego desplegados para que se activen. Una vez que hayas asignado un horario a una operación en Integration Studio, no tendrá efecto hasta que se haya desplegado. (En contraste, los horarios asignados a una operación a través de la Consola de Administración tienen efecto inmediato sin necesidad de redeplegar el proyecto en Harmony.)

• ¿Está habilitado el horario?
  Los horarios pueden ser deshabilitados y habilitados nuevamente solo desde la Consola de Administración. Verifique la página de Proyectos dentro de las pestañas Operaciones y Horarios para asegurarse de que el horario esté habilitado.

• ¿Sabe en qué zona horaria está su horario?
  Las zonas horarias se discuten en Zonas horarias de operación.

• Si está utilizando un agente privado, ¿está en funcionamiento el servicio de programación?
  En la máquina donde está instalado el agente privado, verifique que Jitterbit Scheduler y Jitterbit Scheduler Service estén en funcionamiento. En Windows, esto se puede verificar a través del Administrador de tareas en Procesos. En Linux y Docker, use el comando jitterbit status.

• Si está utilizando un agente privado, ¿los horarios agresivos están sobrecargando el grupo de agentes?
  Si se utilizan agentes privados, se debe realizar una evaluación adicional para asegurarse de que demasiados horarios en un corto período de tiempo no sobrecarguen el grupo de agentes, causando un retraso en las operaciones.

  Los agentes privados tienen como predeterminado la capacidad de ejecutar hasta dos veces la cantidad de CPU para cada máquina de agente. Por ejemplo, si la máquina del agente privado tiene 4 núcleos de CPU, podrá procesar hasta 8 operaciones concurrentes.

  Al evaluar los requisitos, algunas de las operaciones pueden ser más dependientes del tiempo que otras. Si varias operaciones no críticas acumulan la cola del agente, entonces las operaciones más críticas podrían verse afectadas. Para evitar esto, determine el número de operaciones que el grupo de agentes puede procesar concurrentemente (utilizando los cálculos de cantidad de CPU descritos anteriormente) y luego equilibre eso con la prioridad comercial y la duración de ejecución de las operaciones programadas.