文档CommerceAEM Assets集成

配置AEM Assets项目

最近更新： 2026年5月11日

创建对象：

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

本主题介绍如何配置AEM Assets项目，以便在AEM创作环境中使用Commerce命名空间、元数据架构和Commerce选项卡。 有关这些资源的背景信息，请参阅AEM Assets中的Commerce元数据。

您可以通过两个选项来配置AEM Assets项目：

  • [推荐]{class="badge positive"} 自助登录 — 在AEM版本2026.5.26309及更高版本上，通过设置环境变量并激活具有OpenAPI功能的Dynamic Media来启用Cloud Manager中的集成。 无需自定义代码部署。 请参阅启用Commerce集成（自助服务）。

  • 手动配置 — 通过Cloud Manager管道部署assets-commerce包。 如果您必须部署自定义包代码，或者您使用的是2026.5.26309之前的AEM版本，请按照这些手动步骤操作。 请参阅手动安装assets-commerce包。

TIP
您可以从右上角菜单查看当前AEM版本： Help > About AEM。

启用Commerce集成（自助服务） enable-aem-commerce-self-service

[支持]{class="badge informative" title="支持"} AEM版本2026.5.26309及更高版本。

在受支持的AEM版本上，您可以从Cloud Manager启用Commerce集成，而无需部署任何自定义代码。 在Author服务上启用集成时，会自动配置Commerce命名空间、元数据架构和​ Commerce ​选项卡。

自助服务先决条件

步骤1：创建项目和环境

在Cloud Manager中创建项目是一个向导过程 — 项目及其环境通过多个步骤进行配置，并在最后保存在一起。

  1. 在Cloud Manager中选择​Add Program。

  2. 选择​Set up for production，输入项目名称，然后选择​Continue。

  3. 在​ Solutions & Add-ons ​步骤中，选择项目所需的解决方案和加载项，包括​Dynamic Media，然后选择​Continue。

    已选择Dynamic Media的Cloud Manager解决方案和加载项步骤 {width="600" modal="regular"}

  4. 在​ Add Environment ​步骤中，输入​ 生产 ​和​ 暂存 ​环境的名称，然后选择区域。

    Cloud Manager添加环境对话框，其中包含生产和暂存详细信息 {width="600" modal="regular"}

  5. 选择​ Save ​以创建项目及其环境。

步骤2：启用Commerce集成变量

在Cloud Manager中，打开您在步骤1中创建的环境，然后：

  1. 选择​ Configuration ​选项卡。

  2. 添加具有以下值的环境变量，然后选择​ Add ​和​Save：

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    字段 值
    名称 COMMERCE_INTEGRATION_ENABLED
    值 true
    已应用服务 作者
    类型 变量

    应用了COMMERCEINTEGRATIONENABLED变量的Cloud Manager环境配置 {width="600" modal="regular"}

    环境将更新以应用配置。 等待环境状态返回到​Running。

步骤3：使用OpenAPI功能激活Dynamic Media

  1. 在环境​ General ​选项卡上，找到​Dynamic Media。

  2. 在​ 旁边有 ​可用的OpenAPI功能，请选择​Click to activate。

    显示Dynamic Media OpenAPI激活链接的“环境常规”选项卡 {width="600" modal="regular"}

    激活在后台运行。 完成后，环境即为Commerce集成做好准备。

    note
    NOTE
    如果​ Click to activate ​不可用，请打开支持票证以启用具有OpenAPI功能的Dynamic Media。

步骤4：验证配置

切换到​ AEM Assets创作环境 ​并打开任何资源。 编辑其属性，并确认默认元数据架构包含​ Commerce ​选项卡，且​ Product Data ​和​ Eligible for Commerce ​字段可见。

手动安装assets-commerce包

NOTE
使用此手动方法部署自定义包代码，或者如果您使用的是2026.5.26309之前的AEM版本。 在支持的版本上，请改用启用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将在您的Cloud Services环境中启用具有OpenAPI功能的Dynamic Media，并共享详细信息（如IMS客户端ID），以便您继续集成。

安装步骤

  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集成销售代表寻求帮助。

配置元数据配置文件（可选）

在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