提交您的來源

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

使用自助式來源（批次SDK）將新來源整合到Adobe Experience Platform的最後一步是測試來源以進行驗證。一旦成功，您就可以連絡您的Adobe代表來提交新的來源。

以下檔案提供如何使用Flow Service API測試及偵錯來源的步驟。

快速入門

如需如何成功呼叫Platform API的詳細資訊，請參閱Platform API快速入門的指南。
如需如何產生Platform API認證的詳細資訊，請參閱有關驗證和存取Experience PlatformAPI的教學課程。
如需如何設定Platform API Postman的相關資訊，請參閱設定開發人員主控台和 Postman上的教學課程。
若要協助您的測試和偵錯程式，請在此下載自助來源驗證集合和環境，並遵循下列步驟。

測試您的來源

若要測試您的來源，您必須在Postman上執行自助來源驗證集合和環境，同時提供與您的來源相關的適當環境變數。

若要開始測試，您必須先在Postman上設定集合和環境。接著，指定您要測試的連線規格ID。

指定`authSpecName`

輸入連線規格ID後，您必須指定用於基礎連線的authSpecName。根據您的選擇，這可能是OAuth 2 Refresh Code或Basic Authentication。指定authSpecName後，您必須在環境中加入其必要的認證。例如，若您指定authSpecName為OAuth 2 Refresh Code，則必須提供OAuth 2的必要認證，即host和accessToken。

指定`sourceSpec`

在新增驗證規格引數後，您必須接著從來源規格中新增必要屬性。您可以在sourceSpec.spec.properties中找到必要的屬性。在以下MailChimp Members範例中，唯一需要的屬性是listId，這表示listId且其對應至您Postman環境的ID值。

"spec": {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "description": "Define user input parameters to fetch resource values.",
  "properties": {
    "listId": {
      "type": "string",
      "description": "listId for which members need to fetch."
    }
  }
}

提供驗證和來源規格引數後，您就可以開始填入其餘的環境變數，請參閱下表以供參考：

NOTE

以下所有範例變數都是您必須更新的預留位置值，flowSpecificationId和targetConnectionSpecId除外，它們是固定值。

參數

說明

範例

x-api-key

用於驗證對Experience Platform API的呼叫的唯一識別碼。如需如何擷取x-api-key的詳細資訊，請參閱驗證及存取Experience PlatformAPI的教學課程。

c8d9a2f5c1e03789bd22e8efdd1bdc1b

x-gw-ims-org-id

企業實體，可以擁有或授權產品及服務並允許存取其成員。如需如何擷取x-gw-ims-org-id資訊的說明，請參閱設定開發人員主控台和 Postman的教學課程。

ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg

authorizationToken

完成對Experience Platform API的呼叫所需的授權權杖。如需如何擷取authorizationToken的詳細資訊，請參閱驗證及存取Experience PlatformAPI的教學課程。

Bearer authorizationToken

schemaId

為了在Platform中使用來源資料，必須建立目標結構描述，以根據您的需求來建構來源資料。如需有關如何建立目標XDM結構描述的詳細步驟，請參閱有關使用API 建立結構描述的教學課程。

https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b

schemaVersion

與您的結構描述對應的唯一版本。

application/vnd.adobe.xed-full-notext+json; version=1

schemaAltId

建立新結構描述時與schemaId一併傳回的meta:altId。

_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b

dataSetId

如需有關如何建立目標資料集的詳細步驟，請參閱有關使用API建立資料集的教學課程。

5f3c3cedb2805c194ff0b69a

mappings

對應集可用來定義來源結構描述中的資料如何對應到目的地結構描述的資料。如需有關如何建立對應的詳細步驟，請參閱有關使用API建立對應集的教學課程。

[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]

mappingId

與對應集對應的唯一ID。

bf5286a9c1ad4266baca76ba3adc9366

connectionSpecId

與您的來源對應的連線規格ID。這是您在建立新連線規格後產生的ID。

2e8580db-6489-4726-96de-e33f5f60295f

flowSpecificationId

RestStorageToAEP的流程規格識別碼。 這是固定值。

6499120c-0b15-42dc-936e-847ea3c24d72

targetConnectionSpecId

擷取的資料著陸所在資料湖的目標連線ID。 這是固定值。

c604ff05-7f1a-43c0-8e18-33bf874cb11c