Programación, zona horaria y concurrencia

Antes de crear un calendario

La programación debe consumir un Workflow publicado y probado manualmente. Confirme permisos para administrar calendarios y ejecutar el Workflow, entradas disponibles sin intervención del navegador, Connections autorizadas y capacidad de worker. Un archivo adjuntado durante una prueba manual no se convierte en una fuente permanente para las ejecuciones futuras.

Abra Configuration → Workflow Scheduler para preparar una programación reutilizable y asígnela desde el Workflow. Revise en el formulario la recurrencia, la hora inicial, la zona horaria y si está habilitada. Manténgala deshabilitada mientras valida la configuración.

Preparar una ejecución diaria

1. Publique y ejecute manualmente el Workflow de laboratorio; confirme su resultado.
2. Cree el calendario con un nombre reconocible, por ejemplo daily_customers_lima.
3. Configure la recurrencia diaria a las 02:15 y seleccione America/Lima. Si utiliza la representación cron, el equivalente es 15 2 * * *.
4. Revise la próxima ejecución calculada. La zona del calendario es independiente de la zona de Profile usada para mostrar fechas.
5. Asigne el calendario al Workflow y revise su política de concurrencia. Habilite la programación solo después de aceptar los valores.
6. Después de la hora prevista, busque el intento en Monitor. Revise tanto las tareas como la salida; una próxima fecha calculada no demuestra una ejecución satisfactoria.

Interpretar hora local y cron

No use una abreviatura ambigua como CST para sustituir la zona IANA. En zonas que cambian de horario estacional, compruebe el comportamiento previsto alrededor de la transición. Revise el calendario al modificar la zona; cambiar solamente el idioma o Profile no debe interpretarse como una reprogramación.

Separar ejecuciones simultáneas de tareas paralelas

concurrencyPolicy administra la coexistencia de ejecuciones del mismo Workflow: allow, forbid o replace; el valor predeterminado es forbid. Revise la política antes de programar cargas que puedan solaparse. Reemplazar una ejecución no garantiza deshacer operaciones externas que ya ocurrieron.

maxParallelTasks limita tareas paralelas dentro de una ejecución: acepta 1–64 y el valor predeterminado es 4. No equivale a una reserva de workers, slots, CPU o capacidad del destino. La selección efectiva sigue dependiendo de recursos, permisos y disponibilidad. Para un laboratorio inicial, una secuencia simple facilita comprobar el comportamiento.

Comprobar y mantener

• Compruebe Workflow y versiones publicadas, calendario asignado y estado habilitado.
• Revise hora y zona de la próxima ejecución, y compare después un intento real.
• Confirme qué entrada permanente se leyó y dónde quedó la salida.
• Al retirar un calendario, revise los intentos existentes: deshabilitar futuras ejecuciones no es lo mismo que cancelar una ejecución activa.

Cuando la hora prevista no produce el resultado

Revise primero si el calendario está habilitado y asignado, si el Workflow está disponible y si una política de concurrencia impidió el solapamiento. Después examine cola, worker y errores de las tareas. No cree calendarios duplicados como primer remedio: pueden iniciar más escrituras cuando se resuelva la causa original.

Un Timer espera dentro de un recorrido; no sustituye al Scheduler. Consulte Monitor y recuperación para decidir qué acción corresponde al estado observado.