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

Dieser Connector unterstützt die Aktivierung der erneuten 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 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 Symbol für Variablen 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 Symbol für Variablen klicken, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem 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 verwendet, um den Salesforce-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • 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 unverändert. 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-Faktor-Authentifizierung für 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.

    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, das mit dem Salesforce-Konto verbundene Sicherheitstoken ein, das durch die Sicherheitskonfiguration der Salesforce-Instanz gefordert wird. Weitere Informationen finden Sie in der Salesforce-Dokumentation zu Ihrem Sicherheitstoken zurücksetzen oder Wenn die Option "Sicherheitstoken zurücksetzen" nicht angezeigt wird.

  • Test: Klicken Sie, um die Verbindung mit den angegebenen 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 zugänglich. Weitere Details finden Sie in den Aktionsmenüs in den Connector-Grundlagen.

Nach der Konfiguration einer Salesforce-Verbindung können Sie eine oder mehrere Salesforce-Aktivitäten, die mit dieser Verbindung verbunden sind, konfigurieren, um sie entweder als Quelle zur Bereitstellung von Daten für einen Vorgang oder als Ziel zur Verarbeitung von Daten in einem Vorgang 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 vorgesehen zur Verwendung als Quelle zur Bereitstellung von Daten in einem Vorgang.

  • Einfügen: Fügt neue Daten in Salesforce ein und ist vorgesehen zur Verwendung als Ziel zur Verarbeitung von Daten in einem Vorgang.

  • Aktualisieren: Aktualisiert vorhandene Daten in Salesforce und ist vorgesehen zur Verwendung als Ziel zur Verarbeitung von Daten in einem Vorgang.

  • Upsert: Aktualisiert sowohl vorhandene Daten als auch fügt neue Daten in Salesforce ein und ist vorgesehen zur Verwendung als Ziel zur Verarbeitung von Daten in einem Vorgang.

  • Löschen: Löscht Daten in Salesforce und ist vorgesehen zur Verwendung als Ziel zur Verarbeitung von Daten in einem Vorgang.

  • Bulk-Abfrage: Abfragen einer großen Anzahl von Datensätzen aus Salesforce und vorgesehen zur Verwendung als Quelle zur Bereitstellung von Daten in einem Vorgang.

  • Bulk-Einfügen: Fügt eine große Anzahl neuer Datensätze in Salesforce ein und ist vorgesehen zur Verwendung als Ziel zur Verarbeitung von Daten in einem Vorgang.

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

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

  • Bulk Delete: Löscht eine große Anzahl von Datensätzen aus Salesforce und ist als Ziel gedacht, um Daten in einer Operation 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 einer Operation zu konsumieren. 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.