Zum Inhalt springen

Salesforce Connect einrichten, um eine Jitterbit Design Studio OData API im Jitterbit API Manager zu konsumieren

Einführung

Diese Seite beschreibt, wie Salesforce Connect (ehemals Salesforce Lightning Connect) eingerichtet und konfiguriert wird, um sicher eine OData API zu konsumieren und die Daten in Echtzeit anzuzeigen. Das gezeigte Beispiel wird Daten aus einer SAP-Quelle unter Verwendung des OData 2.0-Protokolls bereitstellen und anzeigen.

Voraussetzungen

  1. Ihre Salesforce-Org muss für den Zugriff auf die Salesforce Connect-Module, einschließlich externer Datenquellen und externer Objekte, bereitgestellt sein.
  2. Ein neues Projekt erstellen in Design Studio.
  3. Eine Jitterbit-Entität erstellen in Design Studio.
  4. Eine API-Entitätsoperation erstellen in Design Studio.
  5. OData API-Konfiguration in API Manager.

Eine externe Datenquelle und ein externes Objekt in Salesforce erstellen

  1. Melden Sie sich bei Ihrer Salesforce-Org an. Scrollen Sie im linken Bereich der Seite zu Build, wählen Sie Develop und dann Externe Datenquellen. Sie benötigen Zugriff auf diese Funktionen, um Salesforce Connect einzurichten. Wenn Sie keinen Zugriff auf diese Funktionen haben, wenden Sie sich an Ihren Salesforce-Vertreter:

    attachment

  2. Klicken Sie auf die Schaltfläche Neue externe Datenquelle:

    attachment

    • Pflichtfelder zeigen einen roten vertikalen Balken links neben dem Feld an.

    • Externe Datenquelle: Geben Sie den Namen der OData-API in das Feld Externe Datenquelle ein.

    • Name: Drücken Sie die Tab-Taste. Das Namensfeld wird automatisch mit dem Namen der OData-API ausgefüllt. Die API Externe Datenquelle und Name können identisch sein.

    • Typ: Klicken Sie in das Feld Typ und wählen Sie Salesforce Connect: OData 2.0 aus der Dropdown-Liste aus.

      Hinweis

      Harmony unterstützt derzeit nur OData 2.0.

    • URL: Geben Sie die vollständige URL Ihrer OData-API in das Feld URL ein oder fügen Sie sie ein. (Auf der APIs-Seite im API Manager fahren Sie mit der Maus über die API-Kachel und klicken Sie auf den Link URL kopieren.)

      Hinweis

      Stellen Sie sicher, dass die URL mit HTTPS (und nicht mit HTTP) beginnt. Wenn Sie eine HTTP-URL verwenden, sind die Daten bei der Anforderung und Rücksendung an Salesforce nicht geschützt.

    • Schreibbare externe Objekte:

      • Aktivieren Sie dieses Kästchen, wenn Sie Salesforce erlauben möchten, Daten in der SAP- oder Datenbankquelle über die OData-API zu POSTEN, PUTTEN, LÖSCHEN oder ZUSAMMENZUFÜGEN. In diesem Fall werden mehrere Operationen der API zugewiesen, die eine oder mehrere dieser Methoden zugewiesen bekommen.
      • Lassen Sie dieses Kästchen für den Nur-Lese-Zugriff deaktiviert. In diesem Fall muss die Betriebsart in der OData-API auf GET gesetzt werden.
    • Identitätstyp: Klicken Sie in dieses Feld und wählen Sie Benannter Principal aus der Dropdown-Liste aus, wenn Sie Profile der API zugewiesen haben und wenn Sie einen zentralen Namen für alle Ihre Salesforce-Benutzer verwenden möchten.

    • Authentifizierungsprotokoll: Klicken Sie in dieses Feld und wählen Sie das entsprechende Authentifizierungsprotokoll aus der Dropdown-Liste basierend auf dem Sicherheitsprofil, das der API zugewiesen ist.

      • Zusätzliche Felder werden je nach ausgewähltem Protokoll angezeigt.
      • Im obigen Beispiel wurde Passwortauthentifizierung ausgewählt und die Felder Benutzername und Passwort wurden angezeigt. Geben Sie den entsprechenden Benutzernamen und Passwort ein.
    • Klicken Sie auf Speichern.

  3. Scrollen Sie nach unten zum Abschnitt Authentifizierung. Klicken Sie auf die Schaltfläche Validieren und Synchronisieren:

    attachment

  4. Die Seite Externe Datenquelle validieren zeigt an:

    attachment

    • Klicken Sie auf das entsprechende Kontrollkästchen, um den Tabellennamen auszuwählen. In diesem Beispiel wurde Kunden ausgewählt.
    • Klicken Sie auf die Sync-Schaltfläche, um die URL zu überprüfen, zu validieren, dass das Format akzeptabel ist, und automatisch ein neues Externes Objekt in Salesforce zu erstellen.
  5. Scrollen Sie nach unten zum Abschnitt Authentifizierung:

    attachment

    • Der Abschnitt Externe Objekte zeigt das neue externe Objekt an, das Sie erstellt haben.
    • Externe Objekte in Salesforce sind ähnlich wie andere benutzerdefinierte Objekte, mit dem Unterschied, dass die Daten nicht in Salesforce gespeichert werden. Die Daten werden in Echtzeit aus der Datenquelle abgerufen. Das externe Objekt unterstützt APIs und andere Anpassungen. Denken Sie daran, beim Verwenden eines externen Objekts immer einen Filter bereitzustellen, um die Daten zu verfeinern.
    • Siehe die Salesforce-Dokumentation Externe Objekte definieren für weitere Informationen zu externen Objekten in Salesforce.

