REST-API-Connectorquellen für Salesforce konfigurieren

Verwenden Sie den REST-API-Connector, um eine Verbindung zu REST-konformen Salesforce-Services herzustellen. Nur die REST-APIs Query und Reports werden unterstützt.

Umsetzungsscriptdatei erstellen.

• Führen Sie die folgenden Schritte aus, um eine Umsetzungsscriptdatei zu erstellen:
  1. Wechseln Sie in das folgende Verzeichnis, in dem sich die Beispielscriptdatei restapi_sample_response_t12n.txt für die Umsetzung befindet:

     $installationsverzeichnis/wlp/usr/servers/prdapp/restapi_t12n

  2. Erstellen Sie eine Kopie dieser Datei, benennen Sie die Datei um und öffnen Sie diese Datei in einem beliebigen Texteditor.
  3. Löschen Sie den Inhalt der Datei, kopieren Sie das folgende Script und fügen Sie es in die Datei ein:

     var input;
                    var finalJson;
     	                var output;
     		
                   // Parse the input in JSON format
                   input = JSON.parse(transformationInput);
             
     		
             
     	       records=input['records']		
     		
     		        output = JSON.stringify(records);

  4. Speichern Sie die Datei als JavaScript-Datei mit der Dateierweiterung .js.
     Die Scriptdatei für die Umsetzung wurde erstellt.

REST-konforme Salesforce-Web-Services mithilfe des Connectors REST API hinzufügen

