文档CommerceAEM Assets集成指南

配置AEM Assets项目以支持Commerce元数据

Last update: Mon Dec 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 用户

当您使用AEM Assets as a Digital Asset Management System (DAM) for Commerce时，安装assets-commerce包允许您从AEM创作环境管理Commerce产品的图像和视频。

完成以下步骤，使用所需的包代码和元数据配置AEM Assets项目，以便从AEM创作环境管理Commerce资源：

  1. 了解 ​

  2. 完成安装步骤以配置AEM Assets项目以支持Commerce元数据

AEM Commerce assets-commerce包内容

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

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

  • 自定义命名空间，Commerce用于标识与Commerce相关的属性。

    • 带有标签commerce:isCommerce的自定义元数据类型Eligible for Commerce用于标记与Adobe Commerce项目关联的Commerce资源。

    • 用于添加commerce:skus属性的自定义元数据类型​ Product Data ​和相应的UI组件。 产品数据包含用于将Commerce资源与产品SKU关联的元数据属性。

      自定义产品数据UI控件 {width="600" modal="regular"}

    • 自定义元数据类型commerce:roles和commerce:positions属性，用于显示如何在Commerce中显示该资源。

  • 具有Commerce选项卡的元数据架构表单，包括用于标记Commerce资源的Eligible for Commerce和Product Data字段。 该表单还提供了在AEM Assets UI中显示或隐藏roles和position字段的选项。

    AEM Assets元数据架构表单的 Commerce选项卡 {width="600" modal="regular"}

  • 示例已标记并批准Commerce资源 equipment_6.jpg以支持初始资源同步。 只有已获批准的Commerce资源才能从AEM Assets同步到Adobe Commerce。

NOTE
有关AEM Commerce包代码的更多信息，请参阅​ 自述文件 ​页。

先决条件

您需要以下资源和权限才能将assets-commerce包代码部署到AEM Assets as a Cloud Service AEM环境：

步骤1：安装assets-commerce包

  1. 导航到AEM Cloud Manager，选择一个项目，然后创建要与Adobe Commerce集成的生产和暂存环境。

  2. 配置部署管道，或验证您的管道是否可以将更改部署到所选环境。

  3. 克隆所选程序的Adobe托管的Git存储库。

  4. 从GitHub中，从AEM Assets Commerce存储库下载包代码。

  5. 从您的本地AEM开发环境中，手动将下载的代码复制到现有的Adobe托管存储库中。

  6. 在您的项目的filter.xml和pom.xml files中，将所有出现的<my-app>替换为您的应用程序名称。

NOTE
或者，您也可以将自定义代码作为​ Maven ​包安装到AEM Assets项目配置中。

  1. 提交更改并将本地开发分支推送到Cloud Manager Git存储库。

  2. 在AEM Cloud Manager中，使用管道更新AEM环境以部署您的代码。

  3. 转到任何资源并编辑其属性以验证更改：

    • 默认元数据架构包括​ Commerce ​选项卡。

    • 产品SKU和Eligible for Commerce字段可见。

Commerce选项卡在资产中不可见

如果​ Commerce ​选项卡未显示在属性中，则必须在元数据架构编辑器中手动创建一个选项卡。

  1. 导航到元数据架构编辑器。

  2. 单击​ 编辑 ​修改默认的元数据架构表单。

  3. 创建​ Commerce ​选项卡，然后选择它。

  4. 将​ Product ​组件拖放到​ Commerce ​选项卡中，并将其映射到属性commerce:skus。

  5. 选中​ 显示角色 ​和​ 显示顺序 ​的复选框。

  6. 将​ checkbox ​组件拖放到​ Commerce ​选项卡中，并将其映射到属性commerce:isCommerce。 将​ 是 ​和​ 否 ​定义为选项。

如果您遇到任何其他问题，请创建支持票证或联系您的AEM Assets集成销售代表寻求帮助。

步骤2：可选。 配置元数据配置文件

在AEM Assets创作环境中，通过创建元数据配置文件来设置Commerce资源元数据的默认值。 然后，将新配置文件应用到AEM Asset文件夹以自动使用这些默认值。 此配置通过减少手动步骤来简化资产处理。

配置元数据配置文件时，您只需配置以下组件：

  • 添加Commerce选项卡。 此选项卡启用由模板添加的Commerce特定配置设置。

  • 将Eligible for Commerce字段添加到Commerce选项卡。

产品数据UI组件会根据模板自动添加。

定义元数据配置文件

  1. 登录到Adobe Experience Manager创作环境。

  2. 在Adobe Experience Manager工作区中，单击Adobe Experience Manager图标以转到为AEM Assets创作内容管理工作区。

    AEM Assets创作 {width="600" modal="regular"}

  3. 通过选择锤子图标打开管理员工具。

    AEM作者管理员管理元数据配置文件 {width="600" modal="regular"}

  4. 通过单击​ Metadata Profiles ​打开配置文件配置页面。

  5. Create Commerce集成的元数据配置文件。

    AEM作者管理员添加元数据配置文件 {width="600" modal="regular"}

  6. 为Commerce元数据添加选项卡。

    1. 单击左侧的​Settings。

    2. 在选项卡部分中单击​+，然后指定​Tab Name、Commerce。

  7. 将Eligible for Commerce字段添加到表单。

    AEM作者管理员将元数据字段添加到配置文件 {width="600" modal="regular"}

    • 单击​Build form。

    • 将Single Line text字段拖到表单中。

    • 通过单击Eligible for Commerce为标签添加​ Field Label ​文本。

    • 在“设置”选项卡上，将标签文本添加到​字段标签。

    • 将占位符文本设置为yes。

    • 在​ Map to Property ​字段中，复制并粘贴以下值

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. 可选。 要在已批准的Commerce资源上传到AEM Assets环境时自动对其进行同步，请将​ Review Status ​选项卡上Basic字段的默认值设置为approved。

  9. 保存更新。

将元数据配置文件应用到Commerce资源源文件夹

  1. 从​ Metadata Profiles页面中，选择Commerce集成配置文件。

  2. 从操作菜单中选择​Apply Metadata Profiles to Folders。

  3. 选择包含Commerce资源的文件夹。

    创建不存在的Commerce文件夹。

  4. 单击​Apply。

后续步骤

recommendation-more-help
7606306b-826c-4603-82d4-2a2c203d5927