Erstellen Sie eine neue benutzerdefinierte Registerkarte in Salesforce

  1. Scrollen Sie im linken Bereich der Seite zu Build, wählen Sie Create und dann Tabs:

    attachment

  2. Scrollen Sie nach unten zum Abschnitt Benutzerdefinierte Objekt-Registerkarten und klicken Sie auf Neu, um eine neue Registerkarte in Salesforce zu erstellen:

    attachment

  3. Neue benutzerdefinierte Objekt-Registerkarte, Schritt 1 von 3:

    attachment

    • Objekt: Klicken Sie in das Feld Objekt und wählen Sie das neue externe Objekt aus der Dropdown-Liste aus. In diesem Beispiel wurde Kunden ausgewählt.
    • Registerkartenstil: Klicken Sie auf das Feld Registerkartenstil, um ein Popup mit Stiloptionen anzuzeigen. Wählen Sie einen Registerkartenstil im Popup aus.
    • Beschreibung: Geben Sie eine kurze Beschreibung des externen Objekts ein.
    • Klicken Sie auf Weiter.
  4. Neuer benutzerdefinierter Objekt-Tab, Schritt 2 von 3:

    attachment

    • Passen Sie die Sichtbarkeit des Tabs mit Profilen nach Wunsch an. In diesem Beispiel ist die Tab-Sichtbarkeit für alle Profile auf Standardmäßig ein gesetzt.
    • Klicken Sie auf Weiter.
  5. Neuer benutzerdefinierter Objekt-Tab, Schritt 3 von 3:

    attachment

    • Wählen Sie die benutzerdefinierten Apps aus, für die der neue benutzerdefinierte Tab verfügbar sein soll, indem Sie auf die entsprechenden Kontrollkästchen klicken. Alle Apps sind im obigen Beispiel enthalten.
    • Klicken Sie auf Speichern.
  6. Klicken Sie auf Startseite in der oberen Symbolleiste:

    attachment

    • Wenn Ihr neuer Tab nicht automatisch angezeigt wird, klicken Sie auf das Pluszeichen auf der rechten Seite der Symbolleiste, um alle Tabs aufzulisten.
    • Klicken Sie auf den neuen Tab, den Sie erstellt haben (in diesem Beispiel Kunden).
    • Klicken Sie auf Neue Ansicht erstellen
    • Passen Sie die Ansicht nach Wunsch an. Geben Sie einen Namen für die Ansicht ein.
    • Klicken Sie auf Speichern.
  7. Im Beispiel, das im Bild unten gezeigt wird, ist die Ansicht Kunden in den USA so eingestellt, dass alle Kunden angezeigt werden, bei denen Land = USA:

    attachment

    • Die Daten werden in Echtzeit abgerufen und nicht in Salesforce gespeichert.
    • Sie können für weitere Details hineinzoomen oder Filter nach Bedarf ändern.
    • Jitterbit API Manager wird weiterhin die Anfragen in Echtzeit bedienen und zusammen mit Salesforce Connect arbeiten, um den Zugriff auf die Daten bereitzustellen.

Zusätzliche Ressourcen zu Salesforce Connect

Diese Ressourcen aus der Salesforce-Dokumentation könnten hilfreich sein: