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 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 erstellt:

Eine vorhandene Salesforce-Verbindung kann von diesen Standorten 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 enthält. 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.

    • Sicherheitstoken: Wenn dies durch die Sicherheitskonfiguration der Salesforce-Instanz erforderlich ist, geben Sie das mit dem Salesforce-Konto verknüpfte Sicherheitstoken ein. Weitere Informationen finden Sie in der Salesforce-Dokumentation zu Sicherheitstoken zurücksetzen oder Option zum Zurücksetzen des Sicherheitstokens nicht sichtbar.

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

    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-beinigen 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 Konfiguration der Verbindung zu speichern und zu schließen.

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

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, 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 löschen möchten.

Nächste Schritte

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Designkomponenten-Palette verfügbar. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Nachdem eine Salesforce-Verbindung konfiguriert wurde, können ein oder mehrere Salesforce-Aktivitäten, die mit dieser Verbindung verbunden sind, konfiguriert werden, um entweder als Quelle zur Bereitstellung von Daten für eine Operation oder als Ziel zur Nutzung von Daten in einer Operation verwendet zu werden, oder die Salesforce-Verbindung kann in einem Skript verwendet werden.

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: Abfragt Daten aus Salesforce und ist als Quelle zur Bereitstellung von Daten in einer Operation gedacht.

  • Einfügen: Fügt neue Daten in Salesforce ein und ist als Ziel zur Nutzung von Daten in einer Operation gedacht.

  • Aktualisieren: Aktualisiert vorhandene Daten in Salesforce und ist als Ziel zur Nutzung von Daten in einer Operation gedacht.

  • Upsert: Aktualisiert sowohl vorhandene Daten als auch fügt neue Daten in Salesforce ein und ist als Ziel zur Nutzung von Daten in einer Operation gedacht.

  • Löschen: Löscht Daten in Salesforce und ist als Ziel zur Nutzung von Daten in einer Operation gedacht.

  • Bulk Query: Abfragen einer großen Anzahl von Datensätzen aus Salesforce, die als Quelle zur Bereitstellung von Daten in einem Vorgang verwendet werden soll.

  • Bulk Insert: Einfügen einer großen Anzahl neuer Datensätze in Salesforce, die als Ziel zur Verarbeitung von Daten in einem Vorgang verwendet werden soll.

  • Bulk Update: Aktualisieren einer großen Anzahl bestehender Datensätze in Salesforce, die als Ziel zur Verarbeitung von Daten in einem Vorgang verwendet werden soll.

  • Bulk Upsert: Sowohl Aktualisieren einer großen Anzahl bestehender Datensätze als auch Einfügen einer großen Anzahl neuer Datensätze in Salesforce, die als Ziel zur Verarbeitung von Daten in einem Vorgang verwendet werden soll.

  • Bulk Delete: Löschen einer großen Anzahl von Datensätzen aus Salesforce, die als Ziel zur Verarbeitung von Daten in einem Vorgang verwendet werden soll. Gelöschte Datensätze werden vor der endgültigen Löschung im Salesforce Papierkorb gespeichert.

  • Bulk Hard Delete: Hartes Löschen einer großen Anzahl von Datensätzen aus Salesforce, die als Ziel zur Verarbeitung von Daten in einem Vorgang verwendet werden soll. Hart gelöschte Datensätze werden automatisch für die Löschung berechtigt.

Use Salesforce connections in scripts

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