建立 Microsoft Dynamics 基礎連線使用 Flow Service API

基礎連線代表來源和Adobe Experience Platform之間已驗證的連線。

本教學課程將逐步引導您完成建立基礎連線的步驟。 Microsoft Dynamics (以下稱"Dynamics")使用 Flow Service API.

快速入門

本指南需要您實際瞭解下列Adobe Experience Platform元件：

  • 來源：Experience Platform可讓您從各種來源擷取資料，同時使用Platform服務來建構、加標籤及增強傳入資料。
  • 沙箱：Experience Platform提供的虛擬沙箱可將單一Platform執行個體分割成個別的虛擬環境，以利開發及改進數位體驗應用程式。

以下小節提供您需要瞭解的其他資訊，才能使用成功將Platform連線至Dynamics帳戶 Flow Service API。

收集必要的認證

為了 Flow Service 以連線到 Dynamics，您必須提供下列連線屬性的值：

認證 說明
serviceUri 您的服務URL Dynamics 執行個體。
username 您的使用者名稱 Dynamics 使用者帳戶。
password 您的密碼 Dynamics 帳戶。
servicePrincipalId 您的使用者端識別碼 Dynamics 帳戶。 使用服務主體和金鑰式驗證時，需要此ID。
servicePrincipalKey 服務主體秘密金鑰。 使用服務主體和基於金鑰的驗證時，需要此認證。
connectionSpec.id 連線規格會傳回來源的聯結器屬性，包括與建立基礎連線和來源連線相關的驗證規格。 的連線規格ID Dynamics 為： 38ad80fe-8b06-4938-94f4-d4ee80266b07.

如需開始使用的詳細資訊，請造訪 此 Dynamics 檔案.

使用平台API

如需如何成功呼叫Platform API的詳細資訊，請參閱以下指南中的 Platform API快速入門.

建立基礎連線

基礎連線會保留您的來源和平台之間的資訊，包括來源的驗證認證、連線的目前狀態，以及您唯一的基本連線ID。 基本連線ID可讓您瀏覽和瀏覽來源內的檔案，並識別您要擷取的特定專案，包括其資料型別和格式的資訊。

POST若要建立基本連線ID，請向 /connections 端點，同時提供 Dynamics 要求引數中的驗證認證。

建立 Dynamics 使用基本驗證的基本連線

若要建立 Dynamics 使用基本驗證的基礎連線，向發出POST要求 Flow Service API同時為您的連線提供值 serviceUri， username、和 password.

API格式

POST /connections

要求

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"
        }
    }'
屬性 說明
auth.params.serviceUri 與您的關聯的服務URI Dynamics 執行個體。
auth.params.username 與您的相關聯的使用者名稱 Dynamics 帳戶。
auth.params.password 與您的關聯的密碼 Dynamics 帳戶。
connectionSpec.id 此 Dynamics 連線規格ID： 38ad80fe-8b06-4938-94f4-d4ee80266b07

回應

成功回應會傳回新建立的連線，包括其唯一識別碼(id)。 在下一個步驟中探索您的CRM系統時，需要此ID。

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

建立 Dynamics 使用服務主體金鑰型驗證的基礎連線

若要建立 Dynamics 使用服務主體金鑰型驗證的基礎連線，向發出POST要求 Flow Service API同時為您的連線提供值 serviceUri， servicePrincipalId、和 servicePrincipalKey.

API格式

POST /connections

要求

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"
        }
    }'
屬性 說明
auth.params.serviceUri 與您的關聯的服務URI Dynamics 執行個體。
auth.params.servicePrincipalId 您的使用者端識別碼 Dynamics 帳戶。 使用服務主體和金鑰式驗證時，需要此ID。
auth.params.servicePrincipalKey 服務主體秘密金鑰。 使用服務主體和基於金鑰的驗證時，需要此認證。
connectionSpec.id 此 Dynamics 連線規格ID： 38ad80fe-8b06-4938-94f4-d4ee80266b07

回應

成功回應會傳回新建立的連線，包括其唯一識別碼(id)。 在下一個步驟中探索您的CRM系統時，需要此ID。

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

後續步驟

依照本教學課程，您已建立 Microsoft Dynamics 基礎連線使用 Flow Service API。 您可以在下列教學課程中使用此基本連線ID：

本頁內容