Dokumentation Experience Platform Användarhandbok om Source Connectors

Skapa en Salesforce Service Cloud-källanslutning med API:t Flow Service

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Utvecklare

En basanslutning representerar den autentiserade anslutningen mellan en källa och Adobe Experience Platform.

I den här självstudiekursen får du lära dig hur du skapar en basanslutning för Salesforce Service Cloud med Flow Service API.

Komma igång

Handboken kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:

Källor: Med Experience Platform kan data hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med Platform-tjänster.
Sandlådor: Experience Platform tillhandahåller virtuella sandlådor som partitionerar en enskild Platform-instans till separata virtuella miljöer för att utveckla och utveckla program för digitala upplevelser.

I följande avsnitt finns ytterligare information som du behöver känna till för att kunna ansluta till Salesforce Service Cloud med API:t Flow Service.

Samla in nödvändiga inloggningsuppgifter

Källan Salesforce Service Cloud stöder grundläggande autentisering och autentiseringsuppgifter för OAuth2-klient.

Grundläggande autentisering

Om du vill ansluta ditt Salesforce Service Cloud-konto till Flow Service med grundläggande autentisering anger du värden för följande autentiseringsuppgifter:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Autentiseringsuppgifter	Beskrivning
`environmentUrl`	URL:en för Salesforce Service Cloud-källinstansen.
`username`	Användarnamnet för användarkontot Salesforce Service Cloud.
`password`	Lösenordet för användarkontot Salesforce Service Cloud.
`securityToken`	Säkerhetstoken för användarkontot Salesforce Service Cloud.
`apiVersion`	(Valfritt) REST API-versionen för den Salesforce Service Cloud-instans som du använder. Värdet för API-versionen måste formateras med ett decimaltecken. Om du till exempel använder API-version `52` måste du ange värdet som `52.0`. Om det här fältet lämnas tomt kommer Experience Platform automatiskt att använda den senaste tillgängliga versionen.
`connectionSpec.id`	Anslutningsspecifikationen returnerar en källas kopplingsegenskaper, inklusive autentiseringsspecifikationer för att skapa bas- och källanslutningarna. Anslutningsspecifikations-ID för Salesforce Service Cloud är: `cfc0fee1-7dc0-40ef-b73e-d8b134c436f5`.

Mer information om hur du kommer igång finns i det här Salesforce-dokumentet.

Autentiseringsuppgifter för OAuth 2-klient

Om du vill ansluta ditt Salesforce Service Cloud-konto till Flow Service med OAuth 2-klientautentiseringsuppgifter anger du värden för följande autentiseringsuppgifter:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Autentiseringsuppgifter	Beskrivning
`environmentUrl`	URL:en för Salesforce Service Cloud-källinstansen.
`clientId`	Klient-ID används tillsammans med klienthemligheten som en del av OAuth2-autentisering. Tillsammans gör klient-ID och klienthemlighet att ditt program kan fungera för ditt kontos räkning genom att identifiera ditt program för Salesforce Service Cloud.
`clientSecret`	Klienthemligheten används tillsammans med klient-ID som en del av OAuth2-autentiseringen. Tillsammans gör klient-ID och klienthemlighet att ditt program kan fungera för ditt kontos räkning genom att identifiera ditt program för Salesforce Service Cloud.
`apiVersion`	REST API-versionen för den Salesforce Service Cloud-instans som du använder. Värdet för API-versionen måste formateras med ett decimaltecken. Om du till exempel använder API-version `52` måste du ange värdet som `52.0`. Om det här fältet lämnas tomt kommer Experience Platform automatiskt att använda den senaste tillgängliga versionen. Det här värdet är obligatoriskt för autentisering av OAuth2-klientautentiseringsuppgifter.
`connectionSpec.id`	Anslutningsspecifikationen returnerar en källas kopplingsegenskaper, inklusive autentiseringsspecifikationer för att skapa bas- och källanslutningarna. Anslutningsspecifikations-ID för Salesforce Service Cloud är: `cfc0fee1-7dc0-40ef-b73e-d8b134c436f5`.

Mer information om hur du använder OAuth för Salesforce Service Cloud finns i Salesforce Service Cloud handboken om OAuth-auktoriseringsflöden.

Använda plattforms-API:er

Mer information om hur du kan anropa plattforms-API:er finns i guiden Komma igång med plattforms-API:er.

Skapa en basanslutning

En basanslutning bevarar information mellan källan och plattformen, inklusive källans autentiseringsuppgifter, anslutningsstatus och ditt unika basanslutnings-ID. Med det grundläggande anslutnings-ID:t kan du utforska och navigera bland filer inifrån källan och identifiera de specifika objekt som du vill importera, inklusive information om deras datatyper och format.

Om du vill skapa ett grundläggande anslutnings-ID skickar du en POST till slutpunkten /connections och anger dina autentiseringsuppgifter för Salesforce Service Cloud som en del av parametrarna för begäran.

API-format

POST /connections

Begäran

Grundläggande autentisering

Följande begäran skapar en basanslutning för Salesforce Service Cloud med grundläggande autentisering:

code language-shell

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" } }'

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	Beskrivning
`auth.params.environmentUrl`	URL:en för din Salesforce Service Cloud-instans.
`auth.params.username`	Användarnamnet som är associerat med ditt Salesforce Service Cloud-konto.
`auth.params.password`	Lösenordet som är kopplat till ditt Salesforce Service Cloud-konto.
`auth.params.securityToken`	Säkerhetstoken som är associerad med ditt Salesforce Service Cloud-konto.
`connectionSpec.id`	Anslutningsspecifikations-ID Salesforce Service Cloud: `cb66ab34-8619-49cb-96d1-39b37ede86ea`

Autentiseringsuppgifter för OAuth2-klient

Följande begäran skapar en basanslutning för Salesforce Service Cloud med hjälp av autentiseringsuppgifter för OAuth 2-klient:

code language-shell

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" } }'

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
Egenskap	Beskrivning
`auth.params.environmentUrl`	URL:en för din Salesforce Service Cloud-instans.
`auth.params.clientId`	Klient-ID som är associerat med ditt Salesforce Service Cloud-konto.
`auth.params.clientSecret`	Klienthemligheten som är associerad med ditt Salesforce Service Cloud-konto.
`auth.params.apiVersion`	REST API-versionen för den Salesforce Service Cloud-instans som du använder.
`connectionSpec.id`	Anslutningsspecifikations-ID Salesforce Service Cloud: `cb66ab34-8619-49cb-96d1-39b37ede86ea`.

Svar

Ett lyckat svar returnerar din nyskapade basanslutning tillsammans med dess unika ID.

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

Nästa steg

Genom att följa den här självstudiekursen har du skapat en Salesforce Service Cloud-basanslutning med API:t Flow Service. Du kan använda detta grundläggande anslutnings-ID i följande självstudier:

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089