Skip to main content

In Zendesk veröffentlichen

Um Inhalte von Paligo in Zendesk zu veröffentlichen, müssen Sie über Folgendes verfügen:

Tipp

Sie müssen keine ganze Publikation in Zendesk veröffentlichen. Sie können auch einen Teil einer Publikation veröffentlichen, z. B. ein Kapitel eines Benutzerhandbuchs. Weitere Informationen finden Sie unter In mehreren Zendesk-Kategorien veröffentlichen.

  1. Wählen Sie das gepunktete Menü (...) für das Topic oder die Publikation im Content Manager aus.

    selectpublish.png
  2. Wählen Sie Veröffentlichen aus. Publish_button_small.png

    publish-document-jan23.png

    Paligo zeigt das Dialogfeld Dokument veröffentlichen an.

  3. Wählen Sie auf der Registerkarte Einstellungen HTML.

  4. Wählen Sie das Zendesk-Layout, das Ihre Publikation verwenden soll.

    Die verschiedenen Zendesk-Layouttypen bilden Inhalte unterschiedlich in Zendesk ab, daher ist es wichtig, dass Sie ein Layout wählen, das Ihren Anforderungen entspricht. Um zu erfahren, wie jedes Layout Inhalte auf Zendesk zuordnet, siehe Zendesk-Layouts.

    choose-zendesk-layout.png
  5. Wählen Sie die Zendesk-Kategorie, die Ihre ausgewählten Paligo-Inhalte erhalten soll.

    zendesk-category.png
  6. Verwenden Sie die Einstellung Verwaltet durch, um auszuwählen, welche Benutzertypen die Artikel bearbeiten und veröffentlichen können, die Paligo erstellt oder in Zendesk aktualisiert. Sie können zum Beispiel Agenten und Manager auswählen. Die Einstellung Verwaltet durch wird in Zendesk manchmal als Berechtigungsgruppe bezeichnet.

    managed-by-zendesk.jpg

    Diese Einstellung wird als Standard für alle Artikel verwendet, die Paligo in Zendesk veröffentlicht, aber Sie können auch unterschiedliche Einstellungen für einzelne Artikel vornehmen. Die individuellen Einstellungen haben Vorrang vor den Standardeinstellungen. Sie legen „Verwaltet durch“ für einzelne Artikel auf der Registerkarte Zendesk Preflight fest.

  7. Verwenden Sie die Einstellung Sichtbar für, um auszuwählen, wer die Artikel sehen kann, die Paligo in Zendesk erstellt oder aktualisiert. Die Gruppe „Sichtbar für“ wird in Zendesk manchmal als Benutzersegmentgruppe bezeichnet.

    visible-to-zendesk.jpg

    Anmerkung

    Paligo verwendet die Einstellung Sichtbar für als Standard für alle Artikel, wenn Sie in Zendesk veröffentlichen. Sie können aber auch unterschiedliche Einstellungen für einzelne Artikel vornehmen.

    Die Zendesk Preflight-Funktion von Zendesk (siehe Schritt 8) bietet für jeden Artikel die Einstellung Sichtbar für. Die Artikeleinstellungen haben Vorrang vor den Standardeinstellungen.

  8. Wählen Sie die zu veröffentlichenden Sprachversionen aus.

    Languages section of Publish document dialog. There are options for each language. English UK and Swedish are selected.

    Anmerkung

    Wenn keine Übersetzungen verfügbar sind, wird nur die Ausgangssprache angezeigt. Bei mehreren genehmigten Übersetzungen in verschiedene Sprachen können Sie auswählen, welche Sie mit aufnehmen möchten. Paligo veröffentlicht jede Sprachversion als separate Ausgabe.

    Bei der PDF-Ausgabe können Sie sie als eine einzige, mehrsprachige Publikation veröffentlichen; aktivieren Sie hierzu das Kontrollkästchen Ausgewählte Sprachen kombinieren.

  9. Wählen Sie Bearbeiten im Abschnitt Profiling-Attribute aus, um Filterung/Profiling anzuwenden (optional).

    Wenn Sie keinen Filter anwenden möchten, lassen Sie das Feld leer.

    Profiling attributes dialog. Outputformat is set to include HTML.

    Wählen Sie OK aus, um das/die gewählte(n) Profiling-Attribut(e) hinzuzufügen.

    Profiling attributes section of Publish document dialog. Shows Outputformat: HTML selected.
  10. Wählen Sie Bearbeiten im Abschnitt Variablen aus, um Variablen anzuwenden (optional).

    Wenn Sie keine Variable anwenden möchten, lassen Sie das Feld leer.

    Variables dialog showing ACME 100 200 300 as variables and ACME 100 is set.

    Wählen Sie OK aus, um die ausgewählten Variablen hinzuzufügen.

    Variables section of publish document dialog. The ACME 100 200 300 variable set is selected with the ACME 100 variant.
  11. Im Abschnitt Ausgabedateiname können Sie den Dateinamen verwalten.

    Standardmäßig verwendet Paligo die in den Systemeinstellungen festgelegte Dateinamensyntax.

    Output filename section. There is a Template field that contains the values ID, Title, and Format. In the top-right corner is a preview of the filename that Paligo will generate if the current settings are used.

    Um die im Dateinamen enthaltenen Angaben zu ändern, geben Sie Ihr gewünschtes Format in den Publikationseinstellungen ein. Die Standardeinstellung lautet: ID-Title-Format.

    Sie können folgende Angaben in den Namen aufnehmen:

    • ID - Die ID des Dokuments.

    • Titel - Der Titel der Publikation oder des Topics, das Sie veröffentlichen.

    • Format - Der Name des Ausgabeformats, zum Beispiel PDF oder HTML5.

    • Bearbeitungsdatum - Das Datum, an dem die Publikation oder das Topic zuletzt bearbeitet wurde.

    • Label der Verzweigung – Der Text aus dem Label der Verzweigung für die Publikation oder das Topic. Dies gilt nur, wenn Ihre Inhalte verzweigt wurden und die Verzweigung über ein Label verfügt. Details hierzu finden Sie unter Beschriftungen für Zweige hinzufügen oder bearbeiten.

    • Eindeutiger Wert - Eine von Paligo generierte zufällige Zeichenfolge, die dem Dateinamen hinzugefügt wird, um ihn einzigartig zu machen. Dadurch kann verhindert werden, dass die Datei durch spätere Veröffentlichungen desselben Dokuments überschrieben wird.

    Tipp

    Wenn Sie @ in das Feld eingeben, zeigt Paligo eine Liste der verfügbaren Werte an, aus denen Sie wählen können. Um einen Wert zu entfernen, klicken Sie ihn an und verwenden Sie die Löschtaste oder Rücktaste, um alle Zeichen zu entfernen.

    Anmerkung

    Der in der oberen rechten Ecke angezeigte Dateiname ist eine Vorschau auf den Dateinamen, den Paligo bei der Veröffentlichung verwendet.

  12. Legen Sie die optionalen Parameter fest (lassen Sie das Kontrollkästchen deaktiviert, wenn Sie diese Funktionen nicht wünschen):

    • Speichern Sie die Ausgabe in Paligo - Aktivieren Sie das Kontrollkästchen, um die Zip-Datei in der Ressourcenübersicht zu speichern. Deaktivieren Sie das Kontrollkästchen, wenn Paligo nur die veröffentlichte Ausgabedatei in Ihrem Browser herunterladen soll.

      Wenn Sie die Ausgabe in Paligo speichern, können Sie die Zip-Datei aus dem Ressourceninfo-Panel für die Publikation oder das Topic herunterladen und dann die Zip-Datei von der Registerkarte Gespeicherte Ausgaben herunterladen.

    • E-Mail an mich - Aktivieren Sie dieses Kontrollkästchen, wenn Paligo Ihnen eine E-Mail schicken soll, wenn die Publikation bereit ist. Dies ist bei sehr großen Publikationen von Vorteil, deren Verarbeitung und Veröffentlichung länger dauern können.

    • Debug-Build erstellen - Aktivieren Sie dieses Kontrollkästchen, wenn Paligo eine Protokolldatei und einen Link-Bericht einfügen soll. Wenn Ihre Inhalte ein Problem verursachen, kann der Paligo Support Sie bitten, diese Funktion zu aktivieren, damit er die Protokolldateien zur Ermittlung der Ursache nutzen kann.

  13. Wählen Sie die Registerkarte Zendesk Preflight um Paligo-zu-Zendesk-Mapping anzeigen.

    Wenn Sie mit dem bestehenden Mapping zufrieden sind, können Sie mit dem nächsten Schritt fortfahren.

    Zendesk Preflight tab showing how Paligo topics are mapped to Zendesk sections and articles.

    Um das Mapping zu ändern, verwenden Sie die verschiedenen Einstellungen auf der Registerkarte Zendesk Preflight. Sie können die Paligo-Topics verschiedenen Abschnitten und Artikeln zuordnen, den Status Verwaltet durch und Sichtbar für ändern, die Topics als Entwurf oder Publikation festlegen und sie bei Bedarf befördern. Weitere Informationen finden Sie unter Paligo-zu-Zendesk-Mapping anpassen.

  14. Wählen Sie Dokument veröffentlichen aus.

    Paligo beginnt mit der Verarbeitung Ihrer Inhalte und wendet Ihre Layout- und Publikationseinstellungen an. Die benötigte Zeit ist von dem Umfang der Inhalte abhängig, die Sie veröffentlichen (je mehr Inhalte, desto länger dauert der Vorgang).

    Publish_Progress_Bar_small.jpg

    Ein Fortschrittsbalken zeigt Ihnen an, wie viel der Verarbeitung Paligo bereits abgeschlossen hat und wie viel noch zu tun ist. Wenn die Verarbeitung abgeschlossen ist, wird eine Benachrichtigung angezeigt.

    Die veröffentlichte Ausgabe erscheint wie folgt:

    • Eine Zip-Datei mit der veröffentlichten Ausgabe erscheint im Ordner Downloads auf Ihrem Computer.

      Wenn Sie die Einstellungen Ihres Browsers geändert haben, um heruntergeladene Dateien an einem anderen Ort zu speichern, befindet sich die Zip-Datei stattdessen dort.

      Wenn Sie eine Publishing-Integration verwenden, wird die Zip-Datei auch an den entsprechenden Dienst gesendet.

    • Ein Link im Panel Aktivitätsfeed zum Herunterladen der veröffentlichten Inhalte.

    Anmerkung

    Um die Inhalte online zur Verfügung zu stellen, entpacken Sie zunächst die Datei. Sie können die Datei dann lokal verwenden oder einen FTP-Client wie Filezilla verwenden, um den entpackten Inhalt auf einen Webserver hochzuladen.

    Tipp

    Sie können Ihre Publikationseinstellungen speichern und wiederverwenden, um einen reibungsloseren Publikationsprozess zu erreichen, siehe Publikationseinstellungen. Alle gespeicherten Einstellungen können auch für [en] Batch Publishing verwendet werden.

    Publish document dialog has a Save Settings option and a Saved Settings tab. The option saves the currently shown settings and these can then be selected in a single action on the tab.

