[仅限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所需的格式,并处理身份验证、批量提交和基于范围的同步控制。 以下各节将介绍该同步的工作方式。

相关上下文:

同步的工作方式

下图显示了通过Adobe I/O Gateway从Adobe Commerce到Commerce Optimizer的数据同步。

Commerce Optimizer Connector高级同步图 {width="800" modal="regular"}

当目录数据在Adobe Commerce中更改时,同步将经过这些阶段。

  1. 实体更改检测 — (每1分钟)Cron作业(indexer_reindex_all_invalid)检测Adobe Commerce实体更改并触发汇编馈送项目的SaaS Data Export。
  2. 转换 — Commerce Optimizer Connector将选取组合馈送,将Adobe Commerce实体和范围映射到Commerce Optimizer API所需的格式,并准备传输的有效负载。
  3. 传输 — 转换后的数据通过HTTP POST (/v1/catalog/<feed name>)通过Adobe I/O Gateway到Commerce Optimizer发送,这将验证并保留传入的馈送。
  4. 保留结果 — 将API响应状态保留到信息源表
  5. 失败重试(每5分钟) — 单独的cron作业(*_resend_failed_items)检测到任何失败的馈送项目,并通过同一管道重新提交它们。

计划的cron作业

以下cron作业按固定计划自动执行管道。

Cron组
Cron作业
用途
计划
index
indexer_update_all_views
侦听实体更新,组合信息源项目,保留信息源状态
每1分钟
index
indexer_reindex_all_invalid
对标记为“需要重新索引”的源索引执行完全重新同步
每1分钟
resync_failed_feeds_data_exporter
*_resend_failed_items
检查失败的信息源项目并将它们重新提交到Commerce Optimizer
每5分钟
commerce_data_export
cleanup_deleted_feed_items
清理超过保留期(7天)的同步删除的信息源项目
每天凌晨2:00

SaaS Data Export​扩展处理馈送收集和状态跟踪。 连接器层将实体和范围映射到Commerce Optimizer API所需的格式,并通过POST /v1/catalog/<feed name>提交它们。

要求

基于范围的同步控制

CommerceOptimizerScopeMapper模块读取每个网站和每个商店视图的导出设置,并在信息源收集和提交期间强制执行这些设置。

  • 已按照正常增量计划启用作用域​导出数据。
  • 已从管道中排除​禁用的作用域
    之前同步的实体在下次cron运行时从Commerce Optimizer中删除。

如果同步问题仅影响一个目录源或价格手册,请参阅数据未同步

有关自定义同步范围的详细信息,请参阅自定义Commerce范围导出配置

时间安排和监控

方案
典型计时
例行目录更新
1到2个增量同步周期(索引和提交大约需要1到2分钟)
瞬时故障
每5分钟重试一次
完全同步或大型目录
分钟到小时

从Commerce管理员的Data Feed Sync Status页面中监视每个馈送的状态。 请参阅验证数据同步是否正常工作

馈送提交和错误处理

FeedSubmitter进程处理Catalog Data Ingestion API调用。

  1. 将更新项目与删除项目分开(不同的API端点)。
  2. 调用单独更新和删除端点。
  3. 将每个项目的状态结果合并回单个响应。

HTTP状态代码合并

当更新和删除调用返回不同的状态代码时,FeedSubmitter将按如下方式合并结果。

更新结果
删除结果
最终结果
200
200或无
200项成功
200
400
200个包含删除错误
400
400
400个合并错误
其他
其他
可重试
错误类型
行为
400
响应errors字段中列出的项目将显示在管理员中,需要引起注意。 重试批次中的其他项目。
5xx
已由resync_failed_feeds_data_exporter组中特定于信息源的*_feed_resend_failed_items cron作业重试。
recommendation-more-help
commerce-help-aco-connector