Programaciones de operaciones en Jitterbit Integration Studio

Introducción

Cada operación se puede configurar para que se ejecute automáticamente mediante una programación. Las programaciones contienen información sobre cuándo se activará automáticamente una operación. Puede definir prácticamente cualquier tipo de programación que necesite, como todos los viernes a las 17:00, el último viernes de cada trimestre o cada hora de un mismo día.

Si una operación que se ejecuta según un cronograma tiene configuradas acciones de operaciones, cualquier operación abajo en la cadena también se ejecuta en consecuencia.

Los cronogramas se pueden crear y aplicar directamente en Integration Studio, como se explica en esta página, o se pueden crear y aplicar desde Proyectos página en la Management Console, donde también puede ver una lista de todos los programas asignados a operaciones dentro de un proyecto, o habilitar o deshabilitar programas.

Al desplegar una programación ya implementada en la nube de Harmony, se le presentan opciones para seleccionar las programaciones que desea usar. Esto se explica en Seleccionar programaciones y variables del proyecto en Despliegue del proyecto.

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

Crear un nuevo horario o abrir un horario existente

Se puede acceder a los cronogramas de operaciones desde el panel del proyecto, la configuración de operación o el tela de diseño, según se esté creando un cronograma nuevo o editando uno existente. Después de crear un cronograma o abrir uno existente para editarlo, consulte Configurar cronogramas de operación más adelante en esta página para la configuración.

Se puede crear un nuevo cronograma desde la pestaña Componentes del panel del proyecto usando la opción Crear nuevo en la categoría Cronogramas (consulte menú de acciones de la pestaña Componentes en la pestañaComponentes del panel Proyecto). Los nuevos horarios se crean con el nombre predeterminado Nuevo Horario. Los horarios posteriores con nombres predeterminados se complementan con un número incremental entre paréntesis.

Se puede editar un cronograma existente desde la pestaña Componentes del panel del proyecto usando la opción Ver/Editar en un componente del cronograma (consulte menú de acciones del componente en la pestañaComponentes del panel Proyecto).

Para editar un programa existente que ya está asignado a una operación, haga clic en el icono Icono de programación en la barra de acción de la operación para mostrar la pestaña Programaciones de la configuración de la operación.

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

• La pestaña Flujos de trabajo del panel del proyecto (vea menú de acciones de componentes en la pestaña Flujos de trabajo del panel Proyecto).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de la pestaña Componentes y menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño)

Nota

Las modificaciones de la programación se aplican a todas las operaciones a las que están asignadas.

Configurar horarios de operación

En la pestaña Programaciones de la configuración de operación, se pueden aplicar a las operaciones las programaciones existentes creadas en Integration Studio o en la Management Console. Desde aquí también puede crear nuevas programaciones, editar las existentes y desvincularlas de las operaciones. Cada opción se describe a continuación.

• Condición: El primer menú ya debería mostrar la selección En Programación, lo que indica que la condición bajo la cual se activará la operación es una programación. No se pueden configurar otras condiciones en este momento.

• Horario: Use este menú para seleccionar el horario existente que desea aplicar a la operación. Si el horario que desea usar aún no existe, haga clic en el enlace Crear nuevo horario para crear uno nuevo. Esta opción se describe a continuación.

• Asignar: Haga clic en Asignar para aplicar el programa seleccionado a la operación. Tenga en cuenta que solo se puede aplicar un programa a cada operación y que el programa asignado no se aplicará hasta que se haya implementado el proyecto.

  Cuando una operación tiene un programa asignado, los campos Programación, Asignar y Crear nuevo programa se reemplazan con opciones para establecer la política de programación y un resumen del programa asignado. Además, un El icono de programación aparece en la operación en el tela de diseño y, al hacer clic en él, vuelve a abrir la pantalla de programaciones de operación.

  Consejo

  Cuando se aplica un cronograma a una operación, se recomienda establecer una acción de operación en caso de error para activar una notificación correo sobre la operación programada.

  

