使用自助源(批处理SDK)将新源集成到Adobe Experience Platform的最后一步是测试源以进行验证。 成功后,您可以联系Adobe代表以提交新来源。
以下文档提供了有关如何使用 Flow Service API.
要测试源,必须运行 自助源验证收集和环境 on Postman 同时提供与您的源相关的适当环境变量。
要开始测试,您必须先在 Postman. 接下来,指定要测试的连接规范ID。
authSpecName
输入连接规范ID后,必须指定 authSpecName
用于基础连接。 根据您的选择,这可能是 OAuth 2 Refresh Code
或 Basic Authentication
. 指定 authSpecName
,则必须在环境中包含其必需的凭据。 例如,如果您指定 authSpecName
as OAuth 2 Refresh Code
,则您必须为OAuth 2提供必需的凭据,这些凭据 host
和 accessToken
.
sourceSpec
添加身份验证规范参数后,您必须从源规范中添加所需的属性。 您可以在 sourceSpec.spec.properties
. 对于 MailChimp Members 以下示例中,唯一必需的属性是 listId
,表示 listId
并且它与 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。 这是您在 创建新连接规范. | 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代表并提交源代码以进行集成。