Scheduled Job

DocType Scheduled Job di TechMaju memungkinkan pengembang untuk mengotomatiskan tugas yang dapat dilakukan pada waktu tertentu atau pada jadwal yang berulang. Ini membantu dalam mengotomatiskan tugas rutin, meningkatkan efisiensi, dan memastikan bahwa operasi penting dilakukan secara konsisten dan tepat waktu.

Memahami DocType Scheduled Job

Tujuan: DocType Scheduled Job dirancang untuk mengotomatiskan berbagai tugas di dalam platform TechMaju. Ini memungkinkan pengembang untuk mendefinisikan pekerjaan yang berjalan pada interval yang ditentukan, memastikan bahwa tugas dieksekusi secara otomatis tanpa intervensi manual.

Fungsi: Scheduled Job dapat mengotomatiskan berbagai macam tugas, seperti:

Secara otomatis menghasilkan dan mendistribusikan laporan.
Secara otomatis menghasilkan dan menjadwalkan entitas dari catatan, seperti insiden, item perubahan, atau item konfigurasi dari templat.
Menjalankan scheduled job dari skrip atau business rule.
Menjadwalkan tugas pada akhir bulan.
Menjadwalkan tugas untuk hari kerja.

Periksa Scheduled Job Log untuk melihat status Scheduled Job. Status Scheduled Job meliputi:

Scheduled: Pekerjaan siap dijalankan pada interval terjadwal berikutnya.
Complete: Pekerjaan berhasil dijalankan.
Failed: Terjadi kesalahan saat menjalankan pekerjaan.

Peran yang Diperlukan

TM Core Developer: Dapat membuat, menulis, dan menghapus Scheduled Job.

Field Scheduled Job

Field	Deskripsi
Nama	Nama Scheduled Job.
Aplikasi	Aplikasi tempat pekerjaan akan digunakan.
Frekuensi Event	Frekuensi di mana pekerjaan akan dijalankan: All Hourly Daily Weekly Monthly Yearly Hourly Long Daily Long Weekly Long Monthly Long Cron Custom
Aktif	Sebuah checkbox untuk mengaktifkan atau menonaktifkan pekerjaan.
Cron Format	Format jadwal cron untuk mendefinisikan jadwal yang kompleks (hanya berlaku jika Frekuensi Event adalah Cron).
Custom Frequency	Frekuensi kustom untuk mendefinisikan jadwal: Daily Weekly Monthly Yearly
Waktu	Waktu di mana pekerjaan harus dijalankan (hanya berlaku jika Frekuensi Event adalah Custom).
Skrip	Skrip atau logika yang akan dijalankan saat pekerjaan berjalan.

Penjelasan Jadwal Cron

Sebuah jadwal Cron adalah cara sederhana namun kuat untuk mendefinisikan waktu untuk tugas berulang. Ini menggunakan sintaks khusus untuk mewakili interval waktu. Format ini terdiri dari lima field:

Menit (0-59)
Jam (0-23)
Hari Bulan (1-31)
Bulan (1-12)
Hari Minggu (0-6, di mana 0 adalah Minggu)

Sintaks Jadwal Cron

* * * * *
| | | | |
| | | | +-- Hari Minggu (0 - 6) (0 adalah Minggu)
| | | +---- Bulan (1 - 12)
| | +------ Hari Bulan (1 - 31)
| +-------- Jam (0 - 23)
+---------- Menit (0 - 59)

Karakter Khusus

* (Asterisk): Mewakili nilai apa pun.
/ (Slash): Digunakan untuk menentukan nilai langkah.

Contoh Ekspresi Cron Tanpa Nilai Langkah

0 0 * * *: Berjalan setiap hari pada tengah malam.
0 12 * * *: Berjalan setiap hari pada siang hari.
0 0 1 * *: Berjalan pada hari pertama setiap bulan pada tengah malam.
0 0 * * 0: Berjalan setiap Minggu pada tengah malam.

Penjelasan Nilai Langkah

Karakter / dalam jadwal Cron mewakili nilai langkah, yang memungkinkan Anda mendefinisikan interval dalam rentang waktu yang ditentukan untuk masing-masing dari 5 field.

Sintaks Nilai Langkah

<start-time>/<interval>

Ini berarti "dimulai pada start-time, jalankan setiap interval unit."

Contoh Nilai Langkah

Setiap 5 menit:
```
*/5 * * * *
```
Ini berarti "setiap 5 menit mulai dari menit 0".
Setiap 2 jam:
```
0 */2 * * *
```
Ini berarti "pada menit 0 setiap 2 jam setiap hari".
Setiap 3 hari pada tengah malam:
```
0 0 */3 * *
```
Ini berarti "pada tengah malam setiap hari ke-3 dalam bulan".

Penjelasan Contoh yang Lebih Rumit

Mari kita uraikan contoh yang lebih rumit:

15 0-23/2 * * 1-5

15: Pada menit ke-15
0-23/2: Setiap 2 jam antara 0 dan 23 (mis., 0, 2, 4, ..., 22)
*: Setiap hari dalam bulan
*: Setiap bulan
1-5: Pada hari kerja (Senin sampai Jumat)

Jadi, ekspresi Cron ini berarti "pada menit ke-15 setiap 2 jam dari pukul 0 hingga 22 pada setiap hari kerja."

Prosedur

Arahkan ke Develop > Scheduled Job.
Menambahkan Scheduled Job Baru:
- Klik '+ Tambah Scheduled Job' untuk membuka formulir pembuatan.
- Isi field yang diperlukan: Nama, Aplikasi, dan Frekuensi Event.
- Centang checkbox 'Aktif' jika Anda ingin pekerjaan segera aktif.
- Untuk Frekuensi Event 'Cron', tentukan jadwal cron menggunakan field 'Cron Format'.
- Untuk Frekuensi Event 'Custom', pilih 'Custom Frequency' (Harian, Mingguan, Bulanan, Tahunan) dan 'Waktu' saat pekerjaan harus dijalankan.
- Masukkan skrip atau logika yang akan dijalankan saat pekerjaan berjalan di field 'Skrip'.
Konfigurasi Scheduled Job:
- Sesuaikan skrip, frekuensi event, dan jadwal sesuai kebutuhan untuk memenuhi persyaratan spesifik tugas.
- Gunakan opsi 'Expand' untuk menulis skrip yang kompleks jika diperlukan.
Menyimpan dan Melihat Scheduled Job:
- Klik 'Terapkan' untuk menyimpan Scheduled Job.
- Pekerjaan akan dijalankan sesuai dengan jadwal dan kondisi yang telah ditentukan.
Periksa Scheduled Job Log untuk melihat status Scheduled Job.

Praktik Terbaik

Uji Scheduled Job di lingkungan pengembangan sebelum menerapkannya ke produksi.
Gunakan Scheduled Job untuk mengotomatiskan tugas rutin, memastikan tugas dilakukan secara konsisten dan tepat waktu.
Secara berkala memperbarui dan meninjau Scheduled Job untuk memastikan efektivitasnya dan kompatibilitasnya dengan versi baru platform TechMaju.
Dokumentasikan tujuan dan fungsi setiap Scheduled Job di dalam platform untuk membantu pemeliharaan di masa mendatang.