DokumentationExperience PlatformAnvändarhandbok om Source Connectors

Skapa en Oracle Service Cloud-källanslutning med hjälp av 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 hjälp med att skapa en basanslutning för Oracle Service Cloud med Flow Service API.

Komma igång

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

  • Källor: Experience Platform tillåter data att hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med hjälp av plattformstjänster.
  • Sandlådor: Experience Platform tillhandahåller virtuella sandlådor som partitionerar en enda plattformsinstans 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 Oracle Service Cloud med API:t Flow Service.

Samla in nödvändiga inloggningsuppgifter

För att Flow Service ska kunna ansluta till Oracle Service Cloud måste du ange värden för följande anslutningsegenskaper:

Autentiseringsuppgifter
Beskrivning
host
Värd-URL:en för din Oracle Service Cloud-instans.
username
Användarnamnet för ditt användarkonto för Oracle Service Cloud.
password
Lösenordet för ditt Oracle Service Cloud-konto.
connectionSpec.id
Anslutningsspecifikationen returnerar en källas kopplingsegenskaper, inklusive autentiseringsspecifikationer för att skapa bas- och källanslutningarna. Anslutningsspecifikations-ID för Oracle Service Cloud är: ba5126ec-c9ac-11eb-b8bc-0242ac130003.

Mer information om hur du autentiserar ditt Oracle Service Cloud-konto finns i Oracle handboken om autentisering.

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 samtidigt som du anger autentiseringsuppgifterna för Oracle Service Cloud som en del av parametrarna för begäran.

API-format

POST /connections

Begäran

Följande begäran skapar en basanslutning för Oracle Service Cloud:

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": "Base connection for Oracle Service Cloud",
      "description": "Base connection for Oracle Service Cloud",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "host": "{HOST}",
              "username": "{USERNAME}",
              "password": "{PASSWORD}"
          }
      },
      "connectionSpec": {
          "id": "ba5126ec-c9ac-11eb-b8bc-0242ac130003",
          "version": "1.0"
      }
  }'
Parameter
Beskrivning
auth.params.host
Värd-URL:en för din Oracle Service Cloud-instans.
auth.params.username
Det användarnamn som är kopplat till ditt Oracle Service Cloud-konto.
auth.params.password
Lösenordet som är kopplat till ditt Oracle Service Cloud-konto.
connectionSpec.id
Oraclets anslutningsspecifikation för Service Cloud: ba5126ec-c9ac-11eb-b8bc-0242ac130003

Svar

Ett svar returnerar den nyligen skapade anslutningen, inklusive dess unika identifierare (id). Detta ID krävs för att undersöka ditt CRM-system i nästa steg.

{
    "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 Oracle 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