AEM Commerce快速入门as a Cloud Service start

要开始使用Adobe Experience Manager (AEM) Commerceas a Cloud Service,必须为您的Experience Manager Cloud Service配置Commerce integration framework(CIF)加载项。 CIF加载项是AEM Sitesas a Cloud Service之上的额外模块。

入门培训 onboarding

AEM Commerceas a Cloud Service的入门培训分为两步:

  1. 启用AEM Commerce as a Cloud Service并配置CIF加载项
  2. 将AEM Commerceas a Cloud Service与您的Commerce解决方案连接

第一步入门培训是通过Adobe完成的。 有关定价和配置的更多详细信息,您必须联系您的销售代表。

使用CIF加载项进行配置后,该加载项将应用于任何现有的Cloud Manager项目。 如果您没有Cloud Manager项目,则必须创建一个。 有关更多详细信息,请参阅设置程序

第二步是每个AEM as a Cloud Service环境的自助服务。 在CIF加载项初始配置后,您必须执行一些其他配置。

将AEM与Commerce解决方案连接 solution

要将CIF加载项和AEM CIF核心组件与商务解决方案连接,必须通过GraphQL环境变量提供Cloud Manager端点URL。 变量名称为COMMERCE_ENDPOINT。 必须配置通过HTTPS的安全连接。

此环境变量在以下两个位置使用:

  • GraphQL通过AEM CIF核心组件和客户项目组件使用的一些常见可共享GraphQl客户端,从AEM调用商务后端。
  • 在每个AEM环境中设置一个GraphQL代理URL,变量设置在/api/graphql处可用。 此URL由AEM Commerce创作工具(CIF加载项)和CIF客户端组件使用。

每个GraphQL环境可以使用不同的AEM as a Cloud Service端点URL。 通过这种方式,项目可以将AEM暂存环境与商务暂存系统和AEM生产环境连接到商务生产系统。 GraphQL端点必须可公开使用,不支持专用VPN或本地连接。 可选地,可以提供身份验证标头以使用需要身份验证的附加CIF功能。

(可选)并且仅适用于Adobe Commerce Enterprise/Cloud,CIF加载项支持为AEM作者使用暂存的目录数据。 此数据要求您配置授权标头。 出于安全原因,此标头仅在AEM Author实例上可用和使用。 AEM Publish实例无法显示暂存数据。

可以使用两个选项来配置端点:

通过Cloud Manager用户界面(默认) cm-ui

可以使用“环境详细信息”页面上的对话框完成此配置。 在查看启用了Commerce的程序的此页时,如果当前未配置端点,则会显示一个按钮:

CM环境信息

单击此按钮将打开一个对话框:

CM Commerce端点

设置暂存目录支持的端点和(可选)授权标头后,该端点会显示在详细信息页面上。 单击“编辑”图标可打开同一个对话框,如有必要,可在其中编辑端点。

CM环境信息

通过Adobe I/OCLI adobe-cli

要通过Adobe I/OCLI将AEM与Commerce解决方案连接,请执行以下步骤:

  1. 通过Cloud Manager插件获取Adobe I/OCLI

    查看AdobeCloud Manager文档,了解如何下载、设置和使用Adobe I/OCLICloud Manager CLI插件

  2. 使用AEM as a Cloud Service程序验证Adobe I/OCLI

  3. 在Cloud Manager中设置COMMERCE_ENDPOINT变量

    code language-bash
    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
    

    有关详细信息,请参阅CLI文档

    商业GraphQL端点URL必须指向商业的GraphQl服务并使用安全的HTTPS连接。 例如:https://<yourcommercesystem>/graphql

  4. 启用需要身份验证的暂存目录功能(可选)

    note note
    NOTE
    此功能仅在Adobe Commerce Enterprise或Cloud Edition中可用。 有关详细信息,请参阅基于令牌的身份验证

    在Cloud Manager中设置COMMERCE_AUTH_HEADER密码变量:

    code language-bash
    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
    
TIP
您可以使用以下命令列出所有Cloud Manager变量以进行仔细检查:aio cloudmanager:list-environment-variables ENVIRONMENT_ID

您已准备好使用AEM Commerceas a Cloud Service,可以通过Cloud Manager部署您的项目。

配置存储和目录 catalog

CIF加载项和CIF核心组件可用于连接到不同商务商店(或商店视图等)的多个AEM网站结构。 默认情况下,CIF加载项使用默认配置进行部署,该默认配置连接到Adobe Commerce的默认存储和目录。

可以在执行以下步骤后,通过CIFCloud Service配置来调整项目的此配置:

  1. 在AEM中,转到“工具”>“Cloud Service”>“CIF配置”。

  2. 选择要更改的商务配置。

  3. 通过操作栏打开配置属性。

CIFCloud Service配置

可以配置以下属性:

  • GraphQL客户端 — 为商务后端通信选择配置的GraphQL客户端。 此客户端通常应保留默认值。

  • 存储视图 — 存储视图标识符。 如果为空,则使用默认存储视图。

  • GraphQL代理路径 — AEM中的GraphQL代理用于向商务后端GraphQL端点代理请求的URL路径。

    note note
    NOTE
    在大多数设置中,不能更改默认值/api/graphql。 只有未使用所提供的GraphQL代理的高级设置才应更改此设置。

    - 启用目录UID支持 — 在商业后端GraphQL调用中启用对UID而不是ID的支持。

    note note
    NOTE
    Adobe Commerce 2.4.2中引入了对UID的支持。仅当您的Commerce后端支持2.4.2或更高版本的GraphQL架构时,才启用UID。

    - 目录根类别标识符 — 商店目录根的标识符(UID或ID)

    note caution
    CAUTION
    从CIF核心组件版本2.0.0开始,删除了id的支持并将其替换为uid。 如果您的项目使用CIF核心组件版本2.0.0,则必须启用目录UID支持,并使用有效的类别UID作为“目录根类别标识符”。

以上所示的配置仅供参考。 项目应提供自己的配置。

有关更复杂的设置,请使用多个AEM网站结构以及不同的商务目录,请参阅Commerce多商店设置教程。

其他资源 additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab