[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}
连接器同步管道
Adobe Commerce Optimizer Connector基于SaaS Data Export构建,将SaaS Data Export索引器收集的数据映射到Adobe Commerce Optimizer Catalog Data Ingestion API所需的格式,并处理身份验证、批量提交和基于范围的同步控制。 以下各节将介绍该同步的工作方式。
相关上下文:
-
在Commerce Optimizer Connector 概述主题中了解集成的业务价值、主要功能和架构。
-
有关模块包名称、馈送API端点和配置密钥路径,请参阅连接器引用
同步的工作方式
下图显示了通过Adobe I/O Gateway从Adobe Commerce到Commerce Optimizer的数据同步。
当目录数据在Adobe Commerce中更改时,同步将经过这些阶段。
- 实体更改检测 — (每1分钟)Cron作业(
indexer_reindex_all_invalid)检测Adobe Commerce实体更改并触发汇编馈送项目的SaaS Data Export。 - 转换 — Commerce Optimizer Connector将选取组合馈送,将Adobe Commerce实体和范围映射到Commerce Optimizer API所需的格式,并准备传输的有效负载。
- 传输 — 转换后的数据通过HTTP POST (
/v1/catalog/<feed name>)通过Adobe I/O Gateway到Commerce Optimizer发送,这将验证并保留传入的馈送。 - 保留结果 — 将API响应状态保留到信息源表。
- 失败重试(每5分钟) — 单独的cron作业(
*_resend_failed_items)检测到任何失败的馈送项目,并通过同一管道重新提交它们。
计划的cron作业
以下cron作业按固定计划自动执行管道。
indexindexer_update_all_viewsindexindexer_reindex_all_invalidresync_failed_feeds_data_exporter*_resend_failed_itemscommerce_data_exportcleanup_deleted_feed_itemsSaaS Data Export扩展处理馈送收集和状态跟踪。 连接器层将实体和范围映射到Commerce Optimizer API所需的格式,并通过POST /v1/catalog/<feed name>提交它们。
要求
- Commerce cron必须正在运行。
- 馈送索引器必须使用 Update by Schedule 模式。 请参阅部分同步。
基于范围的同步控制
CommerceOptimizerScopeMapper模块读取每个网站和每个商店视图的导出设置,并在信息源收集和提交期间强制执行这些设置。
- 已按照正常增量计划启用作用域导出数据。
- 已从管道中排除禁用的作用域。
之前同步的实体在下次cron运行时从Commerce Optimizer中删除。
如果同步问题仅影响一个目录源或价格手册,请参阅数据未同步。
有关自定义同步范围的详细信息,请参阅自定义Commerce范围导出配置。
时间安排和监控
从Commerce管理员的Data Feed Sync Status页面中监视每个馈送的状态。 请参阅验证数据同步是否正常工作。
馈送提交和错误处理
FeedSubmitter进程处理Catalog Data Ingestion API调用。
- 将更新项目与删除项目分开(不同的API端点)。
- 调用单独更新和删除端点。
- 将每个项目的状态结果合并回单个响应。
HTTP状态代码合并
当更新和删除调用返回不同的状态代码时,FeedSubmitter将按如下方式合并结果。
errors字段中列出的项目将显示在管理员中,需要引起注意。 重试批次中的其他项目。resync_failed_feeds_data_exporter组中特定于信息源的*_feed_resend_failed_items cron作业重试。