Commerce CLI を使用したフィードの同期

magento/saas-export パッケージの saas:resync コマンドを使用すると、Adobe Commerce SaaS サービスのデータ同期を管理できます。

Adobeでは、saas:resync コマンドを定期的に使用することはお勧めしません。 コマンドを使用する一般的なシナリオは次のとおりです。

var/log/saas-export.log ファイルの同期操作を監視します。

初期同期

コマンドラインから saas:resync をトリガーする場合、カタログのサイズに応じて、データの更新に数分から数時間かかる場合があります。

初期同期では、Adobeでは次の順序でコマンドを実行することをお勧めします。

bin/magento saas:resync --feed productattributes
bin/magento saas:resync --feed products
bin/magento saas:resync --feed scopesCustomerGroup
bin/magento saas:resync --feed scopesWebsite
bin/magento saas:resync --feed prices
bin/magento saas:resync --feed productoverrides
bin/magento saas:resync --feed variants
bin/magento saas:resync --feed categories
bin/magento saas:resync --feed categoryPermissions

CLI コマンドを使用した同期

saas:resync コマンドは、様々な同期操作をサポートしています。

使用可能なすべてのオプションを表示します。

bin/magento saas:resync --help

オプションの説明と例については、次の節を参照してください。

--by-ids

特定のエンティティを ID で部分的に再同期します。 products、productAttributes、productOverrides、inventoryStockStatus、prices、variants および categoryPermissions フィードをサポートします。

デフォルトでは、「--by-ids」オプションを使用する場合、製品 SKU 値を使用して値を指定します。 代わりに製品 ID を使用するには、「--id-type=ProductID」オプションを追加します。

例：

bin/magento saas:resync --feed products --by-ids='ADB102,ADB111,ADB112'

bin/magento saas:resync --feed= products --by-ids='1,2,3' --id-type='productId'

--cleanup-feed

インデックスを再作成してデータを SaaS に送信する前に、フィードインデクサーテーブルをクリーンアップします。 products、productAttributes、productOverrides、inventoryStockStatus、prices、variants および categoryPermissions でのみサポートされます。

--dry-run オプションと共に使用すると、操作はすべての項目に対してドライラン再同期操作を実行します。

例：

bin/magento saas:resync --feed products --cleanup-feed

--continue-resync

中断された再同期操作を再開します。 products、productAttributes、productOverrides フィードでのみサポートされます。

例：

bin/magento saas:resync --feed productAttributes --continue-resync

--dry-run

フィードを SaaS に送信せずに、またフィード テーブルに保存せずに、フィードの再インデックス プロセスを実行します。 このオプションは、データセットの問題を特定するのに役立ちます。

EXPORTER_EXTENDED_LOG=1 環境変数を追加して、ペイロードを var/log/saas-export.log に保存します。

例：

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run

特定のフィード項目のテスト

--by-ids オプションと拡張ログコレクションを追加して特定のフィード項目をテストし、var/log/saas-export.log ファイルに生成されたペイロードを確認します。

例：

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed products --dry-run --by-ids='ADB102,ADB111,ADB112'

すべてのフィード項目のテスト

デフォルトでは、resync --dry-run の操作中に送信されるフィードには、新しい項目、または以前に書き出しに失敗した項目のみが含まれます。 処理するフィード内のすべての項目を含めるには、--cleanup-feed オプションを使用します。

例

bin/magento saas:resync --feed products --dry-run --cleanup-feed

--feed

必須。 再同期するフィード エンティティを指定します。

使用可能なフィード：

例：

bin/magento saas:resync --feed products

--no-reindex

インデックスを再作成せずに、既存のカタログ データを Commerce Services に再送信します。 製品関連のフィードではサポートされていません。

動作は エクスポートモードによって異なります。

例：

bin/magento saas:resync --feed productAttributes --no-reindex

--id-type=ProductId

デフォルトでは、saas:resync feed コマンドを --by-ids オプションと共に使用した場合に指定されるエンティティは、製品 SKU によって指定されます。 --id-type=ProductId オプションを使用して、製品 ID でエンティティを指定します。

bin/magento saas:resync --feed products --by-ids='1,2,3' --id-type='productId'

例：

トラブルシューティング

接続されたCommerce サービスに期待されるデータが表示されない場合は、データの書き出しエラーログを確認し、saas:resync コマンドを環境変数と共に使用してペイロードとプロファイラーのデータを確認することで、問題のトラブルシューティングを行います。 ログの確認とトラブルシューティングを参照してください。