Skapa en Microsoft Dynamics-basanslutning med API:t Flow Service
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 (kallas nedan Dynamics) 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 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.
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 API:t Flow Service.
Samla in nödvändiga inloggningsuppgifter
För att Flow Service ska kunna ansluta till Dynamics måste du ange värden för följande anslutningsegenskaper:
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
Autentiseringsuppgifter | Beskrivning |
serviceUri |
Tjänst-URL:en för din Dynamics-instans. |
username |
Användarnamnet för ditt Dynamics-användarkonto. |
password |
Lösenordet för ditt Dynamics-konto. |
table 0-row-2 1-row-2 2-row-2 | |
---|---|
Autentiseringsuppgifter | Beskrivning |
servicePrincipalId |
Klient-ID för ditt 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 det här Dynamics dokumentet.
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 Dynamics som en del av parametrarna för begäran.
Skapa en Dynamics-basanslutning
Det första steget i att skapa en källanslutning är att autentisera Dynamics-källan och generera ett grundläggande 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 grundläggande anslutnings-ID skickar du en POST till slutpunkten /connections
och anger dina autentiseringsuppgifter för Dynamics som en del av parametrarna för begäran.
API-format
POST /connections
Om du vill skapa en Dynamics-basanslutning med grundläggande autentisering kan du göra en POST-förfrågan till Flow Service-API:t och ange värden för din anslutnings serviceUri
, username
och password
.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Begäran | ||||||||||||||
|
accordion | ||
---|---|---|
svar | ||
Ett svar returnerar den nyligen skapade anslutningen, inklusive dess unika identifierare (
|
Om du vill skapa en Dynamics-basanslutning med huvudnyckelbaserad autentisering, ska du göra en POST-förfrågan till Flow Service-API:t och ange värden för din anslutnings serviceUri
, servicePrincipalId
och servicePrincipalKey
.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Begäran | ||||||||||||||
|
accordion | ||
---|---|---|
svar | ||
Ett svar returnerar den nyligen skapade anslutningen, inklusive dess unika identifierare (
|
Nästa steg
Genom att följa den här självstudiekursen har du skapat en Microsoft Dynamics-basanslutning med API:t Flow Service. Du kan använda detta grundläggande anslutnings-ID i följande självstudier: