BPMN Editor

Reading Guide

Panduan membuka Reading Guide untuk membaca diagram BPMN sebagai kalimat berurutan dan bernomor, tanpa perlu memahami simbol BPMN.


Reading Guide membacakan diagram BPMN yang sedang terbuka menjadi kalimat. Setiap langkah mendapat satu kalimat, diurutkan sesuai jalannya proses dan diberi nomor.

Dengan begitu, pemilik proses dapat menyetujui atau mengoreksi isi diagram tanpa harus memahami simbol BPMN terlebih dahulu.

Reading Guide dapat digunakan pada semua diagram BPMN, baik yang Anda gambar sendiri, yang diunggah dari file, maupun yang dihasilkan secara otomatis.

Membuka Reading Guide

  1. Temukan Tombol Reading Guide
    Tombol Reading guide berada di pojok kanan bawah canvas, di sebelah kiri kontrol zoom.

  2. Buka Panel
    Klik tombol tersebut. Panel akan terbuka dan langsung membaca diagram yang sedang tampil di canvas.

Untuk menutup panel, klik tombol yang sama sekali lagi atau klik ikon ✕ di pojok panel.

Membaca Isi Panel

Panel terdiri atas tiga bagian, berurutan dari atas ke bawah.

Judul Diagram

Baris paling atas menampilkan nama proses sebagaimana tertulis di diagram.

Who is Involved

Bagian ini mendaftar pihak-pihak yang terlibat, yaitu pool dan lane pada diagram. Contohnya "HR pada PT Maju Jaya" atau "Vendor, pihak luar yang isinya sengaja tidak dimodelkan".

Bagian ini tidak diberi nomor karena pool dan lane bukan langkah kerja. Keduanya menjawab pertanyaan siapa yang terlibat, sebelum daftar di bawahnya menjawab apa yang terjadi.

Daftar Langkah

Di bawahnya adalah langkah-langkah proses, bernomor mulai dari 1 dan diurutkan sesuai jalannya proses.

Setiap baris menampilkan:

  • Nomor langkah, sehingga Anda dapat merujuknya saat berdiskusi, misalnya "langkah 7 belum benar".
  • Kalimat bacaan, misalnya "HR melakukan Review Leave Request melalui sistem".
  • Nama lane, yaitu pihak yang mengerjakan langkah tersebut, ditulis kecil di bawah kalimat.
  • Penanda incomplete, muncul apabila ada bagian kalimat yang tidak dapat dilengkapi dari diagram.

Jumlah langkah dan jumlah kalimat yang belum lengkap ditampilkan di kepala panel, misalnya 12 steps · 2 incomplete.

Menemukan Elemen di Canvas

Klik salah satu baris, baik pada bagian Who is involved maupun pada daftar langkah. Elemen yang bersangkutan akan dipilih dan digulirkan ke tengah layar pada canvas.

Cara kerjanya sama seperti mengklik temuan pada panel Problems milik Linter. Anda dapat membaca kalimatnya, menemukan bagian yang janggal, lalu mengkliknya untuk langsung melihat elemennya di diagram.

Mengganti Bahasa Bacaan

Di kepala panel tersedia dua tombol, yaitu EN dan ID.

  • EN membaca dalam bahasa Inggris. Ini adalah pilihan awal, mengikuti bahasa antarmuka Studio.
  • ID membaca dalam Bahasa Indonesia.

Pilihan bahasa disimpan untuk masing-masing diagram. Dengan begitu, SOP berbahasa Indonesia dapat tetap dibaca dalam Bahasa Indonesia, sementara dokumen lain tetap berbahasa Inggris, tanpa perlu mengubah pengaturan setiap kali berpindah dokumen.

Yang diterjemahkan hanyalah kata penghubung pada kalimat bacaan. Label pada diagram Anda, seperti nama langkah, nama lane, dan pertanyaan pada gateway, selalu ditampilkan apa adanya.

Sebagai contoh, satu langkah yang sama akan terbaca:

  • EN: HR performs Review Leave Request using the system.
  • ID: HR melakukan Review Leave Request melalui sistem.

Kalimat yang Belum Lengkap

Baris yang ditandai incomplete menunjukkan bahwa diagram belum memuat informasi yang dibutuhkan untuk melengkapi kalimatnya.

Beberapa penyebab yang sering muncul:

PenandaPenyebab
langkah-langkahnya / its stepsMuncul pada Call Activity, karena langkah-langkahnya berada di proses lain.
nama aturan / rule setMuncul pada Business Rule Task. Nama aturannya perlu didokumentasikan secara terpisah.
Label kosongLangkah, gateway, atau cabang yang belum diberi nama.

Gunakan daftar incomplete sebagai daftar periksa. Setiap barisnya menunjukkan pertanyaan yang belum terjawab oleh diagram Anda.

Pembacaan Ulang Otomatis

Reading Guide membaca kondisi diagram saat itu, termasuk perubahan yang belum disimpan.

Setiap kali Anda mengubah diagram, panel akan membaca ulang secara otomatis. Anda juga dapat membaca ulang kapan saja dengan tombol Read again, yaitu ikon panah melingkar di kepala panel.

Apabila diagram sedang dalam kondisi yang belum dapat dibaca, misalnya ada langkah yang belum tersambung ke mana pun, panel akan menampilkan keterangan singkat dan membaca ulang begitu diagramnya kembali utuh.

Memindahkan dan Mengubah Ukuran Panel

Panel dapat diatur seperti panel Problems pada Linter:

  • Memindahkan panel: seret bagian kepala panel.
  • Mengubah ukuran panel: seret sudut kanan bawah panel.
  • Melipat panel: klik ikon panah di kepala panel untuk menyisakan bagian kepalanya saja.