Skip to main content

Paligo mit Salesforce Knowledge verbinden

Zusammenfassung

Erfahren Sie, wie Sie Paligos Integrationseinstellungen für Salesforce Knowledge einrichten.

[en] Before you start setting up the Paligo integration, make sure that you have configured your Salesforce Instance as described in Vorbereitungen für die Salesforce-Integration. When you have done that, you can set up the Salesforce integration in Paligo. You will then be able to publish from Paligo to Salesforce and use Paligo to delete Salesforce content remotely.

Wenn Sie die Vorbereitung getroffen haben, können Sie Paligo mit Salesforce Knowledge verbinden. Es gibt eine ganze Reihe von Aufgaben zu erledigen, daher haben wir sie in 4 Phasen unterteilt.

Schritt 1: Holen Sie sich die Benutzeranmeldedaten und den Sicherheits-Token

Um sich mit Salesforce zu verbinden, benötigt Paligo verschiedene Details, einschließlich der Benutzeranmeldedaten und eines Sicherheits-Tokens. Um Zugangsdaten und Sicherheits-Token zu erhalten, kann es einfacher sein, von der Lightning Experience-Schnittstelle von Salesforce auf die Classic-Schnittstelle zu wechseln.

Anmerkung

[en] If you are publishing to a Salesforce sandbox and a Salesforce production instance, you need separate user credentials for each instance. Also, you must include both sets of user credentials, even if you are only publishing to the sandbox.

[en] Do not copy the user credentials for one instance into the settings for another instance. You need separate user credentials, including separate tokens, for each instance.

Verwendung der Classic-Schnittstelle:

  1. Stellen Sie sicher, dass die „Permission API“ in Ihrem Salesforce-Konto aktiviert ist. Normalerweise ist dies standardmäßig aktiviert, andernfalls können Sie dies unter Einrichtung in Benutzer > Profile einstellen.

  2. Holen Sie sich die Benutzerzugangsdaten für Salesforce, die Sie für die Verbindung der Integration verwenden möchten.

    Anmerkung

    Wir empfehlen Ihnen, hierfür einen separaten Benutzer anzulegen. Dies kann besonders wichtig sein, damit Sie nicht von einem einzelnen Benutzer abhängig sind, der Ihr Unternehmen möglicherweise verlässt.

  3. Sichern Sie sich den Sicherheits-Token. Möglicherweise haben Sie diesen erhalten, als Sie Ihr Salesforce-Konto erstellt haben. Aber wenn Sie ihn nicht haben, können Sie einen neuen generieren:

    1. Wählen Sie in Salesforce Ihr Profil in der oberen rechten Ecke aus.

    2. Wählen Sie Einstellungen aus.

    3. Suchen Sie im Feld Schnellsuche nach „Token“ und wählen Sie dann Sicherheits-Token zurücksetzen. Sie erhalten per E-Mail einen neuen Sicherheits-Token.

Sie benötigen die Benutzerdaten und den Sicherheits-Token in Schritt 4, wenn Sie die Integrationseinstellungen in Paligo hinzufügen.

Als Nächstes müssen Sie das API-Feld einrichten.

Schritt 2: Inhalts-API-Feldname abrufen

Sie müssen einen API-Feldnamen erhalten, da dies eine weitere Einstellung ist, die für die Paligo-to-Salesforce-Integration erforderlich ist.

  1. Gehen Sie zu Einrichtung in Salesforce.

  2. Suchen Sie im Schnellfinder nach dem Objektmanager und wählen Sie diesen aus.

  3. Wählen Sie im Objektmanager Knowledge.

  4. Erstellen Sie ein Rich-Text-Feld.

    1. Wählen Sie Felder und Beziehungen.

    2. Wählen Sie Neu.

    3. Wählen Sie Textbereich (Rich).

    4. Wählen Sie Weiter aus.

    5. Füllen Sie die Felder aus:

      (Sie können einen anderen Namen wählen, wenn Sie möchten)

      richtextfield.png

      Anmerkung

      Wenn Sie große Artikel veröffentlichen möchten, erhöhen Sie die Länge auf den maximalen Wert. Wenn die Länge zu klein ist, kann dies zu einem Fehler beim Veröffentlichen führen.

    6. Wählen Sie Weiter aus.

    7. Verlassen Sie den nächsten Bildschirm wie gewohnt. Wählen Sie Weiter aus.

    8. Deaktivieren Sie auf dem nächsten Bildschirm alle Kästchen. Wir werden dieses Feld später zu einem neuen Artikeltyp/Seitenlayout hinzufügen.

    9. Drücken Sie Speichern.

  5. Wenn Sie kein vorhandenes Seitenlayout haben, in dem Sie veröffentlichen möchten, können Sie ein neues erstellen.

    newpagelayout.png

  6. Drücken Sie Speichern.

  7. Ziehen Sie Ihr Rich-Text-Feld in den Bereich Knowledge-Detail:

    dragrichtextfield.png
    dragrichtextfield2.png

  8. Erstellen Sie einen neuen Datensatztyp:

    1. Wählen Sie Datensatztypen im linken Menü des Objektmanagers.

    2. Wählen Sie Neu.

    3. Füllen Sie die Felder etwa wie unten aus, aber auch hier können Sie Ihren Namen wählen:

      newrecordtype.png

    4. Wenn Sie es für alle aktivieren möchten, markieren Sie alle Kästchen. Sie müssen es auch als Standard-Datensatztyp für Paligo festlegen, um es veröffentlichen zu können.

      defaultrecordtype.png

  9. Wählen Sie Weiter aus.

  10. Wählen Sie das Seitenlayout, das Sie verwenden möchten.

    selectpagelayout.png

  11. Drücken Sie Speichern.

  12. Holen Sie sich den Inhalt API-Feld für die Paligo-Einstellungen:

    1. Wählen Sie Felder & Beziehungen.

    2. Suchen Sie Ihr Rich-Text-Feld und notieren Sie sich den Feldnamen. Sie benötigen den Feldnamen, wenn Sie die Integrationseinstellungen in Paligo hinzufügen.

      copyrichtextfield.png

