Saltar al contenido

Horarios de Operación

Introducción

Cada operación se puede configurar para que se ejecute automáticamente aplicando un cronograma. Los cronogramas contienen información sobre cuándo se activará automáticamente una operación. Podrás definir prácticamente cualquier tipo de horario que necesites, como todos los viernes a las 17 horas, el último viernes de cada trimestre o cada hora de un solo 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 Cloud 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 cronogramas asignados a las operaciones dentro de un proyecto, o habilitar o deshabilitar cronogramas.

Al desplegar una programación que ya se ha implementado en la nube de Harmony, se le presentan opciones para seleccionar qué programaciones usar. Esto se trata en Seleccionar cronogramas y variables del proyecto en Despliegue del proyecto.

Otras formas de ejecutar operaciones incluyen la ejecución manual de operaciones o el uso de un activador de API, como se describe en Despliegue y ejecución de operaciones.

Crear un Nuevo Horario o Abrir un Horario Existente

Se puede acceder a los cronogramas de operación desde el panel del proyecto, la configuración de operación o el tela de diseño, dependiendo de si está creando un cronograma nuevo o editando un cronograma existente. Después de crear un cronograma o abrir un cronograma existente para editarlo, consulte Configurar cronogramas de operación más adelante en esta página para su 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 Programaciones (consulte Menú de acciones de categoría en Pestaña Componentes del panel de proyecto). Los nuevos horarios se crean con el nombre predeterminado Nuevo Horario. Las nuevas programaciones posteriores con nombres predeterminados se añaden con un número incrementado entre paréntesis.

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

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

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

Nota

Las ediciones de programación surten efecto en 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, las programaciones existentes que se crearon en Cloud Studio o en Management Console se pueden aplicar a las operaciones. Desde aquí también puede crear nuevos cronogramas, editar cronogramas existentes y disociar cronogramas de las operaciones. Cada opción se describe a continuación.

