Konfigurieren Sie Acrolinx für Ihre Anforderungen in Salesforce.
Anmerkung
Zum Einrichten von Acrolinx for Salesforce Knowledge benötigen Sie Admin-Berechtigungen in Salesforce.
So richten Sie Acrolinx für Salesforce Knowledge ein:
Aktivieren Sie Cross-Origin Resource Sharing (CORS) zwischen Salesforce und Ihrer Acrolinx-Plattform. Lesen Sie dazu unseren Artikel über das Aktivieren von CORS.
Einrichten von SSOMit SSO können Sie das browserbasierte Anmeldeverfahren für die Acrolinx Sidebar überspringen. Erfahren Sie, wie Sie Acrolinx für SSO einrichten.
Sobald Sie SSO aktiviert haben, klicken Sie im Acrolinx Setup auf den Schalter neben Use SSO. Geben Sie Ihr Passwort in das Feld Password ein.
Um Acrolinx für Salesforce zu verwenden, benötigen Autor*innen Zugriff auf die Knowledge Base und einen dieser beiden Berechtigungssätze:
-
Acrolinx User — hat Zugriff auf die Funktionen von Acrolinx für Salesforce.
-
Acrolinx Admin — hat Zugriff auf den Acrolinx User und kann auf die Verwaltungsseite zugreifen. Dort können Sie Protokolle, Stapelprüfungsergebnisse und andere von einem*r Systemadmin eingerichtete Optionen einsehen.
Um Acrolinx für Salesforce verwenden zu können, benötigen Autor*innen Zugriff auf die Knowledge Base und den Berechtigungssatz Acrolinx User oder Acrolinx Admin.
So weisen Sie eine oder beide Acrolinx-Berechtigungen zu:
-
Geben Sie im Setup in das Feld Quick Find das Wort „Users“ ein. Wählen Sie Users aus.
-
Klicken Sie auf den Namen der Person, der Sie Berechtigungen zuweisen möchten. Dadurch wird das entsprechende Profil geöffnet.
-
Navigieren Sie zum Abschnitt Permission Set Assignments des Profils und klicken Sie auf Edit Assignments.
-
Wählen Sie einen Berechtigungssatz in der Spalte Available Permission Sets aus, und klicken Sie auf Add, um sie in die Spalte Enabled Permission Sets zu verschieben.
Anmerkung
Wenn ein*e Benutzer*in Stapelprüfungen durchführen soll, müssen Sie auch die Berechtigung „Run Flows“ zur Spalte Enabled Permission Sets hinzufügen.
-
Klicken Sie auf Save.
So generieren Sie den Private Key und das Serverzertifikat mithilfe der OpenSSL-Bibliothek:
Tipp
Sie haben kein OpenSSL? Erfahren Sie, wie Sie es installieren.
-
Führen Sie den folgenden Befehl aus, um einen Private Key zu generieren. Der Befehl wird Ihnen eine
server.pass.key-Datei zurückgeben.openssl genrsa -des3 -passout pass:x -out server.pass.key 2048
-
Verwenden Sie die Datei
server.pass.key, um mit dem folgenden Befehl eine weitere Schlüsseldatei zu erstellen:openssl rsa -passin pass:x -in server.pass.key -out server.key
Damit erhalten Sie Ihre Datei
server.key. Die Dateiserver.keyist Ihr privater RSA-Schlüssel. -
Mit dem folgenden Befehl fordern Sie das Zertifikat an und generieren es:
openssl req -new -key server.key -out server.csr
Wenn Sie den Befehl ausgeführt haben, müssen Sie einige Informationen angeben:
-
Country Name: <Ihr Land>
-
State or Province Name: <Ihr Bundesland>
-
Locality Name (city): <Ihre Stadt>
-
Organization Name: <Ihr Unternehmen>
-
Organization Unit Name: <Ihr Unternehmen>
-
Common Name: <Optional>
-
Email Address: <Ihre Email-Adresse>
-
-
Generieren Sie das SSL-Zertifikat mit dem folgenden Befehl:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
Damit erhalten Sie Ihre
Server.crt-Datei.Server.Crtist Ihr digitales Signaturzertifikat.
Tipp
Bewahren Sie die von Ihnen generierten Schlüssel an einem sicheren Ort auf – insbesondere die Schlüssel aus den Schritten 2 und 4.
Wenn Sie Acrolinx in Salesforce Knowledge öffnen, sehen Sie eine Registerkarte für den Acrolinx Setup Guide. Hier erfahren Sie, wie Sie Acrolinx konfigurieren und die Verbindung zur Acrolinx-Plattform herstellen.
Öffnen Sie zunächst Acrolinx in Salesforce und gehen Sie zu Acrolinx Setup Guide > Set up Acrolinx (Required).
Hinweis
Bevor Sie beginnen: Stellen Sie sicher, dass Sie den Schritt „Generate Private Key and Server Certificate“ im Abschnitt Vorbereiten Ihrer Instanz abgeschlossen haben.
Mit verbundenen Anwendungen können Sie externe Anwendungen in Salesforce integrieren.
Fügen Sie eine neue verbundene Anwendung über den App-Manager hinzu und geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Connected App Name: |
Der eindeutige Name, der im App-Manager und in der Startfeld der App angezeigt wird. Verwenden Sie diesen Namen nicht noch einmal innerhalb Ihrer Organisation. |
|
API Name |
Der API-Name, der verwendet wird, wenn von einem Programm aus auf Ihre Anwendung verwiesen wird. Standardmäßig enthält dieser Name keine Leerzeichen. Sie können nur Buchstaben, Zahlen und Unterstriche eingeben. |
|
Contact Email |
Die Kontakt-E-Mail für Sie oder Ihr Support-Team. |
|
Enable OAuth Settings |
Zugriff auf Salesforce-Daten durch eine externe Anwendung (in diesem Fall Acrolinx) gewähren. |
|
Callback URL |
Der Endpunkt, den Salesforce während OAuth zurück zu Ihrer Anwendung sendet. Er ist derselbe wie der OAuth-Redirect-URI. Je nachdem, welchen OAuth-Flow Sie verwenden, ist die URL in der Regel diejenige, an die der Browser eines*r Benutzers*in nach erfolgreicher Autorisierung weitergeleitet wird. Stellen Sie sicher, dass die URL sicheres HTTPS oder ein benutzerdefiniertes URI-Schema verwendet. |
|
Use digital signatures |
Wählen Sie aus, ob Sie den JWT OAuth-Flow verwenden. Fügen Sie das Zertifikat auf Ihrem System hinzu, um es für den JWT OAuth-Flow hochzuladen. Die Zertifikatsgröße ist auf 4 KB begrenzt. |
|
Selected OAuth Scopes |
OAuth-Bereiche definieren Berechtigungen für die verbundene Anwendung. Diese werden als Token vergeben, nachdem die App autorisiert wurde. Manage user data via APIs (api) – Ermöglicht den Zugriff auf das Konto des*r aktuellen, angemeldeten Benutzer*i über APIs. Perform requests at any time (refresh_token, offline_access) - Ermöglicht die Rückgabe eines Aktualisierungstokens, wenn der anfragende Client zum Empfang berechtigt ist. Mit einem Aktualisierungstoken kann die App mit den Daten des*der Nutzers*in interagieren, während diese*r offline ist. Dieses Token ist gleichbedeutend mit der Anforderung von offline_access. |
Sobald Sie diese Informationen hinzugefügt haben, müssen Sie die Schritte im Setup Guide als Done markieren.
In diesem Schritt erstellen Sie einen neuen Berechtigungssatz für die Acrolinx Sidebar und weisen ihn Ihren Benutzer*innen zu.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Label |
Die Bezeichnung des Berechtigungssatzes, die dem „Label“ in der Bedienoberfläche entspricht. Limit: 80 Zeichen. |
|
API Name |
Der eindeutige Name des Objekts in der API. Dieser Name darf nur Unterstriche und alphanumerische Zeichen enthalten und muss in Ihrer Organisation eindeutig sein. Er muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten, nicht mit einem Unterstrich enden und nicht zwei aufeinander folgende Unterstriche enthalten. |
Klicken Sie auf Edit, um den Consumer Key aus der verbundenen Anwendung und den Private Key hinzuzufügen, den Sie im Abschnitt Vorbereiten Ihrer Instanz im Acrolinx für Salesforce Knowledge Admin Guide erstellt haben.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Consumer Key |
Identifiziert den Kunden gegenüber Salesforce. Ein Kundengeheimnis etabliert den Besitz des Customer Keys. |
|
Private Key |
Wird für die Verschlüsselung/Entschlüsselung von Daten verwendet, die zwischen Ihrem Server und Salesforce gesendet werden. Sie erstellen ihn, wenn Sie Ihr Zertifikat mit einer Certificate Signing Request (CSR) anfordern. |
Nachdem Sie die Informationen hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Verbinden Sie sich über Salesforce mit der Acrolinx-Plattform.
In diesem Schritt geben Sie die eindeutige Acrolinx-URL an, fügen sie zu den Remote-Site-Einstellungen hinzu und richten SSO ein.
In diesem Schritt fügen Sie Komponenten zur Record-Seite in Salesforce hinzu, damit Sie Artikel mit Acrolinx prüfen und den Acrolinx Score anzeigen können.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die Stapelprüfung umfasst.
Legen Sie die maximale Anzahl paralleler Prüfungen fest und klicken Sie auf Add, um die Stapelprüfung in der Listenansicht zu aktivieren.
Nachdem Sie eine Schaltfläche zum List View Button Layout hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Anmerkung
Wenn Sie sowohl die Stapelprüfung als auch die automatisierte Prüfung verwenden, gelten alle Felder, die Sie hinzufügen, für beide Prüfungsarten. Wenn Sie z. B. Felder für die Stapelprüfung konfigurieren, werden diese automatisch auch für die automatisierte Prüfung konfiguriert.
In diesem Schritt können Sie Acrolinx-spezifische Felder zum Knowledge-Objekt hinzufügen, damit wichtige Prüfinformationen dort erscheinen, wo Sie sie brauchen. Für Sidebar-Prüfungen ist dieser Schritt optional. Wenn Ihre Lizenz die automatisierte Prüfung beinhaltet, sind diese Felder erforderlich.
Sie können die Felder benennen, wie Sie möchten. Im Folgenden sind einige Vorschläge:
Tipp
Um ein Feld anzuzeigen, müssen Sie es zum Layout der Record-Seite hinzufügen.
|
Feld-Bezeichnung |
Beschreibung |
|---|---|
|
Acrolinx Score |
Feld zum Speichern des Acrolinx Scores. |
|
Acrolinx Scorecard |
Feld zum Speichern eines Links zur Acrolinx Scorecard. |
|
Embed Scorecard |
Feld zum Einbetten des Links zur Acrolinx Scorecard unter dem Acrolinx Score. |
|
Last Checked |
Fügen Sie ein Feld hinzu, um das Datum der letzten Prüfung des Artikels zu speichern. |
|
Score Status |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ gespeichert wird. |
|
Score Color |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ angezeigt wird. |
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die automatisierte Prüfung umfasst.
Klicken Sie auf Apply, um einen Flow zu erstellen, der eine automatisierte Acrolinx-Prüfung startet, wenn Sie einen Artikel speichern oder aktualisieren.
Anmerkung
Wenn Sie auf Acrolinx für Salesforce Knowledge Version 3.6 aktualisieren möchten, stellen Sie sicher, dass Sie den Trigger deaktivieren, den Sie in früheren Versionen von Acrolinx für Salesforce Knolwedge eingerichtet haben, bevor Sie auf Apply klicken.
Überprüfen Sie die Logik des Flows und markieren Sie den Schritt als Done.
Anmerkung
Wenn Sie sowohl die Stapelprüfung als auch die automatisierte Prüfung verwenden, gelten alle Felder, die Sie hinzufügen, für beide Prüfungsarten. Wenn Sie z. B. Felder für die automatisierte Prüfung konfigurieren, werden diese automatisch auch für die Stapelprüfung konfiguriert.
In diesem Schritt können Sie Acrolinx-spezifische Felder zum Knowledge-Objekt hinzufügen, damit wichtige Prüfinformationen dort erscheinen, wo Sie sie brauchen. Für Sidebar-Prüfungen ist dieser Schritt optional. Wenn Ihre Lizenz die automatisierte Prüfung beinhaltet, sind diese Felder erforderlich.
Sie können die Felder benennen, wie Sie möchten. Im Folgenden sind einige Vorschläge:
Tipp
Um ein Feld anzuzeigen, müssen Sie es zum Layout der Record-Seite hinzufügen.
|
Feld-Bezeichnung |
Beschreibung |
|---|---|
|
Acrolinx Score |
Feld zum Speichern des Acrolinx Scores. |
|
Acrolinx Scorecard |
Feld zum Speichern eines Links zur Acrolinx Scorecard. |
|
Embed Scorecard |
Feld zum Einbetten des Links zur Acrolinx Scorecard unter dem Acrolinx Score. |
|
Last Checked |
Fügen Sie ein Feld hinzu, um das Datum der letzten Prüfung des Artikels zu speichern. |
|
Score Status |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ gespeichert wird. |
|
Score Color |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ angezeigt wird. |
Mit diesem Schritt können Sie bestimmte Knowledge-Artikel-Felder von einer Acrolinx-Prüfung ausschließen. Diese werden auch auf der Seite „Edit with Acrolinx“ ausgeblendet.
Gehen Sie auf die Registerkarte Customize the "Edit with Acrolinx" Page (Optional). Klicken Sie dann auf Add, um ein neues Feldset für die Felder zu erstellen, die Sie ausschließen möchten.
Wenn Sie das Feldset mit den gewünschten Feldern konfiguriert haben, markieren Sie den Schritt als Done.
Hinweis
Zudem müssen Sie Ihr Salesforce Content-Profil aktualisieren, um diese Felder auszuschließen.
So aktualisieren Sie Ihr Content-Profil:
Hinweis
Wenn Sie Acrolinx für Salesforce Knowledge Version 3.8 zum ersten Mal installieren, lädt Acrolinx standardmäßig den Acrolinx Lightning Editor (CKEditor). Wenn Sie zum neuen Acrolinx Lightning Editor (TinyMCE) wechseln möchten, sind die folgenden Schritte erforderlich.
Um den Acrolinx Lightning Editor (TinyMCE) zu verwenden, gehen Sie wie folgt vor:
-
Gehen Sie zu Setup > Custom Settings.
-
Klicken Sie neben Acrolinx Configuration Settings auf Manage.
-
Wenn es keine Datensätze gibt, klicken Sie auf New. Falls es einen Datensatz gibt, klicken Sie auf Edit.
-
Klicken Sie auf das Kontrollkästchen neben Enable Acrolinx Lightning Editor.
-
Klicken Sie auf Save.
Wenn Sie den Cache sofort nach einer Änderung des Knowledge-Layouts löschen möchten, können Sie dies über die Befehlszeile tun. Andernfalls wird der Cache automatisch aktualisiert. Die automatische Aktualisierung dauert 6 Stunden.
So löschen Sie den Cache sofort:
-
Öffnen Sie zunächst Acrolinx in Salesforce und klicken Sie auf Acrolinx Setup Guide.
-
Klicken Sie auf die Registerkarte Clear Cache for Batch Checking (Optional).
-
Wählen Sie eine*n Benutzer*in aus der Dropdown-Liste und klicken Sie auf Clear Cache.
Anmerkung
Der Cache kann nur für einen bestimmte*n Benutzer*in geleert werden. Das Löschen für eine Gruppe von Benutzer*innen ist nicht möglich.
Aktivieren Sie Cross-Origin Resource Sharing (CORS) zwischen Salesforce und Ihrer Acrolinx-Plattform. Lesen Sie dazu unseren Artikel über das Aktivieren von CORS.
Einrichten von SSOMit SSO können Sie das browserbasierte Anmeldeverfahren für die Acrolinx Sidebar überspringen. Erfahren Sie, wie Sie Acrolinx für SSO einrichten.
Sobald Sie SSO aktiviert haben, klicken Sie im Acrolinx Setup auf den Schalter neben Use SSO. Geben Sie Ihr Passwort in das Feld Password ein.
Um Acrolinx für Salesforce zu verwenden, benötigen Autor*innen Zugriff auf die Knowledge Base und einen dieser beiden Berechtigungssätze:
-
Acrolinx User — hat Zugriff auf die Funktionen von Acrolinx für Salesforce.
-
Acrolinx Admin — hat Zugriff auf den Acrolinx User und kann auf die Verwaltungsseite zugreifen. Dort können Sie Protokolle, Stapelprüfungsergebnisse und andere von einem*r Systemadmin eingerichtete Optionen einsehen.
Um Acrolinx für Salesforce verwenden zu können, benötigen Autor*innen Zugriff auf die Knowledge Base und den Berechtigungssatz Acrolinx User oder Acrolinx Admin.
So weisen Sie eine oder beide Acrolinx-Berechtigungen zu:
-
Geben Sie im Setup in das Feld Quick Find das Wort „Users“ ein. Wählen Sie Users aus.
-
Klicken Sie auf den Namen der Person, der Sie Berechtigungen zuweisen möchten. Dadurch wird das entsprechende Profil geöffnet.
-
Navigieren Sie zum Abschnitt Permission Set Assignments des Profils und klicken Sie auf Edit Assignments.
-
Wählen Sie einen Berechtigungssatz in der Spalte Available Permission Sets aus, und klicken Sie auf Add, um sie in die Spalte Enabled Permission Sets zu verschieben.
Anmerkung
Wenn ein*e Benutzer*in Stapelprüfungen durchführen soll, müssen Sie auch die Berechtigung „Run Flows“ zur Spalte Enabled Permission Sets hinzufügen.
-
Klicken Sie auf Save.
So generieren Sie den Private Key und das Serverzertifikat mithilfe der OpenSSL-Bibliothek:
Tipp
Sie haben kein OpenSSL? Erfahren Sie, wie Sie es installieren.
-
Führen Sie den folgenden Befehl aus, um einen Private Key zu generieren. Der Befehl wird Ihnen eine
server.pass.key-Datei zurückgeben.openssl genrsa -des3 -passout pass:x -out server.pass.key 2048
-
Verwenden Sie die Datei
server.pass.key, um mit dem folgenden Befehl eine weitere Schlüsseldatei zu erstellen:openssl rsa -passin pass:x -in server.pass.key -out server.key
Damit erhalten Sie Ihre Datei
server.key. Die Dateiserver.keyist Ihr privater RSA-Schlüssel. -
Mit dem folgenden Befehl fordern Sie das Zertifikat an und generieren es:
openssl req -new -key server.key -out server.csr
Wenn Sie den Befehl ausgeführt haben, müssen Sie einige Informationen angeben:
-
Country Name: <Ihr Land>
-
State or Province Name: <Ihr Bundesland>
-
Locality Name (city): <Ihre Stadt>
-
Organization Name: <Ihr Unternehmen>
-
Organization Unit Name: <Ihr Unternehmen>
-
Common Name: <Optional>
-
Email Address: <Ihre Email-Adresse>
-
-
Generieren Sie das SSL-Zertifikat mit dem folgenden Befehl:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
Damit erhalten Sie Ihre
Server.crt-Datei.Server.Crtist Ihr digitales Signaturzertifikat.
Tipp
Bewahren Sie die von Ihnen generierten Schlüssel an einem sicheren Ort auf – insbesondere die Schlüssel aus den Schritten 2 und 4.
Wenn Sie Acrolinx in Salesforce Knowledge öffnen, sehen Sie eine Registerkarte für den Acrolinx Setup Guide. Hier erfahren Sie, wie Sie Acrolinx konfigurieren und die Verbindung zur Acrolinx-Plattform herstellen.
Öffnen Sie dazu Acrolinx in Salesforce und klicken Sie auf Acrolinx Setup Guide.
Hinweis
Bevor Sie beginnen: Stellen Sie sicher, dass Sie den Schritt „Generate Private Key and Server Certificate“ im Abschnitt Vorbereiten Ihrer Instanz abgeschlossen haben.
Mit verbundenen Anwendungen können Sie externe Anwendungen in Salesforce integrieren.
Fügen Sie eine neue verbundene Anwendung über den App-Manager hinzu und geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Connected App Name: |
Der eindeutige Name, der im App-Manager und in der Startfeld der App angezeigt wird. Verwenden Sie diesen Namen nicht noch einmal innerhalb Ihrer Organisation. |
|
API Name |
Der API-Name, der verwendet wird, wenn von einem Programm aus auf Ihre Anwendung verwiesen wird. Standardmäßig enthält dieser Name keine Leerzeichen. Sie können nur Buchstaben, Zahlen und Unterstriche eingeben. |
|
Contact Email |
Die Kontakt-E-Mail für Sie oder Ihr Support-Team. |
|
Enable OAuth Settings |
Zugriff auf Salesforce-Daten durch eine externe Anwendung (in diesem Fall Acrolinx) gewähren. |
|
Callback URL |
Der Endpunkt, den Salesforce während OAuth zurück zu Ihrer Anwendung sendet. Er ist derselbe wie der OAuth-Redirect-URI. Je nachdem, welchen OAuth-Flow Sie verwenden, ist die URL in der Regel diejenige, an die der Browser eines*r Benutzers*in nach erfolgreicher Autorisierung weitergeleitet wird. Stellen Sie sicher, dass die URL sicheres HTTPS oder ein benutzerdefiniertes URI-Schema verwendet. |
|
Use digital signatures |
Wählen Sie aus, ob Sie den JWT OAuth-Flow verwenden. Fügen Sie das Zertifikat auf Ihrem System hinzu, um es für den JWT OAuth-Flow hochzuladen. Die Zertifikatsgröße ist auf 4 KB begrenzt. |
|
Selected OAuth Scopes |
OAuth-Bereiche definieren Berechtigungen für die verbundene Anwendung. Diese werden als Token vergeben, nachdem die App autorisiert wurde. Manage user data via APIs (api) – Ermöglicht den Zugriff auf das Konto des*r aktuellen, angemeldeten Benutzer*i über APIs. Perform requests at any time (refresh_token, offline_access) - Ermöglicht die Rückgabe eines Aktualisierungstokens, wenn der anfragende Client zum Empfang berechtigt ist. Mit einem Aktualisierungstoken kann die App mit den Daten des*der Nutzers*in interagieren, während diese*r offline ist. Dieses Token ist gleichbedeutend mit der Anforderung von offline_access. |
Sobald Sie diese Informationen hinzugefügt haben, müssen Sie die Schritte im Setup Guide als Done markieren.
In diesem Schritt erstellen Sie einen neuen Berechtigungssatz für die Acrolinx Sidebar und weisen ihn Ihren Benutzer*innen zu.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Label |
Die Bezeichnung des Berechtigungssatzes, die dem „Label“ in der Bedienoberfläche entspricht. Limit: 80 Zeichen. |
|
API Name |
Der eindeutige Name des Objekts in der API. Dieser Name darf nur Unterstriche und alphanumerische Zeichen enthalten und muss in Ihrer Organisation eindeutig sein. Er muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten, nicht mit einem Unterstrich enden und nicht zwei aufeinander folgende Unterstriche enthalten. |
Klicken Sie auf Edit, um den Consumer Key aus der verbundenen Anwendung und den Private Key hinzuzufügen, den Sie im Abschnitt Vorbereiten Ihrer Instanz im Acrolinx für Salesforce Knowledge Admin Guide erstellt haben.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Consumer Key |
Identifiziert den Kunden gegenüber Salesforce. Ein Kundengeheimnis etabliert den Besitz des Customer Keys. |
|
Private Key |
Wird für die Verschlüsselung/Entschlüsselung von Daten verwendet, die zwischen Ihrem Server und Salesforce gesendet werden. Sie erstellen ihn, wenn Sie Ihr Zertifikat mit einer Certificate Signing Request (CSR) anfordern. |
Nachdem Sie die Informationen hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Verbinden Sie sich über Salesforce mit der Acrolinx-Plattform.
In diesem Schritt geben Sie die eindeutige Acrolinx-URL an, fügen sie zu den Remote-Site-Einstellungen hinzu und richten SSO ein.
In diesem Schritt können Sie Acrolinx-spezifische Felder zum Knowledge-Objekt hinzufügen, damit wichtige Prüfinformationen dort erscheinen, wo Sie sie brauchen. Für Sidebar-Prüfungen ist dieser Schritt optional. Wenn Ihre Lizenz die automatisierte Prüfung beinhaltet, sind diese Felder erforderlich.
Sie können die Felder benennen, wie Sie möchten. Im Folgenden sind einige Vorschläge:
Tipp
Um ein Feld anzuzeigen, müssen Sie es zum Layout der Record-Seite hinzufügen.
|
Feld-Bezeichnung |
Beschreibung |
|---|---|
|
Acrolinx Score |
Feld zum Speichern des Acrolinx Scores. |
|
Acrolinx Scorecard |
Feld zum Speichern eines Links zur Acrolinx Scorecard. |
|
Embed Scorecard |
Feld zum Einbetten des Links zur Acrolinx Scorecard unter dem Acrolinx Score. |
|
Last Checked |
Fügen Sie ein Feld hinzu, um das Datum der letzten Prüfung des Artikels zu speichern. |
|
Score Status |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ gespeichert wird. |
|
Score Color |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ angezeigt wird. |
In diesem Schritt fügen Sie Komponenten zur Record-Seite in Salesforce hinzu, damit Sie Artikel mit Acrolinx prüfen und den Acrolinx Score anzeigen können.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die Stapelprüfung umfasst.
Legen Sie die maximale Anzahl paralleler Prüfungen fest und klicken Sie auf Add, um die Stapelprüfung in der Listenansicht zu aktivieren.
Nachdem Sie eine Schaltfläche zum List View Button Layout hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die automatisierte Prüfung umfasst.
Klicken Sie auf Apply, um einen Flow zu erstellen, der eine automatisierte Acrolinx-Prüfung startet, wenn Sie einen Artikel speichern oder aktualisieren.
Anmerkung
Wenn Sie auf Acrolinx für Salesforce Knowledge Version 3.6 aktualisieren möchten, stellen Sie sicher, dass Sie den Trigger deaktivieren, den Sie in früheren Versionen von Acrolinx für Salesforce Knolwedge eingerichtet haben, bevor Sie auf Apply klicken.
Überprüfen Sie die Logik des Flows und markieren Sie den Schritt als Done.
Mit diesem Schritt können Sie bestimmte Knowledge-Artikel-Felder von einer Acrolinx-Prüfung ausschließen. Diese werden auch auf der Seite „Edit with Acrolinx“ ausgeblendet.
Klicken Sie auf Add, um ein neues Feldset für die Felder zu erstellen, die Sie ausschließen möchten.
Wenn Sie das Feldset mit den gewünschten Feldern konfiguriert haben, markieren Sie den Schritt als Done.
Hinweis
Zudem müssen Sie Ihr Salesforce Content-Profil aktualisieren, um diese Felder auszuschließen.
So aktualisieren Sie Ihr Content-Profil:
Hinweis
Wenn Sie Acrolinx für Salesforce Knowledge Version 3.8 zum ersten Mal installieren, lädt Acrolinx standardmäßig den Acrolinx Lightning Editor (CKEditor). Wenn Sie zum neuen Acrolinx Lightning Editor (TinyMCE) wechseln möchten, sind die folgenden Schritte erforderlich.
Um den Acrolinx Lightning Editor (TinyMCE) zu verwenden, gehen Sie wie folgt vor:
-
Gehen Sie zu Setup > Custom Settings.
-
Klicken Sie neben Acrolinx Configuration Settings auf Manage.
-
Wenn es keine Datensätze gibt, klicken Sie auf New. Falls es einen Datensatz gibt, klicken Sie auf Edit.
-
Klicken Sie auf das Kontrollkästchen neben Enable Acrolinx Lightning Editor.
-
Klicken Sie auf Save.
Wenn Sie den Cache sofort nach einer Änderung des Knowledge-Layouts löschen möchten, können Sie dies über die Befehlszeile tun. Andernfalls wird der Cache automatisch aktualisiert. Die automatische Aktualisierung dauert 6 Stunden.
So löschen Sie den Cache sofort:
-
Gehen Sie zu Setup > Developer Console.
-
Klicken Sie auf Debug > Open Execute Anonymous Window.
-
Fügen Sie die Codezeile in das Fenster Enter Apex Code ein.
-
Um den Cache für den*die aktuelle*n Benutzer*in zu löschen, fügen Sie die folgende Codezeile in das Fenster Enter Apex Code ein.
AcrolinxApp.AcrolinxCache.clear(Knowledge__kav.getSObjec tType());
-
Um den Cache für eine*n andere*n Benutzer*in zu löschen, geben Sie die entsprechende Salesforce ID als zweiten Parameter ein. Zum Beispiel:
AcrolinxApp.AcrolinxCache.clear(Knowledge__kav.getSObjec tType(), '0058N000005Uy9IQAS');
-
-
Klicken Sie auf Execute. Wenn der Cache-Wert erfolgreich entfernt wurde, sehen Sie
true.
Hinweis
Standardmäßig lautet das Präfix für diesen Objektnamen Knowledge. Sie können dieses Präfix über den Objektnamen für das Objekt Knowledge__kav im Object Manager ändern. Stellen Sie sicher, dass Sie den API-Namen des Knowledge-Objekts im Object Manager überprüfen.
Aktivieren Sie Cross-Origin Resource Sharing (CORS) zwischen Salesforce und Ihrer Acrolinx-Plattform. Lesen Sie dazu unseren Artikel über das Aktivieren von CORS.
Einrichten von SSOMit SSO können Sie das browserbasierte Anmeldeverfahren für die Acrolinx Sidebar überspringen. Erfahren Sie, wie Sie Acrolinx für SSO einrichten.
Sobald Sie SSO aktiviert haben, klicken Sie im Acrolinx Setup auf den Schalter neben Use SSO. Geben Sie Ihr Passwort in das Feld Password ein.
Um Acrolinx für Salesforce zu verwenden, benötigen Autor*innen Zugriff auf die Knowledge Base und einen dieser beiden Berechtigungssätze:
-
Acrolinx User — hat Zugriff auf die Funktionen von Acrolinx für Salesforce.
-
Acrolinx Admin — hat Zugriff auf den Acrolinx User und kann auf die Verwaltungsseite zugreifen. Dort können Sie Protokolle, Stapelprüfungsergebnisse und andere von einem*r Systemadmin eingerichtete Optionen einsehen.
Um Acrolinx für Salesforce verwenden zu können, benötigen Autor*innen Zugriff auf die Knowledge Base und den Berechtigungssatz Acrolinx User oder Acrolinx Admin.
So weisen Sie eine oder beide Acrolinx-Berechtigungen zu:
-
Geben Sie im Setup in das Feld Quick Find das Wort „Users“ ein. Wählen Sie Users aus.
-
Klicken Sie auf den Namen der Person, der Sie Berechtigungen zuweisen möchten. Dadurch wird das entsprechende Profil geöffnet.
-
Navigieren Sie zum Abschnitt Permission Set Assignments des Profils und klicken Sie auf Edit Assignments.
-
Wählen Sie einen Berechtigungssatz in der Spalte Available Permission Sets aus, und klicken Sie auf Add, um sie in die Spalte Enabled Permission Sets zu verschieben.
Anmerkung
Wenn ein*e Benutzer*in Stapelprüfungen durchführen soll, müssen Sie auch die Berechtigung „Run Flows“ zur Spalte Enabled Permission Sets hinzufügen.
-
Klicken Sie auf Save.
So generieren Sie den Private Key und das Serverzertifikat mithilfe der OpenSSL-Bibliothek:
Tipp
Sie haben kein OpenSSL? Erfahren Sie, wie Sie es installieren.
-
Führen Sie den folgenden Befehl aus, um einen Private Key zu generieren. Der Befehl wird Ihnen eine
server.pass.key-Datei zurückgeben.openssl genrsa -des3 -passout pass:x -out server.pass.key 2048
-
Verwenden Sie die Datei
server.pass.key, um mit dem folgenden Befehl eine weitere Schlüsseldatei zu erstellen:openssl rsa -passin pass:x -in server.pass.key -out server.key
Damit erhalten Sie Ihre Datei
server.key. Die Dateiserver.keyist Ihr privater RSA-Schlüssel. -
Mit dem folgenden Befehl fordern Sie das Zertifikat an und generieren es:
openssl req -new -key server.key -out server.csr
Wenn Sie den Befehl ausgeführt haben, müssen Sie einige Informationen angeben:
-
Country Name: <Ihr Land>
-
State or Province Name: <Ihr Bundesland>
-
Locality Name (city): <Ihre Stadt>
-
Organization Name: <Ihr Unternehmen>
-
Organization Unit Name: <Ihr Unternehmen>
-
Common Name: <Optional>
-
Email Address: <Ihre Email-Adresse>
-
-
Generieren Sie das SSL-Zertifikat mit dem folgenden Befehl:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
Damit erhalten Sie Ihre
Server.crt-Datei.Server.Crtist Ihr digitales Signaturzertifikat.
Tipp
Bewahren Sie die von Ihnen generierten Schlüssel an einem sicheren Ort auf – insbesondere die Schlüssel aus den Schritten 2 und 4.
Wenn Sie Acrolinx in Salesforce Knowledge öffnen, sehen Sie eine Registerkarte für den Acrolinx Setup Guide. Hier erfahren Sie, wie Sie Acrolinx konfigurieren und die Verbindung zur Acrolinx-Plattform herstellen.
Öffnen Sie dazu Acrolinx in Salesforce und klicken Sie auf Acrolinx Setup Guide.
Hinweis
Bevor Sie beginnen: Stellen Sie sicher, dass Sie den Schritt „Generate Private Key and Server Certificate“ im Abschnitt Vorbereiten Ihrer Instanz abgeschlossen haben.
Mit verbundenen Anwendungen können Sie externe Anwendungen in Salesforce integrieren.
Fügen Sie eine neue verbundene Anwendung über den App-Manager hinzu und geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Connected App Name: |
Der eindeutige Name, der im App-Manager und in der Startfeld der App angezeigt wird. Verwenden Sie diesen Namen nicht noch einmal innerhalb Ihrer Organisation. |
|
API Name |
Der API-Name, der verwendet wird, wenn von einem Programm aus auf Ihre Anwendung verwiesen wird. Standardmäßig enthält dieser Name keine Leerzeichen. Sie können nur Buchstaben, Zahlen und Unterstriche eingeben. |
|
Contact Email |
Die Kontakt-E-Mail für Sie oder Ihr Support-Team. |
|
Enable OAuth Settings |
Zugriff auf Salesforce-Daten durch eine externe Anwendung (in diesem Fall Acrolinx) gewähren. |
|
Callback URL |
Der Endpunkt, den Salesforce während OAuth zurück zu Ihrer Anwendung sendet. Er ist derselbe wie der OAuth-Redirect-URI. Je nachdem, welchen OAuth-Flow Sie verwenden, ist die URL in der Regel diejenige, an die der Browser eines*r Benutzers*in nach erfolgreicher Autorisierung weitergeleitet wird. Stellen Sie sicher, dass die URL sicheres HTTPS oder ein benutzerdefiniertes URI-Schema verwendet. |
|
Use digital signatures |
Wählen Sie aus, ob Sie den JWT OAuth-Flow verwenden. Fügen Sie das Zertifikat auf Ihrem System hinzu, um es für den JWT OAuth-Flow hochzuladen. Die Zertifikatsgröße ist auf 4 KB begrenzt. |
|
Selected OAuth Scopes |
OAuth-Bereiche definieren Berechtigungen für die verbundene Anwendung. Diese werden als Token vergeben, nachdem die App autorisiert wurde. Manage user data via APIs (api) – Ermöglicht den Zugriff auf das Konto des*r aktuellen, angemeldeten Benutzer*i über APIs. Perform requests at any time (refresh_token, offline_access) - Ermöglicht die Rückgabe eines Aktualisierungstokens, wenn der anfragende Client zum Empfang berechtigt ist. Mit einem Aktualisierungstoken kann die App mit den Daten des*der Nutzers*in interagieren, während diese*r offline ist. Dieses Token ist gleichbedeutend mit der Anforderung von offline_access. |
Sobald Sie diese Informationen hinzugefügt haben, müssen Sie die Schritte im Setup Guide als Done markieren.
In diesem Schritt erstellen Sie einen neuen Berechtigungssatz für die Acrolinx Sidebar und weisen ihn Ihren Benutzer*innen zu.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Label |
Die Bezeichnung des Berechtigungssatzes, die dem „Label“ in der Bedienoberfläche entspricht. Limit: 80 Zeichen. |
|
API Name |
Der eindeutige Name des Objekts in der API. Dieser Name darf nur Unterstriche und alphanumerische Zeichen enthalten und muss in Ihrer Organisation eindeutig sein. Er muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten, nicht mit einem Unterstrich enden und nicht zwei aufeinander folgende Unterstriche enthalten. |
Klicken Sie auf Edit, um den Consumer Key aus der verbundenen Anwendung und den Private Key hinzuzufügen, den Sie im Abschnitt Vorbereiten Ihrer Instanz im Acrolinx für Salesforce Knowledge Admin Guide erstellt haben.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Consumer Key |
Identifiziert den Kunden gegenüber Salesforce. Ein Kundengeheimnis etabliert den Besitz des Customer Keys. |
|
Private Key |
Wird für die Verschlüsselung/Entschlüsselung von Daten verwendet, die zwischen Ihrem Server und Salesforce gesendet werden. Sie erstellen ihn, wenn Sie Ihr Zertifikat mit einer Certificate Signing Request (CSR) anfordern. |
Nachdem Sie die Informationen hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Verbinden Sie sich über Salesforce mit der Acrolinx-Plattform.
In diesem Schritt geben Sie die eindeutige Acrolinx-URL an, fügen sie zu den Remote-Site-Einstellungen hinzu und richten SSO ein.
In diesem Schritt können Sie Acrolinx-spezifische Felder zum Knowledge-Objekt hinzufügen, damit wichtige Prüfinformationen dort erscheinen, wo Sie sie brauchen. Für Sidebar-Prüfungen ist dieser Schritt optional. Wenn Ihre Lizenz die automatisierte Prüfung beinhaltet, sind diese Felder erforderlich.
Sie können die Felder benennen, wie Sie möchten. Im Folgenden sind einige Vorschläge:
Tipp
Um ein Feld anzuzeigen, müssen Sie es zum Layout der Record-Seite hinzufügen.
|
Feld-Bezeichnung |
Beschreibung |
|---|---|
|
Acrolinx Score |
Feld zum Speichern des Acrolinx Scores. |
|
Acrolinx Scorecard |
Feld zum Speichern eines Links zur Acrolinx Scorecard. |
|
Embed Scorecard |
Feld zum Einbetten des Links zur Acrolinx Scorecard unter dem Acrolinx Score. |
|
Last Checked |
Fügen Sie ein Feld hinzu, um das Datum der letzten Prüfung des Artikels zu speichern. |
|
Score Status |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ gespeichert wird. |
|
Score Color |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ angezeigt wird. |
In diesem Schritt fügen Sie Komponenten zur Record-Seite in Salesforce hinzu, damit Sie Artikel mit Acrolinx prüfen und den Acrolinx Score anzeigen können.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die Stapelprüfung umfasst.
Legen Sie die maximale Anzahl paralleler Prüfungen fest und klicken Sie auf Add, um die Stapelprüfung in der Listenansicht zu aktivieren.
Nachdem Sie eine Schaltfläche zum List View Button Layout hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die automatisierte Prüfung umfasst.
Klicken Sie auf Apply, um einen Flow zu erstellen, der eine automatisierte Acrolinx-Prüfung startet, wenn Sie einen Artikel speichern oder aktualisieren.
Anmerkung
Wenn Sie auf Acrolinx für Salesforce Knowledge Version 3.6 aktualisieren möchten, stellen Sie sicher, dass Sie den Trigger deaktivieren, den Sie in früheren Versionen von Acrolinx für Salesforce Knolwedge eingerichtet haben, bevor Sie auf Apply klicken.
Überprüfen Sie die Logik des Flows und markieren Sie den Schritt als Done.
Mit diesem Schritt können Sie bestimmte Knowledge-Artikel-Felder von einer Acrolinx-Prüfung ausschließen. Diese werden auch auf der Seite „Edit with Acrolinx“ ausgeblendet.
Klicken Sie auf Add, um ein neues Feldset für die Felder zu erstellen, die Sie ausschließen möchten.
Wenn Sie das Feldset mit den gewünschten Feldern konfiguriert haben, markieren Sie den Schritt als Done.
Hinweis
Zudem müssen Sie Ihr Salesforce Content-Profil aktualisieren, um diese Felder auszuschließen.
So aktualisieren Sie Ihr Content-Profil:
Hinweis
Wenn Sie Acrolinx für Salesforce Knowledge Version 3.8 zum ersten Mal installieren, lädt Acrolinx standardmäßig den Acrolinx Lightning Editor (CKEditor). Wenn Sie zum neuen Acrolinx Lightning Editor (TinyMCE) wechseln möchten, sind die folgenden Schritte erforderlich.
Um den Acrolinx Lightning Editor (TinyMCE) zu verwenden, gehen Sie wie folgt vor:
-
Gehen Sie zu Setup > Custom Settings.
-
Klicken Sie neben Acrolinx Configuration Settings auf Manage.
-
Wenn es keine Datensätze gibt, klicken Sie auf New. Falls es einen Datensatz gibt, klicken Sie auf Edit.
-
Klicken Sie auf das Kontrollkästchen neben Enable Acrolinx Lightning Editor.
-
Klicken Sie auf Save.
Wenn Sie den Cache sofort nach einer Änderung des Knowledge-Layouts löschen möchten, können Sie dies über die Befehlszeile tun. Andernfalls wird der Cache automatisch aktualisiert. Die automatische Aktualisierung dauert 6 Stunden.
So löschen Sie den Cache sofort:
-
Gehen Sie zu Setup > Developer Console.
-
Klicken Sie auf Debug > Open Execute Anonymous Window.
-
Fügen Sie die Codezeile in das Fenster Enter Apex Code ein.
-
Um den Cache für den*die aktuelle*n Benutzer*in zu löschen, fügen Sie die folgende Codezeile in das Fenster Enter Apex Code ein.
AcrolinxApp.AcrolinxCache.clear(Knowledge__kav.getSObjec tType());
-
Um den Cache für eine*n andere*n Benutzer*in zu löschen, geben Sie die entsprechende Salesforce ID als zweiten Parameter ein. Zum Beispiel:
AcrolinxApp.AcrolinxCache.clear(Knowledge__kav.getSObjec tType(), '0058N000005Uy9IQAS');
-
-
Klicken Sie auf Execute. Wenn der Cache-Wert erfolgreich entfernt wurde, sehen Sie
true.
Hinweis
Standardmäßig lautet das Präfix für diesen Objektnamen Knowledge. Sie können dieses Präfix über den Objektnamen für das Objekt Knowledge__kav im Object Manager ändern. Stellen Sie sicher, dass Sie den API-Namen des Knowledge-Objekts im Object Manager überprüfen.
Aktivieren Sie Cross-Origin Resource Sharing (CORS) zwischen Salesforce und Ihrer Acrolinx-Plattform. Lesen Sie dazu unseren Artikel über das Aktivieren von CORS.
Einrichten von SSOMit SSO können Sie das browserbasierte Anmeldeverfahren für die Acrolinx Sidebar überspringen. Erfahren Sie, wie Sie Acrolinx für SSO einrichten.
Sobald Sie SSO aktiviert haben, klicken Sie im Acrolinx Setup auf den Schalter neben Use SSO. Geben Sie Ihr Passwort in das Feld Password ein.
Um Acrolinx für Salesforce zu verwenden, benötigen Autor*innen Zugriff auf die Knowledge Base und einen dieser beiden Berechtigungssätze:
-
Acrolinx User — hat Zugriff auf die Funktionen von Acrolinx für Salesforce.
-
Acrolinx Admin — hat Zugriff auf den Acrolinx User und kann auf die Verwaltungsseite zugreifen. Dort können Sie Protokolle, Stapelprüfungsergebnisse und andere von einem*r Systemadmin eingerichtete Optionen einsehen.
Um Acrolinx für Salesforce verwenden zu können, benötigen Autor*innen Zugriff auf die Knowledge Base und den Berechtigungssatz Acrolinx User oder Acrolinx Admin.
So weisen Sie eine oder beide Acrolinx-Berechtigungen zu:
-
Geben Sie im Setup in das Feld Quick Find das Wort „Users“ ein. Wählen Sie Users aus.
-
Klicken Sie auf den Namen der Person, der Sie Berechtigungen zuweisen möchten. Dadurch wird das entsprechende Profil geöffnet.
-
Navigieren Sie zum Abschnitt Permission Set Assignments des Profils und klicken Sie auf Edit Assignments.
-
Wählen Sie einen Berechtigungssatz in der Spalte Available Permission Sets aus, und klicken Sie auf Add, um sie in die Spalte Enabled Permission Sets zu verschieben.
Anmerkung
Wenn ein*e Benutzer*in Stapelprüfungen durchführen soll, müssen Sie auch die Berechtigung „Run Flows“ zur Spalte Enabled Permission Sets hinzufügen.
-
Klicken Sie auf Save.
So generieren Sie den Private Key und das Serverzertifikat mithilfe der OpenSSL-Bibliothek:
Tipp
Sie haben kein OpenSSL? Erfahren Sie, wie Sie es installieren.
-
Führen Sie den folgenden Befehl aus, um einen Private Key zu generieren. Der Befehl wird Ihnen eine
server.pass.key-Datei zurückgeben.openssl genrsa -des3 -passout pass:x -out server.pass.key 2048
-
Verwenden Sie die Datei
server.pass.key, um mit dem folgenden Befehl eine weitere Schlüsseldatei zu erstellen:openssl rsa -passin pass:x -in server.pass.key -out server.key
Damit erhalten Sie Ihre Datei
server.key. Die Dateiserver.keyist Ihr privater RSA-Schlüssel. -
Mit dem folgenden Befehl fordern Sie das Zertifikat an und generieren es:
openssl req -new -key server.key -out server.csr
Wenn Sie den Befehl ausgeführt haben, müssen Sie einige Informationen angeben:
-
Country Name: <Ihr Land>
-
State or Province Name: <Ihr Bundesland>
-
Locality Name (city): <Ihre Stadt>
-
Organization Name: <Ihr Unternehmen>
-
Organization Unit Name: <Ihr Unternehmen>
-
Common Name: <Optional>
-
Email Address: <Ihre Email-Adresse>
-
-
Generieren Sie das SSL-Zertifikat mit dem folgenden Befehl:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
Damit erhalten Sie Ihre
Server.crt-Datei.Server.Crtist Ihr digitales Signaturzertifikat.
Tipp
Bewahren Sie die von Ihnen generierten Schlüssel an einem sicheren Ort auf – insbesondere die Schlüssel aus den Schritten 2 und 4.
Wenn Sie Acrolinx in Salesforce Knowledge öffnen, sehen Sie eine Registerkarte für den Acrolinx Setup Guide. Hier erfahren Sie, wie Sie Acrolinx konfigurieren und die Verbindung zur Acrolinx-Plattform herstellen.
Öffnen Sie dazu Acrolinx in Salesforce und klicken Sie auf Acrolinx Setup Guide.
Hinweis
Bevor Sie beginnen: Stellen Sie sicher, dass Sie den Schritt „Generate Private Key and Server Certificate“ im Abschnitt Vorbereiten Ihrer Instanz abgeschlossen haben.
Mit verbundenen Anwendungen können Sie externe Anwendungen in Salesforce integrieren.
Fügen Sie eine neue verbundene Anwendung über den App-Manager hinzu und geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Connected App Name: |
Der eindeutige Name, der im App-Manager und in der Startfeld der App angezeigt wird. Verwenden Sie diesen Namen nicht noch einmal innerhalb Ihrer Organisation. |
|
API Name |
Der API-Name, der verwendet wird, wenn von einem Programm aus auf Ihre Anwendung verwiesen wird. Standardmäßig enthält dieser Name keine Leerzeichen. Sie können nur Buchstaben, Zahlen und Unterstriche eingeben. |
|
Contact Email |
Die Kontakt-E-Mail für Sie oder Ihr Support-Team. |
|
Enable OAuth Settings |
Zugriff auf Salesforce-Daten durch eine externe Anwendung (in diesem Fall Acrolinx) gewähren. |
|
Callback URL |
Der Endpunkt, den Salesforce während OAuth zurück zu Ihrer Anwendung sendet. Er ist derselbe wie der OAuth-Redirect-URI. Je nachdem, welchen OAuth-Flow Sie verwenden, ist die URL in der Regel diejenige, an die der Browser eines*r Benutzers*in nach erfolgreicher Autorisierung weitergeleitet wird. Stellen Sie sicher, dass die URL sicheres HTTPS oder ein benutzerdefiniertes URI-Schema verwendet. |
|
Use digital signatures |
Wählen Sie aus, ob Sie den JWT OAuth-Flow verwenden. Fügen Sie das Zertifikat auf Ihrem System hinzu, um es für den JWT OAuth-Flow hochzuladen. Die Zertifikatsgröße ist auf 4 KB begrenzt. |
|
Selected OAuth Scopes |
OAuth-Bereiche definieren Berechtigungen für die verbundene Anwendung. Diese werden als Token vergeben, nachdem die App autorisiert wurde. Manage user data via APIs (api) – Ermöglicht den Zugriff auf das Konto des*r aktuellen, angemeldeten Benutzer*i über APIs. Perform requests at any time (refresh_token, offline_access) - Ermöglicht die Rückgabe eines Aktualisierungstokens, wenn der anfragende Client zum Empfang berechtigt ist. Mit einem Aktualisierungstoken kann die App mit den Daten des*der Nutzers*in interagieren, während diese*r offline ist. Dieses Token ist gleichbedeutend mit der Anforderung von offline_access. |
Sobald Sie diese Informationen hinzugefügt haben, müssen Sie die Schritte im Setup Guide als Done markieren.
In diesem Schritt erstellen Sie einen neuen Berechtigungssatz für die Acrolinx Sidebar und weisen ihn Ihren Benutzer*innen zu.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Label |
Die Bezeichnung des Berechtigungssatzes, die dem „Label“ in der Bedienoberfläche entspricht. Limit: 80 Zeichen. |
|
API Name |
Der eindeutige Name des Objekts in der API. Dieser Name darf nur Unterstriche und alphanumerische Zeichen enthalten und muss in Ihrer Organisation eindeutig sein. Er muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten, nicht mit einem Unterstrich enden und nicht zwei aufeinander folgende Unterstriche enthalten. |
Klicken Sie auf Edit, um den Consumer Key aus der verbundenen Anwendung und den Private Key hinzuzufügen, den Sie im Abschnitt Vorbereiten Ihrer Instanz im Acrolinx für Salesforce Knowledge Admin Guide erstellt haben.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Consumer Key |
Identifiziert den Kunden gegenüber Salesforce. Ein Kundengeheimnis etabliert den Besitz des Customer Keys. |
|
Private Key |
Wird für die Verschlüsselung/Entschlüsselung von Daten verwendet, die zwischen Ihrem Server und Salesforce gesendet werden. Sie erstellen ihn, wenn Sie Ihr Zertifikat mit einer Certificate Signing Request (CSR) anfordern. |
Nachdem Sie die Informationen hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Verbinden Sie sich über Salesforce mit der Acrolinx-Plattform.
In diesem Schritt geben Sie die eindeutige Acrolinx-URL an, fügen sie zu den Remote-Site-Einstellungen hinzu und richten SSO ein.
In diesem Schritt können Sie Acrolinx-spezifische Felder zum Knowledge-Objekt hinzufügen, damit wichtige Prüfinformationen dort erscheinen, wo Sie sie brauchen. Für Sidebar-Prüfungen ist dieser Schritt optional. Wenn Ihre Lizenz die automatisierte Prüfung beinhaltet, sind diese Felder erforderlich.
Sie können die Felder benennen, wie Sie möchten. Im Folgenden sind einige Vorschläge:
Tipp
Um ein Feld anzuzeigen, müssen Sie es zum Layout der Record-Seite hinzufügen.
|
Feld-Bezeichnung |
Beschreibung |
|---|---|
|
Acrolinx Score |
Feld zum Speichern des Acrolinx Scores. |
|
Acrolinx Scorecard |
Feld zum Speichern eines Links zur Acrolinx Scorecard. |
|
Embed Scorecard |
Feld zum Einbetten des Links zur Acrolinx Scorecard unter dem Acrolinx Score. |
|
Last Checked |
Fügen Sie ein Feld hinzu, um das Datum der letzten Prüfung des Artikels zu speichern. |
|
Score Status |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ gespeichert wird. |
|
Score Color |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ angezeigt wird. |
In diesem Schritt fügen Sie Komponenten zur Record-Seite in Salesforce hinzu, damit Sie Artikel mit Acrolinx prüfen und den Acrolinx Score anzeigen können.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die Stapelprüfung umfasst.
Legen Sie die maximale Anzahl paralleler Prüfungen fest und klicken Sie auf Add, um die Stapelprüfung in der Listenansicht zu aktivieren.
Nachdem Sie eine Schaltfläche zum List View Button Layout hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die automatisierte Prüfung umfasst.
Klicken Sie auf Apply, um einen Flow zu erstellen, der eine automatisierte Acrolinx-Prüfung startet, wenn Sie einen Artikel speichern oder aktualisieren.
Anmerkung
Wenn Sie auf Acrolinx für Salesforce Knowledge Version 3.6 aktualisieren möchten, stellen Sie sicher, dass Sie den Trigger deaktivieren, den Sie in früheren Versionen von Acrolinx für Salesforce Knolwedge eingerichtet haben, bevor Sie auf Apply klicken.
Überprüfen Sie die Logik des Flows und markieren Sie den Schritt als Done.
Hinweis
Wenn Sie Acrolinx für Salesforce Knowledge Version 3.8 zum ersten Mal installieren, lädt Acrolinx standardmäßig den Acrolinx Lightning Editor (CKEditor). Wenn Sie zum neuen Acrolinx Lightning Editor (TinyMCE) wechseln möchten, sind die folgenden Schritte erforderlich.
Um den Acrolinx Lightning Editor (TinyMCE) zu verwenden, gehen Sie wie folgt vor:
-
Gehen Sie zu Setup > Custom Settings.
-
Klicken Sie neben Acrolinx Configuration Settings auf Manage.
-
Wenn es keine Datensätze gibt, klicken Sie auf New. Falls es einen Datensatz gibt, klicken Sie auf Edit.
-
Klicken Sie auf das Kontrollkästchen neben Enable Acrolinx Lightning Editor.
-
Klicken Sie auf Save.
Aktivieren Sie Cross-Origin Resource Sharing (CORS) zwischen Salesforce und Ihrer Acrolinx-Plattform. Lesen Sie dazu unseren Artikel über das Aktivieren von CORS.
Einrichten von SSOMit SSO können Sie das browserbasierte Anmeldeverfahren für die Acrolinx Sidebar überspringen. Erfahren Sie, wie Sie Acrolinx für SSO einrichten.
Sobald Sie SSO aktiviert haben, klicken Sie im Acrolinx Setup auf den Schalter neben Use SSO. Geben Sie Ihr Passwort in das Feld Password ein.
Um Acrolinx für Salesforce zu verwenden, benötigen Autor*innen Zugriff auf die Knowledge Base und einen dieser beiden Berechtigungssätze:
-
Acrolinx User — hat Zugriff auf die Funktionen von Acrolinx für Salesforce.
-
Acrolinx Admin — hat Zugriff auf den Acrolinx User und kann auf die Verwaltungsseite zugreifen. Dort können Sie Protokolle, Stapelprüfungsergebnisse und andere von einem*r Systemadmin eingerichtete Optionen einsehen.
Um Acrolinx für Salesforce verwenden zu können, benötigen Autor*innen Zugriff auf die Knowledge Base und den Berechtigungssatz Acrolinx User oder Acrolinx Admin.
So weisen Sie eine oder beide Acrolinx-Berechtigungen zu:
-
Geben Sie im Setup in das Feld Quick Find das Wort „Users“ ein. Wählen Sie Users aus.
-
Klicken Sie auf den Namen der Person, der Sie Berechtigungen zuweisen möchten. Dadurch wird das entsprechende Profil geöffnet.
-
Navigieren Sie zum Abschnitt Permission Set Assignments des Profils und klicken Sie auf Edit Assignments.
-
Wählen Sie einen Berechtigungssatz in der Spalte Available Permission Sets aus, und klicken Sie auf Add, um sie in die Spalte Enabled Permission Sets zu verschieben.
Anmerkung
Wenn ein*e Benutzer*in Stapelprüfungen durchführen soll, müssen Sie auch die Berechtigung „Run Flows“ zur Spalte Enabled Permission Sets hinzufügen.
-
Klicken Sie auf Save.
So generieren Sie den Private Key und das Serverzertifikat mithilfe der OpenSSL-Bibliothek:
Tipp
Sie haben kein OpenSSL? Erfahren Sie, wie Sie es installieren.
-
Führen Sie den folgenden Befehl aus, um einen Private Key zu generieren. Der Befehl wird Ihnen eine
server.pass.key-Datei zurückgeben.openssl genrsa -des3 -passout pass:x -out server.pass.key 2048
-
Verwenden Sie die Datei
server.pass.key, um mit dem folgenden Befehl eine weitere Schlüsseldatei zu erstellen:openssl rsa -passin pass:x -in server.pass.key -out server.key
Damit erhalten Sie Ihre Datei
server.key. Die Dateiserver.keyist Ihr privater RSA-Schlüssel. -
Mit dem folgenden Befehl fordern Sie das Zertifikat an und generieren es:
openssl req -new -key server.key -out server.csr
Wenn Sie den Befehl ausgeführt haben, müssen Sie einige Informationen angeben:
-
Country Name: <Ihr Land>
-
State or Province Name: <Ihr Bundesland>
-
Locality Name (city): <Ihre Stadt>
-
Organization Name: <Ihr Unternehmen>
-
Organization Unit Name: <Ihr Unternehmen>
-
Common Name: <Optional>
-
Email Address: <Ihre Email-Adresse>
-
-
Generieren Sie das SSL-Zertifikat mit dem folgenden Befehl:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
Damit erhalten Sie Ihre
Server.crt-Datei.Server.Crtist Ihr digitales Signaturzertifikat.
Tipp
Bewahren Sie die von Ihnen generierten Schlüssel an einem sicheren Ort auf – insbesondere die Schlüssel aus den Schritten 2 und 4.
Wenn Sie Acrolinx in Salesforce Knowledge öffnen, sehen Sie eine Registerkarte für den Acrolinx Setup Guide. Hier erfahren Sie, wie Sie Acrolinx konfigurieren und die Verbindung zur Acrolinx-Plattform herstellen.
Öffnen Sie dazu Acrolinx in Salesforce und klicken Sie auf Acrolinx Setup Guide.
Hinweis
Bevor Sie beginnen: Stellen Sie sicher, dass Sie den Schritt „Generate Private Key and Server Certificate“ im Abschnitt Vorbereiten Ihrer Instanz abgeschlossen haben.
Mit verbundenen Anwendungen können Sie externe Anwendungen in Salesforce integrieren.
Fügen Sie eine neue verbundene Anwendung über den App-Manager hinzu und geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Connected App Name: |
Der eindeutige Name, der im App-Manager und in der Startfeld der App angezeigt wird. Verwenden Sie diesen Namen nicht noch einmal innerhalb Ihrer Organisation. |
|
API Name |
Der API-Name, der verwendet wird, wenn von einem Programm aus auf Ihre Anwendung verwiesen wird. Standardmäßig enthält dieser Name keine Leerzeichen. Sie können nur Buchstaben, Zahlen und Unterstriche eingeben. |
|
Contact Email |
Die Kontakt-E-Mail für Sie oder Ihr Support-Team. |
|
Enable OAuth Settings |
Zugriff auf Salesforce-Daten durch eine externe Anwendung (in diesem Fall Acrolinx) gewähren. |
|
Callback URL |
Der Endpunkt, den Salesforce während OAuth zurück zu Ihrer Anwendung sendet. Er ist derselbe wie der OAuth-Redirect-URI. Je nachdem, welchen OAuth-Flow Sie verwenden, ist die URL in der Regel diejenige, an die der Browser eines*r Benutzers*in nach erfolgreicher Autorisierung weitergeleitet wird. Stellen Sie sicher, dass die URL sicheres HTTPS oder ein benutzerdefiniertes URI-Schema verwendet. |
|
Use digital signatures |
Wählen Sie aus, ob Sie den JWT OAuth-Flow verwenden. Fügen Sie das Zertifikat auf Ihrem System hinzu, um es für den JWT OAuth-Flow hochzuladen. Die Zertifikatsgröße ist auf 4 KB begrenzt. |
|
Selected OAuth Scopes |
OAuth-Bereiche definieren Berechtigungen für die verbundene Anwendung. Diese werden als Token vergeben, nachdem die App autorisiert wurde. Manage user data via APIs (api) – Ermöglicht den Zugriff auf das Konto des*r aktuellen, angemeldeten Benutzer*i über APIs. Perform requests at any time (refresh_token, offline_access) - Ermöglicht die Rückgabe eines Aktualisierungstokens, wenn der anfragende Client zum Empfang berechtigt ist. Mit einem Aktualisierungstoken kann die App mit den Daten des*der Nutzers*in interagieren, während diese*r offline ist. Dieses Token ist gleichbedeutend mit der Anforderung von offline_access. |
Sobald Sie diese Informationen hinzugefügt haben, müssen Sie die Schritte im Setup Guide als Done markieren.
In diesem Schritt erstellen Sie einen neuen Berechtigungssatz für die Acrolinx Sidebar und weisen ihn Ihren Benutzer*innen zu.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Label |
Die Bezeichnung des Berechtigungssatzes, die dem „Label“ in der Bedienoberfläche entspricht. Limit: 80 Zeichen. |
|
API Name |
Der eindeutige Name des Objekts in der API. Dieser Name darf nur Unterstriche und alphanumerische Zeichen enthalten und muss in Ihrer Organisation eindeutig sein. Er muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten, nicht mit einem Unterstrich enden und nicht zwei aufeinander folgende Unterstriche enthalten. |
Klicken Sie auf Edit, um den Consumer Key aus der verbundenen Anwendung und den Private Key hinzuzufügen, den Sie im Abschnitt Vorbereiten Ihrer Instanz im Acrolinx für Salesforce Knowledge Admin Guide erstellt haben.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Consumer Key |
Identifiziert den Kunden gegenüber Salesforce. Ein Kundengeheimnis etabliert den Besitz des Customer Keys. |
|
Private Key |
Wird für die Verschlüsselung/Entschlüsselung von Daten verwendet, die zwischen Ihrem Server und Salesforce gesendet werden. Sie erstellen ihn, wenn Sie Ihr Zertifikat mit einer Certificate Signing Request (CSR) anfordern. |
Nachdem Sie die Informationen hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Verbinden Sie sich über Salesforce mit der Acrolinx-Plattform.
In diesem Schritt geben Sie die eindeutige Acrolinx-URL an, fügen sie zu den Remote-Site-Einstellungen hinzu und richten SSO ein.
In diesem Schritt können Sie Acrolinx-spezifische Felder zum Knowledge-Objekt hinzufügen, damit wichtige Prüfinformationen dort erscheinen, wo Sie sie brauchen. Für Sidebar-Prüfungen ist dieser Schritt optional. Wenn Ihre Lizenz die automatisierte Prüfung beinhaltet, sind diese Felder erforderlich.
Sie können die Felder benennen, wie Sie möchten. Im Folgenden sind einige Vorschläge:
Tipp
Um ein Feld anzuzeigen, müssen Sie es zum Layout der Record-Seite hinzufügen.
|
Feld-Bezeichnung |
Beschreibung |
|---|---|
|
Acrolinx Score |
Feld zum Speichern des Acrolinx Scores. |
|
Acrolinx Scorecard |
Feld zum Speichern eines Links zur Acrolinx Scorecard. |
|
Embed Scorecard |
Feld zum Einbetten des Links zur Acrolinx Scorecard unter dem Acrolinx Score. |
|
Last Checked |
Fügen Sie ein Feld hinzu, um das Datum der letzten Prüfung des Artikels zu speichern. |
|
Score Status |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ gespeichert wird. |
|
Score Color |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ angezeigt wird. |
In diesem Schritt fügen Sie Komponenten zur Record-Seite in Salesforce hinzu, damit Sie Artikel mit Acrolinx prüfen und den Acrolinx Score anzeigen können.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die Stapelprüfung umfasst.
Legen Sie die maximale Anzahl paralleler Prüfungen fest und klicken Sie auf Add, um die Stapelprüfung in der Listenansicht zu aktivieren.
Nachdem Sie eine Schaltfläche zum List View Button Layout hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die automatisierte Prüfung umfasst.
Klicken Sie auf Apply, um einen Flow zu erstellen, der eine automatisierte Acrolinx-Prüfung startet, wenn Sie einen Artikel speichern oder aktualisieren.
Anmerkung
Wenn Sie auf Acrolinx für Salesforce Knowledge Version 3.6 aktualisieren möchten, stellen Sie sicher, dass Sie den Trigger deaktivieren, den Sie in früheren Versionen von Acrolinx für Salesforce Knolwedge eingerichtet haben, bevor Sie auf Apply klicken.
Überprüfen Sie die Logik des Flows und markieren Sie den Schritt als Done.
Aktivieren Sie Cross-Origin Resource Sharing (CORS) zwischen Salesforce und Ihrer Acrolinx-Plattform. Lesen Sie dazu unseren Artikel über das Aktivieren von CORS.
Einrichten von SSOMit SSO können Sie das browserbasierte Anmeldeverfahren für die Acrolinx Sidebar überspringen. Erfahren Sie, wie Sie Acrolinx für SSO einrichten.
Sobald Sie SSO aktiviert haben, klicken Sie im Acrolinx Setup auf den Schalter neben Use SSO. Geben Sie Ihr Passwort in das Feld Password ein.
Um Acrolinx für Salesforce zu verwenden, benötigen Autor*innen Zugriff auf die Knowledge Base und einen dieser beiden Berechtigungssätze:
-
Acrolinx User — hat Zugriff auf die Funktionen von Acrolinx für Salesforce.
-
Acrolinx Admin — hat Zugriff auf den Acrolinx User und kann auf die Verwaltungsseite zugreifen. Dort können Sie Protokolle, Stapelprüfungsergebnisse und andere von einem*r Systemadmin eingerichtete Optionen einsehen.
Um Acrolinx für Salesforce verwenden zu können, benötigen Autor*innen Zugriff auf die Knowledge Base und den Berechtigungssatz Acrolinx User oder Acrolinx Admin.
So weisen Sie eine oder beide Acrolinx-Berechtigungen zu:
-
Geben Sie im Setup in das Feld Quick Find das Wort „Users“ ein. Wählen Sie Users aus.
-
Klicken Sie auf den Namen der Person, der Sie Berechtigungen zuweisen möchten. Dadurch wird das entsprechende Profil geöffnet.
-
Navigieren Sie zum Abschnitt Permission Set Assignments des Profils und klicken Sie auf Edit Assignments.
-
Wählen Sie einen Berechtigungssatz in der Spalte Available Permission Sets aus, und klicken Sie auf Add, um sie in die Spalte Enabled Permission Sets zu verschieben.
Anmerkung
Wenn ein*e Benutzer*in Stapelprüfungen durchführen soll, müssen Sie auch die Berechtigung „Run Flows“ zur Spalte Enabled Permission Sets hinzufügen.
-
Klicken Sie auf Save.
So generieren Sie den Private Key und das Serverzertifikat mithilfe der OpenSSL-Bibliothek:
Tipp
Sie haben kein OpenSSL? Erfahren Sie, wie Sie es installieren.
-
Führen Sie den folgenden Befehl aus, um einen Private Key zu generieren. Der Befehl wird Ihnen eine
server.pass.key-Datei zurückgeben.openssl genrsa -des3 -passout pass:x -out server.pass.key 2048
-
Verwenden Sie die Datei
server.pass.key, um mit dem folgenden Befehl eine weitere Schlüsseldatei zu erstellen:openssl rsa -passin pass:x -in server.pass.key -out server.key
Damit erhalten Sie Ihre Datei
server.key. Die Dateiserver.keyist Ihr privater RSA-Schlüssel. -
Mit dem folgenden Befehl fordern Sie das Zertifikat an und generieren es:
openssl req -new -key server.key -out server.csr
Wenn Sie den Befehl ausgeführt haben, müssen Sie einige Informationen angeben:
-
Country Name: <Ihr Land>
-
State or Province Name: <Ihr Bundesland>
-
Locality Name (city): <Ihre Stadt>
-
Organization Name: <Ihr Unternehmen>
-
Organization Unit Name: <Ihr Unternehmen>
-
Common Name: <Optional>
-
Email Address: <Ihre Email-Adresse>
-
-
Generieren Sie das SSL-Zertifikat mit dem folgenden Befehl:
openssl x509 -req -sha256 -days 365 -in server.csr -signkey server.key -out server.crt
Damit erhalten Sie Ihre
Server.crt-Datei.Server.Crtist Ihr digitales Signaturzertifikat.
Tipp
Bewahren Sie die von Ihnen generierten Schlüssel an einem sicheren Ort auf – insbesondere die Schlüssel aus den Schritten 2 und 4.
Wenn Sie Acrolinx in Salesforce Knowledge öffnen, sehen Sie eine Registerkarte für den Acrolinx Setup Guide. Hier erfahren Sie, wie Sie Acrolinx konfigurieren und die Verbindung zur Acrolinx-Plattform herstellen.
Öffnen Sie dazu Acrolinx in Salesforce und klicken Sie auf Acrolinx Setup Guide.
Hinweis
Bevor Sie beginnen: Stellen Sie sicher, dass Sie den Schritt „Generate Private Key and Server Certificate“ im Abschnitt Vorbereiten Ihrer Instanz abgeschlossen haben.
Mit verbundenen Anwendungen können Sie externe Anwendungen in Salesforce integrieren.
Fügen Sie eine neue verbundene Anwendung über den App-Manager hinzu und geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Connected App Name: |
Der eindeutige Name, der im App-Manager und in der Startfeld der App angezeigt wird. Verwenden Sie diesen Namen nicht noch einmal innerhalb Ihrer Organisation. |
|
API Name |
Der API-Name, der verwendet wird, wenn von einem Programm aus auf Ihre Anwendung verwiesen wird. Standardmäßig enthält dieser Name keine Leerzeichen. Sie können nur Buchstaben, Zahlen und Unterstriche eingeben. |
|
Contact Email |
Die Kontakt-E-Mail für Sie oder Ihr Support-Team. |
|
Enable OAuth Settings |
Zugriff auf Salesforce-Daten durch eine externe Anwendung (in diesem Fall Acrolinx) gewähren. |
|
Callback URL |
Der Endpunkt, den Salesforce während OAuth zurück zu Ihrer Anwendung sendet. Er ist derselbe wie der OAuth-Redirect-URI. Je nachdem, welchen OAuth-Flow Sie verwenden, ist die URL in der Regel diejenige, an die der Browser eines*r Benutzers*in nach erfolgreicher Autorisierung weitergeleitet wird. Stellen Sie sicher, dass die URL sicheres HTTPS oder ein benutzerdefiniertes URI-Schema verwendet. |
|
Use digital signatures |
Wählen Sie aus, ob Sie den JWT OAuth-Flow verwenden. Fügen Sie das Zertifikat auf Ihrem System hinzu, um es für den JWT OAuth-Flow hochzuladen. Die Zertifikatsgröße ist auf 4 KB begrenzt. |
|
Selected OAuth Scopes |
OAuth-Bereiche definieren Berechtigungen für die verbundene Anwendung. Diese werden als Token vergeben, nachdem die App autorisiert wurde. Manage user data via APIs (api) – Ermöglicht den Zugriff auf das Konto des*r aktuellen, angemeldeten Benutzer*i über APIs. Perform requests at any time (refresh_token, offline_access) - Ermöglicht die Rückgabe eines Aktualisierungstokens, wenn der anfragende Client zum Empfang berechtigt ist. Mit einem Aktualisierungstoken kann die App mit den Daten des*der Nutzers*in interagieren, während diese*r offline ist. Dieses Token ist gleichbedeutend mit der Anforderung von offline_access. |
Sobald Sie diese Informationen hinzugefügt haben, müssen Sie die Schritte im Setup Guide als Done markieren.
In diesem Schritt erstellen Sie einen neuen Berechtigungssatz für die Acrolinx Sidebar und weisen ihn Ihren Benutzer*innen zu.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Label |
Die Bezeichnung des Berechtigungssatzes, die dem „Label“ in der Bedienoberfläche entspricht. Limit: 80 Zeichen. |
|
API Name |
Der eindeutige Name des Objekts in der API. Dieser Name darf nur Unterstriche und alphanumerische Zeichen enthalten und muss in Ihrer Organisation eindeutig sein. Er muss mit einem Buchstaben beginnen, darf keine Leerzeichen enthalten, nicht mit einem Unterstrich enden und nicht zwei aufeinander folgende Unterstriche enthalten. |
Klicken Sie auf Edit, um den Consumer Key aus der verbundenen Anwendung und den Private Key hinzuzufügen, den Sie im Abschnitt Vorbereiten Ihrer Instanz im Acrolinx für Salesforce Knowledge Admin Guide erstellt haben.
Geben Sie die erforderlichen Informationen ein:
|
Feld |
Beschreibung |
|---|---|
|
Consumer Key |
Identifiziert den Kunden gegenüber Salesforce. Ein Kundengeheimnis etabliert den Besitz des Customer Keys. |
|
Private Key |
Wird für die Verschlüsselung/Entschlüsselung von Daten verwendet, die zwischen Ihrem Server und Salesforce gesendet werden. Sie erstellen ihn, wenn Sie Ihr Zertifikat mit einer Certificate Signing Request (CSR) anfordern. |
Nachdem Sie die Informationen hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Verbinden Sie sich über Salesforce mit der Acrolinx-Plattform.
In diesem Schritt geben Sie die eindeutige Acrolinx-URL an, fügen sie zu den Remote-Site-Einstellungen hinzu und richten SSO ein.
In diesem Schritt können Sie Acrolinx-spezifische Felder zum Knowledge-Objekt hinzufügen, damit wichtige Prüfinformationen dort erscheinen, wo Sie sie brauchen. Für Sidebar-Prüfungen ist dieser Schritt optional. Wenn Ihre Lizenz die automatisierte Prüfung beinhaltet, sind diese Felder erforderlich.
Sie können die Felder benennen, wie Sie möchten. Im Folgenden sind einige Vorschläge:
Tipp
Um ein Feld anzuzeigen, müssen Sie es zum Layout der Record-Seite hinzufügen.
|
Feld-Bezeichnung |
Beschreibung |
|---|---|
|
Acrolinx Score |
Feld zum Speichern des Acrolinx Scores. |
|
Acrolinx Scorecard |
Feld zum Speichern eines Links zur Acrolinx Scorecard. |
|
Embed Scorecard |
Feld zum Einbetten des Links zur Acrolinx Scorecard unter dem Acrolinx Score. |
|
Last Checked |
Fügen Sie ein Feld hinzu, um das Datum der letzten Prüfung des Artikels zu speichern. |
|
Score Status |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ gespeichert wird. |
|
Score Color |
Fügen Sie ein Feld hinzu, in dem der Farbwert des „Score Status“ angezeigt wird. |
In diesem Schritt fügen Sie Komponenten zur Record-Seite in Salesforce hinzu, damit Sie Artikel mit Acrolinx prüfen und den Acrolinx Score anzeigen können.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die Stapelprüfung umfasst.
Legen Sie die maximale Anzahl paralleler Prüfungen fest und klicken Sie auf Add, um die Stapelprüfung in der Listenansicht zu aktivieren.
Nachdem Sie eine Schaltfläche zum List View Button Layout hinzugefügt haben, markieren Sie den Schritt im Setup Guide als Done.
Dieser Schritt ist nur erforderlich, wenn Ihre Lizenz die automatisierte Prüfung umfasst.
Klicken Sie auf Apply, um einen Flow zu erstellen, der eine automatisierte Acrolinx-Prüfung startet, wenn Sie einen Artikel speichern oder aktualisieren.
Anmerkung
Wenn Sie auf Acrolinx für Salesforce Knowledge Version 3.6 aktualisieren möchten, stellen Sie sicher, dass Sie den Trigger deaktivieren, den Sie in früheren Versionen von Acrolinx für Salesforce Knolwedge eingerichtet haben, bevor Sie auf Apply klicken.
Überprüfen Sie die Logik des Flows und markieren Sie den Schritt als Done.