Als Nächstes müssen Sie eine verbundene App in Salesforce erstellen.

Schritt 3: Eine Connected App in Salesforce erstellen

Um Paligo mit Salesforce zu verbinden, müssen Sie eine connected App in Salesforce haben.

  1. Gehen Sie zu Einrichtung.

    setup.png

  2. Geben Sie „oauth“ in das Feld Schnellsuche ein und wählen Sie OAuth und OpenID Connect Einstellungen.

    Allow_Oauth_username_Password_flows_small.jpg

  3. Wählen Sie den Schieberegler OAuth Username-Password Flows zulassen, um ihn zu aktivieren.

  4. Geben Sie im Feld Schnellsuche „app“ ein und wählen Sie App-Manager.

    enter-app.png

  5. Erstellen Sie eine neue Connected App.

    new-connected-app.png

  6. Geben Sie einen Namen für die App ein, z. B. Paligo. Der API-Name wird automatisch ausgefüllt.

  7. Geben Sie eine Kontakt-E-Mail-Adresse ein.

  8. Wählen Sie OAuth-Einstellungen aktivieren.

  9. Geben Sie im Feld Callback URL https://login.salesforce.com/services/oauth2/callback ein.

  10. Fügen Sie in der Liste der verfügbaren OAuth-Bereiche Vollen Zugriff (full) zu den ausgewählten OAuth-Bereichen hinzu.

    oauth-scopes.png

  11. Drücken Sie Speichern.

    save-and-wait.png

    Es dauert bis zu 10 Minuten, bis die App in Salesforce einsatzbereit ist.

  12. Notieren Sie sich die Werte Verbraucherschlüssel und Verbraucher-Secret, da Sie diese zu den Integrationseinstellungen in Paligo hinzufügen müssen.

Anschließend können Sie in Paligo die Details zur Salesforce-Integration hinzufügen.

Schritt 4: Paligo mit Salesforce verbinden

Wenn Sie die Schritte 1–3 einschließlich in Salesforce abgeschlossen haben, können Sie die Integrationsdetails zu Paligo hinzufügen.

Wichtig

[en] If you are going to use a Salesforce sandbox instance:

  • [en] Complete the connection details for the production instance. Paligo needs these settings to be in place, even if you don't intend to publish to a production instance.

  • [en] Complete the connection details for the sandbox instance in the dedicated Sandbox section. Only enter details for a sandbox instance in the dedicated sandbox section.

