カタログアダプタ

Catalog Adapter 拡張機能は、Commerce アプリケーションに含まれているデフォルトの製品価格インデクサーを無効にし、代わりに カタログサービスから提供される価格を使用します。

このアダプタは、SaaS データ書き出しおよびAdobe Commerce サービスで動作するように設計されています。 SaaS データのエクスポートは価格の送信を担当し、Catalog Adapter はAdobe Commerceサービスからすべての価格を取得します。

Catalog Adapter を有効にすると、価格のインデックス作成と操作が次のような影響を受けます。

  • Adobe Commerce アプリケーションに含まれる価格インデクサーが無効になっています。
  • 価格は、SaaS データのエクスポートと SaaS 価格インデクサーを使用して管理されます。
  • お客様が商品や商品の価格を表示するページを開くと、その価格はAdobe Commerce サービスから取得されます。
  • 価格は、SaaS データ書き出しからのデータを同期してAdobe Commerce サービスに送信されます。
  • チェックアウトでは価格が動的に再計算されます。

カタログアダプタ拡張機能を削除または無効にすることで、Commerce アプリケーションで価格インデックスを再度有効にすることができます。

要件

インストール

カタログ アダプタ拡張機能は、次のモジュールをインストールする Composer メタパッケージです。

  • Price Indexer Disabler-Commerce アプリケーションの価格インデックスを無効にして、SaaS 価格インデックスを使用して価格が配信されるようにします。 SaaS 価格インデックス作成拡張機能がインストールされている場合、Commerce アプリケーションの製品価格インデックス作成を有効にすることはできません。
  • 価格プロバイダー-Adobe Commerce サービスの商品の価格を提供します。 検索クエリを作成し、フロントエンドの製品の価格を取得します。
  • カタログサービス検索アダプター – 商品検索リクエストに応じて、Adobe Commerce アプリケーションからAdobe Commerce サービスに価格を転送します。

インストール手順

クラウドインフラストラクチャ

このメソッドを使用して、Commerce Cloudインスタンスの Catalog Adapter をインストールします。

  1. ローカルワークステーションで、Adobe Commerce on cloud infrastructure プロジェクトのプロジェクトディレクトリに移動します。

    note note
    NOTE
    Commerce Adobe Commerce プロジェクト環境のローカル管理について詳しくは、クラウドインフラストラクチャユーザーガイドの CLI を使用したブランチの管理を参照してください
  2. Adobe Commerce Cloud CLI を使用して更新する環境ブランチを確認します。

    code language-shell
    magento-cloud environment:checkout <environment-id>
    
  3. カタログアダプタモジュールを追加します。

    code language-bash
    composer require magento/catalog-adapter --no-update
    
  4. パッケージの依存関係を更新します。

    code language-bash
    composer update "magento/catalog-adapter"
    
  5. composer.json ファイルと composer.lock ファイルのコード変更をコミットしプッシュします。

  6. 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 をインストールするには、この方法を使用します。

  1. Composer を使用して、プロジェクトにカタログアダプタを追加します。

    code language-bash
    composer require magento/catalog-adapter --no-update
    
  2. 依存関係を更新し、拡張機能をインストールします。

    code language-bash
    composer update  "magento/catalog-adapter"
    
  3. Adobe Commerceをアップグレード :

    code language-bash
    bin/magento setup:upgrade
    
  4. キャッシュをクリアする:

    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 に依存するサードパーティの拡張機能との統合はありません。
  1. Catalog Adapter のインストール

Adobe Commerce product price indexer に依存する

  • サポートされているサービス(Live Search、Product Recommendations、Catalog Service)がインストールされている、Luma またはAdobe Commerce Core GraphQL マーチャントです
  • Adobe Commerce product price indexer に基づくサードパーティの拡張機能を使用します。
  1. Catalog Adapter のインストール
  2. デフォルトのAdobe Commerce製品価格インデクサーを再度有効にします。

ヘッドレス Commerce インスタンス

  • 必要なサービスがインストールされたヘッドレス Commerce インスタンス(Live Search、Product Recommendations、Catalog Service)を持つマーチャント
  • デフォルトのAdobe Commerce製品価格インデクサーに依存しない
  1. Catalog Adapter パッケージから magento/module-price-indexer-disabler モジュールをインストールします。
recommendation-more-help
d84c01c7-401e-4340-8dad-f91bb65421cb