Activadores de eventos programados recurrentes

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Tres activadores diferentes te permiten programar una automatización con anticipación:

1. Time.ScheduledTimeEvent
2. Time.RecurringClockTimeScheduledEvent
3. Time.RecurringSolarTimeScheduledEvent

El primero, Time.ScheduledTimeEvent, te permite programar una automatización para que comience en un solo instante preciso en el futuro o de forma recurrente, según la hora del reloj o un evento solar (es decir, el amanecer o el atardecer).

Por ejemplo, este activador inicia la automatización a las 10:00 p.m. todos los días:

starter<_>(structure, Time.ScheduledTimeEvent) {
  parameter(Time.ScheduledTimeEvent.clockTime(LocalTime.of(22, 0, 0, 0)))
}

Como alternativa, puedes especificar el evento de hora solar en lugar de la hora del reloj. El parámetro para este tipo de activador es un SolarTimeStruct que consta de lo siguiente:

1. type, que es SolarTimeType.Sunrise o SolarTimeType.Sunset
2. offset, que te permite cambiar la hora de inicio en relación con el evento solar por cualquier cantidad de tiempo. Los valores positivos introducen una demora después del evento solar, mientras que los valores negativos hacen que el activador se active antes del evento solar.

El siguiente ejemplo es un activador que inicia la automatización 15 minutos antes del amanecer todos los días:

starter<_>(structure, Time.ScheduledTimeEvent) {
  parameter(
    Time.ScheduledTimeEvent.solarTime(
      SolarTimeStruct(SolarTimeType.Sunrise, java.time.Duration.ofMinutes(-15))
    )
  )
}

Los dos últimos activadores son activadores de eventos programados recurrentes, que te permiten crear automatizaciones que se ejecutan periódicamente según criterios más específicos que pueden incluir condiciones basadas en el tiempo y el calendario.

Time.RecurringClockTimeScheduledEvent te permite programar una automatización en función de una o más condiciones de hora o fecha. Este activador usa una sintaxis similar a la que usa la utilidad cron de Unix para especificar el programa de una automatización recurrente.

Time.RecurringSolarTimeScheduledEvent te permite programar una automatización en función de la hora del amanecer o del atardecer, de manera opcional, en combinación con una condición basada en el calendario.

Expresiones cron

Es posible que ya conozcas cron, un comando que se usa en sistemas Unix y Linux para programar tareas recurrentes.

Los activadores de eventos programados recurrentes usan una sintaxis de expresión de programación similar a la que usa cron y, por este motivo, las expresiones de programación que se usan con estos activadores se denominan expresiones cron.

Existen varios "tipos" diferentes de cron y varias variaciones de sintaxis en estas implementaciones. Las expresiones cron del activador de eventos programados recurrentes usan la misma sintaxis que el programador de Quartz. La sintaxis de la expresión cron de Quartz se explica en la documentación de CronExpression de Quartz.

Ejemplos

A continuación, se incluyen algunos ejemplos para ilustrarlo.

RecurringClockTimeScheduledEvent

En un activador RecurringClockTimeScheduledEvent, la cadena de expresión cron se asigna al campo Time.RecurringClockTimeScheduledEvent.cronExpression.

El siguiente es un ejemplo de un activador RecurringClockTimeScheduledEvent que inicia la automatización a las 8:00 p.m. todos los miércoles de abril:

starter<_>(structure, event = Time.RecurringClockTimeScheduledEvent) {
  parameter(Time.RecurringClockTimeScheduledEvent.cronExpression("0 0 20 ? 4 4 *"))
}

RecurringSolarTimeScheduleEvent

El activador RecurringSolarTimeScheduleEvent toma dos parámetros:

1. Un SolarTimeStruct.
2. cronExpression: Es un subconjunto de una expresión cron que consta solo de los campos día del mes, mes, día de la semana y año. La hora solar determina la hora exacta en la que comenzará la automatización, por lo que se omiten los campos Segundo, Minuto y Hora.

El siguiente ejemplo es un activador que hace que una automatización comience una hora después del amanecer, todos los miércoles de abril:

starter<_>(structure, event = Time.RecurringSolarTimeScheduledEvent) {
  parameter(
    Time.RecurringSolarTimeScheduledEvent.solarTime(
      TimeTrait.SolarTimeStruct(SolarTimeType.Sunrise, Duration.ofHours(1))
    )
  )
  parameter(Time.RecurringSolarTimeScheduledEvent.cronExpression("? 4 4 *"))
}