Sie können eine Publikation vollständig oder in Teilen in unterschiedlichen Kategorien in Zendesk veröffentlichen. Dies ist besonders nützlich, wenn Sie Abschnitte einer Publikation verschiedenen Zendesk-Kategorien zuordnen möchten.

Nehmen wir zum Beispiel an, Sie haben ein „Mars Travel Manual“ erstellt, wie unten gezeigt. In diesem Fall könnten Sie jedes „Kapitel“ in einer anderen Kategorie in Zendesk veröffentlichen (z. B. eine Kategorie für „About Space Travel“, eine Kategorie für „Space Safety“, eine Kategorie für „The Mission Control Center“ usw.).

So veröffentlichen Sie in mehreren Zendesk-Kategorien:

space-publication-clear.png

Um in verschiedenen Zendesk-Kategorien publizieren zu können, müssen Sie im Layout-Editor die Einstellung Querverweise außerhalb des Publikationsumfangs fixieren aktivieren.

  1. Wählen Sie im oberen Menü Layout aus.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo zeigt eine Liste von Layouts an. Die Liste ist leer, wenn keine benutzerdefinierten Layouts in Ihrer Paligo-Instanz vorhanden sind.

  2. Wählen Sie das Zendesk-Layout aus, das Sie im Layout-Editor bearbeiten möchten.

  3. Wählen Sie auf der Seitenleiste Zendesk aus.

  4. Aktivieren Sie das Kontrollkästchen Querverweise außerhalb des Publikationsumfangs fixieren.

    Fix_Cross_Links_Outside_Publication.png
  5. Drücken Sie Speichern.

