Sync SOP Lanes

Gambaran Umum

Memilih Select Role satu per satu pada setiap lane memakan waktu kalau Drive Anda berisi banyak diagram. Fitur ini mencocokkan lane di diagram BPMN dengan node struktur organisasi berdasarkan nama, lalu menuliskan node itu sebagai role lane (properti Select Role pada lane).

Role lane menentukan dua hal:

• Daftar pilihan Assignee untuk task di dalam lane itu.
• SOP yang muncul per role di halaman Organization Structure.

Karena itu, salah role berarti salah daftar assignee dan salah daftar SOP. Selalu tinjau langkah Review sebelum menekan Apply.

Ada tiga pintu masuk:

Aturan Pencocokan Nama

Sebuah lane mendapat role bila nama lane sama dengan nama node di organisasi milik Pool file itu, setelah normalisasi berikut:

• spasi di awal dan akhir dibuang,
• spasi berturut-turut digabung menjadi satu,
• huruf besar/kecil diabaikan.

Ini adalah batasan yang permanen, bukan kekurangan sementara. Pencocokan selalu persis sama setelah normalisasi:

• Singkatan tidak dikenali (HR tidak sama dengan People & Culture).
• Sinonim, terjemahan, kemiripan tulisan, dan tanda baca yang berbeda tidak disamakan.

Lane yang tidak cocok tidak dibiarkan begitu saja: di langkah Review, Anda tetap bisa memilih node tujuannya secara manual (lihat status No match).

Batas lainnya:

• Pencocokan hanya di dalam satu organisasi. Organisasi diambil dari properti organisasi pada Pool (process), bukan per lane. Lane tidak pernah dicocokkan lintas organisasi. Cara mengatur organisasi pada Pool dijelaskan di Mengelola SOP Berdasarkan Role.
• Child lane ikut dibaca dan ditampilkan dengan keterangan "Child lane of nama lane induk".

Sync SOP Lanes (Banyak File)

Sync SOP lanes berjalan dalam empat langkah. Stepper di bagian atas dialog menampilkannya: Scope → Scan → Review → Apply, lalu layar hasil.

Status per Lane di Review

Hal lain yang perlu diketahui di Review:

• Memilih node di sebuah baris otomatis mencentang baris itu. Memilih "Leave without a role" melepas centangnya.
• Pool tanpa organisasi: file itu dilewati. Atur organisasi pada Pool di editor BPMN, lalu jalankan sync lagi.
• File yang Pool-nya memakai organisasi lain dibiarkan sepenuhnya dan dihitung terpisah di ringkasan Review ("N files of other organizations left alone").
• Peringatan assignee: bila sebuah user task di lane itu punya assignee tetap yang bukan anggota node tujuan, barisnya memberi peringatan. Sync tidak mengubah assignee; ia hanya memperingatkan.
• Setiap grup file punya tautan Open in editor yang terbuka di tab baru, sehingga hasil Review Anda tidak hilang.

Hasil Sync

Setelah Apply selesai, layar Lane sync applied memuat:

• jumlah lane dan file yang tersimpan, serta waktunya,
• daftar per file dengan nomor versi vN → vN+1 dan pasangan lane → node,
• pengingat cara membatalkan.

Tanda di Organization Structure

Setelah Apply, halaman Organization Structure memberi beberapa tanda:

• banner Lane sync applied dengan tombol View result untuk membuka kembali layar hasil,
• kartu Lane sync yang menampilkan waktu dan jumlah lane dari run terakhir,
• tanda +N sync pada node di pohon organisasi,
• tanda Lane sync pada file di tab SOP node itu.

Hal yang Wajib Diperhatikan

• Hanya role lane yang berubah. Sync tidak mengubah assignee, dan tidak mengubah lane yang sudah punya role.
• Konflik versi: bila ada orang menyimpan versi baru setelah Scan membaca file itu, file tersebut tidak ditulis sehingga pekerjaan orang lain tetap aman. Muncul peringatan beserta tombol Scan again.
• Satu kegagalan tidak menghentikan yang lain: Apply dan Scan melanjutkan ke file berikutnya.

Membatalkan

Buka file yang ingin dikembalikan, lalu restore versi sebelumnya dari panel Versions (lihat BPMN Versioning). Versi hasil sync mudah dikenali dari catatannya:

Setelah restore, deploy ulang bila Anda sudah men-deploy versi hasil sync.

Match Lanes by Name (Satu File)

Bila hanya satu diagram yang perlu dicocokkan, pakai Match lanes by name. Aturan pencocokan dan status per lane sama dengan Sync SOP lanes; yang berbeda adalah tempat memulainya dan cara menyimpannya.

Dari Editor BPMN

1. Buka diagram, lalu klik Match lanes by name pada toolbar editor BPMN.
2. Tinjau hasilnya pada dialog, ubah pilihan bila perlu, lalu terapkan.
3. Perubahan hanya terjadi di kanvas. Simpan file seperti biasa agar tersimpan. Sebelum disimpan, Anda bisa membatalkannya satu langkah dengan Ctrl+Z.

Dari Drive

Ada dua jalan:

• Klik menu tiga titik pada file BPMN, lalu pilih Match lanes by name.
• Buka panel File information → tab Details, lalu klik tombol di bagian Lane roles.

Hasilnya langsung disimpan sebagai satu versi baru dengan catatan Lane match: N lanes mapped.

Bagian Lane roles pada panel File information → Details untuk file BPMN menampilkan:

• organisasi Pool,
• satu baris per lane beserta role-nya (atau "No role" dengan alasannya),
• badge N of M lanes,
• catatan ringkas, misalnya "N lanes without a role have a node with the same name."

Perubahan pada Select Role di Editor

Saat fitur aktif, dropdown Select Role pada lane berubah:

• Node bernama kembar diberi nama induk: Nama (Induk).
• Di bawah dropdown muncul daftar Assignee options for tasks in this lane, atau "This node has no members yet." bila node belum punya anggota.
• Muncul peringatan untuk assignee tetap yang bukan anggota node.

Feature Flag

Fitur ini bawaannya mati di kedua sisi. Keduanya harus dinyalakan.

Cara menyalakannya:

1. Di environment bpm-service, set FEATURE_FLAG_LANE_SYNC=true, lalu restart bpm-service.
2. Di Studio, set VITE_FEATURE_FLAG_LANE_SYNC=true. Studio membaca nilai ini dari conf.js saat runtime (bisa diganti per deployment tanpa build ulang) atau dari .env saat build.

Bila flag tidak dinyalakan: