Skip to main content

In Salesforce Knowledge veröffentlichen

Zusammenfassung

Erfahren Sie, wie Sie Ihre Paligo-Inhalte in Salesforce Navigationsthemen und/oder Artikel veröffentlichen können.

[en] If you have set up the Paligo-Salesforce integration, you can publish content from Paligo to your Salesforce Knowledge instance. You can also use Paligo to delete content that already exists in Salesforce.

  1. [en] Decide whether you are going to use a Salesforce Nested Layout or a Salesforce Knowledge Layout for publishing.

    • [en] Salesforce Nested Layouts are for publishing a structure of navigational topics and articles to a community. For these, you must publish from a publication.

    • [en] Salesforce Knowledge Layouts are for publishing articles only, with no structure. For these, you can publish from a publication or an individual topic.

    [en] To learn more, see Mapping mit einem Salesforce Knowledge-Layout and Mapping mit einem verschachtelten Salesforce-Layout.

  2. [en] Select the dotted menu (...) for the topic or publication in the Content Manager and then select Publish Download icon..

    selectpublish.png
    publish-document-jan23.png

    Paligo zeigt das Dialogfeld Dokument veröffentlichen an.

  3. Wählen Sie die HTML-Ausgabe und wählen Sie Salesforce Knowledge.

    publish-salesforce.png

  4. Verwenden Sie das Feld Salesforce-Link-Präfix, um alle Querverweise anzupassen. Sie sollten dieses Feld nur verwenden, wenn sich Ihre Artikel in Salesforce nicht direkt im Stammverzeichnis Ihrer Instanz befinden.

    Wenn die URL für Ihre Artikel beispielsweise „my-instance.force.com/<name of article>“ lautet, lassen Sie das Feld Salesforce-Link-Präfix leer. Paligo wird Ihre Querverweise standardmäßig korrekt veröffentlichen.

    Wenn die URL für Ihre Artikel ein oder mehrere zusätzliche Verzeichnisse zwischen der Instanz und dem Artikel hat, geben Sie die Syntax in das Feld Salesforce-Link-Präfix ein. Wenn die URL für Ihre Artikel beispielsweise „my-instance.force.com/sa/<name of article>“ lautet, geben Sie „/sa/“ in das Feld Salesforce-Link-Präfix ein.

  5. Verwenden Sie den Schalter SEO-freundlich, um zu steuern, wie Paligo URLs für die Artikel generiert.

    • Schalten Sie den Schalter ein (blau), wenn Paligo URLs generieren soll, die auf dem Titel des Topics basieren. Dadurch wird eine aussagekräftigere URL erstellt, die für Suchmaschinen und Ihre Leser besser ist. Wenn Sie beispielsweise ein Topic mit dem Titel „Forschungsartikel“ haben, generiert Paligo seine URL als „/articles/research-grants-12345“. Leerzeichen im Titel werden durch Bindestriche ersetzt und die ID des Topics wird am Ende hinzugefügt, um sicherzustellen, dass die URL eindeutig ist.

      Paligo publishing settings. SEO friendly links switch is set to on. Its background is blue.

    • Schalten Sie den Schalter auf aus (weiß), wenn Paligo URLs generieren soll, die auf der UUID des Topics basieren. Dadurch wird eine URL erstellt, die die UUID enthält, z. B. /articles/UUID-123-1230654.

      Paligo publishing settings. The SEO friendly links switch is set to off. Its background is white.

  6. Mithilfe von Artikel anhand von URL zuordnen legen Sie fest, wie Paligo reagieren soll, falls die Zuordnung zwischen Paligo und Salesforce verloren geht.

    Wenn Sie Ihre Inhalte schon einmal in Salesforce veröffentlicht haben, hat Paligo gespeichert, welche Topics zu welchen URLs in Salesforce zugeordnet sind. Dies nennen wir „Mapping“. Wenn Sie in Salesforce von der Produktion zur Sandbox oder von der Sandbox zur Produktion wechseln, kann das Mapping verloren gehen.

    Dieser Verlust lässt sich verhindern, wenn Sie das Kontrollkästchen Artikel anhand von URL zuordnen aktivieren.

    Wenn Sie das Kästchen leer lassen (nicht angekreuzt), verliert Paligo das Mapping und erstellt neue Artikel, wenn Sie zwischen Produktion und Sandbox wechseln. In einem solchen Szenario kann der Veröffentlichungsprozess fehlschlagen, wenn es in der Salesforce-Instanz bereits einen Artikel mit der URL gibt, auf die Paligo Anspruch erhebt.

    Salesforce Knowledge publishing settings in Paligo. Close up of the Match articles based on URL setting and checkbox.

  7. Verwenden Sie die Einstellung Salesforce-Communities, um die Experience Cloud auszuwählen, die die Inhalte von Paligo erhält. Die Experience Cloud ist die Website, die Ihre Salesforce Knowledge-Artikel enthält. Mehr über Experience Clouds erfahren Sie in der offiziellen Salesforce Dokumentation.

    Anmerkung

    Die Einstellung Salesforce-Communities ist nur verfügbar, wenn Sie mit einem Salesforce-Nested-Layout veröffentlichen.

  8. [en] To associate the content you are publishing with data categories, click in the Salesforce Data Categories field and choose from the list. Alternatively, you can leave the field blank and publish without data categories.

    Paligo publishing settings. Salesforce Data Categories setting has a dropdown list showing a hierarchy of Data Categories.

    Datenkategorien sind ein Salesforce-Konzept, mit dem Sie den Zugriff auf Artikel klassifizieren und steuern können. Sie müssen sie in Salesforce Knowledge einrichten. Sobald sie vorhanden sind, kann Paligo sie erkennen und zeigt sie als Optionen in der Einstellung Salesforce-Datenkategorien an.

    Informationen zu den Datenkategorien finden Sie in der offiziellen Salesforce-Dokumentation.

    Anmerkung

    Wenn Sie eine „übergeordnete“ Datenkategorie auswählen, können Sie keine ihrer „untergeordneten“ Datenkategorien auswählen. Das liegt daran, dass Salesforce es nicht zulässt, einen Artikel sowohl mit einer übergeordneten Kategorie als auch mit seinen untergeordneten Kategorien zu verknüpfen.

    Warnung

    Wenn Sie veröffentlichen, entfernt Paligo alle bestehenden Beziehungen zwischen dem Artikel und Datenkategorien. Es erstellt dann die neuen Beziehungen, die Sie in den Publikationseinstellungen von Paligo ausgewählt haben.

  9. [en] This step only applies if you did not select any data categories in the previous step.

    • [en] Clear the Remove existing data categories box to keep any existing data categories.

    • [en] Check the Remove existing data categories box to remove any existing data categories in your Salesforce Knowledge.

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

    Wichtig

    [en] If Paligo is going to create new navigational topics, you must include the source language of your Salesforce Knowledge instance in the Languages.

    [en] For example, let's say your Salesforce Knowledge instance uses Spanish as its primary language. When you publish from Paligo, you must include Spanish, otherwise Paligo will be unable to create any new navigational topics.

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

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

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

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

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

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

  16. Wählen Sie die Registerkarte Preflight und verwenden Sie die Salesforce Preflight-Funktion, um eine Vorschau des Inhalt-Mappings anzuzeigen. Sie können auch auswählen, welche Topics veröffentlicht werden und bei Bedarf Artikel und Navigations-Topics aus der Ferne löschen. Dies ist ein optionaler, aber empfohlener Schritt.

    Publish document dialog when a Salesforce Knowledge Layout is used for publishing. The Preflight tab is selected. It contains a hierarchy like a table of contents. There is also a salesforce tab and a side panel. The side panel has a global tab and an active component tab. At the top, there are panels that show the number of resources being added, updated, and deleted.

    [en] Use Salesforce Preflight to:

    • [en] Preview the content mapping

    • [en] Choose which articles or navigational topics are going to be published

    • [en] Set the status of articles

    • [en] Remotely delete articles and navigational topics that already exist in your Salesforce Knowledge instance.

    [en] For instructions on using Preflight, see Salesforce Preflight or [en] Salesforce Preflight for Knowledge Layouts.

  17. Veröffentlichen in Salesforce Knowledge.

    Sie können den Veröffentlichungsprozess starten, indem Sie Dokument veröffentlichen in der Registerkarte Einstellungen oder Veröffentlichen in der Registerkarte Preflight auswählen.

Wenn die Publikation abgeschlossen ist, gehen Sie zu Ihrem Salesforce Knowledge-Konto und überprüfen Sie die Ergebnisse. Sie können das Erscheinungsbild der Artikel in Salesforce festlegen. In der Regel erfolgt dies durch die Einrichtung eines Ein Salesforce-Layout erstellen und die Verwendung von CSS zur Gestaltung des Inhalts.

Anmerkung

Wenn Salesforce einen Fehler in Bezug auf die Artikelgröße anzeigt und Ihr Artikel 130 KB oder weniger beträgt, liegt dies wahrscheinlich an den Größenbeschränkungen, die in Salesforce festgelegt wurden. Einzelheiten zur Änderung der Grenzwerte finden Sie in der Salesforce-Dokumentation.

Paligo kann Topics von bis zu 130 KB Größe veröffentlichen, wobei Inhalte in ein einziges Feld in Salesforce „geschoben“ werden.

Tipp

Oft ist es am einfachsten, Artikel im Salesforce Classic-Modus zu verwalten. Sie können die veröffentlichten Artikel finden, indem Sie alle Registerkarten anzeigen (das Pluszeichen oben rechts) und dann Artikelverwaltung auswählen.

All tabs section in Salesforce. A callout box highlights the article management option. Another callout box highlights the plus icon in the top-right corner.