文档CommerceAEM Assets集成

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

最近更新： 2026年5月11日

创建对象：

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

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

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

  1. 了解assets-commerce包内容

  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相关的属性。

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

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

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

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

    • 替换文本多字段(Alt texts)元数据，以便编辑人员可以输入由Commerce商店视图代码键入的替换文本。 这不会更改在目录中为产品图像分配或设定范围的方式。 查看AEM Assets元数据中的替换文本。

  • 具有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包代码 ​的更多信息，请参阅GitHub上的自述文件页面。

AEM Assets元数据中的替换文本

编辑符合条件的图像时，Alt texts​多字段在AEM Assets资源元数据编辑器的​ Commerce ​选项卡上可用。

IMPORTANT
每次存储查看行为仅适用于替换文本。 AEM Assets集成不会同步每个Adobe Commerce商店视图中的其他产品图像。 AEM中的产品图像将继续同步到Commerce中，其库分配行为与此版本之前相同。

多字段在每个Commerce商店视图中包含一行。 每一行有两个输入：

  • Store View Code — 存储视图标识符（例如default或en_US）。

  • Alt Text — 该商店视图的替换文本，限制为255个字符。

选择​ Add ​为其他存储视图添加更多行。 要删除某行，请选择该行上的​ Delete ​图标以将其删除。

Alt文本包含存储视图代码和Alt文本输入的多字段 {width="600" modal="regular"}

保存时，如果任何行具有空的​ Store View Code ​或如果两行使用相同的存储视图代码（不区分大小写），则客户端验证会阻止提交。

替代文本条目作为两个索引对齐的String[]属性保留在JCR资产元数据中：

  • commerce:altTextStoreViews：存储每行的视图代码。
  • commerce:altTextValues：在与commerce:altTextStoreViews中的每个条目相同的索引处匹配替换文本。

当这些资源同步到Adobe Commerce时，每个商店视图替换文本将写入产品媒体集，以获得匹配的商店视图代码。 底层图像映射保持不变。

先决条件

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

产品视觉效果

[仅限SaaS]{class="badge positive" title="仅适用于Adobe Commerce as a Cloud Service和Adobe Commerce Optimizer项目（Adobe管理的SaaS基础架构）。"}具有OpenAPI功能的Dynamic Media是AEM Assets支持的产品可视化自助服务。

  1. 导航到您的Cloud Manager。

  2. 选择所需的环境。

  3. 启用具有OpenAPI功能的​Dynamic Media。

    如果​ 具有OpenAPI功能的Dynamic Media ​按钮未处于活动状态，请打开支持票证。

AEM Assets

[仅限PaaS]{class="badge informative" title="仅适用于云项目上的Adobe Commerce（Adobe管理的PaaS基础架构）。"}在AEM as a Cloud Service上，提交包含以下信息的Adobe支持票证：

  • Title：启用Dynamic Media OpenAPI以将Adobe Commerce与AEM Assets完全集成

    • 支持票证的内容：

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

在提交支持票证后，Adobe会在您的云服务环境中启用具有OpenAPI功能的Dynamic Media，并共享详细信息（如IMS客户端ID），以便您继续集成。

步骤1：安装assets-commerce包

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

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

    Cloud Manager存储库凭据和克隆命令 {width="600" modal="regular"}

    在Cloud Manager 管道​中，选择​ Access Repo Info ​以打开​Repository Info。 复制​ URL ​或​ Git command line ​值，根据需要生成访问密码，然后使用Git客户端本地克隆。

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

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

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

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

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

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

    Cloud Manager管道 {width="600" modal="regular"}

    当管道存在时，打开操作菜单(…) 到​Run、Edit、View/Edit variables​或其他操作 — 请参阅上面链接的Cloud Manager管道文档。

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

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

    • 默认元数据架构包括​ 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字段拖到表单中。

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

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

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

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

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

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

  9. 保存更新。

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

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

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

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

    创建不存在的Commerce文件夹。

  4. 选择​Apply。

后续步骤

recommendation-more-help
commerce-help-aem-assets-integration