Een Microsoft Dynamics basisverbinding met de Flow Service API
Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.
Dit leerprogramma begeleidt u door de stappen om een basisverbinding tot stand te brengen voor Microsoft Dynamics (hierna "Dynamics") gebruiken Flow Service API.
Aan de slag
Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
- Bronnen: Met Experience Platform kunnen gegevens uit verschillende bronnen worden ingepakt en kunt u inkomende gegevens structureren, labelen en verbeteren met behulp van de platformservices.
- Sandboxen: Experience Platform biedt virtuele sandboxen die één platforminstantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.
De volgende secties verstrekken extra informatie die u zult moeten weten om Platform met een rekening van de Dynamiek met succes te verbinden gebruikend Flow Service API.
Vereiste referenties verzamelen
Om Flow Service verbinding maken met Dynamicsmoet u waarden opgeven voor de volgende eigenschappen van de verbinding:
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
Credentials | Beschrijving |
serviceUri |
De service-URL van uw Dynamics -instantie. |
username |
De gebruikersnaam voor uw Dynamics gebruikersaccount. |
password |
Het wachtwoord voor uw Dynamics account. |
table 0-row-2 1-row-2 2-row-2 | |
---|---|
Credentials | Beschrijving |
servicePrincipalId |
De client-id van uw Dynamics account. Deze ID wordt vereist wanneer het gebruiken van de dienst hoofd en op sleutel-gebaseerde authentificatie. |
servicePrincipalKey |
De geheime sleutel van de dienst belangrijkste geheim. Deze referentie wordt vereist wanneer het gebruiken van de dienst belangrijkste en op sleutel-gebaseerde authentificatie. |
Raadpleeg voor meer informatie over aan de slag gaan dit Dynamics document.
Platform-API's gebruiken
Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op aan de slag met platform-API's.
Een basisverbinding maken
Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.
Om een identiteitskaart van de basisverbinding te creëren, doe een verzoek van de POST aan /connections
als u uw Dynamics verificatiereferenties als onderdeel van de aanvraagparameters.
Een Dynamics basisverbinding
De eerste stap bij het maken van een bronverbinding is het verifiëren van uw Dynamics bron en genereer een basis-verbindings-id. Met een basis-verbindings-id kunt u bestanden verkennen en door de bestanden navigeren vanuit de bron en specifieke items identificeren die u wilt invoeren, zoals informatie over de gegevenstypen en indelingen.
Om een identiteitskaart van de basisverbinding te creëren, doe een verzoek van de POST aan /connections
als u uw Dynamics verificatiereferenties als onderdeel van de aanvraagparameters.
API-indeling
POST /connections
Een Dynamics basisverbinding die basisauthentificatie gebruikt, doe een verzoek van de POST aan Flow Service API terwijl het verstrekken van waarden voor uw verbinding serviceUri
, username
, en password
.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
verzoek | ||||||||||||||
|
accordion | ||
---|---|---|
Response | ||
Met een geslaagde reactie wordt de nieuwe verbinding geretourneerd, inclusief de unieke id (
|
Een Dynamics basisverbinding die de dienst belangrijkste op sleutel-gebaseerde authentificatie gebruikt, doe een verzoek van de POST aan Flow Service API terwijl het verstrekken van waarden voor uw verbinding serviceUri
, servicePrincipalId
, en servicePrincipalKey
.
accordion | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
verzoek | ||||||||||||||
|
accordion | ||
---|---|---|
Response | ||
Met een geslaagde reactie wordt de nieuwe verbinding geretourneerd, inclusief de unieke id (
|
Volgende stappen
Aan de hand van deze zelfstudie hebt u een Microsoft Dynamics basisverbinding met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken: