Zum Inhalt springen

Salesforce-Verbindung

Einführung

Eine Salesforce-Verbindung, die mit dem Salesforce-Connector erstellt wird, ermöglicht den Zugriff auf Salesforce. Nach der Konfiguration einer Verbindung können Sie Instanzen von Salesforce-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden.

Hinweis

Agent-Version 11.59 / 12.3 oder später ist erforderlich, um 2-legged OAuth 2.0 mit dem Salesforce-Connector zu verwenden.

Dieser Connector unterstützt die Organisationsrichtlinie Re-Authentifizierung bei Änderung aktivieren. Wenn diese aktiviert ist, erfordert eine Änderung des Server-Hosts oder des Benutzernamens in dieser Verbindung, dass Benutzer das Passwort und das Sicherheits-Token für die Verbindung erneut eingeben.

Salesforce-Verbindung erstellen oder bearbeiten

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

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

Salesforce-Verbindung konfigurieren

Nachfolgend wird jedes Element der Benutzeroberfläche des Salesforce-Verbindungskonfigurationsbildschirms beschrieben.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • 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 zur Identifizierung des Salesforce-Endpunkts verwendet, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

  • Authentifizierungstyp: Wählen Sie den Authentifizierungstyp für die Verbindung mit Salesforce aus, 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, behalten Sie die Standard-URL https://login.salesforce.com bei. 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 ohne aktivierte Multi-Faktor-Authentifizierung (MFA) ist erforderlich.

      Um ein Salesforce-Konto ohne MFA zu konfigurieren, stellen Sie sicher, dass die dem Salesforce-Systemintegrations-Login zugewiesene Berechtigungssatz nicht die Option Multi-Faktor-Authentifizierung für API-Logins ausgewählt 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.

  • Sicherheits-Token: Falls die Sicherheitskonfiguration der Salesforce-Instanz dies erfordert, geben Sie das Sicherheits-Token ein, das dem Salesforce-Konto zugeordnet ist. Weitere Informationen finden Sie in der Salesforce-Dokumentation unter Reset Your Security Token oder Unable to see the Reset Security Token option.

    Wählen Sie OAuth 2.0 Client Credentials aus, um diese Felder anzuzeigen:

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

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

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

    Weitere Informationen finden Sie unter 2-legged OAuth 2.0 prerequisites.

    Hinweis

    Agent-Version 11.59 / 12.3 oder später ist erforderlich, um 2-legged OAuth 2.0 mit dem Salesforce-Connector zu verwenden.

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

  • Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine vorhandene Verbindungskonfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Component dependencies, deletion, and removal). Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Designkomponentenpalette zugänglich. Weitere Informationen finden Sie unter Actions menus in Connector basics.

Nach der Konfiguration einer Salesforce-Verbindung können Sie eine oder mehrere Salesforce-Aktivitäten konfigurieren, die dieser Verbindung zugeordnet sind. Diese können entweder als Quelle zum Bereitstellen von Daten für einen Vorgang oder als Ziel zum Verarbeiten von Daten in einem Vorgang verwendet werden, oder Sie können die Salesforce-Verbindung in einem Skript verwenden.

Aktivitäten konfigurieren

Es sind elf Aktivitäten verfügbar, fünf Standard- und sechs Bulk-Aktivitäten. Bulk-Aktivitäten sollten nur verwendet werden, wenn Sie keine Transformation benötigen, um Daten vor dem Erreichen des Ziels zu ändern.

  • Query: Fragt Daten aus Salesforce ab und ist für die Verwendung als Quelle zum Bereitstellen von Daten in einem Vorgang vorgesehen.

  • Insert: Fügt neue Daten in Salesforce ein und ist für die Verwendung als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Update: Aktualisiert vorhandene Daten in Salesforce und ist für die Verwendung als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in Salesforce ein und ist für die Verwendung als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Delete: Löscht Daten in Salesforce und ist für die Verwendung als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Bulk Query: Fragt eine große Anzahl von Datensätzen aus Salesforce ab und soll als Quelle verwendet werden, um Daten in einem Vorgang bereitzustellen.

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

  • Bulk Update: Aktualisiert eine große Anzahl vorhandener Datensätze in Salesforce und soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten.

  • Bulk Upsert: Aktualisiert eine große Anzahl vorhandener Datensätze und fügt gleichzeitig eine große Anzahl neuer Datensätze in Salesforce ein. Diese Aktivität soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten.

  • Bulk Delete: Löscht eine große Anzahl von Datensätzen aus Salesforce und soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten. Gelöschte Datensätze werden im Salesforce-Papierkorb gespeichert, bevor sie endgültig gelöscht werden.

  • Bulk Hard Delete: Löscht eine große Anzahl von Datensätzen endgültig aus Salesforce und soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten. Endgültig gelöschte Datensätze werden automatisch zum Löschen freigegeben.

Salesforce-Verbindungen in Skripten verwenden

Auf Salesforce-Verbindungen kann in einem Skript mithilfe von Skriptfunktionen verwiesen werden, die einen salesforceOrg als Parameter verwenden. Weitere Informationen finden Sie unter Salesforce-Funktionen verwenden.