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

saas:resync パッケージのmagento/saas-export コマンドを使用すると、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でエンティティを指定するには、--id-type=ProductId オプションを使用します。

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

例：

トラブルシューティング

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