Mit dem Salesforce® Connector können Sie Befehle verwenden, um mit Salesforce als Teil einer Kette zu interagieren. Mit diesem Konnektor können Sie beispielsweise Folgendes tun:
- Hochladen, Extrahieren und Löschen von Daten in Salesforce über SOQL und Massenoperationen
- Salesforce-Objekte erstellen und verwalten
- Aktualisieren und Erstellen von Datensätzen in Salesforce
Der Connector arbeitet mit allen Versionen von Salesforce Sales Cloud zusammen:
- Salesforce Essentials®
- Salesforce Net Zero Cloud
- Lightning® Profi
- Lightning Enterprise
- Lightning Unlimited
Hinweis: Dieser Konnektor wird von Workiva hergestellt und verbindet sich mit einem System eines Drittanbieters. Unser Support-Team kann Ihnen zwar bei der Konfiguration dieses Konnektors innerhalb Ihres Arbeitsbereichs behilflich sein, aber wir sind nicht in der Lage, Fehler zu beheben oder anderweitig bei Problemen zu helfen, die ihren Ursprung außerhalb der Workiva-Plattform haben.
Anforderungen
Um den Konnektor für die Verwendung in Ihrer Organisation verfügbar zu machen, muss ein org-Sicherheitsadministrator ihn zunächst aktivieren.
Sie können dann Ihre Verbindung zu Salesforce mit einer der folgenden Methoden sichern:
- Salesforce OAuth-Authentifizierung unter Verwendung einer Client-ID, eines Secrets und eines Scopes
- Grundlegende Authentifizierung mit einem Benutzernamen und einem Passwort
- Client-Anmeldeinformationen, die nur eine Client-ID und ein Geheimnis enthalten
Salesforce OAuth-Authentifizierung
Um sich mit Workiva zu verbinden, benötigen Sie die client ID und secret von Salesforce sowie den OAuth-Bereich der verbundenen App.
Die OAuth-Authentifizierung erfordert zusätzlich die Verwendung einer mit Salesforce verbundenen App. Um diese in Salesforce zu erstellen, richten Sie die App ein und konfigurieren die folgenden erforderlichen Einstellungen:
- Geben Sie unter Callback URL eine der folgenden Angaben ein, die zu Ihrem AppSpot passt:
- PROD -
https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback - EMEA -
https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback - APAC -
https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
- PROD -
- Unter Selected OAuth Scopes finden Sie Perform requests on your behalf at any time (refresh_token, offline_access) und mindestens einen weiteren Bereich.
Basis-Authentifizierung
Um sich mit Workiva zu verbinden, benötigen Sie den Benutzernamen, das Passwort und das Sicherheits-Token von Salesforce für den Integrationsbenutzer.
Für die Basisauthentifizierung ist ein Integrationsbenutzer mit API-aktivierten Berechtigungen erforderlich, zusätzlich zu den Berechtigungen, die sich auf die Aufgaben beziehen, die der Connector ausführt.
Hinweis: Um die Berechtigungen des Integrationsbenutzers in Salesforce festzulegen, wählen Sie Administer, Manage Users, Profiles und wählen Sie das entsprechende Profil.
- Wählen Sie unter Administrative Berechtigungen, API Aktiviert.
- Damit der Konnektor einen Befehl ausführen kann, benötigt der Benutzer mindestens die Berechtigung Read für die entsprechenden Daten.
- Um Massenaktualisierungen an Salesforce-Objekten durchzuführen, benötigt der Benutzer Bearbeiten Berechtigungen für das Objekt.
Authentifizierung von Client-Zugangsdaten
Um sich mit Workiva zu verbinden, benötigen Sie die client ID und secret von Salesforce.
Die Authentifizierung mit Client-Anmeldeinformationen erfordert die Verwendung einer mit Salesforce verbundenen App. Um diese in Salesforce zu erstellen, richten Sie die App unter Verwendung des Client Credentials Flow ein.
Einrichten des Salesforce-Connectors für die OAuth-Authentifizierung
Die OAuth-Authentifizierung ermöglicht Ihnen den Zugriff auf Salesforce mit einer Client-ID und einem Geheimnis. Im Gegensatz zur Anmeldemethode mit Client-Anmeldeinformationen umfasst die OAuth-Authentifizierung ein Aktualisierungs-Token und erfordert einen Bereich.
Diese Methode wird für länger laufende Befehle empfohlen, die bei Verwendung der Client-Zugangsdaten-Methode eine Zeitüberschreitung verursachen würden.
- Klicken Sie unter Chain-Generator auf Verbindungen und dann auf Erstellen oben rechts.
- Wählen Sie unter Connector Connection, Salesforce und den Standard-CloudRunner.
- Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.
- Geben Sie unter Eigenschaften die Salesforce-Instanz oder die benutzerdefinierte Domäne ein, mit der eine Verbindung hergestellt werden soll:
Eigenschaft Details Instanz Geben Sie die Salesforce-Instanz ein, mit der Sie sich verbinden möchten. Wenn Ihr Unternehmen eine benutzerdefinierte Salesforce-Domäne verwendet, lassen Sie dieses Feld leer. Hinweis: In Ihrer Salesforce-URL stehen die Zeichen vor
salesforce.com-wiena73-für die Instanz.Benutzerdefinierte Domäne Geben Sie die benutzerdefinierte Salesforce-Domäne ein, mit der eine Verbindung hergestellt werden soll, falls verwendet. Hinweis: Um Ihre benutzerdefinierte Domain in Salesforce anzuzeigen, wählen Sie Firmeneinstellungen, Meine Domain. Eine benutzerdefinierte Domain endet normalerweise mit
.my.salesforce.com. - Wählen Sie für Authentifizierungstyp Salesforce OAuth.
- Geben Sie die Client-ID, das Geheimnis und den Bereich unter Authentifizierung ein, und klicken Sie dann auf Verbinden.
Hinweis: Wenn die Verbindung zu Salesforce erfolgreich ist, werden das Refresh Token und Access Token des Connectors automatisch ausgefüllt. Wenn die Verbindung fehlschlägt, klicken Sie auf Stop und warten Sie, bis die Verbindung wieder hergestellt ist.
Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit AES-256-Verschlüsselung gespeichert.
- Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
- Um die Verbindung zu testen, erstellen und führen Sie mit dem Befehl Berichte auflisten des Konnektors eine Kette aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.
Einrichten des Salesforce-Connectors für die grundlegende Authentifizierung
Mit der Basisauthentifizierung können Sie sich bei Salesforce mit dem Benutzernamen und dem Kennwort eines Integrationsbenutzers anmelden.
- Klicken Sie unter Chain-Generator auf Verbindungen und dann auf Erstellen oben rechts.
- Wählen Sie unter Connector Connection, Salesforce und den Standard-CloudRunner.
- Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.
- Geben Sie unter Eigenschaften die Salesforce-Instanz oder die benutzerdefinierte Domäne ein, mit der eine Verbindung hergestellt werden soll:
Eigenschaft Details Instanz Geben Sie die Salesforce-Instanz ein, mit der Sie sich verbinden möchten. Wenn Ihr Unternehmen eine benutzerdefinierte Salesforce-Domäne verwendet, lassen Sie dieses Feld leer. Hinweis: In Ihrer Salesforce-URL stehen die Zeichen vor
salesforce.com-wiena73-für die Instanz.Benutzerdefinierte Domäne Geben Sie die benutzerdefinierte Salesforce-Domäne ein, mit der eine Verbindung hergestellt werden soll, falls verwendet. Hinweis: Um Ihre benutzerdefinierte Domain in Salesforce anzuzeigen, wählen Sie Firmeneinstellungen, Meine Domain. Eine benutzerdefinierte Domain endet normalerweise mit
.my.salesforce.com. - Wählen Sie für Authentifizierungstyp Basic Auth.
- Geben Sie unter Authentifizierung den Benutzernamen, das Passwort und das Sicherheits-Token des Integrationsbenutzers ein.
Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.
- Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
- Um die Verbindung zu testen, erstellen und führen Sie mit dem Befehl Berichte auflisten des Konnektors eine Kette aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.
Einrichten des Salesforce-Connectors für Kundenanmeldeinformationen
Die Authentifizierung mit Client-Anmeldeinformationen ermöglicht Ihnen den Zugriff auf Salesforce mit einer Client-ID und einem Geheimnis. Diese Methode unterscheidet sich von der OAuth-Anmeldemethode dadurch, dass kein Bereich erforderlich ist und Sie sich nicht über die Schaltfläche Connect bei Salesforce authentifizieren müssen.
Warnung: Diese Authentifizierungsmethode enthält kein Refresh-Token. Aus diesem Grund ist es nicht für langlaufende Befehle geeignet und kann in bestimmten Ketten zu Timeouts führen.
- Klicken Sie unter Chain-Generator auf Verbindungen und dann auf Erstellen oben rechts.
- Wählen Sie unter Connector Connection, Salesforce und den Standard-CloudRunner.
- Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um den Konnektor zu identifizieren.
- Geben Sie unter Eigenschaften die Salesforce-Instanz oder die benutzerdefinierte Domäne ein, mit der eine Verbindung hergestellt werden soll:
Eigenschaft Details Instanz Geben Sie die Salesforce-Instanz ein, mit der Sie sich verbinden möchten. Wenn Ihr Unternehmen eine benutzerdefinierte Salesforce-Domäne verwendet, lassen Sie dieses Feld leer. Hinweis: In Ihrer Salesforce-URL stehen die Zeichen vor
salesforce.com-wiena73-für die Instanz.Benutzerdefinierte Domäne Geben Sie die benutzerdefinierte Salesforce-Domäne ein, mit der eine Verbindung hergestellt werden soll, falls verwendet. Hinweis: Um Ihre benutzerdefinierte Domain in Salesforce anzuzeigen, wählen Sie Firmeneinstellungen, Meine Domain. Eine benutzerdefinierte Domain endet normalerweise mit
.my.salesforce.com. - Wählen Sie für Authentifizierungstyp Client Credentials.
- Geben Sie unter Authentication die Client-ID und das Geheimnis ein.
Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit AES-256-Verschlüsselung gespeichert.
- Wählen Sie die Umgebungen aus, die für die Verbindung verwendet werden sollen, und klicken Sie auf Speichern.
- Um die Verbindung zu testen, erstellen und führen Sie mit dem Befehl Berichte auflisten des Konnektors eine Kette aus und prüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.
Fehlersuche
Wenn die Verbindung zu Salesforce fehlschlägt, können Sie je nach Authentifizierungstyp verschiedene Konfigurationseinstellungen überprüfen.
OAuth2-Authentifizierung
Wenn die Verbindung mit der verbundenen Salesforce-Anwendung fehlschlägt, wenn Sie zum ersten Mal auf Connect klicken, klicken Sie auf Stop und warten Sie, bis die Verbindung wieder hergestellt ist. Wenn die Verbindung mit der OAuth2-Authentifizierung weiterhin fehlschlägt:
- Vergewissern Sie sich, dass die richtige Salesforce-Instanz oder benutzerdefinierte Domäne für den Connector eingegeben wurde.
- Überprüfen Sie die Client-ID und das Geheimnis der mit Salesforce verbundenen Anwendung, die der Connector verwendet.
- In der verbundenen Salesforce-App:
- Überprüfen Sie, ob die Rückruf-URL lautet:
- PROD -
https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback - EMEA -
https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback - APAC -
https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
- PROD -
- Stellen Sie sicher, dass die ausgewählten OAuth-Bereiche Perform requests on your behalf at any time (refresh_token, offline_access) und mindestens einen weiteren Bereich umfassen.
- Überprüfen Sie, ob die Rückruf-URL lautet:
Wenn der Connector die Verbindung zur Salesforce-App verliert:
- Klicken Sie unter Chains auf Connections , wählen Sie die Verbindung aus und klicken Sie auf Edit.
- Klicken Sie unter OAuth auf Reset.
- Um den Connector für die Verbindung zu Salesforce zu aktivieren, klicken Sie auf Allow.
Basis-Authentifizierung
Wenn die Verbindung mit der Basisauthentifizierung fehlschlägt:
- Überprüfen Sie die Anmeldedaten und das Sicherheits-Token des Integrationsbenutzers. Um ein neues Sicherheitstoken in Salesforce anzufordern, melden Sie sich als Integrationsbenutzer an und wählen Sie Einstellungen, Meine persönlichen Informationen, und klicken Sie auf Sicherheitstoken zurücksetzen.
- Vergewissern Sie sich, dass die richtige Salesforce-Instanz oder benutzerdefinierte Domäne für den Connector eingegeben wurde.
- Stellen Sie sicher, dass der Integrationsbenutzer über die Berechtigungen API Enabled verfügt, zusätzlich zu den Berechtigungen, die sich auf alle Aufgaben beziehen, die der Connector ausführt.
Authentifizierung von Client-Zugangsdaten
Wenn die Verbindung mit der Client-Authentifizierung fehlschlägt:
- Vergewissern Sie sich, dass die richtige Salesforce-Instanz oder benutzerdefinierte Domäne für den Connector eingegeben wurde.
- Überprüfen Sie die Client-ID und das Geheimnis der mit Salesforce verbundenen Anwendung, die der Connector verwendet.