Saltar al contenido

Horarios

Dentro de Jitterbit, las operaciones se pueden ejecutar de varias maneras, como manualmente, automáticamente a través de una llamada API o automáticamente a través de un cronograma. Esta página cubre la configuración de un programa para ejecutar su operación automáticamente.

Los horarios contienen información sobre cuándo se activará automáticamente una operación. Jitterbit te permite definir prácticamente cualquier tipo de horario que necesites, 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 horarios 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.

Consejo

A partir de versión 9.0, otro lugar donde puede crear y aplicar programaciones es desde la Management Console. Los cambios de programación realizados a través de Management Console surten efecto inmediatamente sin necesidad de volver a implementar el proyecto en Harmony. Para obtener más información, consulte Proyectos.

Crear Nuevo Horario

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

  • Ir a Archivo > Nuevo > Nuevo horario.
  • En el árbol de la izquierda, haz clic derecho en Horarios y selecciona Nuevo horario.
  • En la barra de herramientas superior, haga clic en el icono de programación archivo adjunto.

Nota

Si crea un cronograma a través de uno de los métodos anteriores, tenga en cuenta que no está asociado con ninguna operación. Para usar el cronograma en una operación, siga Usar el cronograma existente en una operación existente abajo.

Crear un Nuevo Horario en una Operación Existente

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

  • Dentro de una operación, haga clic en la flecha hacia abajo archivo adjunto o haga clic con el botón derecho en el fondo de la operación, luego seleccione Programa > Seleccionar programa > Crear nuevo programa.

Usar Programa Existente en una Operación Existente

Si ya tiene una operación y un cronograma creados, 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 archivo adjunto o haga clic derecho en el fondo de la operación, luego seleccione Programa > Seleccione Programación y elija el programa 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 Horario, use el menú desplegable Horario para seleccionar el horario existente.
  • Arrastre el cronograma existente desde el árbol de la izquierda y suéltelo en el fondo de la operación.

Precaución

Si está utilizando un programa existente en varias operaciones, tenga cuidado al editar el programa, ya que los cambios en el programa afectarán a todas las operaciones que usan ese programa.

Editar Horario

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

  • Haz doble clic en el horario en el árbol de la izquierda.
  • Dentro de la operación, haga clic en el icono de programación archivo adjunto y seleccione Editar horario.
  • Dentro de la operación, haga clic en la flecha hacia abajo adjunto o haga clic con el botón derecho en el fondo de la operación y seleccione Programa > Editar programa.

Configuracion Basica

La pantalla de configuración debe ser similar al ejemplo a continuación. Cada opción configurable se explica a continuación.

