¿Qué es una programación?
Una programación es un disparador basado en cron adjunto a un contexto. Cuando se dispara, Matcher inicia una ejecución de coincidencia
COMMIT para ese contexto con sus reglas y fuentes. La ejecución solo concilia cuando el contexto está ACTIVE.
Ciclo de vida de la programación
Las programaciones admiten un ciclo de vida CRUD completo bajo
/v1/contexts/{contextId}/schedules.
Crear una programación
Entrega un
cronExpression. El campo enabled queda activo de forma predeterminada cuando se omite.
cURL
String
requerido
Expresión cron que define la frecuencia de ejecución (de 1 a 100 caracteres), con al menos cinco minutos entre disparos. Usa cinco campos: minuto, hora, día del mes, mes y día de la semana. Matcher rechaza un campo de segundos, las macros como
@daily y las programaciones por minuto y de menos de un minutoBoolean
Si la programación está activa de inmediato
id, su nextRunAt y sus marcas de tiempo. Listar las programaciones (GET) devuelve todas las programaciones del contexto, habilitadas y deshabilitadas por igual.
Pausar vs. eliminar una programación
Cuando necesitas detener una conciliación recurrente, tienes dos opciones. Deshabilita la programación para pausar las ejecuciones automáticas y conservar su configuración y su historial. Volver a habilitarla después es una sola llamada, sin necesidad de recrearla. Actualiza la expresión cron, cambia
enabled, o ambos (los campos omitidos quedan sin cambios):
cURL
DELETE .../schedules/{scheduleId}) solo cuando la cadencia desaparece para siempre. La eliminación es permanente. Para tomar una pausa, deshabilítala en su lugar.
Mejores prácticas
Alinea la cadencia con la disponibilidad de las fuentes
Alinea la cadencia con la disponibilidad de las fuentes
Programa las ejecuciones para que se disparen después de que todas las fuentes del contexto hayan entregado sus datos del período. Ejecutar antes de que termine la ingesta produce excepciones evitables.
Prefiere deshabilitar antes que eliminar
Prefiere deshabilitar antes que eliminar
Para pausar una cadencia de conciliación, deshabilita la programación. Conserva el historial y la configuración, y volver a habilitarla es una sola llamada.
Usa expresiones cron explícitas
Usa expresiones cron explícitas
Mantén las expresiones cron legibles y documentadas (por ejemplo,
0 0 * * * = todos los días a las 00:00). Matcher las evalúa en UTC.Próximos pasos
Contextos y fuentes
Configura los contextos y las fuentes que una programación concilia.
Generar informes
Revisa los resultados que producen las ejecuciones programadas.