目录适配器
Catalog Adapter
扩展禁用Commerce应用程序中包含的默认产品价格索引器,并改用目录服务提供的价格。
该适配器设计用于SaaS数据导出和Adobe Commerce服务。 SaaS数据导出负责提交价格,Catalog Adapter将从Adobe Commerce服务中检索所有价格。
启用Catalog Adapter后,价格索引和操作将在以下方面受到影响:
您可以通过删除或禁用Catalog Adapter扩展在Commerce应用程序中重新启用价格索引。
要求
-
Adobe Commerce 2.4.4+
-
安装了以下Commerce服务之一:
安装
Catalog Adapter扩展是一个Composer中继,用于安装以下模块:
- 价格索引器禁用 — 此模块禁用Commerce应用程序中的价格索引,以便通过SaaS价格索引来提供价格。 安装SaaS价格索引扩展后,Commerce应用程序中的产品价格索引器无法打开。
- 价格提供程序 — 此模块提供Adobe Commerce服务产品的价格。 它形成搜索查询并获取前端产品的价格。
- 目录服务搜索适配器 — 此模块将价格从Adobe Commerce应用程序传输到Adobe Commerce服务,以响应产品搜索请求。
安装步骤
使用此方法为Commerce Cloud实例安装Catalog Adapter。
-
在本地工作站上,转到云基础架构项目上Adobe Commerce的项目目录。
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。
-
使用编辑器将目录适配器添加到您的项目中:
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产品价格索引器,则可以使用以下命令重新启用它:
# 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产品价格索引器的第三方扩展集成
- 安装Catalog Adapter。
依赖于Adobe Commerce产品价格索引器
- 您是已安装支持服务(Live Search、Product Recommendations、Catalog Service)的Luma或Adobe Commerce Core GraphQL商家
- 您使用依赖于Adobe Commerce产品价格索引器的第三方扩展
- 安装Catalog Adapter。
- 重新启用默认的Adobe Commerce产品价格索引器。
Headless Commerce实例
- 安装了所需服务(Live Search、产品Recommendations、目录服务)的Headless Commerce实例的商家
- 不依赖默认的Adobe Commerce产品价格索引器
- 从Catalog Adapter包安装
magento/module-price-indexer-disabler
模块。