Przewodnik po składni diagramu przejścia użytkownika Mermaid.js

Diagram przejścia użytkownika opisuje kroki, które użytkownik wykonuje w celu osiągnięcia określonego celu w aplikacji. W przeciwieństwie do schematów przepływu skupionych na systemie lub diagramów sekwencji, przejścia użytkownika skupiają się na działaniach ludzkich, etapach przepływu pracy oraz śledzeniu satysfakcji użytkownika w czasie.

Podstawowa struktura składni

Każde przejście użytkownika zaczyna się od przejście deklaracji, po której następuje tytuł i sekwencyjne sekcje, które rozkładają doświadczenie użytkownika.

przejście
tytuł Przykładowe przejście użytkownika
sekcja Nazwa etapu
  Nazwa zadania: Wynik: Użytkownik1, Użytkownik2

Odwołanie składniowe

Poniższa tabela rozkłada podstawowe elementy używane do tworzenia mapy przejścia użytkownika w Mermaid.js.

Składnik Opis Przykład składni
Deklaracja Inicjuje renderowanie diagramu przejścia użytkownika. przejście
Tytuł Określa główny nagłówek lub cel użytkownika na szczycie mapy. tytuł Przepływ logowania
Sekcja Reprezentuje wysoki poziom fazy lub etapu przejścia użytkownika. sekcja Faza odkrywania
Zadanie Pewna określona czynność wykonana przez użytkownika w ramach sekcji. Przeglądaj dokumentację
Wynik satysfakcji Liczba całkowita od 1 do 5 odzwierciedlająca radość lub trudności użytkownika. : 4 : (4 z 5)
Uczestnicy Lista ról rozdzielonych przecinkami uczestniczących w zakończeniu zadania. Użytkownik, System

Prawdziwy szablon: Doświadczenie zakupowe w e-commerce

Ten szablon przedstawia pełną podróż użytkownika, śledząc doświadczenie klienta przy zakupie produktu online, śledząc punkty bólu emocjonalnego (niskie oceny) oraz chwile radości (wysokie oceny).

podróż
tytuł Podróż zakupowa online
sekcja Odkrywanie produktu
  Wyszukaj produkt: 4: Użytkownik
  Porównaj ceny: 3: Użytkownik
  Przejrzyj zdjęcia produktu: 5: Użytkownik
sekcja Kanał zakupowy
  Dodaj produkt do koszyka: 4: Użytkownik
  Utwórz konto: 2: Użytkownik, System
  Wprowadź dane dostawy: 3: Użytkownik
  Przetwarzaj kartę kredytową: 1: Użytkownik, Brama płatności
sekcja Po zakupie
  Otrzymaj potwierdzenie e-mail: 5: System
  Śledź dostawę przesyłki: 4: Użytkownik, Logistyka


Wskazówka składni:Oceny satysfakcji są automatycznie kolorowane przez renderowanie. Ocena 1 lub 2 wyróżnia trudności operacyjne (czerwony/oranżowy), ocena 3 to obojętność (żółty), a oceny 4 lub 5 oznaczają płynne, skuteczne interakcje (zielony).


Zaawansowane pojęcie: Podróże wielu uczestników

W złożonych przepływach pracy zadania rzadko są wykonywane przez jednego człowieka. Mermaid pozwala przypisać wielu uczestnikom jedno zadanie, rozdzielając ich nazwy przecinkami. Jest to pomocne do pokazania, gdzie interakcja z klientem wymaga wsparcia backendowego lub automatyzacji z systemu.

podróż
tytuł Przykład wsparcia wielu uczestników
sekcja Sprawa obsługi klienta
  Zgłoś błąd: 3: Klient
  Przypisz błąd do agenta: 4: System, Administrator obsługi
  Zbadaj błąd techniczny: 2: Programista, Tester jakości
  Rozwiąż problem i poinformuj: 5: Administrator obsługi

Powszechne błędy składniowe

Podczas tworzenia map podróży użytkownika małe błędy formatowania mogą spowodować błąd w silniku renderowania. Pamiętaj o tych trzech zasadach formatowania, aby upewnić się, że twój diagram zostanie poprawnie wygenerowany:

  • Zasada podwójnego dwukropka: Każda linia zadania musi mieć dokładnie strukturę Opis zadania: Ocena: Uczestnik. Pominięcie drugiego dwukropka przed listą uczestników jest najczęstszą przyczyną niepowodzenia ładowania diagramu podróży.
  • Ograniczenia zakresu ocen:Oceny satysfakcji muszą być liczbą całkowitą z zakresu 1 do 5. Przekazanie oceny 0 lub liczby większej niż 5 spowoduje uszkodzenie parametrów układu.
  • Wcięcia: Choć Mermaid jest elastyczny w stosowaniu odstępów, utrzymywanie zadań wciętych pod ich odpowiednimi sekcjami znacznie ułatwia odczytywanie i utrzymanie plików tekstowych wraz ze skalowaniem funkcji produktu.
Przewijanie do góry