目录适配器

Catalog Adapter扩展禁用Commerce应用程序中包含的默认产品价格索引器,并改用目录服务提供的价格。

该适配器设计用于SaaS数据导出和Adobe Commerce服务。 SaaS数据导出负责提交价格,Catalog Adapter将从Adobe Commerce服务中检索所有价格。

启用Catalog Adapter后,价格索引和操作将在以下方面受到影响:

  • Adobe Commerce应用程序中包含的价格索引器已禁用。
  • 使用SaaS数据导出和SaaS价格索引器来管理价格。
  • 当客户打开产品、类别或其他页面显示产品价格时,将从Adobe Commerce服务中检索价格。
  • 通过同步SaaS数据导出中的数据,将价格发送到Adobe Commerce服务。
  • 结账会动态重新计算价格。

您可以通过删除或禁用Catalog Adapter扩展在Commerce应用程序中重新启用价格索引。

要求

安装

Catalog Adapter扩展是一个Composer中继,用于安装以下模块:

  • 价格索引器禁用 — 此模块禁用Commerce应用程序中的价格索引,以便通过SaaS价格索引来提供价格。 安装SaaS价格索引扩展后,Commerce应用程序中的产品价格索引器无法打开。
  • 价格提供程序 — 此模块提供Adobe Commerce服务产品的价格。 它形成搜索查询并获取前端产品的价格。
  • 目录服务搜索适配器 — 此模块将价格从Adobe Commerce应用程序传输到Adobe Commerce服务,以响应产品搜索请求。

安装步骤

云基础架构

使用此方法为Commerce Cloud实例安装Catalog Adapter。

  1. 在本地工作站上,转到云基础架构项目上Adobe Commerce的项目目录。

    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.jsoncomposer.lock文件的代码更改。

  6. 添加、提交并将composer.jsoncomposer.lock文件的代码更改推送到云环境。

    code language-shell
    git add -A
    git commit -m "Add catalog adapter module"
    git push origin <branch-name>
    

    将更新推送到云环境会启动Commerce云部署流程以应用更改。 从部署日志中检查部署状态。

内部部署

使用此方法为内部部署实例安装Catalog Adapter。

  1. 使用编辑器将目录适配器添加到您的项目中:

    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产品价格索引器,则可以使用以下命令重新启用它:

# re-enable Product Price indexer
bin/magento module:disable Magento_PriceIndexerDisabler
# re-index Product Price indexer
bin/magento index:reindex catalog_product_price

禁用Headless店面的产品价格索引器方案

如果您有Headless Commerce实例,则可能需要禁用Adobe Commerce产品价格索引器以减少Adobe Commerce实例的负载。 您可以通过安装magento/module-price-indexer-disabler模块来完成此任务:

composer require magento/module-price-indexer-disabler

使用方案

以下是一些常见的Catalog Adapter方案。

不依赖于Adobe Commerce产品价格索引器

  • 您是已安装所需服务(Live Search、Product Recommendations、Catalog Service)的Luma或Adobe Commerce Core GraphQL商家
  • 没有与依赖于Adobe Commerce产品价格索引器的第三方扩展集成
  1. 安装Catalog Adapter。

依赖于Adobe Commerce产品价格索引器

  • 您是已安装支持服务(Live Search、Product Recommendations、Catalog Service)的Luma或Adobe Commerce Core GraphQL商家
  • 您使用依赖于Adobe Commerce产品价格索引器的第三方扩展
  1. 安装Catalog Adapter。
  2. 重新启用默认的Adobe Commerce产品价格索引器。

Headless Commerce实例

  • 安装了所需服务(Live Search、产品Recommendations、目录服务)的Headless Commerce实例的商家
  • 不依赖默认的Adobe Commerce产品价格索引器
  1. 从Catalog Adapter包安装magento/module-price-indexer-disabler模块。
recommendation-more-help
d84c01c7-401e-4340-8dad-f91bb65421cb