Menerapkan dependensi antar alur kerja menggunakan node SUB_PROCESS - DataWorks

Node SUB_PROCESS adalah jenis node khusus dalam suatu alur kerja (workflow) yang digunakan untuk mereferensikan alur kerja lain. Node ini ideal untuk membagi tugas kompleks menjadi beberapa subtugas. Dengan mendefinisikan dan mengelola setiap subtugas secara independen, pemeliharaan dan penggunaan ulang keseluruhan tugas menjadi lebih mudah.

Latar Belakang

Anda dapat menggunakan node SUB_PROCESS dalam suatu alur kerja untuk mereferensikan alur kerja yang sudah ada, sehingga memungkinkan pembuatan panggilan bersarang (nested calls) antar alur kerja. Anda tidak perlu mengonfigurasi tugas terjadwal atau dependensi untuk alur kerja yang direferensikan karena eksekusinya dikendalikan oleh alur kerja yang mereferensikannya. Secara spesifik:

Alur kerja yang dapat direferensikan hanya berjalan ketika dipanggil oleh alur kerja lain.
Waktu proses (runtime) alur kerja yang direferensikan bergantung pada waktu proses alur kerja yang mereferensikannya.
Misalnya, jika Workflow-E berisi node SUB_PROCESS yang mereferensikan Workflow-D, maka Workflow-D akan dipicu secara sinkron saat Workflow-E dijalankan. Dalam struktur bersarang multi-lapis, proses ini berlanjut sepanjang rantai referensi.
Jumlah eksekusi alur kerja yang direferensikan bergantung pada jumlah kali alur kerja tersebut direferensikan.
Misalnya, jika beberapa node SUB_PROCESS di alur kerja berbeda mereferensikan alur kerja yang sama, alur kerja tersebut akan berjalan sekali untuk setiap referensi.

Anda dapat membangun hierarki alur kerja referensi linear yang sederhana, seperti pada diagram kiri, atau hierarki alur kerja kompleks dengan beberapa cabang paralel, seperti pada diagram kanan. Setiap struktur memiliki karakteristik unik dan cocok untuk skenario berbeda. Pilih solusi yang paling sesuai dengan proses bisnis Anda.

Diagram kiri: Diagram ini menunjukkan hierarki alur kerja linear. Alur kerja di setiap lapisan mereferensikan alur kerja di lapisan berikutnya melalui node SUB_PROCESS internal. Misalnya, Workflow-E mereferensikan Workflow-D, yang kemudian mereferensikan alur kerja lain, dan seterusnya hingga Workflow-B mereferensikan Workflow-A.
Diagram kanan: Diagram ini menunjukkan hierarki alur kerja kompleks di mana satu alur kerja dapat direferensikan oleh beberapa alur kerja lain. Misalnya, Workflow-A direferensikan oleh Workflow-B1 dan Workflow-B2 melalui masing-masing node SUB_PROCESS internal mereka.

Prasyarat

Anda memiliki ruang kerja tempat fitur Use Data Studio (New Version) diaktifkan dan telah disambungkan ke kelompok sumber daya. Untuk informasi selengkapnya, lihat Buat ruang kerja.

Catatan Penggunaan

Saat menggunakan node SUB_PROCESS untuk menerapkan struktur bersarang multi-lapis, Anda dapat menyarangkan referensi hingga 5 lapis, termasuk alur kerja akar. Jumlah total alur kerja tidak boleh melebihi 200.
Node SUB_PROCESS menciptakan hubungan pemicu (trigger), bukan dependensi hulu atau hilir. Saat suatu alur kerja menemui node SUB_PROCESS selama eksekusi, alur kerja tersebut memicu alur kerja yang direferensikan untuk berjalan.
Jika suatu alur kerja dipicu melalui referensi, nilai parameter penjadwalannya didasarkan pada waktu penjadwalan alur kerja yang memicunya.
Setelah Anda mengaktifkan alur kerja agar dapat direferensikan, alur kerja tersebut dan node-node internalnya tidak boleh memiliki dependensi terhadap tugas lain, dan tugas lain juga tidak boleh bergantung padanya. Tugas lain tersebut mencakup alur kerja lain, node di luar alur kerja saat ini, serta node akar ruang kerja.

Konfigurasi Alur Kerja

Bagian ini memberikan contoh cara menggunakan node SUB_PROCESS untuk mereferensikan alur kerja yang sudah ada. Pada contoh ini, node SUB_PROCESS di Workflow2 mereferensikan Workflow1.

Workflow 1: Aktifkan Referensi

Agar suatu alur kerja dapat direferensikan, Anda harus menghapus dependensi node hulu dan hilir yang sudah ada. Alur kerja yang direferensikan tidak mendukung waktu proses terjadwal. Ikuti langkah-langkah berikut untuk mengaktifkan sakelar referensi pada suatu alur kerja. Kami menyarankan Anda membuat alur kerja baru untuk menguji fitur ini.

Ikuti langkah-langkah berikut untuk membuat alur kerja bernama Workflow1 dan mengaktifkan opsi referensi untuk Workflow1.

