Skip to main content

Aus Zendesk importieren

Zusammenfassung

Sie können Ihre Zendesk-Artikel direkt in Paligo importieren. Im Rahmen des Imports erstellt Paligo passend zu Ihren Artikeln neue Topics. Anschließend können Sie die Topics wieder den Artikeln zuordnen, um Aktualisierungen in Paligo vornehmen und die Änderungen in Zendesk veröffentlichen zu können.

Sie können Inhalte direkt aus Ihrem Zendesk Guide Helpcenter in Paligo importieren, wenn dies in Ihrem Plan enthalten ist. Beim Import analysiert Paligo die Zendesk-Abschnitte und -Artikel und erstellt passende Versionen in Paligo. Diese Versionen werden mit Paligo XML als strukturierte Inhalte markiert.

Es ist jedoch wichtig zu verstehen, dass bei einem Import keine Verbindung zwischen Ihren Zendesk-Inhalten und den dazugehörigen Inhalten in Paligo besteht. Nach dem Import sind die Zendesk-Artikel und die dazugehörigen Paligo Topics als separate Inhalte vorhanden. Damit Sie die Paligo Topics bearbeiten und die Änderungen in den dazugehörigen Zendesk-Artikeln erscheinen lassen können, müssen Sie Beziehungen zwischen den Topics und den Artikeln herstellen. Dies wird als „Mapping“ bezeichnet und kann mithilfe der Zendesk Preflight Funktion in Paligo eingerichtet werden.

Anmerkung

Die Architektur mit mehreren Abschnitten von Zendesk Enterprise wird für den Import in Paligo nicht unterstützt. Wenn Sie eine Architektur mit mehreren Abschnitten importieren müssen, wenden Sie sich bitte an den Kundensupport.

Das folgende Video zeigt die Vorgehensweise für einen Import aus Zendesk und die anschließende erstmalige Einrichtung des Mappings.

 

Anmerkung

Sie können Topics nicht in Zendesk aktualisieren und dann per Import dieselben Topics in Paligo aktualisieren. Wenn Sie dies versuchen, werden durch den Import eine völlig neue Publikation und neue Topics erstellt. Die Importfunktion dient nur zur Migration von Inhalten von Zendesk nach Paligo.

Für den Import aus Zendesk gelten folgende Voraussetzungen:

  • Sie benötigen einen Plan mit Zendesk-Integration.

  • Die Zendesk-Integration muss eingerichtet sein, wobei für den Import von Inhalten die Standardkategorie verwendet wird.

    Informationen zum Einrichten der Integration finden Sie unter Paligo mit Zendesk verbinden.

  • Wenn Sie über die Zendesk Multibrand-Funktion verfügen, setzen Sie das Zendesk-Konto, aus dem Sie importieren möchten, ganz oben in die Multibrand-Liste. Paligo importiert aus dem ersten Konto in der Multibrand-Liste. Informationen zum Ändern der Reihenfolge in der Liste finden Sie unter Paligo mit Zendesk verbinden.

Sie können Inhalte direkt aus Zendesk in Paligo importieren. Beim Import bezieht Paligo die Inhalte aus Ihren Artikeln und fügt sie neuen, automatisch erstellten Topics hinzu. Es besteht zu diesem Zeitpunkt jedoch keine Beziehung zwischen den importierten Inhalten und den Artikeln. Beim Import wird nur eine Paligo Version Ihrer Zendesk-Artikel erstellt.

Um die importierten Topics für die Veröffentlichung von Aktualisierungen zurück in Zendesk zu verwenden, müssen Sie das Paligo-zu-Zendesk-Mapping anpassen. Verwenden Sie dazu die Preflight-Einstellungen, die für das „Mapping“ von Topics zu Artikeln vorgesehen sind. Sie erstellen die Beziehung, indem Sie Importierte Inhalte Zendesk-Artikeln zuordnen.

  1. Erstellen Sie eine .zip-Datei der Zendesk-Inhalte.

  2. Importassistenten verwenden Sie können den , um die Zendesk .zip-Datei zu importieren. Wählen Sie das Zendesk Format aus.