Paligo „schiebt“ den Inhalt der Publikation in Zendesk. Inhalte von Paligo auf Zendesk übertragen und Abschnitte und Artikel werden erstellt und/oder aktualisiert.

Wiederholen Sie die Schritte 2–10 des Prozesses für jede andere Zendesk-Kategorie.

Anmerkung

Wenn Sie Verzweigungen verwenden, um verschiedene Versionen Ihrer Topics zu erstellen, lesen Sie bitte Verzweigte Inhalte in Zendesk zuordnen, um zu erfahren, wie verzweigte Topics zugeordnet werden.

So können Sie eine Publikation vollständig oder in Teilen in unterschiedlichen Kategorien in Zendesk veröffentlichen:

  1. Erweitern Sie im Content Manager die Publikation, die Sie in Zendesk veröffentlichen möchten.

  2. Wählen Sie das Drei-Punkte-Menü (...) für den Teil der Publikation, den Sie in Zendesk veröffentlichen möchten.

    Sie können eine ganze Publikation oder eine beliebige „Gabelung“ in der Publikation auswählen. Eine „Gabelung“ ist ein Topic und dessen Unter-Topics („untergeordnete“ Topics).

    option-button-for-pub.png
  3. Wählen Sie Veröffentlichen aus. Publish_button_small.png

  4. Wählen Sie auf der Registerkarte Einstellungen HTML.

  5. Wählen Sie das Zendesk-Layout, das Ihre Publikation verwenden soll.

    choose-zendesk-layout.png
  6. Wählen Sie die Zendesk-Kategorie, die Ihre ausgewählten Paligo-Inhalte erhalten soll.

    zendesk-category.png
  7. Wählen Sie die zu veröffentlichenden Sprachversionen aus.

    Languages section of Publish document dialog. There are options for each language. English UK and Swedish are selected.

    Anmerkung

    Wenn keine Übersetzungen verfügbar sind, wird nur die Ausgangssprache angezeigt. Bei mehreren genehmigten Übersetzungen in verschiedene Sprachen können Sie auswählen, welche Sie mit aufnehmen möchten. Paligo veröffentlicht jede Sprachversion als separate Ausgabe.

    Bei der PDF-Ausgabe können Sie sie als eine einzige, mehrsprachige Publikation veröffentlichen; aktivieren Sie hierzu das Kontrollkästchen Ausgewählte Sprachen kombinieren.

  8. Wählen Sie Bearbeiten im Abschnitt Profiling-Attribute aus, um Filterung/Profiling anzuwenden (optional).

    Wenn Sie keinen Filter anwenden möchten, lassen Sie das Feld leer.

    Profiling attributes dialog. Outputformat is set to include HTML.

    Wählen Sie OK aus, um das/die gewählte(n) Profiling-Attribut(e) hinzuzufügen.

    Profiling attributes section of Publish document dialog. Shows Outputformat: HTML selected.
  9. Wählen Sie Bearbeiten im Abschnitt Variablen aus, um Variablen anzuwenden (optional).

    Wenn Sie keine Variable anwenden möchten, lassen Sie das Feld leer.

    Variables dialog showing ACME 100 200 300 as variables and ACME 100 is set.

    Wählen Sie OK aus, um die ausgewählten Variablen hinzuzufügen.

    Variables section of publish document dialog. The ACME 100 200 300 variable set is selected with the ACME 100 variant.
  10. Wählen Sie Dokument veröffentlichen aus.

    Paligo beginnt mit der Verarbeitung Ihrer Inhalte und wendet Ihre Layout- und Publikationseinstellungen an. Die benötigte Zeit ist von dem Umfang der Inhalte abhängig, die Sie veröffentlichen (je mehr Inhalte, desto länger dauert der Vorgang).

    Publish_Progress_Bar_small.jpg

    Ein Fortschrittsbalken zeigt Ihnen an, wie viel der Verarbeitung Paligo bereits abgeschlossen hat und wie viel noch zu tun ist. Wenn die Verarbeitung abgeschlossen ist, wird eine Benachrichtigung angezeigt.

    Die veröffentlichte Ausgabe erscheint wie folgt:

    • Eine Zip-Datei mit der veröffentlichten Ausgabe erscheint im Ordner Downloads auf Ihrem Computer.

      Wenn Sie die Einstellungen Ihres Browsers geändert haben, um heruntergeladene Dateien an einem anderen Ort zu speichern, befindet sich die Zip-Datei stattdessen dort.

      Wenn Sie eine Publishing-Integration verwenden, wird die Zip-Datei auch an den entsprechenden Dienst gesendet.

    • Ein Link im Panel Aktivitätsfeed zum Herunterladen der veröffentlichten Inhalte.

    Anmerkung

    Um die Inhalte online zur Verfügung zu stellen, entpacken Sie zunächst die Datei. Sie können die Datei dann lokal verwenden oder einen FTP-Client wie Filezilla verwenden, um den entpackten Inhalt auf einen Webserver hochzuladen.

    Tipp

    Sie können Ihre Publikationseinstellungen speichern und wiederverwenden, um einen reibungsloseren Publikationsprozess zu erreichen, siehe Publikationseinstellungen. Alle gespeicherten Einstellungen können auch für [en] Batch Publishing verwendet werden.

    Publish document dialog has a Save Settings option and a Saved Settings tab. The option saves the currently shown settings and these can then be selected in a single action on the tab.

