Programaciones en Jitterbit Design Studio

En Jitterbit, las operaciones se pueden ejecutar de varias maneras, como de forma manual, automática a través de una llamada API o automática a través de una programación. Esta página explica cómo configurar una programación para ejecutar la operación automáticamente.

Los horarios contienen información sobre cuándo se activará automáticamente una operación. Jitterbit le permite definir prácticamente cualquier tipo de horario que necesite, como todos los viernes a las 5 p. m., el último viernes de cada trimestre o cada hora durante un día.

Crear un horario

Puede optar por crear un nuevo cronograma por sí solo o dentro de una operación existente. Los cronogramas deben asignarse a una operación para que sean aplicables a esa operación. Para obtener más información sobre la creación de operaciones, consulte Crear una operación.

Crear nuevo horario

Hay varias formas de crear un nuevo cronograma como un elemento de proyecto independiente dentro de Design Studio:

• Vaya a Archivo > Nuevo > Nuevo horario.
• En el árbol de la izquierda, haga clic derecho en Horarios y seleccione Nuevo horario.
• En la barra de herramientas superior, haga clic en el ícono de programación .

Crear un nuevo cronograma en una operación existente

También puede crear un nuevo cronograma como elemento de proyecto que ya esté asignado a una operación en Design Studio. Para ello:

• Dentro de una operación, haga clic en la flecha hacia abajo o haga clic derecho en el fondo de la operación, luego seleccione Programación > Seleccionar programación > Crear nueva programación.

Utilizar un cronograma existente en una operación existente

Si ya tiene una operación y un cronograma creado, hay varias formas de agregar un cronograma existente a una operación existente dentro de Design Studio:

• Dentro de una operación, haga clic en la flecha hacia abajo o haga clic derecho en el fondo de la operación, luego seleccione Programación > Seleccionar programación y elija la programación existente.
• Dentro de la operación, haga doble clic en el título de la operación para abrir la ventana Configurar operación. Expanda la sección Programación y utilice el menú desplegable Programación para seleccionar la programación existente.
• Arrastre el cronograma existente desde el árbol de la izquierda y suéltelo en el fondo de la operación.

Editar horario

Después de crear un nuevo cronograma, se abrirá la pantalla de configuración en la vista principal de Design Studio. Puede volver a la pantalla de configuración en cualquier momento de una de las siguientes maneras:

• Haga doble clic en el calendario en el árbol de la izquierda.
• Dentro de la operación, haga clic en el ícono de agenda y seleccione Editar programación.
• Dentro de la operación, haga clic en la flecha hacia abajo o haga clic derecho en el fondo de la operación y seleccione Programación > Editar programación.

Configuración básica

La pantalla de configuración debería ser similar al ejemplo que se muestra a continuación. A continuación se explica cada opción configurable.

