Skapa en Microsoft Dynamics basanslutning med Flow Service API

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 Microsoft Dynamics (nedan kalladDynamics") 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: Experience Platform tillåter att data kan hämtas från olika källor samtidigt som du kan strukturera, märka 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 i separata virtuella miljöer för att utveckla och utveckla program för digitala upplevelser.

Följande avsnitt innehåller ytterligare information som du behöver känna till för att kunna ansluta plattformen till ett Dynamics-konto med Flow Service API.

Samla in nödvändiga inloggningsuppgifter

För att Flow Service för att ansluta till Dynamicsmåste du ange värden för följande anslutningsegenskaper:

Grundläggande autentisering
table 0-row-2 1-row-2 2-row-2 3-row-2
Autentiseringsuppgifter Beskrivning
serviceUri Tjänst-URL:en för Dynamics -instans.
username Ditt användarnamn Dynamics användarkonto.
password Lösenordet för Dynamics konto.
Tjänstens huvudnamn och nyckelautentisering
table 0-row-2 1-row-2 2-row-2
Autentiseringsuppgifter Beskrivning
servicePrincipalId Klient-ID för din Dynamics konto. Detta ID krävs när tjänstens huvudnamn och nyckelbaserad autentisering används.
servicePrincipalKey Tjänstens hemliga huvudnyckel. Denna autentiseringsuppgift krävs när tjänstens huvudnamn och nyckelbaserad autentisering används.

Mer information om hur du kommer igång finns i this Dynamics dokument.

Använda plattforms-API:er

Mer information om hur du kan anropa API:er för plattformar finns i handboken komma igång med plattforms-API:er.

Skapa en basanslutning

TIP
När du har skapat en fil kan du inte ändra autentiseringstypen för en Dynamics basanslutning. Om du vill ändra autentiseringstypen måste du skapa en ny 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 basanslutnings-ID skickar du en POST till /connections slutpunkt när du ger Dynamics autentiseringsuppgifter som en del av parametrarna för begäran.

Skapa en Dynamics basanslutning

TIP
När du har skapat en fil kan du inte ändra autentiseringstypen för en Dynamics basanslutning. Om du vill ändra autentiseringstypen måste du skapa en ny basanslutning.

Det första steget i att skapa en källanslutning är att autentisera Dynamics och generera ett anslutnings-ID. Med ett grundläggande anslutnings-ID kan du utforska och navigera bland filer inifrån källan och identifiera specifika objekt som du vill importera, inklusive information om deras datatyper och format.

Om du vill skapa ett basanslutnings-ID skickar du en POST till /connections slutpunkt när du ger Dynamics autentiseringsuppgifter som en del av parametrarna för begäran.

API-format

POST /connections
Grundläggande autentisering

Skapa en Dynamics basanslutning med grundläggande autentisering, gör en POST-förfrågan till Flow Service API när du anger värden för anslutningen serviceUri, usernameoch password.

accordion
Begäran
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": "Dynamics connection",
        "description": "Dynamics connection using basic auth",
        "auth": {
            "specName": "Basic Authentication for Dynamics-Online",
            "params": {
                "serviceUri": "{SERVICE_URI}",
                "username": "{USERNAME}",
                "password": "{PASSWORD}"
            }
        },
        "connectionSpec": {
            "id": "38ad80fe-8b06-4938-94f4-d4ee80266b07",
            "version": "1.0"
        }
    }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Egenskap Beskrivning
auth.params.serviceUri Den tjänst-URI som är associerad med din Dynamics -instans.
auth.params.username Användarnamnet som är associerat med din Dynamics konto.
auth.params.password Lösenordet som är kopplat till Dynamics konto.
connectionSpec.id The Dynamics anslutningsspecifikation-ID: 38ad80fe-8b06-4938-94f4-d4ee80266b07
accordion
svar

Ett lyckat 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.

code language-json
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"9e0052a2-0000-0200-0000-5e35tb330000\""
}
Tjänstens huvudnyckelbaserade autentisering

Skapa en Dynamics basanslutning med huvudnyckelbaserad autentisering, gör en POST-förfrågan till Flow Service API när du anger värden för anslutningen serviceUri, servicePrincipalIdoch servicePrincipalKey.

accordion
Begäran
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": "Dynamics connection",
      "description": "Dynamics connection using key-based authentication",
      "auth": {
          "specName": "Service Principal Key Based Authentication",
          "params": {
              "serviceUri": "{SERVICE_URI}",
              "servicePrincipalId": "{SERVICE_PRINCIPAL_ID}",
              "servicePrincipalKey": "{SERVICE_PRINCIPAL_KEY}"
          }
      },
      "connectionSpec": {
          "id": "38ad80fe-8b06-4938-94f4-d4ee80266b07",
          "version": "1.0"
      }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Egenskap Beskrivning
auth.params.serviceUri Den tjänst-URI som är associerad med din Dynamics -instans.
auth.params.servicePrincipalId Klient-ID för din Dynamics konto. Detta ID krävs när tjänstens huvudnamn och nyckelbaserad autentisering används.
auth.params.servicePrincipalKey Tjänstens hemliga huvudnyckel. Denna autentiseringsuppgift krävs när tjänstens huvudnamn och nyckelbaserad autentisering används.
connectionSpec.id The Dynamics anslutningsspecifikation-ID: 38ad80fe-8b06-4938-94f4-d4ee80266b07
accordion
svar

Ett lyckat 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.

code language-json
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"9e0052a2-0000-0200-0000-5e35tb330000\""
}

Nästa steg

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

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