configuración de horarios

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

  • Horario: Utilice este menú para seleccionar el horario existente que desea aplicar a la operación. Si el horario que desea utilizar aún no existe, haga clic en el enlace Crear nuevo horario para crear un nuevo horario. Esta opción se trata 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 cronograma a cada operación y que el cronograma asignado no entrará en vigor hasta que se haya implementado el proyecto.

    Cuando una operación tiene una programación asignada, los campos Programar, Asignar y Crear nueva programación se reemplazan con opciones para establecer la política de programación y un resumen de la programación asignada.. Además, un icono de programación aparece en la operación en el tela de diseño, que al hacer clic vuelve a abrir la pantalla de programación de operación.

    Consejo

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

    horarios asignados

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

    • Ejecutar siempre: Seleccione ejecutar la operación según lo programado en caso de que todavía se esté ejecutando una ejecución anterior de la operación. Esta opción debe seleccionarse sólo si tiene un requisito especial para hacerlo. Al utilizar esta opción, asegúrese de que tener operaciones simultáneas no sea perjudicial al procesar potencialmente los mismos registros de datos de origen varias veces.

    • Omitir si ya se está ejecutando: Seleccione para omitir una ejecución programada de la operación en caso de que todavía se esté ejecutando una ejecución anterior de la misma operación (predeterminado).

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

    • Editar: Para editar el horario asignado, haga clic en el ícono de edición para abrir la pantalla de configuración del horario y realizar los cambios necesarios. También se puede acceder a los cronogramas existentes desde el panel de proyecto. En la pestaña Componentes, para editar una programación, coloque el cursor sobre el nombre de la programación y luego haga clic en el icono del menú de acciones. y en el menú seleccione Ver/Editar.

      Nota

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

    • Eliminar: Para disociar la programación de la operación, haga clic en el icono de eliminar . 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. Esto abre la pantalla de configuración del horario.

    Nota

    El horario no se crea hasta que haya configurado y guardado el nuevo horario. Una vez creada la programación, deberá seleccionarla en el menú Programación disponible y hacer clic en Asignar para aplicarla a la operación.

    programar diálogo

    • Nombre del programa: Ingrese un nombre para el programa. Es posible que desee darle 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"). El nombre no debe comenzar ni terminar con un espacio.

    • Ocurrencia: Utilice el menú para seleccionar una de las tres opciones para los días en los que el cronograma debe iniciar la(s) operación(es) en la 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 quedan disponibles para configurar:

        • 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. Cuando se selecciona esta opción, estos campos quedan disponibles para configurar:

        • Cada [#] semana(s): Ingrese una cantidad de semana(s) entre ejecuciones de operación.
        • [dom, lun, mar, miércoles, jueves, viernes, sábado]: Haga clic para seleccionar los días de la semana en los que desea la operación a ejecutar. Se debe seleccionar al menos un día.
      • Mensual: El cronograma activará la operación mensualmente. Cuando se selecciona esta opción, elija una de las dos opciones que estarán disponibles para configurar:

        • Día [#] de cada [#] mes(es): Ingrese el día del mes y el número de meses intermedios se ejecuta la operación.
        • El [1.º, 2.º, 3.º, 4.º o último] [día de la semana] de cada [#] mes: Utilice el menús para seleccionar qué día del mes e ingresar el número de meses entre ejecuciones de operación.
    • Frecuencia: Seleccione una de dos opciones para los horarios en los que el cronograma debe iniciar la operación en los días que se ejecuta:

      • Ocurre una vez a las [hh:mm:ss] [AM/PM]: La programación activará la operación solo una vez a la hora especificada. Especifique la hora utilizando el control deslizante superior para ajustar la hora o el control deslizante inferior para ajustar los minutos.

      • Ocurre cada [#] [Minuto(s)/Hora(s)] A partir de [hh:mm:ss] [AM/PM] y termina en [hh:mm:ss] [AM/PM]: El horario reactivará repetidamente la operación durante el período de tiempo especificado a lo largo del día. Especifique las horas a lo largo del día en las que desea limitar la ejecución de la operación, ya sea utilizando el control deslizante superior para ajustar la hora o el control deslizante inferior para ajustar los minutos.

        Nota

        Las zonas horarias se analizan a continuación en Husos Horarios de operación.

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

      Nota

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

      • Fecha de inicio: De forma predeterminada, el programa estará activo a partir de la fecha actual. Si desea que el programa comience otro día, use el selector de fecha/hora para seleccionar la fecha de inicio deseada.
      • Agregar fecha de finalización: De forma predeterminada, las operación a las que se asigna el cronograma se ejecutarán indefinidamente de acuerdo con el cronograma. Si desea especificar una fecha de finalización, primero haga clic en el enlace Agregar fecha de finalización para agregar el campo Fecha de finalización. Luego use el selector de fecha/hora para establecer la fecha en la que desea que finalice el programa.
      • Eliminar fecha de finalización: Este enlace aparece una vez que se agrega el campo Fecha de finalización. Para eliminar el campo Fecha de finalización, haga clic en el enlace Eliminar fecha de finalización.
    • Guardar: Haga clic para guardar y cerrar la configuración del horario.

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. La huso horario en la que se ejecutará la operación depende del agente que ejecuta la operación, a menos que la configuración Anular Huso Horario del Agente de programación esté habilitada en las políticas de su organización:

  • Huso Horario del Agente

    • Agentes en Nube: Todos los Agentes en Nube están en UTC.
    • Agentes Privados: Las husos horarios del 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 cronograma configurado inicia la operación pueden ser impredecibles dependiendo del agente específico que se esté utilizando.

    Cuando se utiliza la versión 10.85/11.23 o posterior del agente, y el agente utiliza una huso horario que observa 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 realizará a las 3 a. m. del segundo domingo de marzo.

    • Cuando se establece un horario 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 anteriores cuando se utiliza la versión del agente 10.84/11.22 y anteriores.

    Consejo

    Para mantener la coherencia en la programación, se recomienda utilizar una huso horario que no respete el horario de verano, como UTC (los Agentes en Nube usan UTC de forma predeterminada). Si usa un Agente Privado, puede usar 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 la 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 todas las programaciones actuales y futuras de una organización.

Programar Menú de Acciones

Después de crear una programación, se puede acceder a las acciones del menú para esa programación desde la pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

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

Opción del menú
Descripción
ver edición Ver/Editar abre la pantalla de configuración de horarios (consulte Configurar horarios de operación anteriormente en esta página).

Nota

Las ediciones programadas surten efecto en todas las operaciones a las que están asignadas.

cortar Cortar coloca una copia del cronograma en el portapapeles y elimina el cronograma original del proyecto (consulte Reutilización de componentes).
Copiar Copiar coloca una copia del programa en su portapapeles (consulte Reutilización de componentes).
duplicar Duplicar crea una programación nueva sin referencia utilizando la misma configuración que el componente original (consulte Reutilización de componentes).
rebautizar Cambiar nombre coloca el cursor en el nombre del programa para que pueda realizar las modificaciones necesarias.
ver dependencias Ver dependencias cambia la vista en el panel del proyecto para mostrar cualquier otra parte del proyecto de la que depende el cronograma (consulte Dependencias de componentes, eliminación y eliminación).
añadir al grupo Agregar al grupo abre un cuadro de diálogo para crear un nuevo grupo personalizado o agregar el programa a un grupo existente (consulte Grupos de componentes).
borrar Eliminar elimina permanentemente la programación (consulte Dependencias de componentes, eliminación y eliminación).
eliminar Eliminar no es funcional actualmente.

Utilice Secuencias de Comandos para Programar Operaciones

Si las opciones disponibles en la interfaz de usuario como se describe en Configurar horarios de operación no satisfacen sus necesidades, puede crear programaciones más complejas mediante secuencias de comandos.

Nota

Si tiene la configuración Anular la Huso Horario del Agente de programación habilitada 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 Jitterbit Script que contiene lógica de secuencia de comandos que verifica el último día del mes y ejecuta una operación si es verdadero. Asegúrese de reemplazar la referencia de la operación con la de la operación que desea ejecutar según el cronograma.

    <trans>
    if(DayOfMonth(LastDayOfMonth(Now()))==DayOfMonth(Now()),
    RunOperation("<TAG>operation:Scheduled Operation</TAG>");
    );
    </trans>
    
  3. Cree una programación que se ejecute todos los días a la hora deseada y aplíquela 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 esta una vez que se completen estos pasos:

    cronograma de cadena de operación

Activar o Desactivar Horarios

Cuando crea y aplica una programación a una operación, está habilitada de forma predeterminada. Usando la Management Console, puede optar por deshabilitar o volver a habilitar un cronograma (si está deshabilitado) de forma remota desde Proyectos página.

En los 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 un cronograma en una sola operación, o usando el interruptor en la columna Estado del programa para habilitar o deshabilitar un programa en todas las operaciones que tienen el programa aplicado. Tenga en cuenta que deshabilitar una programación a nivel de proyecto hace que el Estado efectivo se deshabilite 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 Cloud Studio, no hay ninguna indicación sobre qué horarios están habilitados o deshabilitados, y no es posible desde Cloud Studio deshabilitar un horario o volver a habilitar un horario que se ha deshabilitado. Por lo tanto, es importante recordar si deshabilita una programación, ya que la única forma de saber si está deshabilitada o volver a habilitarla es a través de Management Console.

Horarios de Solución de Problemas

Si una programación no funciona como se esperaba, verifique estos elementos al solucionar el problema:

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

  • ¿Está habilitado el horario?
    Los horarios se pueden deshabilitar y volver a habilitar solo desde la Management Console. Marque los Proyectos dentro de las pestañas Operaciones y Programaciones para asegurarse de que la programación esté habilitada.

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

  • 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 comprobar a través del Administrador de tareas en Procesos.

  • Si está utilizando un Agente Privado, ¿los horarios agresivos sobrecargan el 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 el Grupo de Agentes, lo que provocará un retraso en las operación.

    Los Agentes Privados pueden ejecutar de forma predeterminada hasta dos veces el recuento de CPU para cada máquina agente. Por ejemplo, si la máquina del Agente Privado tiene 4 núcleos de CPU, podrá procesar hasta 8 operaciones simultáneas.

    Al evaluar los requisitos, algunas de las operaciones pueden depender más del tiempo que otras. Si varias operaciones no críticas retrasaran la cola del agente, entonces más operaciones críticas podrían verse afectadas. Para evitar esto, determine la cantidad de operaciones que el Grupo de Agentes puede procesar simultáneamente (utilizando los cálculos de recuento de CPU descritos anteriormente) y luego equilibre eso con la prioridad comercial y la tiempo de ejecución del tiempo de ejecución de las operaciones programadas.