Zum Inhalt springen

Salesforce-Verbindung

Einführung

Eine Salesforce-Verbindung, die mit dem Salesforce-Connector erstellt wurde, ermöglicht den Zugriff auf Salesforce. Sobald eine Verbindung konfiguriert ist, können Instanzen von Salesforce-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind und entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Hinweis

Für die Verwendung von 2-beiniger OAuth 2.0 mit dem Salesforce-Connector ist die Agent-Version 11.59 / 12.3 oder höher erforderlich.

Dieser Connector unterstützt die Re-Authentifizierung bei Änderung Organisationsrichtlinie. Wenn aktiviert, erfordert eine Änderung des Serverhosts oder Benutzernamens in dieser Verbindung, dass die Benutzer das Passwort und das Sicherheitstoken für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer Salesforce-Verbindung

Eine neue Salesforce-Verbindung wird mit dem Salesforce-Connector von einem dieser Standorte aus erstellt:

Eine vorhandene Salesforce-Verbindung kann von diesen Standorten aus bearbeitet werden:

Konfigurieren einer Salesforce-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Salesforce-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Salesforce-Verbindung zu identifizieren. Der Name muss für jede Salesforce-Verbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Salesforce-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungstyp: Wählen Sie den Authentifizierungstyp aus, um eine Verbindung zu Salesforce herzustellen, entweder Basic Auth oder OAuth 2.0 Client Credentials.

    Wählen Sie Basic Auth, um diese Felder anzuzeigen:

    • Server-Host: Geben Sie die URL des Salesforce-Servers ein. Wenn Sie eine Produktionsinstanz verwenden, lassen Sie die Standard-URL als https://login.salesforce.com stehen. Wenn Sie eine Sandbox-Instanz verwenden, aktivieren Sie das Kontrollkästchen Sandbox unten.

    • Sandbox: Wenn Sie eine Salesforce-Sandbox-Instanz verwenden, aktivieren Sie dieses Kontrollkästchen, um das Feld Server-Host oben auf https://test.salesforce.com umzuschalten.

    • Benutzername: Geben Sie den Benutzernamen für das Salesforce-Konto ein. Ein Salesforce-Konto, bei dem die Multi-Faktor-Authentifizierung (MFA) nicht aktiviert ist, ist erforderlich.

      Um ein Salesforce-Konto ohne MFA zu konfigurieren, stellen Sie sicher, dass das Berechtigungsset, das dem Salesforce-Systemintegrations-Login zugewiesen ist, nicht die Auswahl Multi-Factor Authentication for API Logins hat. Systemintegrations-Login-Typen sind von der MFA-Anforderung von Salesforce ausgenommen, wie von Salesforce in Ist MFA für meine Integrationsbenutzer erforderlich? in ihrer Dokumentation Salesforce Multi-Factor Authentication FAQ beschrieben.

  • Passwort: Geben Sie das Passwort für das Salesforce-Konto ein.

    !!! caution "Vorsicht"
    Ein Salesforce-Passwort, das erweiterte ASCII-Zeichen wie £ verwendet, kann beim Abrufen von Daten während der Aktivitätskonfiguration den folgenden Fehler verursachen:

    ```
    Ungültiger Benutzername, Passwort, Sicherheitstoken; oder Benutzer gesperrt. [INVALID_LOGIN]
    ```

    In diesem Fall kann der Verbindungstest dennoch erfolgreich sein. Wenn Sie diesen Fehler während der Aktivitätskonfiguration erhalten und Sonderzeichen im Passwort verwenden, versuchen Sie, das Passwort zu ändern.

  • Sicherheitstoken: Geben Sie, falls erforderlich durch die Sicherheitskonfiguration der Salesforce-Instanz, das mit dem Salesforce-Konto verbundene Sicherheitstoken ein. Weitere Informationen finden Sie in der Salesforce-Dokumentation zu Ihrem Sicherheitstoken zurücksetzen oder Wenn die Option "Sicherheitstoken zurücksetzen" nicht angezeigt wird.

    Wählen Sie OAuth 2.0-Clientanmeldeinformationen aus, um diese Felder anzuzeigen:

  • Instanz-URL: Geben Sie die Salesforce-Instanz-URL ein.

  • Client-ID: Geben Sie die Client-ID aus Ihrer konfigurierten Salesforce-App ein.

  • Client-Geheimnis: Geben Sie das Client-Geheimnis aus Ihrer konfigurierten Salesforce-App ein.

    Weitere Informationen finden Sie in den 2-beinigen OAuth 2.0-Voraussetzungen.

    Hinweis

    Agent-Version 11.59 / 12.3 oder höher ist erforderlich, um 2-beiniges OAuth 2.0 mit dem Salesforce-Connector zu verwenden.

  • Test: Klicken Sie, um die Verbindung mit den bereitgestellten Anmeldeinformationen zu überprüfen.

  • Änderungen speichern: Klicken Sie, um die Verbindungsconfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen wurden, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

  • Löschen: Nachdem eine bestehende Verbindungs-Konfiguration geöffnet wurde, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Nächste Schritte

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Design-Komponentenpalette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Nachdem eine Salesforce-Verbindung konfiguriert wurde, können Sie eine oder mehrere Salesforce-Aktivitäten konfigurieren, die mit dieser Verbindung verknüpft sind, um sie entweder als Quelle zur Bereitstellung von Daten für eine Operation oder als Ziel zur Verarbeitung von Daten in einer Operation zu verwenden, oder Sie können die Salesforce-Verbindung in einem Skript verwenden.

