Pemicu acara terjadwal berulang

Tiga pemicu berbeda memungkinkan Anda menjadwalkan otomatisasi terlebih dahulu:

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

Pemicu pertama, Time.ScheduledTimeEvent, memungkinkan Anda menjadwalkan otomatisasi untuk dimulai pada satu waktu yang tepat di masa mendatang, atau secara berulang, berdasarkan waktu jam atau peristiwa matahari (yaitu, matahari terbit atau terbenam).

Misalnya, pemicu ini memulai otomatisasi pada pukul 22.00 setiap hari:

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

Atau, Anda dapat menentukan peristiwa waktu matahari, bukan waktu jam. Parameter untuk jenis pemicu ini adalah SolarTimeStruct yang terdiri dari:

  1. type, yaitu SolarTimeType.Sunrise atau SolarTimeType.Sunset.
  2. offset, yang memungkinkan Anda menggeser waktu mulai relatif terhadap peristiwa matahari dengan jumlah waktu berapa pun. Nilai positif akan memperkenalkan penundaan setelah peristiwa matahari, dan nilai negatif akan menyebabkan pemicu dipicu sebelum peristiwa matahari.

Contoh berikut adalah pemicu yang memulai otomatisasi 15 menit sebelum matahari terbit setiap hari:

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

Dua pemicu kedua adalah pemicu peristiwa terjadwal berulang, yang memungkinkan Anda membuat otomatisasi yang berjalan secara berkala menurut kriteria yang lebih spesifik yang dapat mencakup kondisi berbasis waktu dan kalender.

Time.RecurringClockTimeScheduledEvent memungkinkan Anda menjadwalkan otomatisasi berdasarkan satu atau beberapa kondisi waktu atau tanggal. Pemicu ini menggunakan sintaksis yang mirip dengan yang digunakan oleh utilitas cron Unix untuk menentukan jadwal otomatisasi berulang.

Time.RecurringSolarTimeScheduledEvent memungkinkan Anda menjadwalkan otomatisasi berdasarkan waktu matahari terbit atau terbenam, yang secara opsional dapat dikombinasikan dengan kondisi berbasis kalender.

Ekspresi cron

Anda mungkin sudah familiar dengan cron, perintah yang digunakan pada sistem Unix dan Linux untuk menjadwalkan tugas berulang.

Pemicu peristiwa terjadwal berulang menggunakan sintaksis ekspresi penjadwalan yang mirip dengan yang digunakan oleh cron, dan karena alasan ini, ekspresi penjadwalan yang digunakan dengan pemicu ini disebut sebagai ekspresi cron.

Ada beberapa 'varian' cron yang berbeda, dan beberapa variasi sintaksis di seluruh implementasi ini. Ekspresi cron pemicu peristiwa terjadwal berulang menggunakan sintaksis yang sama dengan penjadwal Quartz. Sintaksis ekspresi cron Quartz dijelaskan dalam dokumentasi untuk Quartz's CronExpression.

Contoh

Berikut beberapa contoh untuk mengilustrasikannya.

Kasus penggunaan Detik Menit Jam Hari dalam Bulan Bulan Hari dalam Seminggu Tahun
Jalankan setiap 24 jam, pada tengah malam 0 0 0 ? * * *
Jalankan pada pukul 06.00 setiap hari Selasa 0 30 19 ? * 3 *
Jalankan pada pukul 15 menit setelah jam, setiap jam, selama bulan Februari 0 15 * ? 2 * *
Jalankan sekali per jam 0 0 * ? * * *
Jalankan setiap 24 jam, pada tengah malam, dari Januari hingga Maret, pada hari kerja terdekat dengan tanggal 1 setiap bulan 0 0 0 ? 1-3 1W *
Pada hari Kamis kedua bulan Februari, sekali per jam, pada pukul 15 menit setelah jam 0 15 * ? 2 5#2 *
Jalankan pada pukul 15 menit setelah jam, setiap jam, pada hari terakhir bulan Februari 0 15 * L 2 ? *
Jalankan pada pukul 06.00 setiap hari Selasa dan Kamis 0 30 19 ? * 3,5 *

RecurringClockTimeScheduledEvent

Dalam pemicu RecurringClockTimeScheduledEvent, string ekspresi cron ditetapkan ke kolom Time.RecurringClockTimeScheduledEvent.cronExpression.

Berikut adalah contoh pemicu RecurringClockTimeScheduledEvent yang memulai otomatisasi pada pukul 20.00, setiap hari Rabu di bulan April:

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

RecurringSolarTimeScheduleEvent

Pemicu RecurringSolarTimeScheduleEvent menggunakan dua parameter:

  1. SolarTimeStruct.
  2. cronExpression: Subset ekspresi cron yang hanya terdiri dari kolom Hari dalam Bulan, Bulan, Hari dalam Seminggu, dan Tahun. Waktu matahari menentukan waktu pasti otomatisasi akan dimulai, sehingga kolom Detik, Menit, dan Jam akan dihilangkan.

Contoh berikut adalah pemicu yang menyebabkan otomatisasi dimulai satu jam setelah matahari terbit, setiap hari Rabu di bulan April:

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