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:
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 Siguiente.
- 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.
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.
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.
Al seleccionar la opción Frecuencia de repetición, defines la frecuencia de creación de tareas:
- Minuto: crea tareas en los minutos de cada hora que son múltiplos del intervalo definido (de
1a59), comenzando en el minuto0. - Hora: crea tareas en las horas del día que son múltiplos del intervalo definido (de
1a23), comenzando a la medianoche (UTC). - Día: crea tareas en el intervalo de días definido, en un horario específico.
- Semana: crea tareas en los días de la semana seleccionados, en un horario específico.
- Mes: crea tareas en el día del mes seleccionado, en un horario específico.
Intervalo alineado al reloj, no a la ejecución anterior
La programación por calendario se convierte en una expresión CRON. Por eso, el intervalo se cuenta desde el inicio de cada hora (o de cada día), y no desde la última tarea creada. Cuando el intervalo no divide la unidad de forma exacta, las tareas no quedan espaciadas de manera uniforme.
Por ejemplo, con la frecuencia de 45 minutos, las tareas se crean en los minutos 0 y 45 de cada hora (5:45, 6:00, 6:45, 7:00...), y no cada 45 minutos.
Si necesitas intervalos iguales entre las tareas, elige un valor que divida la unidad de forma exacta, como 10, 15, 20 o 30 minutos.
El campo Estrategia de Programación se genera automáticamente según el calendario seleccionado y describe cuándo se crearán las tareas. Para intervalos que dividen la unidad de forma exacta, como 30 minutos, el campo muestra la frecuencia ("cada 30 minutos"). Para los demás, muestra los minutos u horarios en que se crearán las tareas ("en los minutos 0 y 45 de cada hora").
El siguiente campo corresponde a Preferencias de inicio, 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.
Con los campos completados, puedes visualizar un resumen de la programación creada y hacer clic en Programar para finalizar.
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.
Acciones¶
Puedes realizar algunas acciones en el menú de acciones de una programación.
Información¶
En la opción Info, puedes visualizar el resumen de la programación y el historial de tareas creadas por el programador.
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.