Buat Workflow1.
1. Buka halaman Ruang Kerja di Konsol DataWorks. Di bilah navigasi atas, pilih wilayah yang diinginkan. Temukan ruang kerja yang diinginkan, lalu pilih Shortcuts > Data Studio di kolom Actions.
2. Di panel navigasi kiri, klik . Di sebelah kanan Workspace Directories, klik > Create Workflow. Setelah menetapkan nama alur kerja dan menyimpannya, editor alur kerja akan terbuka.
Aktifkan sakelar referensi.
Pada halaman konfigurasi Workflow1, klik Property di sebelah kanan. Di kotak dialog properti, aktifkan sakelar Referenceable.
Catatan
- Setelah sakelar ini diaktifkan, alur kerja saat ini dapat direferensikan oleh alur kerja lain menggunakan node SUB_PROCESS. Anda tidak perlu mengonfigurasi properti seperti waktu penjadwalan atau dependensi penjadwalan.
- Setelah alur kerja diaktifkan untuk direferensikan, alur kerja tersebut dan node-node internalnya tidak boleh memiliki dependensi terhadap tugas lain, dan tugas lain juga tidak boleh bergantung padanya. Tugas lain tersebut mencakup alur kerja lain, node di luar alur kerja saat ini, serta node akar ruang kerja.

Alur Kerja 2: Referensi Alur Kerja 1

Anda dapat membuat node SUB_PROCESS di Workflow2 untuk mereferensikan Workflow1.

Buat alur kerja bernama Workflow2. Untuk informasi selengkapnya, lihat Recurring workflows.
Buat node SUB_PROCESS.
Klik Workflow2 yang telah Anda buat untuk membuka halaman konfigurasinya. Seret node SUB_PROCESS dari Logical Node ke kanvas.
Konfigurasi alur kerja referensi.
Di kotak dialog Add Node, atur Reference Workflow ke Select Existing. Dari daftar drop-down di bawah Select Existing, pilih alur kerja yang akan direferensikan, yaitu Workflow1. Untuk Node Name, gunakan nama yang dihasilkan sistem atau masukkan nama kustom. Klik Confirm.
Catatan
- Untuk mereferensikan suatu alur kerja, Anda dapat memasukkan nilai kustom untuk Workflow Name lalu klik Confirm.
- Setelah mengonfirmasi referensi alur kerja baru, Anda dapat mengarahkan kursor ke node SUB_PROCESS dan mengklik Open Referenced Workflow. Di kotak dialog yang muncul, klik Save And Open untuk membuka halaman konfigurasi alur kerja baru tersebut.
- Pada halaman konfigurasi alur kerja yang direferensikan, sakelar Referenceable di panel konfigurasi Property di sebelah kanan diaktifkan secara default.
Simpan dan lihat detail referensi.
Buka halaman konfigurasi Workflow2 dan klik Save di bagian atas halaman. Di halaman Change Check, klik Save untuk mengonfirmasi perubahan Anda.
Catatan
Setelah sakelar referensi suatu alur kerja diaktifkan, alur kerja tersebut dapat direferensikan oleh beberapa alur kerja lain. Anda dapat melihat jumlah kali alur kerja tersebut direferensikan di panel Property di sisi kanan halaman alur kerja. Anda juga dapat mengklik View Details untuk informasi lebih lanjut.

Langkah Selanjutnya

Setelah mengonfigurasi referensi antar alur kerja, Anda dapat memublikasikan tugas alur kerja ke lingkungan penjadwalan untuk penjadwalan berkala. Kemudian, Anda dapat menggunakan fitur pengisian ulang data (data backfill) untuk mengamati status berjalan dari keseluruhan alur kerja.

Konfigurasi penjadwalan.
Untuk menjalankan tugas alur kerja secara berkala, Anda harus terlebih dahulu mengonfigurasi properti penjadwalannya. Untuk informasi selengkapnya, lihat Node scheduling.
Publikasikan tugas alur kerja.
Tugas alur kerja hanya akan dijadwalkan secara otomatis setelah dipublikasikan ke lingkungan produksi. Anda harus mempublikasikan alur kerja tersebut. Untuk informasi selengkapnya, lihat Publish an auto triggered task.
Penting
Sebelum mempublikasikan Workflow2 yang berisi node SUB_PROCESS, Anda harus terlebih dahulu mempublikasikan Workflow1 karena alur kerja tersebut direferensikan oleh node ini. Jika tidak, Workflow2 akan gagal dipublikasikan.
Jalankan dan lihat tugas alur kerja.
Setelah mempublikasikan tugas alur kerja, kami menyarankan Anda menggunakan fitur pengisian ulang data untuk melihat status berjalan dari tugas yang dipicu otomatis di Pusat Operasi. Untuk informasi selengkapnya, lihat Getting started with Operation Center.
Untuk melihat status eksekusi semua node internal dalam alur kerja yang direferensikan, temukan node SUB_PROCESS yang sedang berjalan, klik kanan, lalu pilih View Internal Tasks Of The Referenced Workflow.