AEM Assets中的Commerce元数据

最近更新： 2026年7月15日

主题：
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

创建对象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

Commerce元数据是AEM Assets和Commerce之间的合同。它可告知Commerce哪些资源适用于Commerce、属于哪些产品以及应如何使用或显示这些资源。此元数据允许AEM Assets集成正确映射和同步资源文件。

Commerce元数据支持以下功能：

通过commerce:isCommerce字段将资产标记为Commerce合格。
通过commerce:skus字段将资产与一个或多个产品SKU关联。
通过commerce:roles和commerce:positions字段定义资源在Commerce中的显示方式。
添加通过commerce:altTextStoreViews和commerce:altTextValues字段由商店视图键入的特定于Commerce的alt文本。
通过Commerce 选项卡和架构表单在AEM Assets属性UI 中公开这些字段。

IMPORTANT

特定于Commerce的替代文本功能尚无法通过自助上线使用。当前仅当您部署assets-commerce自定义代码包时提供（请参阅手动安装assets-commerce包）。计划对即将发布的AEM版本提供本机支持。

要在AEM项目中配置这些资源，请参阅配置AEM Assets项目。本主题的其余部分介绍如何提供元数据。

AEM Commerce assets-commerce包内容

Adobe提供了assets-commerce AEM Commerce代码包，用于将Commerce命名空间和元数据架构资源添加到Experience Manager Assets as a Cloud Service配置。

此包代码可将以下资源添加到AEM Assets创作环境：

自定义命名空间，Commerce用于标识与Commerce相关的属性。
- 带有标签Eligible for Commerce的自定义元数据类型commerce:isCommerce用于标记与Adobe Commerce项目关联的Commerce资源。
- 用于添加 Product Data 属性的自定义元数据类型commerce:skus和相应的UI组件。产品数据包含用于将Commerce资源与产品SKU关联的元数据属性。
  
  {width="600" modal="regular"}
- 自定义元数据类型commerce:roles和commerce:positions属性，用于显示如何在Commerce中可视化该资源。
- 替换文本多字段(Alt texts)元数据，以便编辑人员可以为每个Commerce商店视图代码输入替换文本。多字段在两个索引对齐的String[]属性中持续存在：
  - commerce:altTextStoreViews — 存储每行的视图代码。
  - commerce:altTextValues — 在与commerce:altTextStoreViews中的每个条目相同的索引处匹配替换文本。
  使用外部匹配器的App Builder实施可以在转换资源负载时拦截这些属性。这不会更改在目录中为产品图像分配或设定范围的方式。查看AEM Assets元数据中的本地化的替换文本。
具有Commerce选项卡的元数据架构表单，包括用于标记Commerce资源的Eligible for Commerce和Product Data字段。该表单还提供了在AEM Assets UI中显示或隐藏roles和position字段的选项。

AEM Assets元数据架构表单的 {width="600" modal="regular"}
示例已标记并批准Commerce资源 equipment_6.jpg以支持初始资源同步。只有已获批准的Commerce资源才能从AEM Assets同步到Adobe Commerce。