• Política de programación: Establezca la política de programación, una de las siguientes: Ejecutar siempre o Omitir si ya se está ejecutando:

  • Ejecutar siempre: Seleccione esta opción para ejecutar la operación según lo programado en caso de que una operación anterior aún esté en curso. Esta opción debe seleccionarse solo si tiene un requisito especial. Al usar esta opción, asegúrese de que las operaciones simultáneas no sean perjudiciales al procesar los mismos registros de datos fuente varias veces.

  • Omitir si ya se está ejecutando: Seleccione esta opción 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 se esté ejecutando (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, haga clic en el Icono de edición para abrir la pantalla de configuración de la programación y realizar los cambios necesarios. También se puede acceder a las programaciones existentes desde el panel del proyecto. En la pestaña Componentes, para editar un programa, pase el cursor sobre el nombre del programa y luego haga clic en el icono Icono del menú de acciones y desde el menú seleccione Ver/Editar.

    Nota

    Si el mismo cronograma se asigna a otras operaciones, las ediciones afectarán el cronograma de todas las operaciones a las que está asignado.

  • Eliminar: Para disociar la programación de la operación, haga clic en el icono Icono de eliminación. Tenga en cuenta que la programación en sí no se elimina, sino que simplemente se desasigna de la operación.

• Crear nuevo horario: Para crear un nuevo horario, haga clic en el enlace Crear nuevo horario. Se abrirá la pantalla de configuración del horario.

  Nota

  El horario no se crea hasta que se haya configurado y guardado. Una vez creado, debe seleccionarlo en el menú Horario disponible y hacer clic en Asignar para aplicarlo a la operación.

  

  • Nombre de la programación: Ingrese un nombre para la programación. Puede asignarle un nombre que refleje su frecuencia o, si se usa para una operación específica, su propósito (por ejemplo, "Cada 5 minutos" o "Sincronización de contactos"). El nombre no debe empezar ni terminar con un espacio.

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

    • Diariamente: La programación activará la operación todos los días o cada pocos días. Al seleccionar esta opción, se pueden configurar los siguientes campos:

      • Cada [#] día(s): Ingrese una cantidad de días entre ejecuciones de operación.

    • Semanal: El horario activará la operación durante un conjunto específico de días de la semana. Al seleccionar esta opción, se pueden configurar los siguientes campos:

      • Cada [#] semana(s): Ingrese una cantidad de semanas entre ejecuciones de operación.
      • [Dom, Lun, Mar, Mié, Jue, Vie, Sáb]: Haga clic para seleccionar el/los día(s) de la semana en que desea que se ejecute la operación. Debe seleccionar al menos un día.

    • Mensual: La programación activará la operación mensualmente. Al seleccionar esta opción, elija una de las dos opciones disponibles para configurar:

      • Día [#] de cada [#] mes(es): Ingrese el día del mes y el número de meses entre ejecuciones de operación.
      • El [1.º, 2.º, 3.º, 4.º o último] [día de la semana] de cada [#] mes: Use los menús para seleccionar el día del mes e ingrese el número de meses entre ejecuciones de operación.

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

    • Ocurre una vez a las [hh:mm:ss] [AM/PM]: El programa activará la operación solo una vez a la hora especificada. Especifique la hora ingresando la hora y los minutos (en HH:MMformato) 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]: La programación reactivará repetidamente la operación durante el intervalo y período de tiempo especificados a lo largo del día. Especifique el intervalo y el período de tiempo dentro del cual desea limitar la ejecución de la operación. Ingrese la hora y los minutos (en HH:MMformato) y el período de tiempo (AM o PM).

      Nota

      Las zonas horarias se analizan a continuación en husos horarios de operación.

  • Duración: Configura las fechas de duración del programa.

    Nota

    Las fechas de inicio y finalización de un cronograma son inclusivas, lo que significa que el cronograma estará activo durante la parte restante del día tanto en la fecha de inicio como en la fecha de finalización.

    • Fecha de inicio: Por defecto, el programa estará activo a partir de la fecha actual. Si desea que el programa comience en otro día, utilice el selector de fecha/hora para seleccionar la fecha de inicio deseada.
    • Añadir fecha de finalización: De forma predeterminada, las operación asignadas a la programación se ejecutarán indefinidamente según la programación. Si desea especificar una fecha de finalización, primero haga clic en el enlace Añadir fecha de finalización para añadir el campo Fecha de finalización. A continuación, utilice el selector de fecha/hora para establecer la fecha de finalización de la programación. La programación estará activa hasta la fecha de finalización.
    • Eliminar fecha de finalización: Este enlace aparece al agregar el campo Fecha de finalización. Para eliminarlo, haga clic en el enlace Eliminar fecha de finalización.

  • Guardar: Haga clic para guardar y cerrar la configuración de programación.

Husos horarios de operación

Al configurar una programación, el campo Frecuencia no muestra la huso horario en la que se ejecutará la operación. Esta huso horario operación del agente que la operación, a menos que la opción Anular Huso horario del Agente de programación esté habilitada en las políticas de su organización:

• Huso horario del Agente

  • Agentes de la nube: Todos los agentes de la nube están en UTC.
  • Agentes privados: Las husos horarios de los agentes privados se determinan según la huso horario de su sistema operativo. Se recomienda encarecidamente que todos los agentes de un grupo de agentes privados se ejecuten en la misma huso horario; de lo contrario, las horas en que un programa configurado inicia la operación podrían ser impredecibles según el agente específico utilizado.

  Cuando se utiliza la versión 10.85/11.23 o posterior del agente, y el agente utiliza una huso horario que respeta el horario de verano, estas acciones ocurren durante un cambio de horario de verano:

  • Cuando se establece un horario de una vez al día entre las 2 y las 3 a. m., la operación programada se ejecutará a las 3 a. m. del segundo domingo de marzo.

  • Cuando se establece un cronograma de una vez al día entre la 1 y las 2 a. m., la operación programada se ejecutará en la segunda instancia a la 1 a. m. del primer domingo de noviembre.

  Un problema conocido existe para los escenarios mencionados al usar la versión 10.84/11.22 del agente y anteriores.

  Consejo

  Para mantener la coherencia de la programación, se recomienda usar una huso horario que no respete el horario de verano, como UTC (los agentes en la nube usan UTC por defecto). Si usa un agente privado, puede usar la opción Anular Huso horario del Agente de programación y seleccionar Etc/UTC.

• Anular la Huso horario del Agente de programación

  • Si la configuración Anular Huso horario del Agente de programación está habilitada en las políticas de su organización, la huso horario seleccionada determinará la huso horario en la que se ejecutarán todos los programas actuales y futuros de una organización.

Menú de acciones de programación

Después de crear un cronograma, se puede acceder a las acciones del menú para ese cronograma desde la pestaña Componentes del panel del proyecto (consulte menú de acciones de componentes en la pestañaComponentes del panel Proyecto).

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

Elemento del menú	Descripción
	Ver/Editar abre la pantalla de configuración de programación (vea Configurar programaciones de operación anteriormente en esta página). Nota Las modificaciones de la programación se aplican a todas las operaciones a las que están asignadas.
	Cortar coloca una copia del cronograma en su portapapeles y elimina el cronograma original del proyecto (vea Reutilización de componentes).
	Copiar coloca una copia del programa en su portapapeles (vea Reutilización de componentes).
	Duplicado crea un nuevo programa sin referencias que utiliza la misma configuración que el componente original (consulte Reutilización de componentes).
	Cambiar nombre posiciona el cursor en el nombre del programa para que usted pueda realizar las modificaciones necesarias.
	Ver dependencias cambia la vista en el panel del proyecto para mostrar cualquier otra parte del proyecto del que dependa el cronograma (consulte Dependencias de componentes, eliminación y remoción).
	Agregar al grupo abre un cuadro de diálogo para crear un nuevo grupo personalizado o para agregar la programación a un grupo existente (consulte Grupos de componentes).
	Eliminar elimina permanentemente la programación (consulte Dependencias de componentes, eliminación y remoción).
	Eliminar no está funcional actualmente.

Utilice secuencias de comandos para programar operaciones

Si las opciones disponibles en la interfaz de usuario se describen en Configurar programaciones de operación no satisfacen tus necesidades, puedes crear programaciones más complejas mediante scripts.

Nota

Si tiene habilitada la configuración Anular Huso horario del Agente de programación en las políticas de su organización, cualquier secuencias de comandos que utilice funciones de fecha y hora como se describe aquí no se anulará con la huso horario seleccionada.

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

1. Crear una operación que contiene un único secuencia de comandos como componente del proyecto.

2. Configure el secuencia de comandos como un Jitterbit Script que contiene la lógica del secuencia de comandos que verifica el último día del mes y ejecuta una operación si es verdadera. Asegúrese de reemplazar la referencia de la operación con la de la operación que desea ejecutar en la programación.

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

3. Cree un cronograma que se ejecute todos los días a la hora deseada y aplíquelo a la operación que contiene el secuencia de comandos que acaba de crear.

4. La cadena de operación debería verse similar a esto una vez completados estos pasos:

   

Habilitar o deshabilitar horarios

Al crear y aplicar una programación a una operación, esta se habilita de forma predeterminada. Mediante la Management Console, puede elegir deshabilitar o volver a habilitar un cronograma (si está deshabilitado) de forma remota desde Proyectos página.

En la sección Proyectos, esto se puede hacer desde la pestaña Operaciones o Programaciones, usando el interruptor en la columna Estado de la Operación para habilitar o deshabilitar una programación en una sola operación, o usando el interruptor en la columna Estado de la Programación para habilitar o deshabilitar una programación en todas las operaciones a las que se aplica. Tenga en cuenta que deshabilitar una programación a nivel de proyecto deshabilita el Estado Vigente incluso si la programación está habilitada para una operación individual. Para obtener instrucciones detalladas, consulte Proyectos (Management Console).

Nota

En la interfaz de Integration Studio, no se indica qué programaciones están habilitadas o deshabilitadas, y no es posible deshabilitar ni reactivar una programación desde Integration Studio. Por lo tanto, es importante recordar que, si se deshabilita una programación, la única forma de saber si está deshabilitada o reactivarla es a través de la Management Console.

Solucionar problemas de horarios

Si un cronograma no funciona como se espera, verifique estos elementos al solucionar el problema:

• ¿Has implementado la operación a la que está asignada la programación?
  En Integration Studio, las programaciones deben asignarse a una operación y luego desplegarse para que se activen. Una vez asignada una programación a una operación en Integration Studio, no surtirá efecto hasta que se haya implementado. (Por el contrario, las programaciones asignadas a una operación a través de la Management Console surten efecto inmediatamente sin necesidad de volver a desplegar el proyecto en Harmony).

• ¿Está habilitado el horario?
  Las programaciones solo se pueden deshabilitar y reactivar desde la Management Console. Consulta Proyectos dentro de las pestañas Operaciones y Horarios para asegurarse de que el horario esté habilitado.

• ¿Sabes en qué huso horario se encuentra tu agenda?
  Las zonas horarias se analizan en husos horarios de operación.

• Si está utilizando un agente privado, ¿está en ejecución el servicio de programación?
  En la máquina donde está instalado el agente privado, compruebe que Jitterbit Scheduler y su servicio se estén ejecutando. En Windows, esto se puede comprobar a través del Administrador de tareas, en Procesos. En Linux y Docker, utilice jitterbit status dominio.

• Si está utilizando un agente privado, ¿los horarios agresivos están sobrecargando al grupo de agentes?
  Si se utilizan agentes privados, se debe realizar una evaluación adicional para garantizar que demasiadas programaciones dentro de un período de tiempo corto no sobrecarguen al grupo de agentes, lo que provocaría un retraso en las operación.

  Los agentes privados pueden ejecutar hasta el doble de la cantidad de CPU por máquina. Por ejemplo, si la máquina tiene 4 núcleos de CPU, podrá procesar hasta 8 operaciones simultáneas.

Al evaluar los requisitos, algunas operaciones podrían depender más del tiempo que otras. Si varias operaciones no críticas acumularan trabajo en la cola de agentes, podrían verse afectadas más operaciones críticas. Para evitarlo, determine la cantidad de operaciones que el grupo de agentes puede procesar simultáneamente (utilizando los cálculos de CPU descritos anteriormente) y compárelas con la prioridad del negocio y la duración de tiempo de ejecución de las operaciones programadas.