Saltar a contenido

Programaciones

En el menú Programaciones puedes crear reglas de programación de tareas para tus Automatizaciones. Esto es útil para tareas que deben ejecutarse en horarios específicos, o para tareas que deben ejecutarse regularmente.

Ver Programaciones

En esta pantalla, puedes ver el resumen de las Programaciones en las siguientes tarjetas:

  • Total de Programaciones: cantidad total de Programaciones creadas.
  • Programaciones Activas: cantidad de Programaciones activas.
  • Programaciones Inactivas: cantidad de Programaciones inactivas.

Debajo del resumen, puedes ver las programaciones en formato de lista con las siguientes columnas:

  • Nombre: nombre de la programación.
  • Automatización: automatización vinculada a la programación.
  • Regla: regla de programación definida, como frecuencia y horario de ejecución.
  • Estado: botón para activar o desactivar la programación.
  • Menú de acciones: acciones disponibles para la programación:

Captura de pantalla del Orquestador de BotCity, presentando el menú Programaciones. La página se titula 'Schedules' y muestra el botón 'New Schedule' en la esquina superior derecha. Debajo, los campos de filtro y ordenación, las tarjetas de resumen Total schedules, Active schedules e Inactive schedules, y la lista de programaciones con las columnas Name, Automation, Rule, Status y el menú de acciones.

Crear una programación

Para crear una programación, haz clic en el botón Nuevo Programa +. Serás redirigido a la página de creación de programaciones en dos pasos.

1. Automatización

En el primer paso, completa la información referente a la automatización y haz clic en Seguiente.

  • Automatización: selecciona la automatización que deseas programar.
  • Nombre del horario: completa el nombre para identificar la programación.
  • Prioridad: define la prioridad de las tareas creadas por la programación.
  • Parámetros: si la automatización posee parámetros, puedes completarlos en este campo.

Zona horaria

Los horarios de los servidores del Orquestador BotCity están en UTC. Por lo tanto, si te encuentras en cualquier otra zona horaria, deberás ajustar la programación.

Captura de pantalla del Orquestador de BotCity, presentando el formulario de New Schedule en el paso 1 - Automation. Muestra el aviso sobre la zona horaria UTC de los servidores y los campos Automation, Schedule Name, Priority y Parameters. En la parte inferior, los botones Cancel y Next.

2. Programación

En este paso defines el tipo de programación por calendario o expresión CRON.

Zona horaria

Los horarios de los servidores del Orquestador BotCity están en UTC. Por lo tanto, si te encuentras en cualquier otra zona horaria, deberás ajustar el horario en el calendario o la expresión CRON para que corresponda a tu zona horaria.

Aquí tienes un ejemplo de este ajuste de zona horaria:

Estoy en Brasil y me gustaría programar tareas para mi automatización todos los días a las 10:00 de la mañana, horario estándar de Brasilia (GMT-3).

  • El horario en el calendario sería 10:00.

  • Como el horario del servidor está en UTC, deberás ajustar el horario a 13:00.

  • La expresión regular Quartz Cron sería 0 0 10 ? * * .

  • Con la corrección de zona horaria, quedaría de la siguiente manera: 0 0 13 ? * * .
  • Esto programará las tareas para ejecutarse a las 13:00 UTC, es decir, 3 horas antes del horario estándar de Brasilia.

Captura de pantalla del Orquestador de BotCity, presentando el paso 2 - Schedule del formulario de New Schedule, con el campo Schedule Type expandido mostrando las opciones Calendar y Cron Expression.

Calendario

Al seleccionar la opción Calendario, puedes definir una programación más simple, con una frecuencia diaria, semanal o mensual, por ejemplo.

  • Frecuencia de repetición: dirige a las opciones de frecuencia de repetición.

  • Ejecución única: dirige a crear una nueva tarea única.

    Captura de pantalla del Orquestador de BotCity, presentando el paso 2 - Schedule con el Schedule Type definido como Calendar y el campo Scheduling Frequency con la opción Repeat frequency seleccionada.

Al seleccionar la opción Frecuencia de repetición, defines la frecuencia de creación de tareas:

  • Minuto: repite la tarea en el intervalo de minutos definido (de 1 a 59).
  • Hora: repite la tarea en el intervalo de horas definido (de 1 a 23).
  • Día: repite la tarea en el intervalo de días definido, en un horario específico.
  • Semana: repite la tarea en los días de la semana seleccionados, en un horario específico.
  • Mes: repite la tarea en el día del mes seleccionado, en un horario específico.

El campo Scheduling policy se genera automáticamente según el calendario seleccionado.

El siguiente campo corresponde a Preferências de início, las opciones son:

  • Inmediatamente: la regla se aplica de inmediato.

  • Comenzar en una fecha específica: la regla comenzará a partir de la fecha elegida.

    Captura de pantalla del Orquestador de BotCity, presentando el campo Start Preferences expandido, con las opciones Immediately y Start on a specific date, además de los campos Scheduling Frequency y Schedule Strategy ya completados.

Con los campos completados, puedes visualizar un resumen de la programación creada y hacer clic en Programar para finalizar.

Captura de pantalla del Orquestador de BotCity, presentando el resumen de la programación (Scheduling Summary) con la información de Automation, Schedule Name, Schedule Strategy y Priority, y los botones Back y Schedule.

Expresión CRON

Al seleccionar la opción Expresión Cron, puedes definir programaciones más complejas, ya que es más potente y flexible.

Completa el campo Cadena CRON de Programación con la regla deseada.

Ejemplo de expresión CRON

Con la expresión CRON 0 */5 * ? * * definida para una automatización, el Orquestador BotCity crea automáticamente una nueva tarea en la cola cada 5 minutos.

Formato aceptado

La cadena de expresión CRON no es el formato de expresión CRON estándar. El Orquestador BotCity utiliza el formato de expresión Quartz CRON.

El sitio Cronwise ofrece una excelente herramienta para generar expresiones CRON, además de describirlas y mostrar las próximas fechas de ejecución.

El campo Estrategia de Programación se genera automáticamente según la cadena CRON completada.

Con los campos completados, puedes visualizar un resumen de la programación creada y hacer clic en Programar para finalizar.

Captura de pantalla del Orquestador de BotCity, presentando el paso 2 - Schedule con el Schedule Type definido como Cron Expression, el campo CRON Scheduling String completado y el resumen de la programación (Scheduling Summary).

Acciones

Puedes realizar algunas acciones en el menú de acciones de una programación.

Captura de pantalla del Orquestador de BotCity, presentando la lista de programaciones con el menú de acciones de una programación abierto, mostrando las opciones Info, Edit y Delete.

Información

En la opción Info, puedes visualizar el resumen de la programación y el historial de tareas creadas por el programador.

Captura de pantalla del Orquestador de BotCity, presentando la página Schedule Info con el resumen de la programación (Scheduling Summary) y el historial de ejecuciones (Running history), con las columnas Id Task, Scheduling time, Executed time y State.

Editar programación

En la opción Editar, puedes modificar la información de una programación existente:

  • Nombre de la Programación
  • Parámetros
  • Tipo de programación
  • Frecuencia
  • Preferencias iniciales

Eliminar programación

En la opción Eliminar, puedes eliminar la programación de la lista.

Captura de pantalla del Orquestador de BotCity, presentando la ventana de confirmación para eliminar una programación, con el título 'Delete consult', la pregunta 'Confirm scheduling delete?' y los botones No y Yes.