使用自助式源(Batch SDK)将新源集成到Adobe Experience Platform的最后一步是测试源以进行验证。 成功后,您可以联系Adobe代表以提交新的源。
以下文档提供了有关如何使用测试和调试源的步骤 Flow Service API.
要测试您的源,您必须运行 自助式源验证收集与环境 日期 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
并且它的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."
}
}
}
提供身份验证和源规范参数后,您可以开始填充其余环境变量,请参阅下表以供参考:
以下所有示例变量都是必须更新的占位符值,以下除外 flowSpecificationId
和 targetConnectionSpecId
,为固定值。
参数 | 描述 | 示例 |
---|---|---|
x-api-key |
用于验证Experience PlatformAPI调用的唯一标识符。 请参阅上的教程 身份验证和访问Experience PlatformAPI 以获取有关如何检索 x-api-key . |
c8d9a2f5c1e03789bd22e8efdd1bdc1b |
x-gw-ims-org-id |
企业实体,可以拥有或许可产品和服务,并允许其成员访问。 请参阅上的教程 设置开发人员控制台和 Postman 以获取有关如何检索 x-gw-ims-org-id 信息。 |
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg |
authorizationToken |
完成Experience PlatformAPI调用所需的授权令牌。 请参阅上的教程 身份验证和访问Experience PlatformAPI 以获取有关如何检索 authorizationToken . |
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 |
此 meta:altId 该项会与 schemaId 创建新架构时。 |
_{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验证收集 以运行收藏集。
您可以禁用 删除流 如果您希望使用Platform UI中的源监控仪表板,请访问运行订单核对清单。 但是,测试完成后,必须确保删除测试流。
在您的源能够完成整个工作流后,您可以继续联系Adobe代表并提交您的源以进行集成。