Zum Inhalt springen

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

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zur Verbindung des App Builders mit einer Salesforce ADO.NET-Datenquelle. Diese Verbindung nutzt einen OAuth-Sicherheitsanbieter mit dem Autorisierungscode-Grant-Typ.

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 der Sandbox-Umgebung abgeschlossen werden.

Erstellen Sie eine benutzerdefinierte OAuth-App in Salesforce

  1. Melden Sie sich bei Salesforce.com oder Ihrer Salesforce-Sandbox-Umgebung an.

  2. Gehen Sie von der Startseite zu Platform Tools > Apps > App Manager.

  3. Klicken Sie auf die Schaltfläche Neue verbundene App.

  4. Geben Sie einen Namen ein, der den Benutzern angezeigt wird, wenn sie sich anmelden, um Berechtigungen für Ihre App zu gewähren, sowie eine Kontakt-Email-Adresse.

  5. Klicken Sie auf OAuth-Einstellungen aktivieren.

  6. Geben Sie einen Wert im Feld Callback-URL ein. Dies sollte die URL Ihrer App Builder-Instanz mit einem angehängten Sicherheitsanbieter sein.

    Hinweis

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

  7. Ausgewählte OAuth-Berechtigungen sollten auf den Umfang der Berechtigungen eingestellt sein, die die Anwendung vom Benutzer anfordern sollte.

    1. Stellen Sie auf "Vollzugriff (full)" und "Anfragen jederzeit durchführen (refresh_token,offline_acesss)" ein.

    Graphische Benutzeroberfläche, Anwendung Beschreibung automatisch generiert

  8. Klicken Sie auf Verbraucherdetails verwalten, um die Client-ID und den Secret-Wert anzuzeigen. Notieren Sie sich diese Werte an einem Ort, der leicht referenziert werden kann, wenn Sie von App Builder aus konfigurieren.

Erstellen Sie einen OAuth-Sicherheitsanbieter im App Builder

  1. Richten Sie einen Sicherheitsanbieter im App Builder ein, indem Sie zu IDE > Sicherheitsanbieter navigieren.

  2. Klicken Sie auf die Schaltfläche + Datenquellenauthentifizierung.

  3. Geben Sie die folgenden Details an:

    • Name: Identifiziert den Sicherheitsanbieter und erscheint gelegentlich in der URL. Beispiel: Salesforce

    • Typ: OAuth

    • Authentifizierungstyp: OAuth

    • OAuth-Zugriffsberechtigung: Autorisierungscode

    • OAuth-Client-Authentifizierung: Basic

    • OAuth-Ressourcen-Authentifizierung: Bearer

    • Token-Besitzer: Benutzer

    • Umleitung bei Herausforderung: Wahr

    attachment

  4. Klicken Sie auf + Endpunkte und konfigurieren Sie die folgenden 3 Datensätze:

  5. Klicken Sie auf + Anmeldeinformationen und erstellen Sie den folgenden Datensatz:

    • Typ: Client

    • Benutzername: Client-ID von Salesforce

    • Passwort: Geheimnis von Salesforce

  6. Klicken Sie auf + Anspruch und erstellen Sie die folgenden 3 Datensätze für die Benutzerbereitstellung:

    • Name: preferred_username

    • Name ID: preferred_username

    • Email-Adresse: email

attachment

Erstellen Sie die Salesforce ADO.NET-Datenquelle im App Builder

  1. Gehen Sie zur App Builder IDE und klicken Sie auf Datenserver.

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

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

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

  5. Erweitern Sie die Sicherheitseinstellungen und setzen Sie den Sicherheitsanbieter auf den, den wir erstellt haben. Beispiel: SalesForce

    attachment

  6. Wenn Sie schließlich eine Salesforce-Sandbox-Umgebung verwenden, klicken Sie 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 von innerhalb des App Builders auf sie zugreifen zu können.

Fehlerbehebung

Wenn Sie Probleme mit Salesforce ADO.NET haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

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

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

Ressourcen