[en] You need to complete both sets of settings. Paligo needs the connection details for the production instance and the sandbox, even if you only intend to publish to the sandbox.

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

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

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

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

    Paligo settings. The Integrations tab is highlighted.

  5. Für die Integration in Salesforce wählen Sie Hinzufügen oder Ändern.

    SalesforceIntegration.jpg

  6. Fügen Sie den Benutzernamen und das Passwort hinzu, die Sie von Salesforce erhalten haben.

    [en] These need to be details for your production environment. Do not enter details for a sandbox environment here.

    Salesforce_Integration.jpg

  7. Fügen Sie den Sicherheits-Token aus Salesforce hinzu.

  8. Fügen Sie den Verbraucherschlüssel und das Verbraucher-Secret hinzu.

  9. Fügen Sie den Namen des Rich-Text-Feldes in das Feld Inhalt Feld API-Name ein.

  10. Wählen Sie aus, ob Paligo Inhalte als Entwurf oder veröffentlichte Artikel in Salesforce veröffentlichen soll.

    Paligo Salesforce integration. The Publish Status section has a Published radio button and a Draft radio button.

  11. Verwenden Sie das Feld benutzerdefiniertes Link-Präfix, um Querverweise anzupassen.

    [en] By default, Paligo uses this syntax for article URLs:

    [en] my-instance.force.com/

    [en] If your articles use this syntax, leave the Custom link prefix field empty.

    [en] If you want to use a different URL structure, enter the required syntax in the Custom link prefix field. For example, if your articles are in an "sa" directory, enter:

    [en] my-instance.force.com/sa/

    Custom_Link_Prefix.jpg

    Anmerkung

    Paligo verwendet das benutzerdefinierte Link-Präfix automatisch jedes Mal, wenn Sie von Paligo in Salesforce veröffentlichen. Es kann jedoch durch ein anderes benutzerdefiniertes Link-Präfix überschrieben werden, das Sie in den Publikationseinstellungen eingeben können, siehe In Salesforce Knowledge veröffentlichen.

  12. Aktivieren Sie das Kontrollkästchen SEO-Links, um das URL-Namensfeld in Salesforce so zu aktualisieren, dass es mit den Topic-Titeln übereinstimmt und SEO-freundlich ist.

    SEO_Links.png

    [en] If you clear the SEO links box , Paligo will generate article URLs based on the UUID of the topics. This creates a URL that contains a number and is less descriptive.

    Diese Einstellung steuert die globale Standardeinstellung, es ist aber auch möglich, diese im Publikationsdialog und in den gespeicherten Publikationseinstellungen zu überschreiben.

    SEO_friendly_Links_Publish_Salesforce.jpg

    Anmerkung

    Es gibt bestimmte Zeichen, die in Salesforce-URL-Namen nicht zulässig sind. Wenn solche Zeichen verwendet werden, werden sie bei der Erstellung von SEO-Links herausgefiltert. Paligo ignoriert dann diese Einstellung und kehrt zur Standard-UUID zurück.

  13. [en] Ignore the Smart restore box. This feature is being gradually retired. Use the Match articles based on URL setting to fix broken mapping instead (see [en] Fix Broken Mapping for Salesforce).

  14. Wählen Sie aus, ob Paligo die URL-Felder Ihrer Artikel aktualisiert, wenn Sie sie in Salesforce veröffentlichen:

    • [en] Check the Always update URL Name Fields box to allow Paligo to create new URLs and change existing ones in Salesforce Knowledge. It will create URLs based on the UUID or title of mapped topics, depending on how you have set SEO links (see step 13) and SEO Friendly Links in the publishing settings (see In Salesforce Knowledge veröffentlichen).

      [en] Paligo can only update the URLs of articles that map to topics in Paligo.

    • [en] Clear the Always Update URL Name Fields box to prevent Paligo from changing URLs for articles. It can only generate URLs for new articles that it is publishing to Salesforce Knowledge for the first time.

  15. Wenn Sie in einer Salesforce-Sandbox statt in Ihrem Produktions-Salesforce-Knowledge veröffentlichen möchten.

    1. Aktivieren Sie das Kontrollkästchen In Sandbox veröffentlichen.

      Deaktivieren Sie das Kontrollkästchen, wenn Sie zurück zur Veröffentlichung im Produktions-Salesforce-Knowledge wechseln möchten.

    2. Geben Sie die Verbindungsdetails für die Sandbox ein: Dies sind der Sandbox-Benutzername, das Sandbox-Passwort und das Sandbox-Token (Sicherheitstoken).

      Anmerkung

      [en] The user in the sandbox instance does not have to be a user in the production instance as well.

    Wenn die Einstellungen vorgenommen sind, veröffentlicht Paligo in Ihrer Sandbox, wenn In Sandbox veröffentlichen aktiviert ist. Es wird in Ihrem Produktions-Salesforce-Knowledge veröffentlicht, wenn In Sandbox veröffentlichen deaktiviert ist.

  16. Drücken Sie Speichern.

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

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

    Test_Reset_Settings_Integrations_small.jpg

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

Sie sollten nun in der Lage sein, von Paligo aus in Salesforce Knowledge zu veröffentlichen. Sie können das integrierte Salesforce Knowledge oder verschachteltes Salesforce-Layout verwenden oder Ihr eigenes erstellen.

[en] For instructions on how to publish from Paligo to Salesforce Knowledge, see In Salesforce Knowledge veröffentlichen.

Anmerkung

[en] When you publish articles as drafts in Salesforce, they will have basic formatting. To make them more visually appealing, you can set up Salesforce to publish the articles to a Salesforce Community that uses a help center theme.

Die Ansicht „Lightning Experience“ in Salesforce kann ein wenig inkonsistent sein, was die Anzeige von Artikelentwürfen angeht. Wenn Sie sie in dieser Ansicht nicht sehen, wechseln Sie in den „klassischen Modus“ und wählen Sie die Ansicht von Entwurfsartikeln.