Commerce Storefront Catalog Service发行说明

最近更新： 2026年5月11日

创建对象：

Admin

以下发行说明涵盖最新的Commerce目录服务更新，包括：

店面目录服务版本
- 增强了目录服务API架构以改进数据检索
- 目录服务API和底层基础架构的安全性、性能和可靠性改进。
有关这些API的更多信息，请参阅Commerce开发人员文档中的Storefront Services架构。
目录服务中继包版本
- 更新了依赖关系，以提高性能、稳定性和与其他Adobe Commerce组件的兼容性。
目录服务安装程序版本
- 更新了依赖关系，以维护目录服务与Commerce栈栈之间的兼容性。

NOTE

如果您的Commerce项目使用Adobe Commerce Optimizer将目录数据提交到Commerce Edge Delivery服务或Headless店面，请参阅Adobe Commerce Optimizer发行说明以了解最新的API更新。

更新按类型分类：

新功能
修复和改进
已知问题

支持最新版本。旧版本的发行说明包括在内，以供参考。

店面目录服务

2026年5月

发行日期： 2026年5月13日

GraphQL中的类别排序顺序 — CategoryView GraphQL类型现在包含职位字段，因此店面可以显示目录层次结构中商家配置的订单中的类别。

发行日期： 2026年5月4日

店面产品价格现在显示所有产品类型的正确货币代码（例如，美元）。以前，某些产品显示NONE而不是预期的货币，从而导致缺少价格。此更新确保在整个店面一致且准确地呈现价格。

2026年4月

发行日期：2026年4月29日

已强制限制Adobe Commerce Optimizer和Adobe Commerce as a Cloud Service的每个请求最多100个SKU
根据记录的限制和边界的客户端。

发行日期：2026年4月17日

添加了一个新的searchCategory GraphQL查询，该查询使客户端能够按名称搜索具有分页结果的类别。查询接受必需的searchTerm（至少3个字符）以及可选的family、pageSize和currentPage参数。结果包括与具有完整类别元数据的CategoryTreeView对象、totalCount和分页pageInfo匹配。

此查询仅适用于使用Adobe Commerce Optimizer促销服务的客户。请参阅searchCategory。

2026年3月

发行日期：2026年3月24日

添加了对计算并返回动态捆绑包价格范围的支持。

2025年12月

发行日期：2025年12月11日

系统级和基础架构改进以提高性能和稳定性。

2025年11

发行日期： 2025年11月17日

按名称筛选属性- productSearch GraphQL查询现在支持使用names字段筛选产品属性。通过此过滤器，您可以：

通过仅请求特定属性减小响应有效负载大小
与现有roles筛选器结合，按可见性角色和属性名称缩小

示例：

仅按属性名称筛选

code language-graphql
`query { products(skus: ["SKU-001"]) { attributes(names: ["color", "size", "material"]) { name label value } } }`

按角色和名称筛选：

code language-graphql
`query { products(skus: ["SKU-001"]) { attributes(roles: ["visible in PDP"], names: ["eco_collection", "new"]) { name label value roles } } }`

NOTE

要在不进行筛选的情况下检索所有属性，请省略names参数或提供空数组。

发行日期：2025年11月6日

系统级和基础架构改进以提高性能和稳定性。

当父产品无定价时，现在可以查询分组产品；子产品返回其自己的可见性角色。

系统级和基础架构改进以提高性能和稳定性。

2025年9月

发行日期：2025年9月8日

已添加层定价支持以查询卷定价：

要检索层定价，请执行以下操作：

将products查询用于所需的SKU
对于SimpleProductView，访问price.tiers
对于ComplexProductView，访问priceRange.minimum.tiers和priceRange.maximum.tiers
每个层包含折扣的tier价格和quantity条件
使用gte （大于或等于）和lt （小于）定义数量阈值

示例：

query {
  products(skus: ["SKU-001"]) {
    ... on SimpleProductView {
      price {
        regular { amount { value currency } }
        tiers {
          tier { amount { value currency } }
          quantity {
            ... on ProductViewTierRangeCondition { gte lt }
          }
        }
      }
    }
  }
}

按最低最终价格筛选的层价格

