Erstellen einer Salesforce Service Cloud-Quellverbindung mit der Flow Service-API

Eine Basisverbindung stellt die authentifizierte Verbindung zwischen einer Quelle und Adobe Experience Platform dar.

In diesem Tutorial erfahren Sie, wie Sie mit der Flow Service API eine Basisverbindung für Salesforce Service Cloud erstellen.

Erste Schritte

Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:

  • Quellen: Experience Platform ermöglicht die Erfassung von Daten aus verschiedenen Quellen und bietet Ihnen gleichzeitig die Möglichkeit, eingehende Daten mithilfe von Platform-Diensten zu strukturieren, zu beschriften und zu erweitern.
  • Sandboxes: Experience Platform stellt virtuelle Sandboxes bereit, die eine einzelne Platform-Instanz in separate virtuelle Umgebungen aufteilen, um die Entwicklung und Weiterentwicklung von Programmen für digitale Erlebnisse zu erleichtern.

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie benötigen, um mithilfe der Flow Service -API erfolgreich eine Verbindung zu Salesforce Service Cloud herstellen zu können.

Sammeln erforderlicher Anmeldeinformationen

Die Quelle Salesforce Service Cloud unterstützt grundlegende Authentifizierung und OAuth2 Client Credential.

Grundlegende Authentifizierung

Um Ihr Salesforce Service Cloud-Konto mit Flow Service mittels einfacher Authentifizierung zu verbinden, geben Sie Werte für die folgenden Anmeldedaten an:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Anmeldedaten Beschreibung
environmentUrl Die URL der Quellinstanz Salesforce Service Cloud.
username Der Benutzername für das Salesforce Service Cloud -Benutzerkonto.
password Das Kennwort für das Salesforce Service Cloud -Benutzerkonto.
securityToken Das Sicherheits-Token für das Salesforce Service Cloud -Benutzerkonto.
apiVersion (Optional) Die REST-API-Version der von Ihnen verwendeten Salesforce Service Cloud-Instanz. Der Wert für die API-Version muss mit einer Dezimalzahl formatiert sein. Wenn Sie beispielsweise die API-Version 52 verwenden, müssen Sie den Wert als 52.0 eingeben. Wenn dieses Feld leer gelassen wird, verwendet Experience Platform automatisch die neueste verfügbare Version.
connectionSpec.id Die Verbindungsspezifikation gibt die Connector-Eigenschaften einer Quelle zurück, einschließlich der Authentifizierungsspezifikationen für die Erstellung der Basis- und Quellverbindungen. Die Verbindungsspezifikations-ID für Salesforce Service Cloud ist: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5.

Weitere Informationen zu den ersten Schritten finden Sie in diesem Salesforce-Dokument.

OAuth 2 Client Credential

Geben Sie Werte für die folgenden Anmeldedaten an, um Ihr Salesforce Service Cloud-Konto mithilfe der OAuth 2-Client-Anmeldedaten mit Flow Service zu verbinden:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Anmeldedaten Beschreibung
environmentUrl Die URL der Quellinstanz Salesforce Service Cloud.
clientId Die Client-ID wird zusammen mit dem Client-Geheimnis als Teil der OAuth2-Authentifizierung verwendet. Gemeinsam ermöglichen es die Client-ID und das Client-Geheimnis Ihrer Anwendung, im Namen Ihres Kontos zu arbeiten, indem Sie Ihre Anwendung mit Salesforce Service Cloud identifizieren.
clientSecret Das Client-Geheimnis wird zusammen mit der Client-ID als Teil der OAuth2-Authentifizierung verwendet. Gemeinsam ermöglichen es die Client-ID und das Client-Geheimnis Ihrer Anwendung, im Namen Ihres Kontos zu arbeiten, indem Sie Ihre Anwendung mit Salesforce Service Cloud identifizieren.
apiVersion Die REST-API-Version der von Ihnen verwendeten Salesforce Service Cloud-Instanz. Der Wert für die API-Version muss mit einer Dezimalzahl formatiert sein. Wenn Sie beispielsweise die API-Version 52 verwenden, müssen Sie den Wert als 52.0 eingeben. Wenn dieses Feld leer gelassen wird, verwendet Experience Platform automatisch die neueste verfügbare Version. Dieser Wert ist für die Authentifizierung von OAuth2-Client-Anmeldedaten obligatorisch.
connectionSpec.id Die Verbindungsspezifikation gibt die Connector-Eigenschaften einer Quelle zurück, einschließlich der Authentifizierungsspezifikationen für die Erstellung der Basis- und Quellverbindungen. Die Verbindungsspezifikations-ID für Salesforce Service Cloud ist: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5.

