提交您的源

使用自助式源(批处理SDK)将新源集成到Adobe Experience Platform的最后一步是测试源以供验证。 成功后,您可以联系Adobe代表以提交新的源。

以下文档提供了有关如何使用Flow Service API测试和调试源的步骤。

快速入门

测试源

要测试您的源,您必须在Postman上运行自助源验证集合和环境,同时提供与您的源相关的适当环境变量。

要开始测试,您必须先在Postman上设置集合和环境。 接下来,指定要测试的连接规范ID。

指定authSpecName

输入连接规范ID后,您必须指定用于基本连接的authSpecName。 根据您的选择,这可以是OAuth 2 Refresh CodeBasic Authentication。 指定authSpecName后,您必须在环境中包含其所需的凭据。 例如,如果将authSpecName指定为OAuth 2 Refresh Code,则必须为OAuth 2提供所需的凭据,即hostaccessToken

指定sourceSpec

添加验证规范参数后,必须接着从源规范中添加所需属性。 您可以在sourceSpec.spec.properties中找到所需的属性。 在以下MailChimp Members示例中,唯一需要的属性是listId,这意味着listId并且它的ID值对应到您的Postman环境。

"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
以下所有示例变量都是必须更新的占位符值,但属于固定值的flowSpecificationIdtargetConnectionSpecId除外。
参数
描述
示例
x-api-key
用于对调用Experience PlatformAPI进行身份验证的唯一标识符。 有关如何检索x-api-key的信息,请参阅有关身份验证和访问Experience PlatformAPI的教程。
c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
公司实体,可以拥有产品或服务,也可以为其授予产品和服务许可证,并允许其成员访问。 有关如何检索x-gw-ims-org-id信息的说明,请参阅有关设置开发人员控制台和 Postman的教程。
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
完成对Experience PlatformAPI的调用所需的授权令牌。 有关如何检索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
流规范ID RestStorageToAEP这是一个固定值
6499120c-0b15-42dc-936e-847ea3c24d72
targetConnectionSpecId
摄取的数据登陆所在数据湖的目标连接ID。 这是一个固定值
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
检查流运行是否完成时要遵循的指定时间间隔。
40
startTime
为数据流指定的开始时间。 开始时间的格式必须为unix时间。
1597784298

提供所有环境变量后,即可使用Postman界面开始运行集合。 在Postman界面中,选择Sources SSSs Verification Collection旁边的省略号(),然后选择​ 运行收藏集

运行者

将显示Runner接口,允许您配置数据流的运行顺序。 选择​ 运行SSS验证集合 ​以运行该集合。

NOTE
如果您希望在Platform UI中使用源监视仪表板,则可以禁用运行订单清单中的​ 删除流。 但是,测试完成后,必须确保删除测试流。

运行集合

提交您的源

在源能够完成整个工作流后,您可以继续联系Adobe代表并提交源以进行集成。

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