API现在仅返回折扣价格低于产品最低最终价格 的层。 由于店面将适用最低最终价格，因此省略了较高层级。

适用于：

简单产品： price.tiers仅包含具有tier.amount.value < price.final.amount.value （最小最终值）的层。
复杂产品： priceRange.minimum.tiers和priceRange.maximum.tiers在生成价格范围时使用相同的规则。

发行日期：2025年9月2日

改进了对缺少价格信息的错误处理 — 当尚未收到价格数据时，API将返回价格字段的null而不是引发错误，从而允许客户端正常处理缺少的数据。

系统级和基础架构改进以增强性能和稳定性。

2025年7月

发行日期：2025年7月30日

系统级和基础架构改进以增强安全性、性能和稳定性。

发行日期： 2025年7月24日

按单位ID检索推荐单位 — 新GraphQL终结点recommendationsByUnitIds按单位的唯一ID检索推荐单位，以实现更灵活、更有针对性的访问。

unitIds是必需的（要获取的recId列表）。
上下文参数(currentSku、cartSkus、userViewHistory、userPurchaseHistory、category)的行为与现有推荐查询中的行为相同。

示例

code language-graphql

code language-graphql
`query { recommendationsByUnitIds( unitIds: ["11ee89d1-bfae-4582-a921-2ced44ff6bf7"] currentSku: "24-MB01" cartSkus: ["24-MB01"] ) { totalResults results { unitId unitName totalProducts productsView { sku } pageType typeId storefrontLabel displayOrder } } }`

query {
  recommendationsByUnitIds(
    unitIds: ["11ee89d1-bfae-4582-a921-2ced44ff6bf7"]
    currentSku: "24-MB01"
    cartSkus: ["24-MB01"]
  ) {
    totalResults
    results {
      unitId
      unitName
      totalProducts
      productsView {
        sku
      }
      pageType
      typeId
      storefrontLabel
      displayOrder
    }
  }
}

系统级和基础架构改进以增强安全性、性能和稳定性。

发行日期： 2025年7月15日

礼品卡产品类型 — 目录店面服务现在支持将产品属性作为JSON对象或数组，从而灵活管理复杂类型，如礼品卡。

先前版本

2025年6月

发行日期： 2025年6月20日

分层价格手册配置 — 父 — 子价格手册的准确价格范围。计算会遵循层次结构和继承的规则；在链接多个价格手册时可减少定价错误。仅限Adobe Commerce Optimizer。查看价格手册。

不区分大小写的键 — 查询中的键查找现在不区分大小写，减少了键大小写错误。

发行日期： 2025年6月20日

目录店面的公共IO事件 — 添加了用于实时集成和可观察性（CSS和EDS）的公共IO事件。

服务器端渲染(SSR) — 体系结构改进，支持SSR以获得更大的目录性能、SEO和UX。

基础架构和安全性 — 事件服务的新AWS角色、ServiceNow集成和CI/CD管道。

事件格式和可观察性 — 简化了负载、增强了监控、改进了变量事件数据。

系统级和基础架构改进以增强安全性、性能和稳定性。

发行日期： 2025年6月13日

检索未缓存数据 — 启用Magento-Is-Preview标头以将未缓存数据从目录终结点传递到Search Service。

多选产品选项-GraphQL API现在公开产品选项是否允许多选（例如，捆绑“选择多个项目”）。

已更新数据摄取的价格验证以支持无价格的产品。

改进了Adobe Commerce Optimizer中简单捆绑定价的错误处理。

系统级和基础架构改进以增强安全性、性能和稳定性。

2025年4月

发行日期：2025年4月8日

系统级和基础架构改进以增强安全性、性能和稳定性。

基础架构现在支持非常大的目录（最多约4.4亿SKU），而不影响现有工作负载。

2025年3月

发行日期： 2025年3月28日

对于可组合目录，没有角色的属性在默认情况下不再编制索引，从而缩短索引时间并减小存储空间。可以通过功能标记重新启用旧版行为。

系统级和基础架构改进以增强安全性、性能和稳定性。

2025年2月

发行日期： 2025年2月18日

系统级和基础架构改进以增强安全性、性能和稳定性。