adjunto

  • Nombre: Ingresa un nombre para tu nuevo horario. Es posible que desee dar al programa un nombre que refleje la frecuencia del programa o, si se usa para una operación específica, que refleje el propósito del programa (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 dar inicio a la(s) operación(es) en 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, lo siguiente está disponible para configurar:

      • Cada [#] Día(s): Ingrese una cantidad de días entre ejecuciones de operación.
    • Semanalmente: El horario activará la operación durante un conjunto específico de días de la semana. Cuando se selecciona esta opción, lo siguiente está disponible para configurar:

      • Cada [#] Semana(s): Ingrese un número de semana(s) entre ejecuciones de operación.
      • [Dom, Lun, Tue, Wed, Thu, Vie, Sat]: Marque las casillas al lado del día(s) de la semana en que desea la operación correr.
    • Mensual: El horario activará la operación mensualmente. Cuando se selecciona esta opción, elija una de las dos opciones que están disponibles para configurar:

      • Día [#] de cada [#] mes(es): Ingrese el día del mes y la cantidad 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 desplegables para seleccionar qué día del mes e ingrese el número de meses entre ejecuciones de operación.
  • Frecuencia diaria: Seleccione una de las dos opciones para las horas en las que el horario debe iniciar la operación en los días en que se ejecuta:

    • Ocurre una vez a las [hh:mm] [AM/PM]: La programación activará la operación solo una vez a la hora especificada. Utilice los menús desplegables para seleccionar las horas, los minutos y la hora del día en que desea que se ejecute la operación.

    • Ocurre cada [#] [Minuto(s)/Hora(s)] Comenzando a las [hh:mm] [AM/PM] y terminando a las [hh: mm] [AM/PM]: El programa reactivará repetidamente la operación durante el período de tiempo especificado a lo largo del día. Ingrese un número que se 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 del 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: Configure las fechas de duración de la programación.

    Nota

    Las fechas de inicio y finalización de un cronograma son inclusivas.

    • A partir de: De forma predeterminada, se seleccionará la fecha actual. Si desea especificar una fecha de inicio diferente, haga clic en el icono de calendario archivo adjunto para abrir un selector de fecha del calendario y seleccionar la fecha deseada.
    • Termina en: De forma predeterminada, la(s) operación(es) en 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 icono de calendario archivo adjunto para abrir un selector de fecha del calendario para seleccionar la fecha deseada.

Consejo

Después de configurar una programación y asignarla a una operación, se recomienda colocar un mensaje de correo de falla en la operación programada. Consulte Crear un mensaje de Correo para más información.

Husos Horarios de Funcionamiento

Al configurar una programación, 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 ejecute la operación, a menos que la opción Anular Huso Horario del Agente esté habilitada en sus políticas de la organización:

  • Huso Horario del Agente

    • Agentes en Nube: Todos los Agentes en Nube están en UTC.
    • Agentes Privados: Las husos horarios de los Agente Privado están determinadas por la huso horario del sistema operativo del Agente Privado. Se recomienda encarecidamente que todos los agentes de un Grupo de Agentes Privados se ejecuten en la misma huso horario, o las horas en las que un programa configurado inicia la operación pueden ser impredecibles según el agente específico que se utilice.
  • Anular la Huso Horario del Agente de programación

    • Si la opción Anular programación de la Huso Horario del Agente está habilitada en las políticas de su organización, la huso horario seleccionada determinará la huso horario en la que se ejecutarán todas las programaciones actuales y futuras de una organización.

Configuración Avanzada con Secuencias de Comandos

Si las opciones disponibles en la interfaz de usuario como se describe anteriormente en Configuración básica no satisfacen sus necesidades comerciales, puede realizar una configuración adicional de la programación mediante secuencias de comandos.

Nota

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

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

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

  2. Cree una nueva operación con un elemento de proyecto de Jitterbit Script como se describe en Crear una 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. Las operaciones deberían ser similares a las siguientes una vez que se completen estos pasos:

    archivo adjunto

Establecer Política de Programación

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

Esto debe hacerse solo 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 icono de programación archivo adjunto y seleccione Política de programación > Omitir la 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.
  • Dentro de la operación, haga clic en la flecha hacia abajo adjunto o haga clic con el botón derecho en el fondo de la operación y seleccione Programar > Política de programación > Omitir ejecución si la operación programada anteriormente todavía está en ejecución o Iniciar incluso si la operación programada anteriormente 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 todavía se está ejecutando o Iniciar incluso si la operación programada anteriormente aún está activa correr.

Si usa Agentes Privados, se debe realizar una evaluación adicional para garantizar que los cronogramas agresivos no sobrecarguen su Grupo de Agentes, lo que provocará una acumulación de operación.

Por defecto, los Agentes Privados pueden ejecutar hasta dos veces su recuento de CPU por máquina agente. Entonces, si su máquina Agente Privado 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 retrasaran su cola de agentes, sus operaciones más críticas podrían verse afectadas. Para evitar esto, simplemente determine la cantidad de operaciones que su Grupo de Agentes puede procesar al mismo tiempo, luego compare eso con la prioridad comercial y la duración del tiempo de tiempo de ejecución de sus operaciones programadas.

Habilitar o Deshabilitar el Horario

Una vez que haya asignado una programación a una operación, puede optar por desactivarla o volver a activarla (si está desactivada) de forma remota a través de la Management Console de los Proyectos página.

Advertencia

Tenga cuidado de recordar si deshabilita su horario, ya que esta función solo está disponible en Management Console y puede que no sea obvio dentro de Design Studio que el horario 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 una programación 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 alternar para activar o desactivar un programa existente, habilitando o deshabilitando efectivamente el programa para esa operación.

  • Horarios: Dentro de la pestaña Horarios, la columna Programado muestra el estado de los horarios asignados a las operaciones dentro del proyecto. Haga clic en el botón de alternancia para activar o desactivar un cronograma existente, habilitando o deshabilitando efectivamente el cronograma para todo el proyecto.

    Precaución

    Habilitar o deshabilitar un horario que se usa dentro de varias operaciones afectará todas las operación que usen el horario.

Eliminar Horario

Si tiene una programación asignada a una operación, puede eliminarla de la operación de las siguientes maneras. Esto no eliminará el cronograma como elemento del proyecto, sino que simplemente lo desasignará de la operación.

  • Dentro de la operación, haga clic en el icono de programación archivo adjunto y seleccione Eliminar programación.
  • Dentro de la operación, haga clic en la flecha hacia abajo adjunto o haga clic con el botón derecho en el fondo de la operación y seleccione Programar > 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 Horario, use el menú desplegable Horario para seleccionar (ninguno).

Cronograma de Solución de Problemas

Si su horario no funciona como se esperaba, 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?
    Los horarios deben asignarse a una operación para que se activen. Una vez que haya guardado una programación en una operación, no tendrá efecto hasta que se haya implementado.

  • ¿Tu horario está habilitado?
    Los horarios se pueden desactivar y volver a activar solo desde la Management Console web. Consulte la página Proyectos dentro de las pestañas Operaciones y Programaciones para asegurarse de que su programación esté habilitada.

  • ¿Sabes en qué huso horario está tu horario?
    Las zonas horarias se analizan en Operación de Husos Horarios.

  • Si está utilizando un Agente Privado, ¿se está ejecutando el servicio de programación?
    En la máquina donde está instalado el Agente Privado, verifique que Jitterbit Scheduler y Jitterbit Scheduler Service se estén ejecutando. En Windows, esto se puede verificar a través del Administrador de tareas en Procesos.

  • Si está utilizando un Agente Privado, ¿los horarios agresivos están sobrecargando su Grupo de Agentes?
    Si utiliza Agentes Privados, se debe realizar una evaluación adicional para garantizar que los cronogramas agresivos no sobrecarguen su Grupo de Agentes, lo que provocará una acumulación de operación.

    Por defecto, los Agentes Privados pueden ejecutar hasta dos veces su recuento de CPI por máquina de agente. Entonces, si su máquina Agente Privado 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 retrasaran su cola de agentes, sus operaciones más críticas podrían verse afectadas. Para evitar esto, simplemente determine la cantidad de operaciones que su Grupo de Agentes puede procesar al mismo tiempo, luego compare eso con la prioridad comercial y la duración del tiempo de ejecución de sus operaciones programadas.