Die Einrichtung der Salesforce-Integration verbindet Ihre Document360-Wissensdatenbank mit Ihrer Salesforce-Konsole. Sobald sie eingerichtet sind, können Support-Mitarbeiter nach Artikeln suchen, Empfehlungen erhalten und Inhalte zur Wissensdatenbank direkt aus Salesforce erstellen. Dieser Artikel führt Sie durch jeden Schritt des Einrichtungsprozesses, von der Installation der Document360-App in Salesforce bis zur Autorisierung der Verbindung über Ihr Document360-Portal.
Bevor du anfängst
- Du brauchst ein Salesforce Lightning-Plattform-Konto. Wenn Sie keine haben, melden Sie sich auf der Salesforce-Anmeldeseite für eine kostenlose Testversion an. Wenn Sie bereits ein Konto haben, springen Sie zu "Installieren Sie die Document360-App auf Salesforce".
- Du musst sowohl in deiner Salesforce-Organisation als auch in deinem Document360-Projekt Administrator sein.
- Die Salesforce-Integration ist ein Zusatzkauf. Gehe in deinem Document360-Portal zu Einstellungen > Erweiterungen und klicke unter der Salesforce-Kachel auf "Jetzt kaufen ", bevor du startest.
Wie man die Salesforce-Integration einrichtet
Die Einrichtung der Integration umfasst fünf Stufen. Erledigen Sie sie in der Reihenfolge:
- Erstelle ein Salesforce-Konto (überspring, falls du bereits eines hast)
- Installiere die Document360-App in Salesforce
- App-Manager-Einstellungen konfigurieren
- Fügen Sie eine Visualforce-Seite hinzu
- App-Zugriff auf Benutzerprofile gewähren
- Die Integration von Document360 autorisieren
Erstelle eines Salesforce-Kontos
Wenn Sie bereits ein Salesforce Lightning Platform-Konto haben, überspringen Sie diesen Abschnitt.
- Gehe zur Salesforce-Anmeldeseite.
- Geben Sie die erforderlichen Daten ein und klicken Sie auf Start meine kostenlose Testphase.
- Besuchen Sie die Salesforce-Preisseite, um einen Tarif auszuwählen und zu kaufen, der Ihren Bedürfnissen entspricht.
- Überprüfen Sie Ihre registrierte E-Mail auf eine Nachricht mit Ihrem Verifizierungslink, Ihrer Konto-URL und Ihrem Benutzernamen. Klicke in der E-Mail auf Konto verifizieren .
- Geben Sie den Verifizierungscode aus der Folge-E-Mail ein und klicken Sie auf Überprüfen.
Der Verifizierungscode erscheint in einer separaten E-Mail als die ursprüngliche Verifizierungslink-E-Mail.
Sie werden zur Salesforce-Startseite weitergeleitet.
Installiere die Document360-App in Salesforce
- Gehen Sie zum Document360-Angebot auf AppExchange.
- Klicke auf Try It.
- Melden Sie sich mit Ihrem Trailblazer-Konto an.
- Wählen Sie die Umgebung aus, in der Sie die App installieren möchten:
- Installation in der Produktion – installiert Document360 in der Produktionsumgebung Ihres Salesforce-Projekts.
- Installieren in Sandbox – installiert Document360 in der Sandbox-Umgebung Ihres Salesforce-Projekts.
- Überprüfen Sie die Installationsdetails und klicken Sie auf Bestätigen und Installieren.
- Gib deine Salesforce-Zugangsdaten ein und klicke auf Anmelden.
- Wählen Sie aus, wer Zugriff auf die Document360-App haben soll:
- Installation nur für Admins – beschränkt den Zugriff nur auf Admins.
- Installieren für alle Nutzer – gewährt allen Nutzern in Ihrer Organisation Zugriff.
- Installation für bestimmte Profile – begrenzt den Zugriff auf ausgewählte Benutzerprofile.
Diese Auswahl bestimmt, welche Benutzer in Ihrer Salesforce-Organisation Zugriff auf die Document360-App haben. Du kannst den Zugriff später anpassen, indem du Benutzerprofile aktualisierst.
- Klicken Sie auf Installieren.
- Warte, bis die Installation abgeschlossen ist, und klicke dann auf Fertig.
Konfigurieren Sie die Einstellungen und Richtlinien des App-Managers
Nach der Installation der Document360-App konfigurieren Sie die OAuth-Richtlinien in Salesforce so, dass sie steuern, wer die Integration autorisieren kann.
- In Ihrer Salesforce-Einrichtung navigieren Sie im linken Navigationsbereich zu Platform Tools > Apps > App Manager . Dieser Schritt gewährleistet eine sichere Autorisierung und angemessene Zugriffskontrolle für Nutzer, die mit der Document360-Integration interagieren.
- Auf der Seite Lightning Experience App Manager findest du Document360 in der App-Liste.
- Klicken Sie auf den Pfeil nach unten am Ende der Document360-App-Reihe und wählen Sie Verwalten.
- Auf der Seite zu den Details der Document360-verbundenen App klicken Sie auf Richtlinien bearbeiten.
- Im Dropdown-Menü Erlaubte Benutzer wählen Sie aus, wer die App autorisieren kann, in ihrem Namen auf Daten zuzugreifen. Es gibt zwei Möglichkeiten:
- Alle Nutzer können sich selbst autorisieren – jeder Nutzer in Ihrer Organisation kann die App bei Bedarf individuell autorisieren. Das funktioniert gut für Organisationen mit unterschiedlichen Rollen oder Abteilungen, die die Integration unabhängig nutzen müssen.
- Vom Administrator genehmigte Benutzer sind vorab autorisiert – Administratoren werden automatisch autorisiert, ohne jedes Mal den Authentifizierungsprozess durchlaufen zu müssen. Das ist nützlich, wenn der Administrator der Hauptnutzer der Integration ist.
Die Auswahl von von Admin-genehmigten Benutzern als vorab autorisiert zu wählen, ist eine einmalige Maßnahme. Sobald es eingerichtet ist, muss der Admin nicht erneut manuell authentifizieren.
Fügen Sie eine Visualforce-Seite in der Salesforce-Entwicklerkonsole hinzu
Sie müssen eine Visualforce-Seite in Ihrer Salesforce-Entwicklerkonsole erstellen, um die Document360-App in Ihre Salesforce-Umgebung einzubetten.
- Im Schnellsuchfeld oben links in deiner Salesforce-Konfiguration suche nach Visualforce Pages und wähle es aus den Ergebnissen aus.
- Klicken Sie auf Neu.
- Geben Sie ein Etikett, einen Namen und eine Beschreibung für die Seite ein.
- Wählen Sie die Felder Verfügbar für Lightning Experience, Experience Builder und die mobile App .
- Fügen Sie den folgenden Code in den Bereich Visualforce Markup ein:
<apex:page standardController="Case"> <apex:canvasApp applicationName="Document360" namespacePrefix="Document360" height="800" width="750px"/> </apex:page>
Du kannst die Höhen- und Breitenwerte im Markup an dein Layout anpassen. Zum Beispiel: height="800px" width="750px". Notieren Sie sich den hier eingestellten Höhenwert – Sie benötigen ihn, wenn Sie die Visualforce-Komponente zu Ihrer Cases-Seite hinzufügen.
- Klicken Sie auf Speichern.
App-Zugriff auf Benutzerprofile gewähren
Der Organisationsadministrator muss der Document360-App Zugriff auf die relevanten Benutzerprofile gewähren. Ohne diesen Schritt sehen Benutzer beim Zugriff auf den Wissenstab einen Fehler "Nicht ausreichende Privilegien ".
- Navigiere zur Einrichtungsseite in deiner Salesforce-Umgebung.
- Im linken Navigationsfenster gehen Sie zu Administration > Benutzer > Profile.
- Klicken Sie in der Profilliste auf das Profil, das dem Team oder der Person zugewiesen ist, die die Fallseite und die Integrationseinstellungen verwaltet.
- Auf der Profilseite klicken Sie auf Bearbeiten.
- Scrollen Sie zum Abschnitt Connected App Access .
- Aktivieren Sie das Kästchen Document360 .
- Klicken Sie auf Speichern.
Wiederhole dies für jedes Profil, das Zugriff auf die Document360-App in Salesforce benötigt.
Autorisieren Sie die Salesforce-Integration über Ihr Document360-Portal
Der letzte Schritt besteht darin, die Verbindung über Ihr Document360-Portal zu autorisieren.
- Geh zu deinem Document360-Portal.
- Navigiere in der linken Navigationsleiste zu den Einstellungen.
- Gehe im linken Navigationsbereich zu Erweiterungen .
- Klicken Sie unter dem Bereich Helpdesk auf Salesforce.
Salesforce ist ein Add-on-Kauf. Wenn du es noch nicht gekauft hast, klicke auf der Salesforce-Kachel auf "Jetzt kaufen ".
- Klicken Sie auf Verbinden.
- Wählen Sie Ihre Autorisierungsart aus:
- Live — autorisiert Ihr Produktions-Salesforce-Projekt.
- Sandbox – autorisiert Ihr Sandbox-Salesforce-Projekt.
- Im Panel "Zugriff erlauben " klicken Sie auf Erlauben und warten Sie ein paar Sekunden.
- Die Salesforce-Kachel zeigt jetzt den Status als Projekt mit Salesforce verbunden zusammen mit der mit Ihrem Projekt verknüpften Salesforce-Konto-URL an.
- Klicken Sie auf Details auf der Salesforce-Kachel, um Ihre vollständigen Konfigurationsinformationen einzusehen.
Um die Integration zu entfernen, klicken Sie auf das Löschen-Symbol auf der Salesforce-Kachel.
Die Salesforce-Integration ist jetzt eingerichtet. Ihre Agenten können jetzt Ihre Wissensdatenbank durchsuchen, Artikelempfehlungen erhalten und Artikel direkt aus der Salesforce-Konsole erstellen. Als Nächstes lernen Sie, wie Sie Document360 in Salesforce verwenden.
Best Practices
- Schließe alle fünf Stufen der Reihe nach ab. Jede Stufe hängt von der vorherigen ab. Das Überspringen der App Manager-Konfiguration kann zum Beispiel später zu Autorisierungsfehlern führen.
- Teste in Sandbox, bevor du live gehst. Verwenden Sie die Sandbox-Umgebung, um zu überprüfen, ob die Integration wie erwartet funktioniert, bevor Sie Ihr Produktions-Salesforce-Projekt verbinden.
- Stellen Sie den Profilzugriff vor der Autorisierung ein. Gewähren Sie der Document360-App Zugriff auf alle relevanten Benutzerprofile, bevor Agenten versuchen, die Integration zu nutzen, um Fehler im Zusammenhang mit unzureichenden Rechten zu vermeiden.
- Notieren Sie die Höhe Ihrer Visualforce-Seite. Wenn du Document360 zu deiner Cases-Seite hinzufügst, muss die Höhe mit dem in deinem Visualforce-Seiten-Markup gesetzten Wert übereinstimmen oder sie übertreffen.
- Use Admin-zugelassene Nutzer sind vorab autorisiert für ein reibungsloseres Erlebnis. Wenn Ihr Administrator der Hauptnutzer der Integration ist, entfällt durch diese Einstellung die Notwendigkeit wiederholter Authentifizierungsanweisungen.
- Beim Upgrade der Integration prüfen Sie die Releasenotes von Document360 und Salesforce auf API- oder Feature-Änderungen, testen Sie in einer Staging-Umgebung und bestätigen Sie dann die Kompatibilität, bevor Sie in die Produktion bereitstellen.
FAQ
Wie sieht die technische Architektur der Document360- und Salesforce-Integration aus?
Die Integration nutzt APIs beider Plattformen, um Datenübertragung und Synchronisation zwischen Document360 und Salesforce zu ermöglichen.
Wie wird die Dokumentenversionierung während der Synchronisation gehandhabt?
Die Integration verfolgt Änderungen in Document360 und aktualisiert entsprechende Datensätze in Salesforce, um die Datengenauigkeit und -konsistenz zu gewährleisten.
Welche Schritte sind beim Upgrade der Integration erforderlich, wenn neue Versionen veröffentlicht werden?
Überprüfen Sie die Release Notes auf Änderungen an APIs oder Funktionen, testen Sie das Update in einer Staging-Umgebung und bestätigen Sie dann die Kompatibilität, bevor Sie in die Produktion gehen.