Weitere Informationen zur Verwendung von OAuth für Salesforce Service Cloud finden Sie im Salesforce Service Cloud Handbuch zu OAuth-Autorisierungsflüssen.

Verwenden von Platform-APIs

Informationen zum Aufrufen von Platform-APIs finden Sie im Handbuch unter Erste Schritte mit Platform-APIs.

Erstellen einer Basisverbindung

Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Platform gespeichert, einschließlich der Authentifizierungsdaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen Kennung der Basisverbindung. Mit der Kennung der Basisverbindung können Sie Dateien aus Ihrer Quelle heraus analysieren und darin navigieren und die spezifischen Elemente identifizieren, die Sie erfassen möchten, einschließlich Informationen zu ihren Datentypen und Formaten.

Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den Endpunkt /connections und geben Sie dabei Ihre Salesforce Service Cloud-Authentifizierungsdaten als Teil der Anfrageparameter an.

API-Format

POST /connections

Anfrage

Grundlegende Authentifizierung

Die folgende Anfrage erstellt eine Basisverbindung für Salesforce Service Cloud mithilfe der einfachen Authentifizierung:

code language-shell
curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Salesforce Service Cloud account for ACME data (basic auth)",
      "description": "Salesforce Service Cloud account for ACME data (basic auth)",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
            "environmentUrl": "https://acme-enterprise-3126.my.salesforce.com",
            "username": "acme-salesforce-service-cloud",
            "password": "xxxx",
            "securityToken": "xxxx"
        }
      },
      "connectionSpec": {
          "id": "cb66ab34-8619-49cb-96d1-39b37ede86ea",
          "version": "1.0"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Parameter Beschreibung
auth.params.environmentUrl Die URL Ihrer Salesforce Service Cloud -Instanz.
auth.params.username Der Benutzername, der Ihrem Salesforce Service Cloud -Konto zugeordnet ist.
auth.params.password Das Ihrem Salesforce Service Cloud-Konto zugeordnete Kennwort.
auth.params.securityToken Das Ihrem Salesforce Service Cloud-Konto zugeordnete Sicherheits-Token.
connectionSpec.id Die Salesforce Service Cloud-Verbindungsspezifikations-ID: cb66ab34-8619-49cb-96d1-39b37ede86ea
OAuth2 Client Credential

Die folgende Anfrage erstellt eine Basisverbindung für Salesforce Service Cloud mithilfe von OAuth 2 Client Credential:

code language-shell
curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Salesforce Service Cloud account for ACME data (OAuth2)",
      "description": "Salesforce Service Cloud account for ACME data (OAuth2)",
      "auth": {
          "specName": "OAuth2 Client Credential",
          "params":
            "environmentUrl": "https://acme-enterprise-3126.my.salesforce.com",
            "clientId": "xxxx",
            "clientSecret": "xxxx",
            "apiVersion": "60.0"
        }
      },
      "connectionSpec": {
          "id": "cb66ab34-8619-49cb-96d1-39b37ede86ea",
          "version": "1.0"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Eigenschaft Beschreibung
auth.params.environmentUrl Die URL Ihrer Salesforce Service Cloud -Instanz.
auth.params.clientId Die mit Ihrem Salesforce Service Cloud-Konto verknüpfte Client-ID.
auth.params.clientSecret Das Client-Geheimnis, das Ihrem Salesforce Service Cloud-Konto zugeordnet ist.
auth.params.apiVersion Die REST-API-Version der von Ihnen verwendeten Salesforce Service Cloud-Instanz.
connectionSpec.id Die Salesforce Service Cloud Verbindungsspezifikations-ID: cb66ab34-8619-49cb-96d1-39b37ede86ea.

Antwort

Bei einer erfolgreichen Antwort wird Ihre neu erstellte Basisverbindung zusammen mit der eindeutigen ID zurückgegeben.

{
    "id": "4267c2ab-2104-474f-a7c2-ab2104d74f86",
    "etag": "\"0200f1c5-0000-0200-0000-5e4352bf0000\""
}

Nächste Schritte

In diesem Tutorial haben Sie eine Salesforce Service Cloud-Basisverbindung mithilfe der Flow Service-API erstellt. Sie können diese Basisverbindungs-ID in den folgenden Tutorials verwenden:

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089