Wenn Sie Inhalte von Paligo nach Zendesk veröffentlichen, wählen Sie eine Kategorie aus, siehe In Zendesk veröffentlichen. Wenn Sie eine Kategorie wählen, in der Paligo schon einmal veröffentlicht hat, wird Paligo dies tun:

  1. Die Publikation auf neue Topics prüfen (Topics, die keinen entsprechenden Artikel in Zendesk haben). Paligo erstellt für jedes neue Topic einen neuen Artikel in Zendesk und schreibt den Inhalt des Topics in diesen Artikel.

  2. Die Topics suchen, die bereits einen entsprechenden Artikel in Zendesk haben. Anschließend werden die Zendesk-Artikel mit den neuesten Inhalten aus den Topics der Paligo-Publikation aktualisiert.

Wichtig

Paligo löscht keine Artikel aus Zendesk. Wenn Sie also Inhalte in Zendesk neu veröffentlichen, sollten Sie überprüfen, ob die Artikel mit der neuesten Struktur Ihrer Paligo-Publikation übereinstimmen. Wenn Topics aus der Publikation entfernt wurden, müssen Sie die entsprechenden Artikel manuell in Zendesk entfernen.

Anmerkung

Wenn Sie Verzweigungen verwenden, um verschiedene Versionen Ihrer Topics zu erstellen, lesen Sie bitte Verzweigte Inhalte in Zendesk zuordnen, um zu erfahren, wie verzweigte Topics zugeordnet werden.

Um Artikel aus Zendesk zu entfernen, können Sie:

  • Zendesk Preflight verwenden, um auszuwählen, welche Artikel gelöscht und dann veröffentlicht werden sollen

  • Die Artikel manuell in Zendesk löschen.

Wie Sie Zendesk Preflight zum Entfernen von Artikeln verwenden, erfahren Sie unter Zendesk-Artikel und -Abschnitte aus der Ferne löschen.