2024年12月

发行日期： 2024年12月9日

主要版本：用于Headless店面、标题管理和产品数据处理的可组合目录数据模型。

可组合目录数据模型(CCDM) — 支持客户将可组合目录用于Headless店面。新端点接受目录视图和策略ID（向后兼容）。具有内置分页的可配置产品详细信息和价格。

对于可组合目录API操作， 标头管理-AC-Locale已重命名为AC-Scope-Locale；指定了标头映射和默认值。

产品数据和定价 — 支持可组合目录数据模型和改进可配置产品的价格处理。

CurrencyEnum已更新，以支持NONE的产品搜索查询，并与联合逻辑保持一致。

基础架构和升级 — 安全性、性能和稳定性的系统级改进。

捆绑包产品选项现在仅显示启用的产品。

发行日期： 2024年12月9日

产品查询中的图像排序—GraphQL images字段中的产品图像现在遵循目录导出sortOrder，以便店面和API行为一致。

系统级和基础架构改进以增强安全性、性能和稳定性。

发行日期：2024年12月

系统级和基础架构改进以增强安全性、性能和稳定性。

2024年10

发行日期：2024年10月22日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

GraphQL架构现在在产品信息中包含lastModifiedAt，以便获得准确的站点地图和搜索引擎重新索引（例如，Google）。

2024年9月

发行日期： 2024年9月26日

系统级和基础架构改进以增强安全性、性能和稳定性。

2024年8月

发行日期： 2024年8月22日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

现在无需产品覆盖（价格）数据即可检索产品信息。以前，这些查询返回： The following sku does not have product override data in the DB: <SKU value>. Make sure data is synced.

发行日期： 2024年8月13日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

添加了对按产品SKU检索所有变体的支持。请参阅目录服务API引用。

2024年5月

发行日期： 2024年5月23日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

选项值的InStock标记现在遵循产品变体的作用域enabled状态。

添加了对产品价格的支持，最高可支持16位和4位小数。从数据管理仪表板或CLI重新同步以应用更新。

已知限制

尚不支持以下功能：

动态属性有效负载的最大大小为9 MB。
本集团产品价格可按简单产品价格计算。
在图像数组中，只有第一个图像包含角色。

将API Mesh和核心GraphQL API用于：

最低广告价格
分层定价
捆绑固定价格的产品

有关详细信息和示例，请参阅目录服务和API网格。

2024年4月

发行日期： 2024年4月11日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

添加了对PHP 8.3的支持。

products和refineProduct查询现在返回简单和复杂产品的可自定义选项数据。

2024年2月

发行日期： 2024年2月22日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

Data Management Dashboard现在可用于数据流（产品推荐、实时搜索、目录服务）。需要catalog-service个中继包v3.1.0+。

发行日期： 2024年2月13日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

目录服务API现在支持产品视频。
缺货的期权现在显示在PDP小部件中。

已知限制

尚不支持以下功能：

动态属性有效负载的最大大小为9 MB。
组产品价格。此值可使用简单的产品价格计算。
在图像数组中，只有第一个图像包含角色。

将API Mesh和核心GraphQL API用于：

最低广告价格
分层定价

2023年10

发行日期：2023年10月12日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

目录服务支持产品变体的inStock标志。
urlKey和externalId字段已添加到GraphQL架构中。
现在支持可下载的产品和礼品卡。

2023年9月

发行日期： 2023年9月19日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

目录服务现在使用SaaS价格索引。
此版本包含服务端的错误修复和改进。

2023年7月

发行日期： 2023年7月18日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

目录服务现在支持产品推荐的recommendations GraphQL查询。

2023年6月

发行日期： 2023年6月27日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

目录服务API现在支持related products。

2023年4月

发行日期： 2023年4月12日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

目录服务现在正在清理已删除的产品变体。
基础架构可扩展性和性能改进。

2023年3月

发行日期： 2023年3月28日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

已将样本添加到products查询。
已添加使用API Mesh获取entityId的功能。

发行日期： 2023年3月6日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

添加了categories个GraphQL功能。
改进了性能和API可扩展性。

2023年2月

发行日期： 2023年2月7日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.x及更高版本

