Jak vytvořit interaktivního průvodce řešením problémů?

Než začnete

• Potřebujete oprávnění ke správě centra nápovědy.
• Nejprve napište články s řešením. Krok s řešením na ně může odkazovat.
• Strom se zadává do pole pro pokročilé jako text ve formátu JSON. Nespěchejte a zkopírujte si níže uvedený příklad.

Postup

1. Otevřete Články a vyberte Průvodci řešením problémů. Tím se otevře seznam průvodců řešením.
2. Zvolte Nové.
3. Vyplňte Název. Volitelné: Shrnutí a Platforma, například zařízení nebo aplikaci, které se problém týká.
4. Do pole pro položku tree vepište svůj strom. Je označeno jako „pokročilé“. Použijte příklad níže.
5. Pokud se v poli zobrazí „That is not valid JSON, so it was not applied.“, zkontrolujte, zda nechybí čárka nebo uvozovka.
6. Zařaďte záznam do správné sekce rozcestníku a publikujte ho.

Podoba stromu

Strom má start a seznam nodes. Existují tři typy uzlů:

• Otázka má text a 2 až 8 answers. Každá odpověď obsahuje label a next odkazující na jiný uzel.
• Opravit obsahuje text. Může obsahovat také articleId (číslo některého z vašich publikovaných článků) nebo https url.
• Kontakt ukončí průchod na panelu „Stále potřebujete pomoc?“.

{
  "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." }
  ]
}

Pravidla, která web kontroluje při uložení

• 1 až 50 uzlů.
• Identifikátory uzlů (ID) obsahují malá písmena, číslice a pomlčky, mají maximálně 40 znaků a začínají písmenem nebo číslicí. Každé ID lze použít pouze jednou.
• Otázka má 2 až 8 odpovědí a každá odpověď odkazuje na existující uzel.
• Ke každému uzlu se lze dostat z start.
• Strom se nesmí zacyklit. Pokud odpověď vede zpět k dřívější otázce, zobrazí se: „This troubleshooter loops back to an earlier step. Every path must end with a fix or contact step.“
• Strom může mít velikost maximálně 32 KB.

Dobré vědět

• Každý publikovaný průvodce má na vašem webu vlastní stránku.
• Přehledy. V sekci Statistiky nápovědy se zobrazuje Kde průvodci skončili, takže uvidíte, ke kterým řešením se čtenáři dostanou.
• Řešení s articleId odkazuje na článek pouze po dobu, kdy je daný článek publikován.

Časté problémy

• „This troubleshooter loops back to an earlier step.“ Některá odpověď směřuje zpět. Změňte její next na uzel s řešením nebo kontaktem.
• Chyba uložení stromu. Chybová zpráva uvádí fields.tree. V uzlu chybí část dat, například text nebo platné next. Porovnejte zápis s příkladem.

Časté dotazy

Související

• Centra nápovědy
• Možnosti kontaktu
• Statistiky a našeptávač hledání
• Centrum nápovědy a dokumentace