持久查询在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
请按照以下步骤解决问题:
-
查看当前的配置结构:
-
在AEM配置浏览器中,导航到
/libs/granite/configurations/content/view.html/conf。 -
识别您正在使用的配置文件夹(例如:
/conf//shared)。
-
-
验证配置要求:
-
确保您的配置位于
/conf下的根级别(例如:/conf/),而不是作为子文件夹(例如/conf//shared)。 -
确认配置包含两者:
-
内容片段模型:
settings/dam/cfm -
Sites/WCM设置:
settings/wcm(包括模板、策略或模板类型)
-
-
将配置重新创建为根级别文件夹:
-
在
/conf下创建新的根级别配置(例如:/conf/)。 -
在此新配置下移动或重新创建内容片段模型和站点/WCM设置。 这可能涉及使用CRXDE Lite或Configuration Browser将相关节点和设置从子文件夹复制到新的根级别文件夹。
-
-
更新GraphQL端点选择:
-
访问站点GraphQL管理控制台:
/libs/cq/graphql/sites/admin/content/console.html。 -
验证新的根级别配置是否显示在 使用 提供的GraphQL架构下拉列表中。
-
根据需要继续创建和保存持久查询。
-
-
完成上述步骤后,确认在GraphQL编辑器中创建持久查询时,保存选项现在可用。