Verbindung zu Salesforce

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-Anmeldedaten, wobei ausschließlich eine Client-ID und ein Geheim
verwendet werden

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.

Für die OAuth-Authentifizierung ist zusätzlich die Verwendung einer mit Salesforce verbundenen App erforderlich. Um diese in Salesforce zu erstellen, rufen Sie auf, richten Sie die App ein und nehmen Sie die folgenden erforderlichen Einstellungen vor:

Geben Sie unter „ “ (Callback-URL) eine der folgenden Optionen ein, die zu Ihrem AppSpot passt:
- USA, Mittelamerika, Südamerika: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
- APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
- Kanada: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
- EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
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 „ -Administratorberechtigungen“ () die Option „ -API aktiviert“ aus.
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.

Für die Authentifizierung über Client-Anmeldeinformationen ist die Verwendung einer mit Salesforce verbundenen App erforderlich. Um diese in Salesforce zu erstellen, richten Sie die App unter mithilfe des Ablaufs „ “ (Client-Anmeldeinformationen) 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.

Rufen Sie unter den Chain Builder auf, klicken Sie auf compare_arrows „Connections“ in der linken Seitenleiste und anschließend auf compare_arrows „Create“ 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 Domain ein, zu 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-Domain verwendet, lassen Sie dieses Feld leer.

Hinweis: In Ihrer Salesforce-URL stehen die Zeichen vor `salesforce.com`-wie `na73`-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, den geheimen Schlüssel und den Geltungsbereich unter „ “ (Authentifizierung) ein und klicken Sie anschließend auf „ “ (Verbinden).

Hinweis: Wenn die Verbindung zu Salesforce erfolgreich hergestellt wurde, werden das Refresh-Token des Konnektors , das Refresh-Token und das Zugriffstoken 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.

Rufen Sie unter den Chain Builder auf, klicken Sie auf compare_arrows „Connections“ in der linken Seitenleiste und anschließend auf compare_arrows „Create“ 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 Domain ein, zu 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`-wie `na73`-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.

Rufen Sie unter den Chain Builder auf, klicken Sie auf compare_arrows „Connections“ in der linken Seitenleiste und anschließend auf compare_arrows „Create“ 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 Domain ein, zu 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“ und „` “ – wie beispielsweise „ `“, „na73“ und „`“ – 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 Callback-URL korrekt ist:
- Für die USA, Mittelamerika und Südamerika: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
- Für den asiatisch-pazifischen Raum: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
- Für Kanada: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
- Für EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
- 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.

Wenn der Connector die Verbindung zur Salesforce-App verliert:

Klicken Sie unter „ “ auf „Chain Builder“, dann auf „ “ compare_arrows „Connections“ in der linken Seitenleiste und anschließend auf „ “ „Edit“ (Bleistift-Symbol) für die Verbindung.
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.

Support

Community

Workiva Support Center