Skip to main content

Integration von Fluid Topics

Fluid Topics ist eine Software, die ein einzelnes Portal für Ihre gesamte Dokumentation bereitstellt, einschließlich PDFs, Word-Dokumenten, Artikeln in Wissensdatenbanken und Inhalten, die Sie in Paligo erstellen.

Um Ihre Paligo-Inhalte in Fluid Topics zu verwenden, benötigen Sie Folgendes:

  • Ein Fluid Topics-Konto mit Administratorberechtigungen

  • Eine in Fluid Topics eingerichtete Quelle. Die Quelle ist ein „Silo“, das die Inhalte aus Paligo empfängt.

  • Einen API-Schlüssel, erzeugt in Fluid Topics.

Anmerkung

Einzelheiten zur Einrichtung dieser Komponenten in Fluid Topics finden Sie in der Dokumentation für Fluid Topics.

Verbinden von Paligo mit Fluid Topics

Wenn Sie Paligo mit Fluid Topics verknüpfen, können Sie direkt in Ihrer Fluid Topics-Instanz veröffentlichen.

Anmerkung

Wenn Ihre Fluid Topics-Anwendung zuvor bereits mit Ihrer Paligo-Instanz verbunden war, gibt es möglicherweise bereits eine Quelle und einen API-Schlüssel. In diesem Fall können Sie diese verwenden, anstatt sie neu zu erstellen.

  1. Melden Sie sich als Administrator bei Fluid Topics an, um eine neue Quell-ID zu erstellen und einen neuen API-Schlüsselzu erzeugen.

    Die Quelle ist das „Silo“, das die Inhalte aus Paligo empfangen wird. Fluid Topics verwendet den API-Schlüssel, um die Verbindung von Paligo zu authentifizieren.

    Informationen zum Erstellen einer Quelle und zum Erzeugen eines API-Schlüssels finden Sie in der Fluid Topics-Dokumentation.

  2. Melden Sie sich bei Paligo über ein Benutzerkonto mit Administratorberechtigungen an.

  3. Melden Sie sich bei Paligo über ein Benutzerkonto mit Administratorberechtigungen an.

  4. Wählen Sie den Avatar in der oberen rechten Ecke aus. User avatar. It shows the user's image and their name. Next to the name is a downward pointing arrow, which when selected, reveals a menu.

  5. Wählen Sie im Menü Einstellungen aus. Cog icon.

  6. Wählen Sie die Registerkarte Integrationen. Jigsaw piece icon.

    Paligo settings. The Integrations tab is highlighted.

  7. Wählen Sie Hinzufügen im Feld Fluid Topicsaus.

    Fluid_Topics_Add_small.jpg

    Wenn die Integration bereits eingerichtet ist, wird stattdessen die Schaltfläche Ändern angezeigt.

  8. Geben Sie den Namen des Kontos ein.

    Fluid_Topics_Integration_settings_small.jpg

  9. Geben Sie die Upload-URL des Fluid Topics-Portals ein, das Inhalte aus Paligo empfangen wird.

  10. Geben Sie den in Schritt 2 erstellten API-Schlüssel ein.

  11. Geben Sie die in Schritt 2 erstellte Quell-ID ein.

    Fluid Topics verwendet die Quell-ID, um das „Silo“ zu identifizieren, das die Paligo-Inhalte erhalten wird. Die Anwendung verwendet auch die Quell-ID, um die Art der empfangenen Inhalte zu identifizieren.

  12. Drücken Sie Speichern.

  13. Aktivieren Sie das Kontrollkästchen Gateway verwenden, IP Allowlisting zu aktivieren. Optional

    Wenn in Fluid Topics IP-Einschränkungen aktiviert sind, müssen Sie Paligo auf die Verwendung einer statischen IP-Adresse festlegen (über einen Gateway).

  14. Stellen Sie dem Fluid Topics-Support die Paligo-IP-Adresse 34.249.89.180 bereit, um sie in die Allowlist aufzunehmen. Optional

    Anschließend kann Paligo zu Fluid Topics veröffentlichen, auch wenn „IP-Einschränkungen“ aktiviert sind.

  15. Drücken Sie Speichern.

  16. Wählen Sie die Schaltfläche Ändern für die Integration aus.

  17. Wählen Sie Testeinstellungen aus, um einen Verbindungstest durchzuführen.

    Test_Reset_Settings_Integrations_small.jpg

  18. Lautet Ihre Einstellung:

    • Richtig, zeigt Paligo eine grüne Erfolgsmeldung an.

    • Falsch, zeigt Paligo eine rote Fehlermeldung an.

      Überprüfen Sie jede Verbindungseinstellung sorgfältig, um sicherzustellen, dass Sie keine Fehler gemacht haben, und versuchen Sie es erneut.

      Wenn der Verbindungstest weiterhin fehlschlägt, wenden Sie sich an den Paligo-Support, um Unterstützung zu erhalten.

Veröffentlichen zu Fluid Topics

Um Inhalte aus Paligo zu Fluid Topics zu veröffentlichen, müssen Sie zuerst die Verbindung von Paligo zu Fluid Topics einrichten. Anschließend können Sie Inhalte aus Paligo zu Fluid Topics veröffentlichen. Im Gegensatz zu einigen anderen Integrationen ist kein Layout erforderlich.

Wenn Sie die Veröffentlichung mit der Fluid Topics-Ausgabe ausführen, wird eine Zip-Datei Ihrer Ausgabe an Fluid Topics gesendet, wo sie verarbeitet und der relevanten Quelle hinzugefügt wird. Sie geben die Quelle in den Paligo-Integrationeinstellungen an.

  1. Verbinden von Paligo mit Fluid Topics.

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

    selectpublish.png

  3. Wählen Sie Veröffentlichen aus. Publish_button_small.png

    publish-document-jan23.png

    Paligo zeigt das Dialogfeld Dokument veröffentlichen an.

  4. Wählen Sie Fluid Topics aus.

    Publish document dialog for publishing to Fluid Topics. There is a Fluid Topics option at the top, as well as settings for languages, profiles, variables, and more.

    Anmerkung

    Wenn die Option Fluid Topics nicht angezeigt wird, überprüfen Sie, ob Paligo eine Verbindung zu Fluid Topics herstellen kann. Die Option „Fluid Topics“ wird nur angezeigt, wenn die Verbindung korrekt eingerichtet ist.

  5. 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.

  6. 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.

  7. 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.

  8. Verwenden Sie den Abschnitt Ausgabe hochladen, um eine Zip-Datei des Inhalts in ein Repository hochzuladen, siehe Integrationen.

  9. 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.

  10. 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.

  11. 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.