持久查询在AEM GraphQL编辑器中不可用,无法获取非根级别的配置

本文介绍在使用非根级别配置时,Adobe Experience Manager (AEM) GraphQL编辑器中为何无法使用保存持久查询的选项,并提供解决问题的步骤。

描述 description

使用AEM GraphQL编辑器时,如果内容片段模型和相关设置存储在不在/conf下的根级别的配置文件夹中,则缺少保存持久查询的选项。 例如,如果内容片段模型位于/conf/dam/shared之类的路径中,则在创建新的GraphQL端点时,此配置将不会显示在 使用 提供的GraphQL架构下拉列表中。 只有包含内容片段模型和站点/WCM设置的根级别配置才会被识别并列为有效端点。 这会阻止保存不符合这些条件的配置的持久查询。

环境

  • Adobe Experience Manager(所有受支持的版本)

症状

  • 持久查询的 保存 选项在GraphQL编辑器中不可用。
  • 创建新的GraphQL端点时,所需的配置文件夹未出现在 使用 提供的GraphQL架构下拉列表中。
  • 不显示特定的错误消息。

原因

AEM Sites GraphQL Admin Console仅列出/conf下包含内容片段模型(settings/dam/cfm)和站点/WCM设置(settings/wcm)的根级别配置。 缺少这些设置的子配置或文件夹无法识别为有效端点,这会阻止保存持久查询。

解决方法 resolution

请按照以下步骤解决问题:

  1. 查看当前的配置结构:

    • 在AEM配置浏览器中,导航到/libs/granite/configurations/content/view.html/conf

    • 识别您正在使用的配置文件夹(例如: /conf//shared)。

  2. 验证配置要求:

    • 确保您的配置位于/conf下的根级别(例如: /conf/),而不是作为子文件夹(例如/conf//shared)。

    • 确认配置包含两者:

    • 内容片段模型: settings/dam/cfm

    • Sites/WCM设置: settings/wcm (包括模板、策略或模板类型)

  3. 将配置重新创建为根级别文件夹:

    • /conf下创建新的根级别配置(例如: /conf/)。

    • 在此新配置下移动或重新创建内容片段模型和站点/WCM设置。 这可能涉及使用CRXDE Lite或Configuration Browser将相关节点和设置从子文件夹复制到新的根级别文件夹。

  4. 更新GraphQL端点选择:

    • 访问站点GraphQL管理控制台: /libs/cq/graphql/sites/admin/content/console.html

    • 验证新的根级别配置是否显示在 使用 提供的GraphQL架构下拉列表中。

    • 根据需要继续创建和保存持久查询。

  5. 完成上述步骤后,确认在GraphQL编辑器中创建持久查询时,保存选项现在可用。

recommendation-more-help
experience-cloud-kcs-help-kbarticles