• Führen Sie die folgenden Schritte aus, um REST-konforme Salesforce-Web-Services mithilfe des REST-API-Connectors hinzuzufügen:
  1. Öffnen Sie Dashboard Designer.
  2. Rufen Sie im Navigationsbereich Connectors & Quellen > Connectorquellen auf.
  3. Klicken Sie auf der Seite 'Alle Connectorquellen' auf Quelle hinzufügen.

     Das Fenster Connectorquelle hinzufügen wird angezeigt.

  4. Wählen Sie in der Liste Connectortyp den Connector REST-API aus.
  5. Geben Sie in das Feld Name der Connectorquelle einen Namen für die Quelle ein.

     Der Quellenname kann alphanumerische Zeichen und Unterstreichungszeichen enthalten.

  6. Geben Sie in das Feld Endpunkt-URL die URL-Details für den Web-Service in einem der folgenden Formate ein:
     • https://server-IP_oder_hostname:port
     • http://server-IP_oder_hostname:port

     Dabei gilt Folgendes:

     • server-IP_oder_hostname ist die IP-Adresse oder der Hostname des Servers, auf dem der Web-Service gehostet wird.
     • port ist der Standardport des Web-Service. Die Standardportnummer für http-URLs ist 80. Die Standardportnummer für https-URLs ist 443.
  7. Geben Sie den Namen der Umsetzungsscriptdatei im Feld Name des Scripts für die Antwortumwandlung ein, wenn Sie die Antwort umsetzen wollen.
  8. Wählen Sie in der Liste Authentifizierungstyp die Option Tokenbasierte Authentifizierung aus und führen Sie die folgenden Schritte aus:
     1. Geben Sie in das Feld Benutzername einen Benutzernamen ein, der bei der Konfiguration des REST-API-Service verwendet wird.
     2. Geben Sie in das Feld Kennwort ein Kennwort ein, das bei der Konfiguration des REST-API-Service verwendet wird. Hängen Sie das Sicherheitstoken an das Kennwort an.
        Beispiel:

        • <password><security_token>
        • kennworttsHrn59DHQrVuWZkunixT25x

          Dabei ist kennwort das Kennwort und tsHrn59DHQrVuWZkunixT25x ist das Sicherheitstoken.

     3. Klicken Sie auf Weiter.
     4. Geben Sie in das Feld Authentifizierungs- oder Anmelde-URL die URL des Authentifizierungsservers für den REST-API-Web-Service ein. Diese Authentifizierungs-URL wird vom Provider des REST-API-Web-Service bereitgestellt.

        Beispiel: https://ap17.salesforce.com/services/oauth2/token

     5. Wählen Sie in der Liste Tokenanforderungsmethode die Methode POST aus.
     6. Geben Sie in das Feld Hauptteil der Tokenanforderung einen Anforderungshauptteil ein. Geben Sie neben den Platzhaltern {USERNAME} und {PASSWORD} auch den Konsumentenschlüssel und das Konsumentengeheimnis der verbundenen App ein.
        Beispiel:

        grant_type=password
        &client_id=enter consumer key of your connected app
        &client_secret=enter consumer secret of your connected app
        &username={USERNAME}
        &password={PASSWORD}

        Die Platzhalter für den Benutzernamen und das Kennwort werden intern durch den tatsächlichen Benutzernamen und das tatsächliche Kennwort ersetzt, die Sie in Schritt a und Schritt b eingegeben haben.

     7. Wählen Sie in der Liste Ablaufzeit des Tokens (in Sekunden) die Ablaufzeit des Tokens aus.

        Nach dem ausgewählten Zeitintervall wird automatisch ein neues Token generiert.

     8. Geben Sie in das Feld Name des Authentifizierungsheaders der API-Anforderung den Namen des Anforderungsheaders für den Authentifizierungsserver ein. Dieser Name des Authentifizierungsheaders wird vom Provider des REST-API-Web-Service bereitgestellt.

        Beispiel: Authorization

     9. Geben Sie in das Feld Wert des Authentifizierungsheaders der API-Anforderung den Wert des Anforderungsheaders für den Authentifizierungsserver ein. Verwenden Sie dabei den Platzhalter {TOKEN}.

        Beispiel: Bearer {TOKEN}

        Dieser Platzhalter wird intern durch das tatsächliche vom System generierte Authentifizierungstoken ersetzt. Dieser Wert des Authentifizierungsheaders wird vom Provider des REST-API-Web-Service bereitgestellt.

     10. Führen Sie im Abschnitt Angepasste Header für Tokenanforderung die folgenden Schritte aus:
         1. Geben Sie in das Feld Name den Namen des Tokenanforderungsheaders ein, der vom Provider des REST-API-Web-Service bereitgestellt wird.

            Beispiel: Content-Type

         2. Geben Sie in das Feld Wert den Wert für den Tokenanforderungsheader ein, der vom Provider des REST-API-Web-Service bereitgestellt wird.

            Beispiel: application/x-www-form-urlencoded

         Wenn Sie weitere Tokenanforderungsheader hinzufügen wollen, können Sie auf Weiteren hinzufügen klicken und die vorherigen Schritte wiederholen.

  9. Klicken Sie auf Weiter.
  10. Wählen Sie in der Liste Methode eine Methode aus und führen Sie basierend auf der ausgewählten Methode einen der folgenden Schritte aus:
      • Geben Sie für die Methode GET im Feld URI den URI (Uniform Resource Identifier) für die Quelle ein.
      • Geben Sie für die Methode POST im Feld URI den URI für die Quelle ein und im Feld Anforderungshauptteil die POST-Anforderung.

      Beispiel-URI für die Methode GET: /services/data/v48.0/query/?q=SELECT+Name,Type,Phone,Industry+FROM+Account

      Beispiel für URI und Anforderungshauptteil für die Methode POST:

      URI:

      http://ap17.salesforce.com/services/data/v48.0/sobjects/account

      Anforderungshauptteil:

      {
      			"Name" : "Petroleum",
      			"Type": "Customer - Direct",
      			"Phone": "+11 111 1111111",
      			"Industry": "Energy"
      		}
      	
      

  11. Führen Sie unter Angepasste Header die folgenden Schritte aus:
      • • Geben Sie in das Feld Name die folgenden Anforderungsheader ein, die vom Provider des REST-API-Web-Service bereitgestellt werden.
          • Authorization
          • Accept
          • Content-Type
        • Geben Sie in das Feld Wert die folgenden Anforderungsheaderwerte ein, die vom Provider des REST-API-Web-Service bereitgestellt werden.
          • Bearer {TOKEN}
          • application/json
          • application/json

        Wenn Sie weitere Anforderungsheader hinzufügen wollen, können Sie auf Weiteren hinzufügen klicken und die vorherigen Schritte wiederholen.

  12. Klicken Sie auf Verbindung testen, um sicherzustellen, dass die Verbindung zur Datenquelle erfolgreich war.
      Wenn die Quellendetails und die Beispielanforderung gültig und vollständig sind, wird eine Nachricht angezeigt, die besagt, dass die Verbindung erfolgreich hergestellt wurde. Wird eine Nachricht ausgegeben, die besagt, dass ein Verbindungsfehler aufgetreten ist, müssen Sie die in der Nachricht beschriebenen Fehler beheben und die Verbindung erneut testen.

      Anmerkung: Auch wenn die Quellendetails gültig sind, kann es vorkommen, dass eine Verbindungsfehlernachricht angezeigt wird. Dies ist der Fall, wenn für die Beispielanforderung eine ungültige Antwort empfangen wird.
  13. Klicken Sie auf Speichern.