カタログアダプタ
Catalog Adapter
拡張機能は、Commerce アプリケーションに含まれているデフォルトの製品価格インデクサーを無効にし、代わりに カタログサービスから提供される価格を使用します。
このアダプタは、SaaS データ書き出しおよびAdobe Commerce サービスで動作するように設計されています。 SaaS データのエクスポートは価格の送信を担当し、Catalog Adapter はAdobe Commerceサービスからすべての価格を取得します。
Catalog Adapter を有効にすると、価格のインデックス作成と操作が次のような影響を受けます。
- Adobe Commerce アプリケーションに含まれる価格インデクサーが無効になっています。
- 価格は、SaaS データのエクスポートと SaaS 価格インデクサーを使用して管理されます。
- お客様が商品や商品の価格を表示するページを開くと、その価格はAdobe Commerce サービスから取得されます。
- 価格は、SaaS データ書き出しからのデータを同期してAdobe Commerce サービスに送信されます。
- チェックアウトでは価格が動的に再計算されます。
カタログアダプタ拡張機能を削除または無効にすることで、Commerce アプリケーションで価格インデックスを再度有効にすることができます。
要件
-
Adobe Commerce 2.4.4 以降
-
次のいずれかのCommerce サービスがインストールされていること。
インストール
カタログ アダプタ拡張機能は、次のモジュールをインストールする Composer メタパッケージです。
- Price Indexer Disabler-Commerce アプリケーションの価格インデックスを無効にして、SaaS 価格インデックスを使用して価格が配信されるようにします。 SaaS 価格インデックス作成拡張機能がインストールされている場合、Commerce アプリケーションの製品価格インデックス作成を有効にすることはできません。
- 価格プロバイダー-Adobe Commerce サービスの商品の価格を提供します。 検索クエリを作成し、フロントエンドの製品の価格を取得します。
- カタログサービス検索アダプター – 商品検索リクエストに応じて、Adobe Commerce アプリケーションからAdobe Commerce サービスに価格を転送します。
インストール手順
このメソッドを使用して、Commerce Cloudインスタンスの Catalog Adapter をインストールします。
-
ローカルワークステーションで、Adobe Commerce on cloud infrastructure プロジェクトのプロジェクトディレクトリに移動します。
note note NOTE Commerce Adobe Commerce プロジェクト環境のローカル管理について詳しくは、クラウドインフラストラクチャユーザーガイドの CLI を使用したブランチの管理を参照してください。 -
Adobe Commerce Cloud CLI を使用して更新する環境ブランチを確認します。
code language-shell magento-cloud environment:checkout <environment-id>
-
カタログアダプタモジュールを追加します。
code language-bash composer require magento/catalog-adapter --no-update
-
パッケージの依存関係を更新します。
code language-bash composer update "magento/catalog-adapter"
-
composer.json
ファイルとcomposer.lock
ファイルのコード変更をコミットしプッシュします。 -
composer.json
ファイルとcomposer.lock
ファイルのコード変更を追加、コミットし、クラウド環境にプッシュします。code language-shell git add -A git commit -m "Add catalog adapter module" git push origin <branch-name>
アップデートをクラウド環境にプッシュすると、Commerce クラウドデプロイメントプロセスが開始され変更が適用されます。 デプロイメントログからデプロイメントステータスを確認します。
オンプレミスのインスタンスに Catalog Adapter をインストールするには、この方法を使用します。
-
Composer を使用して、プロジェクトにカタログアダプタを追加します。
code language-bash composer require magento/catalog-adapter --no-update
-
依存関係を更新し、拡張機能をインストールします。
code language-bash composer update "magento/catalog-adapter"
-
Adobe Commerceをアップグレード :
code language-bash bin/magento setup:upgrade
-
キャッシュをクリアする:
code language-bash bin/magento cache:clean
note tip TIP 場合によっては(特に実稼動環境にデプロイする場合)、コンパイル済みのコードは時間がかかるので、クリアしないようにしたい場合があります。 変更を加える前に、システムを必ずバックアップしてください。
Adobe Commerce製品価格インデクサーを再度有効にします。
デフォルトのAdobe Commerce product price indexer に依存するサードパーティアプリケーションがある場合は、次のコマンドを使用して再度有効にすることができます。
# re-enable Product Price indexer
bin/magento module:disable Magento_PriceIndexerDisabler
# re-index Product Price indexer
bin/magento index:reindex catalog_product_price
ヘッドレスストアフロントシナリオに対する製品価格インデクサーの無効化
ヘッドレス Commerce インスタンスがある場合は、Adobe Commerce product price indexer を無効にして、Adobe Commerce インスタンスの負荷を軽減する必要がある場合があります。 magento/module-price-indexer-disabler
モジュールをインストールすると、このタスクを完了できます。
composer require magento/module-price-indexer-disabler
使用シナリオ
一般的な Catalog Adapter
シナリオを次に示します。
Adobe Commerce product price indexer に依存しない
- 必要なサービス(Live Search、Product Recommendations、Catalog Service)がインストールされている、Luma またはAdobe Commerce Core GraphQL マーチャントです
- Adobe Commerce product price indexer に依存するサードパーティの拡張機能との統合はありません。
- Catalog Adapter のインストール
Adobe Commerce product price indexer に依存する
- サポートされているサービス(Live Search、Product Recommendations、Catalog Service)がインストールされている、Luma またはAdobe Commerce Core GraphQL マーチャントです
- Adobe Commerce product price indexer に基づくサードパーティの拡張機能を使用します。
- Catalog Adapter のインストール
- デフォルトのAdobe Commerce製品価格インデクサーを再度有効にします。
ヘッドレス Commerce インスタンス
- 必要なサービスがインストールされたヘッドレス Commerce インスタンス(Live Search、Product Recommendations、Catalog Service)を持つマーチャント
- デフォルトのAdobe Commerce製品価格インデクサーに依存しない
- Catalog Adapter パッケージから
magento/module-price-indexer-disabler
モジュールをインストールします。