SaaS Data Exportのシナリオのトラブルシューティング
このページでは、一般的に設定ミスや同期結果の誤解釈が原因でSaaS Data Exportを操作する際に発生する可能性のある動作について説明します。 以下の説明を使用して、根本原因を特定し、適切な解決策を適用します。
Commerce サービスで設定可能またはバンドル製品が見つからない configurable-bundle-missing
問題：設定可能な製品またはバンドル製品のステータスはAdobe Commerceで 有効 ですが、ストアフロントで返されないか、Commerce SaaS サービスで無効 ステータスで表示されます。
原因：複合製品の有効な状態は、親製品の状態だけでなく、子製品の状態によって異なります。 CommerceのSaaS サービスは、次の計算済みステータスを反映します。
- 構成可能な製品 – 少なくとも1つの製品バリアントを有効にする必要があります。
- バンドル製品 – 必要なバンドルオプションごとに、少なくとも1つの製品を有効にする必要があります。
これらの条件が満たされない場合、親の製品は、独自のステータスが 有効 に設定されていても、無効として扱われます。
解決策：
- 設定可能な製品について、少なくとも1つの関連するシンプルな製品バリエーションが有効になっていて、正しいweb サイトとストアビューに割り当てられていることを確認します。
- バンドル製品の場合、必要な各バンドルオプションに少なくとも1つの有効な子製品があることを確認します。 すべての無効な子に対して必須オプションを指定すると、バンドル全体が無効として扱われます。
- 適切な子製品を有効にした後、再同期をトリガーするか、次回のスケジュールされた同期を待ってから、Commerce SaaS サービスで更新されたステータスを確認します。
カタログ価格ルールのアクティブ化後に価格が更新されない prices-not-updated
問題： スケジュールされた更新機能を使用してカタログ価格ルールをアクティブ化した後、価格は更新されません。 スケジュールされた更新が適用された後、commerce-data-export.logにはprices フィードのsynced: 0が表示されます。
原因： カタログ価格ルールに予定更新を使用すると、クローングループ間で競合状態が発生する可能性があります。 catalog_data_exporter_product_prices インデクサーは、依存関係であるcatalogrule_product インデックスの再構築が完了する前に実行される可能性があります。 その結果、価格エクスポーターは古いデータを読み取り、変更を書き出しません。
解決策：
この問題の即時の修正は回避策です。両方のcron グループを順次実行するように設定して、レース条件を排除します。
-
Stores > Configuration > Advanced > System > Cron (Scheduled Tasks)に移動します。
-
両方に Use Separate Process を No に設定：
- グループのCron設定オプション：index
- グループのCron設定オプション：staging
-
保存後に設定キャッシュをフラッシュします。
Adobe Commerceと接続サービス間のカタログデータの相違 catalog-data-discrepancy
問題：接続されたCommerce サービス（Live SearchやProduct Recommendationsなど）に表示されている製品データがAdobe Commerceのカタログデータと一致しません。 例えば、ストアフロントで商品名、価格、説明が古かったり、間違っていたりします。
原因：再同期がトリガーされた後、データが更新され、UI コンポーネントに反映されるまでに最大1時間かかる場合があります。 そのウィンドウを超えて矛盾が続く場合は、フィード データが既に最新としてマークされているため、アイテムが最後の同期で取得されなかった可能性があります。または、同期で変更が検出されなかった可能性があります。
解決策：
- Commerce ストアフロントから、検索結果を開きます。 次に、該当する製品を選択して、詳細ビューを開きます。
- JSON出力をコピーし、Commerce カタログにあるものと一致することを確認します。
- コンテンツが一致しない場合は、スペースやピリオドの追加など、カタログ内の製品を少し変更して、変更を強制的に検出します。
- 再同期を待つか、管理者のCLIまたはData Feed Sync Status ページから手動再同期をトリガーします。
Product Recommendationsのカタログデータのトラブルシューティングについて詳しくは、Commerce ナレッジベースの商品レコメンデーションモジュール のトラブルシューティングを参照してください。
スケジュールでデータ同期が実行されていません sync-not-on-schedule
問題： データの同期がスケジュールどおりに実行されないか、Adobe Commerceの製品の変更にもかかわらずアイテムが同期されていません。
原因：最も一般的な原因は、cron ジョブが実行されていないか、Update by Schedule モードでインデクサーが設定されていないことです。
解決策：
- cron ジョブが実行中であることを確認します。
- 次のフィードのインデックスが Update by Schedule に設定されていることを確認します。カタログ属性、製品、製品の上書き、製品バリアント。 Commerce管理者のIndex ManagementまたはCLI:
bin/magento indexer:show-mode | grep -i feedを使用して確認します。
カタログ同期のステータスが「失敗」です catalog-sync-failed
問題： カタログの同期で、Data Feed Sync Status ページに失敗 ステータスが表示されます。
原因： データの収集または送信フェーズ中に、回復不能なエラーが発生しました。 一般的な原因には、API認証の問題、ネットワークエラー、データ検証エラーなどがあります。
解決策：
-
エラーの詳細については、データ書き出しエラーログを参照してください。 ログ形式と拡張ログ オプションについては、 ログの確認とトラブルシューティング を参照してください。
- データ収集中にエラーが発生した
var/log/commerce-data-export-errors.log。 - データ送信中にエラーが発生した
var/log/saas-export-errors.log。
- データ収集中にエラーが発生した
-
エラーが設定またはサードパーティの拡張機能に関連しない場合は、関連するログエントリを含むサポートチケット を送信します。
ログに「操作がスキップされました – プロセスがロックされました」というメッセージが表示される process-locked
問題： commerce-data-export.log ファイルには、次のようなエントリが含まれています。
{"feed":"products","operation":"partial sync","status":"operation skipped - process locked by \"full sync(1234)\"", ...}
原因：これは予期された動作であり、エラーではありません。 完全な再インデックスまたはsaas:resyncが既に進行中の間に、クロントリガーによる部分的な同期が実行しようとすると、メッセージが表示されます。 SaaS Data Export拡張機能では、フィード ロック メカニズムを使用して、同時同期操作の競合を防止しています。
解決策：
アクションは必要ありません。 実行中のプロセスが完了してロックを解除すると、次のcron実行が取得され、保留中の変更が同期されます。 ロックメカニズムの仕組みについて詳しくは、SaaS データ書き出し用のフィードロックメカニズム を参照してください。