• Nombre: Ingrese un nombre para su nueva programación. Es posible que desee darle a la programación un nombre que refleje la frecuencia de la programación o, si se utiliza para una operación específica, que refleje el propósito de la programación (por ejemplo, "Cada 5 minutos" o "Sincronización de contactos").

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

  • Diariamente: La programación activará la operación todos los días o cada pocos días. Cuando se selecciona esta opción, se pueden configurar las siguientes opciones:

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

  • Semanal: La programación activará la operación durante un conjunto específico de días de la semana. Cuando se selecciona esta opción, se pueden configurar las siguientes opciones:

    • Cada [#] semana(s): Ingrese una(s) semana(s) entre ejecuciones de operación.
    • [Dom, Lun, Mar, Mié, Jue, Vie, Sáb]: Marque las casillas junto al/los día(s) de la semana en que desea que se ejecute la operación.

  • Mensual: La programación activará la operación mensualmente. Cuando se selecciona esta opción, elija una de las dos opciones que se encuentran 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.er, 2.do, 3.er, 4.do o último] [día de la semana] de cada [#] mes: Use los menús desplegables para seleccionar qué día del mes e ingrese la cantidad de meses entre ejecuciones de operación.

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

  • Se produce una vez a las [hh:mm] [AM/PM]: El cronograma activará la operación solo una vez a la hora especificada. Use los menús desplegables para seleccionar la(s) hora(s), los minutos y la hora del día en que desea que se ejecute la operación.

  • Se produce cada [#] [Minuto(s)/Hora(s)] a partir de las [hh:mm] [AM/PM] y finalizando a las [hh:mm] [AM/PM]: El programa reactivará repetidamente la operación durante el período de tiempo especificado durante el día. Ingrese un número que corresponda con la selección desplegable de minutos u horas en los que desea que se ejecute la operación, junto con las selecciones desplegables de cualquier momento durante el día en el que desee limitar la ejecución de la operación.

    Nota

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

• Duración: Configura las fechas de duración de la programación.

  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.

  • A partir de: De manera predeterminada, el cronograma estará activo a partir de la fecha actual. Si desea especificar una fecha de inicio diferente, haga clic en el ícono de calendario para abrir un selector de fechas de calendario y seleccionar la fecha deseada.
  • Finalización: De manera predeterminada, las operación a las que se asigna el cronograma se ejecutarán indefinidamente según el cronograma. Si desea especificar una fecha de finalización, haga clic en el ícono del calendario para abrir un selector de fechas del calendario y seleccionar la fecha deseada. El calendario estará activo hasta el final de la fecha de finalización.

Husos horarios de operación

Al configurar un cronograma, el campo Frecuencia diaria no muestra la huso horario en la que se ejecutará la operación. La huso horario en la que se ejecutará la operación depende del agente que la ejecuta, a menos que la configuración Anular Huso horario del Agente del cronograma 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 están determinadas por la huso horario del sistema operativo del agente privado. Es muy recomendable que todos los agentes de un grupo de agentes privados se ejecuten en la misma huso horario, de lo contrario, los horarios en los que un programa configurado inicia la operación pueden ser impredecibles según el agente específico que se utilice.

  Cuando se utiliza la versión 10.85/11.23 o posterior del agente y el agente está usando 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 de la 1 a. m. del primer domingo de noviembre.

  Un problema conocido existe para los escenarios anteriores cuando se utiliza la versión del agente 10.84/11.22 y anteriores.

  Consejo

  Para mantener la coherencia en el cronograma, se recomienda utilizar una huso horario que no respete el horario de verano, como UTC (los agentes en la nube utilizan UTC de manera predeterminada). Si utiliza un agente privado, puede utilizar la configuració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.

Configuración avanzada con scripts

Si las opciones disponibles en la interfaz de usuario se describen arriba en Configuración básica no satisfacen sus necesidades comerciales, puede realizar una configuración adicional del cronograma mediante scripts.

Por ejemplo, un caso de uso común puede ser crear un cronograma para ejecutar la operación el último día del mes. Los siguientes pasos explican este caso de uso:

1. Cree un nuevo programa y configúrelo para que se ejecute todos los días a una hora adecuada como se describe anteriormente en esta página.

2. Cree una nueva operación con un elemento de proyecto de secuencia de comandos Jitterbit como se describe en Crear un secuencia de comandos.

3. Asigne la programación a la operación de secuencia de comandos que acaba de crear.

4. Abra el secuencia de comandos e ingrese lo siguiente para verificar el último día del mes y ejecutar una operación si es verdadero:

   <trans>
   if(DayOfMonth(LastDayOfMonth(Now()))==DayOfMonth(Now()),
   RunOperation("<TAG>Operations/Some Operation to Run</TAG>")
   );
   </trans>
   

5. Una vez completados estos pasos, las operaciones deberían ser similares a las siguientes:

   

Establecer política de programación

Cada vez que se crea una nueva programación, se configura de manera predeterminada que cualquier operación se omita en caso de que una instancia previamente programada de la misma operación aún se esté ejecutando. Esta es la práctica recomendada en la mayoría de las situaciones, pero se puede cambiar para permitir que una operación se inicie incluso si una instancia previamente programada aún se está ejecutando.

Esto solo debe hacerse si tiene un requisito especial para hacerlo. Si realiza este cambio, debe asegurarse de que tener operaciones simultáneas no sea perjudicial al procesar potencialmente los mismos registros de datos de origen varias veces.

Se puede acceder a esta configuración desde la operación de las siguientes maneras:

• Dentro de la operación, haga clic en el ícono de agenda y seleccione Política de programación > Omitir ejecución si la operación programada previamente aún se está ejecutando o Iniciar incluso si la operación programada previamente aún se está ejecutando.
• Dentro de la operación, haga clic en la flecha hacia abajo o haga clic derecho en el fondo de la operación y seleccione Programación > Política de programación > Omitir ejecución si la operación programada previamente aún se está ejecutando o Iniciar incluso si la operación programada previamente aún se está ejecutando.
• Dentro de la operación, haga doble clic en el título de la operación para abrir la ventana Configurar operación. Expanda la sección Programación, use el menú desplegable Programación para seleccionar la programación adecuada y seleccione Omitir ejecución si la operación programada anteriormente aún se está ejecutando o Iniciar incluso si la operación programada anteriormente aún se está ejecutando.

Si se utilizan agentes privados, se debe realizar una evaluación adicional para garantizar que los cronogramas agresivos no sobrecarguen a su grupo de agentes, lo que provocaría un retraso en las operación.

Los agentes privados pueden ejecutar hasta dos veces la cantidad de CPU por máquina agente de manera predeterminada. Por lo tanto, si su máquina agente privada tiene 4 núcleos de CPU, podrá procesar hasta 8 operaciones simultáneas.

Al evaluar los requisitos de su negocio, algunas de sus operaciones pueden depender más del tiempo que otras. Si varias operaciones no críticas acumularan trabajo en la cola de agentes, las operaciones más críticas podrían verse afectadas. Para evitarlo, simplemente determine la cantidad de operaciones que su grupo de agentes puede procesar simultáneamente y luego equilibre esa cantidad con la prioridad comercial y la duración de tiempo de ejecución de las operaciones programadas.

Habilitar o deshabilitar la programación

Una vez que haya asignado un cronograma a una operación, puede elegir deshabilitarlo o volver a habilitarlo (si está deshabilitado) de forma remota a través de la Management Console de los Proyectos página.

Tenga cuidado de recordar si deshabilita su programación, ya que esta funcionalidad solo está disponible dentro de la Management Console y puede que no sea obvio dentro de Design Studio que la programación se ha deshabilitado de forma remota.

En la página Proyectos, seleccione una fila dentro de la tabla Proyectos para mostrar pestañas adicionales en la parte inferior de la página. Puede habilitar o deshabilitar un cronograma para una sola operación o para todo el proyecto de la siguiente manera:

• Operaciones: Dentro de la pestaña Operaciones, la columna Estado muestra el estado de cualquier programación asignada a la operación. Haga clic en el botón de alternancia para activar o desactivar una programación existente, lo que habilita o deshabilita efectivamente la programación para esa operación.

• Programas: Dentro de la pestaña Programas, la columna Programado muestra el estado de los programas asignados a las operaciones dentro del proyecto. Haga clic en el botón de alternancia para activar o desactivar un programa existente, lo que habilita o deshabilita efectivamente el programa para todo el proyecto.

  Precaución

  Habilitar o deshabilitar una programación que se utiliza dentro de múltiples operaciones afectará a todas las operación que utilicen la programación.

Eliminar horario

Si tiene un cronograma asignado a una operación, puede eliminarlo de la operación de las siguientes maneras. Esto no eliminará el cronograma como elemento del proyecto, sino que simplemente lo anulará de la asignación de la operación.

• Dentro de la operación, haga clic en el ícono de agenda y seleccione Eliminar programación.
• Dentro de la operación, haga clic en la flecha hacia abajo o haga clic derecho en el fondo de la operación y seleccione Programación > Eliminar programación.
• Dentro de la operación, haga doble clic en el título de la operación para abrir la ventana Configurar operación. Expanda la sección Programación y utilice el menú desplegable Programación para seleccionar (ninguno).

Programación de resolución de problemas

Si su programación no funciona como se espera, verifique los siguientes elementos para ayudar a identificar y solucionar problemas el problema:

• ¿Ha implementado la operación a la que está asignada la programación?
  Para que se activen, las programaciones deben estar asignadas a una operación. Una vez que haya guardado una programación en una operación, no tendrá efecto hasta que se haya implementado.

• ¿Está habilitada tu agenda?
  Los cronogramas se pueden deshabilitar y volver a habilitar solo desde la Management Console web. Verifique la página Proyectos dentro de las pestañas Operaciones y Cronogramas para asegurarse de que su cronograma 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, verifique que Jitterbit Scheduler y Jitterbit Scheduler Service estén ejecutándose. En Windows, esto se puede verificar a través del Administrador de tareas en Procesos. En Linux y Docker, use el comando jitterbit status dominio.

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

  Los agentes privados pueden ejecutar hasta dos veces el recuento de CPI por máquina agente, por lo que si su máquina agente privada tiene 4 núcleos de CPU, podrá procesar hasta 8 operaciones simultáneas.

  Al evaluar los requisitos de su negocio, algunas de sus operaciones pueden depender más del tiempo que otras. Si varias operaciones no críticas acumularan trabajo en la cola de agentes, las operaciones más críticas podrían verse afectadas. Para evitarlo, simplemente determine la cantidad de operaciones que su grupo de agentes puede procesar simultáneamente y luego equilibre esa cantidad con la prioridad comercial y la duración de tiempo de ejecución de las operaciones programadas.