Panduan Sintaks Jalur Pengguna Mermaid.js

Diagram Jalur Pengguna menggambarkan langkah-langkah yang diambil pengguna untuk mencapai tujuan tertentu dalam aplikasi Anda. Berbeda dengan bagan alir berfokus sistem atau diagram urutan, jalur pengguna berfokus pada tindakan manusia, tahapan alur kerja, dan pelacakan kepuasan pengguna dari waktu ke waktu.

Struktur Sintaks Dasar

Setiap jalur pengguna dimulai dengan jalur deklarasi, diikuti oleh judul dan bagian-bagian berurutan yang memecah pengalaman pengguna.

jalur
title Jalur Pengguna Contoh
bagian Nama Tahap
  Nama Tugas: Skor: Aktor1, Aktor2

Referensi Sintaks

Tabel di bawah ini memecah elemen-elemen utama yang digunakan untuk membuat peta jalur pengguna dalam Mermaid.js.

Komponen Deskripsi Contoh Sintaks
Deklarasi Menginisialisasi renderer diagram jalur pengguna. jalur
Judul Menentukan judul utama atau tujuan pengguna di bagian atas peta. judul Alur Kerja Masuk
Bagian Mewakili tahap atau fase tingkat tinggi dari jalur pengguna. bagian Fase Penemuan
Tugas Tindakan spesifik yang diambil pengguna dalam suatu bagian. Telusuri dokumentasi
Skor Kepuasan Bilangan bulat dari 1 hingga 5 yang memetakan kegembiraan atau hambatan pengguna. : 4 : (4 dari 5)
Pemain Daftar peran yang dipisahkan dengan koma yang terlibat dalam menyelesaikan tugas. Pengguna, Sistem

Rancangan Dunia Nyata: Pengalaman Checkout E-Commerce

Rancangan ini menampilkan perjalanan pengguna secara lengkap yang melacak pengalaman pelanggan dalam membeli barang secara online, melacak titik-titik ketidaknyamanan emosional (skor rendah) dan momen kepuasan (skor tinggi).

perjalanan
title Perjalanan Pembelian Online
bagian Penemuan Produk
  Cari barang: 4: Pengguna
  Bandingkan harga: 3: Pengguna
  Lihat gambar produk: 5: Pengguna
bagian Funnel Checkout
  Tambahkan barang ke keranjang: 4: Pengguna
  Buat akun: 2: Pengguna, Sistem
  Masukkan detail pengiriman: 3: Pengguna
  Proses kartu kredit: 1: Pengguna, Gateway Pembayaran
bagian Setelah Pembelian
  Terima konfirmasi email: 5: Sistem
  Lacak pengiriman paket: 4: Pengguna, Logistik


Kiat Sintaks:Skor kepuasan secara otomatis diberi warna oleh renderer. Skor 1 atau 2 menandai hambatan operasional (merah/oranye), skor 3 bersifat netral (kuning), dan skor 4 atau 5 mewakili interaksi yang lancar dan sukses (hijau).


Konsep Lanjutan: Perjalanan Multi-Pemain

Dalam alur kerja yang kompleks, tugas jarang diselesaikan oleh satu orang saja. Mermaid memungkinkan Anda menetapkan beberapa pemain untuk satu tugas dengan memisahkan nama mereka menggunakan koma. Ini membantu menunjukkan di mana interaksi pelanggan memerlukan dukungan backend atau otomatisasi dari sistem.

perjalanan
title Contoh Dukungan Multi-Pemain
bagian Kasus Dukungan Pelanggan
  Kirim tiket masalah: 3: Pelanggan
  Tugaskan tiket ke agen: 4: Sistem, Admin Dukungan
  Selidiki bug teknis: 2: Pengembang, Tester QA
  Selesaikan masalah dan beri tahu: 5: Admin Dukungan

Kesalahan Umum Sintaks

Saat menulis peta perjalanan pengguna, kesalahan format kecil dapat menyebabkan mesin rendering menghasilkan kesalahan. Ingat tiga aturan format ini untuk memastikan diagram Anda terbentuk dengan benar:

  • Aturan Dua Titik Ganda:Setiap baris tugas harus mengikuti struktur tepat dariDeskripsi Tugas: Skor: Pemain. Lupa menuliskan titik dua kedua sebelum daftar pemain adalah alasan paling umum mengapa diagram perjalanan gagal dimuat.
  • Keterbatasan Rentang Skor:Skor kepuasan harus berupa bilangan bulat antara 1 dan 5. Mengirim skor 0 atau angka lebih dari 5 akan merusak parameter tata letak.
  • Indentasi: Meskipun Mermaid fleksibel terhadap spasi, menjaga tugas-tugas Anda diindentasi di bawah bagian-bagian yang sesuai membuat file teks mentah Anda jauh lebih mudah dibaca dan dipertahankan saat fitur produk Anda berkembang.
Scroll to Top