Business Process/Linter Rules

Pool Has Lane

Memastikan setiap pool memiliki minimal satu lane agar setiap aktivitas punya aktor yang bernama.

AtributNilai
Rule IDpool-has-lane
SeverityError — wajib diperbaiki agar BPMN lolos linter
Elemen yang dicekPool (participant) yang berisi proses
SumberPlugin linter AlurKerja (bpmnlint-plugin-alurkerja)

Rule Pool Has Lane memeriksa bahwa setiap pool yang berisi proses memiliki minimal satu lane — walaupun pool tersebut hanya dikerjakan oleh satu aktor. Temuan ditampilkan pada judul pool.

Pesan di Studio

Temuan rule ini tampil di panel Problems BPMN Editor dengan pesan berikut:

  • Pool "<nama pool>" has no lanes — every pool must contain at least one lane so each activity can be assigned to a named actor

Kenapa ini masalah

Di AlurKerja, lane menentukan siapa yang mengerjakan setiap aktivitas. Tanpa lane, semua pekerjaan di pool menjadi milik aktor tanpa nama: penerima task tidak dapat ditentukan, reading guide tidak bisa menyebut siapa yang mengerjakan setiap langkah, dan dokumentasi proses tidak dapat menjelaskan pemilik tiap langkah.

Lane juga menjadi penghubung ke struktur organisasi. Setiap lane dipetakan ke sebuah role (node di org chart milik organisasi pool), dan role itu menentukan daftar pilihan assignee untuk task di lane tersebut serta SOP yang tampil per role di halaman Organization Structure. Lihat Check SOP Lanes.

Cara memperbaiki

  1. Klik pool, lalu klik Add lane pada context pad (baris teratas). Studio membuat satu lane seukuran pool, memindahkan semua elemen pool ke lane itu, dan langsung membuka kolom nama lane. Satu lane sudah cukup untuk pool dengan satu aktor. Untuk lebih dari satu aktor, pakai Divide into two lanes atau Divide into three lanes, atau tambah lane lain lewat Add lane above / Add lane below setelah lane pertama ada.
  2. Beri nama setiap lane sesuai jabatan atau peran yang mengerjakannya, sebaiknya sama dengan nama node di struktur organisasi agar bisa dicocokkan otomatis. Lane tanpa nama akan dilaporkan oleh Label Required.
  3. Pastikan nama pool adalah nama organisasi atau pihak yang menjalankan proses (misalnya PT ABC), bukan nama proses. Nama proses diisi pada properti process di Properties Panel pool.
  4. Pastikan semua aktivitas, event, dan gateway berada di dalam lane yang tepat.
  5. Jalankan ulang linter, lalu periksa juga temuan lane lainnya seperti Lane Has Activity dan Start Event Topmost Lane.

Contoh

Diagram berikut diperiksa langsung dengan BPMN Linter yang sama seperti di Studio. Elemen yang bermasalah ditandai merah. Klik Unduh .bpmn untuk membuka contoh di BPMN Editor.

✗ Contoh salahUnduh .bpmn

Menjalankan linter…

Pool PT ABC tidak memiliki lane, sehingga tidak jelas siapa yang mengerjakan setiap task.

✓ Contoh benarUnduh .bpmn

Menjalankan linter…

Pool diberi satu lane Pegawai. Satu lane sudah cukup untuk proses yang dikerjakan satu aktor.

Catatan

Uji sebelum deploy

Menambah atau mengubah lane dapat mengubah aktor dan penerima task. Bila BPMN sudah dipakai di production, uji satu instance terlebih dahulu dan deploy secara bertahap.

Versi sebelum 2026.10.3.1

Sebelum versi 2026.10.3.1 (rilis 22 Oktober 2026), pool tanpa lane hanya punya Add lane above dan Add lane below, yang selalu membuat dua lane. Untuk mendapat satu lane, hapus lane yang kosong.

Proses yang seluruhnya otomatis

Bila semua langkah di pool dijalankan sistem (misalnya hanya berisi Service Task, Script Task, atau Send Task tanpa User Task), tambahkan tetap satu lane, misalnya bernama Sistem. Lane ini tidak perlu dipetakan ke role di struktur organisasi karena tidak ada task yang membutuhkan assignee.

Pengecualian

Rule ini tidak berlaku untuk proses tanpa pool (bukan diagram kolaborasi), dan untuk pool kosong/collapsed yang hanya mewakili pihak luar (black-box pool).

Rule terkait