Paligo erstellt für aus Zendesk importierte Inhalte Topics passend zu den Abschnitten und Artikeln. Um diese Topics zur Aktualisierung der passenden Artikel in Zendesk zu verwenden, müssen Sie Beziehungen zwischen den Topic und Artikeln herstellen. Dies wird als „Mapping“ bezeichnet und wird mithilfe der Zendesk Preflight Funktion eingerichtet, die zu den Publikationseinstellungen gehört.

  1. Wählen Sie das Optionsmenü (...) ) für die Publikation aus, die Paligo beim Import der Inhalte aus Zendesk erstellt hat. Wählen Sie anschließend Veröffentlichen aus.

  2. Wählen Sie im Dialogfeld Dokument veröffentlichen HTML aus.

  3. Wählen Sie ein Zendesk-Layout aus der Dropdown-Liste unter den Schaltflächen für die Ausgabetypen.

    select-zendesk-layout.jpg

    Wenn Sie ein Zendesk-Layout auswählen, ändert sich das Dialogfeld Dokument veröffentlichen und zeigt Zendesk-spezifische Einstellungen wie Zendesk-Kategorie und Verwaltet von an. Außerdem erscheint oben die Registerkarte Zendesk Preflight.

    publish-to-zendesk.jpg
  4. Wenden Sie beliebige Sprachen, Profiling-Attribute, Variablen und optionale Parameter an, die Sie für die Publikation verwenden möchten.

    Dies sind gängige Publikationseinstellungen, über die Sie unter Inhalte veröffentlichen, Filterung/Profiling und Variablen mehr erfahren.

  5. Wählen Sie die Registerkarte Zendesk Preflight aus.

    import-zendesk-preflight-main.jpg

    Die Registerkarte Zendesk Preflight zeigt Ihnen, was beim Veröffentlichen in Zendesk passiert. In einer hierarchische Liste werden die Kategorien, Abschnitte und Artikel anzeigt, die erstellt, aktualisiert oder gelöscht werden. Die mit einem Plus-Symbol markierten werden zu Ihrer Zendesk-Instanz hinzugefügt.

    category-section-articles.jpg

    Anmerkung

    In Paligo erstellen Sie verschiedene Ebenen in der Struktur einer Publikation, indem Sie Topics hinzufügen und in einer Hierarchie organisieren. Wo Zendesk also einen Abschnitt und dann darin Artikel anzeigt, sehen Sie in Paligo ein Topic mit weiteren Topics auf einer niedrigeren Ebene. Da das Topic der obersten Ebene Inhalte enthalten kann, erstellt Paligo dafür bei der Veröffentlichung in Zendesk automatisch einen zusätzlichen Artikel. Wenn Sie möchten, können Sie Paligo mithilfe der Zendesk-Layouts davon abhalten, zusätzliche Artikel für Topics der obersten Ebene zu erstellen.

    Da zwischen den importierten Topics und den Artikeln in Zendesk keine Beziehung besteht, sieht Paligo sie als vollständig neue Inhalte an. Wenn Sie also in Zendesk veröffentlichen, erstellt Paligo neue Kategorien, Abschnitte und Artikel.

    Unter den neuen Abschnitten und Artikeln befinden sich ausgegraute Abschnitte und Artikel ohne Symbole. Sie stellen die bereits in Zendesk vorhandenen Abschnitte und Artikel dar.

    existing-zendesk-articles.jpg

    Sie verfügen über kein Update-Symbol, da Paligo sie nicht verändern wird. Das System weiß, dass sie in Zendesk vorhanden sind, aber sie sind keinem Topic zugeordnet.

    Mit einem neuen Import möchten Sie höchstwahrscheinlich nicht, dass durch die importierten Topics neue Abschnitte und Artikel erstellt werden. Stattdessen möchten Sie wahrscheinlich, dass dadurch die bestehenden Abschnitte und Artikel aktualisiert werden. Daher folgt im nächsten Schritt die Einrichtung dieses Mappings.

  6. Wählen Sie das Zahnradsymbol für einen Abschnitt aus, den Paligo zu Zendesk hinzufügen soll. Das Dialogfeld Mapping erscheint.

    mapping-dialog-1.jpg
  7. Wählen Sie die Dropdown-Liste Mapping aus.

    mapping-dialog-2.jpg

    Sie haben nun die Möglichkeit, einen neuen Abschnitt in Zendesk zu erstellen (die Option mit dem Plus-Symbol). Oder Sie können das Abschnittstopic in Paligo einem beliebigen vorhandenen, nicht zugeordneten Abschnitt oder Artikel zuordnen (die Optionen mit den Update-Symbolen).

    Nach einem Import möchten Sie höchstwahrscheinlich die Abschnittstopics vorhandenen Abschnitten in Zendesk und die Artikeltopics vorhandenen Artikeln in Zendesk zuordnen.

  8. Stellen Sie den Abschnitt so ein, dass er einem vorhandenen, nicht zugeordneten Abschnitt in Zendesk zugeordnet wird, und wählen Sie anschließend Bestätigen aus.

    Wenn Sie bestätigen, wird die Liste aktualisiert und zeigt das neue Mapping an. Sie sollten nun sehen können, dass der Abschnitt jetzt über ein Update-Symbol anstelle eines Plus-Symbols verfügt, da Sie das Abschnittstopic so eingestellt haben, dass es einen vorhandenen Abschnitt in Zendesk aktualisiert. Wenn Sie den Abschnitt in der Liste erweitern, sollten Sie sehen können, dass er jetzt die vorhandenen Artikel in diesem Abschnitt (ausgegraut) ebenso wie die neuen Artikel enthält, die Paligo in diesem Abschnitt erstellen wird (Plus-Symbole).

    section-mapped-to-existing-section.jpg

    Dieses Mapping ist von Ihnen höchstwahrscheinlich nicht erwünscht. Stattdessen möchten Sie, dass Paligo die Inhalte den vorhandenen Artikeln zuordnet. Daher folgt im nächsten Schritt die Zuordnung der neuen Artikel (Plus-Symbole) zu den vorhandenen Artikeln (ausgegraut).

  9. Wählen Sie das Zahnradsymbol für einen der neuen Artikel, um das Dialogfeld Mapping anzuzeigen.

    topic-mapped-to-existing-article-1.jpg
  10. Wählen Sie die Dropdown-Liste Mapping aus und stellen Sie den Artikel so ein, dass er den vorhandenen Artikel aktualisiert (Update-Symbol), statt einen neuen Artikel zu erstellen (Plus-Symbol). Wählen Sie Bestätigen aus, wenn Sie das Mapping eingerichtet haben.

    topic-mapped-to-existing-article-2.jpg

    Sie können den Artikel so einstellen, dass er einem beliebigen vorhandenen, nicht zugeordneten Artikel in Zendesk zugeordnet wird; höchstwahrscheinlich möchten Sie ihn jedoch dem vorhandenen Artikel mit demselben Namen zuordnen.

    Anmerkung

    Sie können auch den Status des Artikels festlegen, sowie wer ihn in Zendesk verwalten und anzeigen kann.

  11. Wiederholen Sie die Schritte 6 bis 10 für jeden neuen Abschnitt und Artikel. Während Sie die neuen Abschnitte und Artikel den vorhandenen Abschnitten und Artikeln zuordnen, zeigt die Liste immer weniger Inhalt. Denn die Topics, die durch den Import generiert wurden, werden nun den vorhandenen Abschnitten und Artikeln zugeordnet, statt dass zusätzlich zu den vorhandenen neue erstellt werden.

    In der Regel stellen Sie die Paligo-Inhalte nach einem Import so ein, dass sie vorhandenen Abschnitten und Artikeln zugeordnet werden, so dass keine neuen Abschnitte oder Artikel in Zendesk erstellt werden.

    zendesk-mapping-in-place.jpg

    Anmerkung

    Verwenden Sie die blauen Kontrollkästchen links in der Liste, um auszuwählen, welche Kategorien, Abschnitte und Artikel veröffentlicht werden sollen.

  12. Wählen Sie Dokument veröffentlichen aus, um Ihre Inhalte zu veröffentlichen.

Paligo veröffentlicht dann Ihre Inhalte in Zendesk. Ab diesem Zeitpunkt werden die Topics in Paligo den Abschnitten und Artikeln in Zendesk zugeordnet. Wenn Sie also in Paligo eine Änderung an einem Topic vornehmen und in Zendesk veröffentlichen, weist auch der passende Artikel die Änderung auf.

Informationen zur Verwendung von Zendesk Preflight für die Veröffentlichung in Zendesk finden Sie unter Paligo-zu-Zendesk-Mapping anpassen.