[僅限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. 傳輸 — 轉換後的資料會透過Adobe I/O Gateway透過HTTP POST (/v1/catalog/<feed name>)傳送至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欄位中列出的專案會出現在Admin中,需要注意。 批次中的其他專案會重試。
5xx
已由resync_failed_feeds_data_exporter群組中的摘要特定*_feed_resend_failed_items cron工作重試。
recommendation-more-help
commerce-help-aco-connector