Zum Inhalt springen

Salesforce ADO.NET-Verbindungshandbuch für Jitterbit App Builder

Übersicht

In diesem Handbuch werden die Systemanforderungen und Anweisungen zum Verbinden von App Builder mit einer Salesforce ADO.NET-Datenquelle beschrieben. Diese Verbindung nutzt einen OAuth Security Provider mit dem Authorization Code Grant Type.

Systemanforderungen

Datenbankserver

Salesforce-Konto mit ADO.NET

Client-Webbrowser

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Verbindungsanweisungen

Der folgende Schritt ist eine Voraussetzung und sollte in der Salesforce-App oder Sandbox-Umgebung durchgeführt werden.

Erstelle eine benutzerdefinierte OAuth-App in Salesforce

  1. Melde dich bei Salesforce.com oder deiner Salesforce Sandbox-Umgebung an

  2. Gehe auf der Startseite zu Platform Tools > Apps > App Manager

  3. Klicke auf die Schaltfläche New Connected App

  4. Gib einen Namen ein, der Benutzern angezeigt wird, wenn sie sich anmelden, um Berechtigungen für deine App zu erteilen, zusammen mit einer Kontakt-E-Mail-Adresse

  5. Klicke auf Enable OAuth Settings

  6. Gib einen Wert in das Feld Callback URL ein. Dies sollte die URL deiner App Builder-Instanz mit einem angehängten Security Provider sein.

    Hinweis

    Die Groß- und Kleinschreibung ist wichtig. Der Name des Security Providers, den wir als Nächstes erstellen, muss mit der Groß- und Kleinschreibung der Callback URL übereinstimmen.

  7. Selected OAuth Scopes sollte auf den Umfang der Berechtigungen eingestellt werden, die die Anwendung vom Benutzer anfordern sollte.

    1. Stelle auf „Full access (full)" und „Perform requests at any time (refresh_token,offline_acesss)" ein

    Graphical user interface, application Description automatically generated

  8. Klicke auf Manage Consumer Details, um die Werte Client ID und Secret anzuzeigen. Notiere diese Werte an einem Ort, auf den du leicht zugreifen kannst, wenn du die Konfiguration in App Builder durchführst.

Erstelle einen OAuth Security Provider in App Builder

  1. Richte einen Security Provider in App Builder ein, indem du zu IDE > Security Providers navigierst

  2. Klicke auf die Schaltfläche + Security Provider

  3. Gib die folgenden Details an:

    • Name: Identifiziert den Security Provider und wird gelegentlich in der URL angezeigt. Beispiel: Salesforce

    • Type: OAuth

    • Authentication Type: OAuth

    • OAuth Grant: Authorization Code

    • OAuth Client Authentication: Basic

    • OAuth Resource Authentication: Bearer

    • Token Owner: User

    • Redirect on Challenge: True

    attachment

  4. Klicke auf + Endpoints und konfiguriere die folgenden 3 Datensätze:

  5. Klicke auf + Credential und erstelle den folgenden Datensatz:

    • Type: Client

    • User Name: Client ID von Salesforce

    • Password: Secret von Salesforce

  6. Klicke auf + Claim und erstelle die folgenden 3 Datensätze für die Benutzerbereitstellung:

    • Name: preferred_username

    • Name ID: preferred_username

    • E-mail Address: email

attachment

Erstelle die Salesforce ADO.NET-Datenquelle in App Builder

  1. Gehe zur App Builder IDE und klicke auf Data Servers

  2. Klicke auf die Schaltfläche + Server, um eine neue Datenquelle hinzuzufügen

  3. Weisen Sie einen Servernamen zu. Dieser Name muss mit der in Salesforce konfigurierten Callback-URL übereinstimmen. Beispiel: SalesForce

  4. Wählen Sie den Typ als Salesforce ADO.NET

  5. Erweitern Sie die Sicherheitseinstellungen und legen Sie den Sicherheitsanbieter auf den von uns erstellten fest. Beispiel: SalesForce

    attachment

  6. Wenn Sie eine Salesforce-Sandbox-Umgebung verwenden, klicken Sie abschließend auf die Schaltfläche Erweiterte Einstellungen und konfigurieren Sie die OAuth-Server-URL

attachment

  1. Erweitern Sie Testen und klicken Sie auf die Schaltfläche Verbindung testen, um sicherzustellen, dass die Konfiguration wie erwartet funktioniert.

Hinweis

Ein Import der Salesforce-Tabellen muss durchgeführt werden, um auf diese aus App Builder zugegriffen zu können.

Fehlerbehebung

Wenn Sie Probleme mit Salesforce ADO.NET haben, werden diese Fehlerbehebungsschritte empfohlen:

  1. Aktivieren Sie Datenprotokollierung, um Protokolldateien und Daten zu generieren, die Sie herunterladen und überprüfen können.

  2. Lesen Sie die CData ADO.NET Provider für Salesforce-Dokumentation für detaillierte Informationen.

Ressourcen