已发布的目录服务中继包以简化安装步骤。
API可扩展性和性能改进。

2023年1月

发行日期： 2023年1月17日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.x及更高版本

简化并改进了入门体验。
新客户沙盒端点可用于预生产测试。
已为虚拟产品添加支持。
API可扩展性和性能改进。

2022年11

发行日期： 2022年11月18日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.x及更高版本

目录服务现在支持Adobe的API网格。
改进了API可扩展性和整体性能。

2022年10

发行日期： 2022年10月4日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.x及更高版本

对捆绑产品和分组产品的支持。
添加了B2B可见性覆盖。产品现在可供搜索，并可添加到特定客户组的购物车中。
服务现在更稳定，性能也有所提高。

2022年9月

发行日期： 2022年9月12日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.x及更高版本

变体图像：根据所选选项返回的产品图像。
价格角色：只有特定客户组的成员才能看到产品价格。
提高了服务的稳定性和性能。
从目录中删除产品时收到更新。

2022年8月

发行日期： 2022年8月9日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.x及更高版本

products和refineProduct查询返回以下数据：

预定义的（系统）产品属性。
动态产品属性，并按角色（产品显示页面/产品列表页面）筛选这些属性。
产品选项。
产品图像并按角色(PDP/PLP)过滤它们。
简单产品的具体价格以及可配置产品的价格范围。
客户组价格及价格范围。它们向没有客户群组的购物者返还后备默认价格。
使用B2B客户特定定价的产品类型。

目录服务中继

目录服务PHP中继(magento/catalog-service)的更新。

对于Adobe Commerce as a Cloud Service客户，您的环境中安装了最新版本。
对于云上或内部部署的Adobe Commerce，Adobe建议使用编辑器升级云环境中的目录服务中继（最新版本）。

v3.3.0发布

发行日期：2025年10月14日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

数据服务升级—magento/data-services依赖关系已更新为^8.0.0。在升级之前，验证环境和自定义数据服务API的使用情况以实现8.x兼容性。

更新了3.3.0版本的版本和元数据。

v3.2.0发布

发行日期： 2024年4月12日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

已为3.2.0更新版本和元数据。没有其他依赖关系更改。

v3.1.0发布

发行日期： 2024年1月26日

[支持]{class="badge informative" title="支持"} Adobe Commerce版本2.4.4及更高版本

已添加新的包依赖项：

类别权限数据导出器 (magento/module-category-permission-data-exporter)，用于导出目录服务使用的类别权限数据。
目录同步管理员 magento/module-catalog-sync-admin，用于与目录同步相关的管理员UI和配置。

更新了3.1.0版本的版本和元数据。

目录服务安装程序

安装程序随目录服务扩展一起提供，并处理安装和环境检查，以使目录服务与您的Commerce栈栈匹配。

对于 Adobe Commerce as a Cloud Service 客户，您的环境中安装了最新安装程序版本。
对于云基础架构上的 Adobe Commerce 或内部部署，使安装程序与目录服务中间包保持一致。

无论何时使用编辑器升级magento/catalog-service，安装程序包都会自动更新为最新版本。当这些发行说明描述所需的更改（例如，支持新的PHP版本）时，您也可以使用Composer单独升级magento/catalog-service-installer。这样，您的安装工具就会与您运行的目录服务版本保持兼容。

v1.0.6发布

发行日期：2026年3月25日

PHP 8.5 — 确保目录服务在PHP 8.5上运行时兼容。

Commerce Storefront Catalog Service发行说明

店面目录服务

2026年5月

2026年4月

2026年3月

2025年12月

2025年11

2025年9月

2025年7月

2025年6月

2025年4月

2025年3月

2025年2月

2024年12月

2024年10

2024年9月

2024年8月

2024年5月

已知限制

2024年4月

2024年2月

已知限制

2023年10

2023年9月

2023年7月

2023年6月

2023年4月

2023年3月

2023年2月

2023年1月

2022年11

2022年10

2022年9月

2022年8月

目录服务中继

v3.3.0发布

v3.2.0发布

v3.1.0发布

目录服务安装程序

v1.0.6发布

相关文档