文档Experience Platform源连接器指南

[Beta 版]{class="badge informative"}

测试并提交源

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

创建对象：

  • 开发人员
NOTE
自助源流SDK处于测试阶段。 有关使用测试版标记源的更多信息，请阅读源概述。

使用自助源(Streaming SDK)将新源集成到Adobe Experience Platform的最后一步是测试和提交新源。 完成连接规范并更新流规范后，您可以通过API或UI开始测试源的功能。 成功后，您可以联系Adobe代表以提交新的源。

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

快速入门

使用API测试您的源

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

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

NOTE
以下所有示例变量都是必须更新的占位符值，但属于固定值的flowSpecificationId和targetConnectionSpecId除外。
参数
描述
示例
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 GenericStreamingAEP。 这是一个固定值。
e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
摄取的数据登陆所在数据湖的目标连接ID。 这是一个固定值。
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
检查流运行是否完成时要遵循的指定时间间隔。
40
startTime
为数据流指定的开始时间。 开始时间的格式必须为unix时间。
1597784298

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

运行者

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

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

运行集合

使用UI测试源

要在UI中测试源，请转到Platform UI中您组织沙盒的源目录。 从这里，您应该看到新源显示在​ 流 ​类别下。

现在，您的沙盒中提供了新源，您必须按照源工作流测试功能。 要开始，请选择​ 设置。

显示新流源的源目录。

出现添加数据步骤。 要测试源是否可以流式传输数据，请使用界面的左侧上传示例JSON数据。 上传数据后，界面的右侧会更新为数据的文件层级预览。 选择​ 下一步 ​以继续。

源工作流程中的添加数据步骤，您可以在其中上传并预览数据，然后再引入。

数据流详细信息页面允许您选择是要使用现有数据集，还是使用新数据集。 在此过程中，您还可以配置要摄取到配置文件的数据，并启用错误诊断和部分摄取等设置。

要进行测试，请选择​ 新数据集 ​并提供输出数据集名称。 在此步骤中，您还可以提供可选描述，以向数据集添加更多信息。 接下来，使用高级搜索选项或通过滚动下拉菜单中的现有架构列表来选择要映射到的架构。 选择架构后，为数据流提供名称和描述。

完成后，选择​ 下一步。

源工作流中的数据流详细信息步骤。

此时将显示映射步骤，该步骤为您提供了一个接口，用于将源架构中的源字段映射到目标架构中相应的目标XDM字段。

Platform根据您选择的目标架构或数据集，为自动映射的字段提供智能推荐。 您可以手动调整映射规则以适合您的用例。 根据需要，您可以选择直接映射字段，或使用数据准备函数转换源数据以派生计算值或计算值。 有关使用映射器界面和计算字段的全面步骤，请参阅数据准备UI指南

成功映射源数据后，选择​ 下一步。

源工作流的映射步骤。

将显示​ 审核 ​步骤，允许您在创建新数据流之前对其进行审核。 详细信息分为以下类别：

  • 连接：显示您的帐户名称、源类型以及您正在使用的流云存储源的其他特定信息。
  • 分配数据集和映射字段：显示用于数据流的目标数据集和架构。

查看数据流后，选择​ 完成，然后等待一些时间来创建数据流。

源工作流的审核步骤。

最后，您必须检索数据流的流端点。 此端点将用于订阅您的webhook，允许您的流源与Experience Platform通信。 要检索您的流端点，请转到刚刚创建的数据流的数据流活动页面，并从属性面板的底部复制端点。

数据流活动中的流终结点。

提交您的源

在您的来源能够完成整个工作流后，您可以继续联系您的Adobe代表并提交您的来源，以便在其他Experience Platform组织之间集成。

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