Jak stworzyć interaktywny przewodnik rozwiązywania problemów?

Zanim zaczniesz

• Potrzebujesz uprawnień do zarządzania centrum pomocy.
• Najpierw napisz artykuły z rozwiązaniami. Krok z rozwiązaniem może do nich linkować.
• Drzewo wpisuje się w zaawansowanym polu jako tekst w formacie JSON. Nie spiesz się i skorzystaj z poniższego przykładu.

Krok po kroku

1. Otwórz Materiały i wybierz Rozwiązywanie problemów. Otworzy się lista przewodników.
2. Wybierz Nowe.
3. Wypełnij Tytuł. Opcjonalnie: Podsumowanie i Platforma, na przykład urządzenie lub aplikację, której dotyczy problem.
4. W polu tree wpisz swoje drzewo. Jest oznaczone jako „zaawansowane”. Użyj poniższego przykładu.
5. Jeśli pojawi się komunikat "That is not valid JSON, so it was not applied.", sprawdź, czy nie brakuje przecinka lub cudzysłowu.
6. Umieść wpis w odpowiedniej sekcji centrum, a następnie opublikuj.

Struktura drzewa

Drzewo zawiera start oraz listę nodes. Dostępne są trzy rodzaje węzłów:

• Pytanie zawiera text oraz od 2 do 8 answers. Każda odpowiedź ma label i next wskazujące na inny węzeł.
• Napraw zawiera text. Może też zawierać articleId (numer jednego z Twoich opublikowanych artykułów) lub url z adresem https.
• Kontakt kończy ścieżkę panelem „Nadal potrzebujesz pomocy?”.

{
  "start": "q1",
  "nodes": [
    { "id": "q1", "kind": "QUESTION", "text": "Do you remember your password?",
      "answers": [ { "label": "Yes", "next": "q2" }, { "label": "No", "next": "f-reset" } ] },
    { "id": "q2", "kind": "QUESTION", "text": "Is two-step sign-in on?",
      "answers": [ { "label": "Yes", "next": "f-code" }, { "label": "No", "next": "c1" } ] },
    { "id": "f-reset", "kind": "FIX", "text": "Reset your password from the sign-in page.", "articleId": 1007 },
    { "id": "f-code", "kind": "FIX", "text": "Check your phone's clock and use a backup code." },
    { "id": "c1", "kind": "CONTACT", "text": "We can help you personally." }
  ]
}

Zasady sprawdzane podczas zapisywania

• Od 1 do 50 węzłów.
• Identyfikatory węzłów mogą mieć do 40 znaków, zawierać małe litery, cyfry i myślniki oraz muszą zaczynać się od litery lub cyfry. Każdy identyfikator może być użyty tylko raz.
• Pytanie musi mieć od 2 do 8 odpowiedzi, a każda odpowiedź musi prowadzić do istniejącego węzła.
• Do każdego węzła musi dać się dotrzeć z poziomu start.
• Drzewo nie może się zapętlać. Jeśli odpowiedź prowadzi do wcześniejszego pytania, zobaczysz: "This troubleshooter loops back to an earlier step. Every path must end with a fix or contact step."
• Drzewo może mieć maksymalnie 32 KB.

Warto wiedzieć

• Każdy opublikowany przewodnik ma osobną stronę w Twojej witrynie.
• Statystyki. Sekcja Help insights pokazuje Gdzie zakończono rozwiązywanie problemów, dzięki czemu wiesz, do których rozwiązań docierają czytelnicy.
• Rozwiązanie z parametrem articleId linkuje do artykułu tylko wtedy, gdy jest on opublikowany.

Częste problemy

• "This troubleshooter loops back to an earlier step." Jedna z odpowiedzi cofa czytelnika. Zmień jej parametr next na węzeł z rozwiązaniem lub kontaktem.
• Błąd zapisu dotyczący struktury drzewa. W treści błędu podany jest parametr fields.tree. W którymś węźle brakuje elementu, na przykład text lub poprawnego next. Porównaj swój kod z przykładem.

Pytania

Powiązane

• Centra pomocy
• Opcje kontaktu
• Wyszukiwania i statystyki
• Centrum pomocy i dokumentacja