Aktivitäten konfigurieren

Es stehen elf Aktivitäten zur Verfügung, fünf Standard- und sechs Bulk-Aktivitäten. Bulk-Aktivitäten sollten nur verwendet werden, wenn keine Transformation erforderlich ist, um Daten vor dem Erreichen des Ziels zu ändern.

  • Abfrage: Abfragen von Daten aus Salesforce und soll als Quelle zur Bereitstellung von Daten in einer Operation verwendet werden.

  • Einfügen: Fügt neue Daten in Salesforce ein und soll als Ziel zur Verarbeitung von Daten in einer Operation verwendet werden.

  • Aktualisieren: Aktualisiert vorhandene Daten in Salesforce und soll als Ziel zur Verarbeitung von Daten in einer Operation verwendet werden.

  • Upsert: Aktualisiert sowohl vorhandene Daten als auch fügt neue Daten in Salesforce ein und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

  • Delete: Löscht Daten in Salesforce und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

  • Bulk Query: Abfragt eine große Anzahl von Datensätzen aus Salesforce und ist als Quelle gedacht, um Daten in einem Vorgang bereitzustellen.

  • Bulk Insert: Fügt eine große Anzahl neuer Datensätze in Salesforce ein und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

  • Bulk Update: Aktualisiert eine große Anzahl vorhandener Datensätze in Salesforce und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

  • Bulk Upsert: Aktualisiert eine große Anzahl vorhandener Datensätze und fügt eine große Anzahl neuer Datensätze in Salesforce ein und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

  • Bulk Delete: Löscht eine große Anzahl von Datensätzen aus Salesforce und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren. Gelöschte Datensätze werden vor der endgültigen Löschung im Salesforce-Papierkorb gespeichert.

  • Bulk Hard Delete: Löscht eine große Anzahl von Datensätzen aus Salesforce dauerhaft und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren. Hart gelöschte Datensätze werden automatisch für die Löschung berechtigt.

Verwenden Sie Salesforce-Verbindungen in Skripten

Salesforce-Verbindungen können in einem Skript unter Verwendung von Skriptfunktionen referenziert werden, die ein salesforceOrg als Parameter verwenden. Weitere Informationen finden Sie unter Verwenden Sie Salesforce-Funktionen.