配置和配置浏览器 configuration-browser

Adobe Experience Manager (AEM)配置用于管理AEM中的设置,并用作工作区。

什么是配置? what-is-a-configuration

可以从两个不同的观点考虑配置。

  • 管理员使用配置作为AEM中的工作区来定义和管理设置组。
  • 开发人员使用实现配置的基础配置机制在AEM中保留和查找设置。

简而言之:从管理员的角度来看,配置是您创建工作区以管理AEM中的设置的方式,而开发人员应该了解AEM如何在存储库中使用和管理这些配置。

从您的角度来看,配置在AEM中有两个主要用途:

  • 配置可为某些用户组启用某些功能。
  • 配置定义这些功能的访问权限。

管理员配置 configurations-administrator

AEM管理员和作者可以将配置视为工作区。 通过实施这些功能的访问权限,这些工作区可用于收集设置组及其关联内容以进行组织。

可为AEM中的许多不同功能创建配置。

示例 administrator-example

例如,管理员可以为可编辑模板创建两个配置。

  • WKND常规
  • WKND — 杂志

随后,管理员可以使用WKND-General配置创建常规页面模板,然后使用WKND-Magazine下特定于杂志的模板。

然后,管理员可以将WKND-General与WKND网站的所有内容相关联。 但是,WKND-Magazine配置只会与杂志站点相关联。

通过执行此操作:

  • 当内容作者为杂志创建页面时,作者可以从常规模板(WKND-General)或杂志模板(WKND-Magazine)中进行选择。
  • 当内容作者为网站的非杂志其他部分创建页面时,作者只能从常规模板(WKND-General)中进行选择。

类似设置不仅适用于可编辑模板,也适用于云配置、ContextHub区段和内容片段模型。

使用配置浏览器 using-configuration-browser

通过配置浏览器,管理员可以轻松地创建、管理和配置对AEM中配置的访问权限。

NOTE
如果用户具有admin权限,则只能使用配置浏览器创建配置。 还需要具有此admin权限才能为配置分配访问权限或修改配置。

创建配置 creating-a-configuration

使用配置浏览器,可以在AEM中轻松创建配置。

  1. 登录AEM as a Cloud Service,从主菜单选择​ 工具 > 常规 > 配置浏览器

  2. 选择​ 创建

  3. 提供配置的​ 标题 ​和​ 名称

    创建配置

    • 标题 ​应为描述性的。

    • 名称 ​会成为存储库中的节点名称。

      • 它会根据标题自动生成,并根据 AEM 命名约定进行调整。
      • 如有必要可以调整。
  4. 检查要允许的配置类型。

  5. 选择​ 创建

TIP
配置可以嵌套。

编辑配置及其访问权限 access-rights

如果您将配置视为工作区,则可以对这些配置设置访问权限,以强制执行谁可以访问这些工作区,谁不能访问这些工作区。

  1. 登录AEM as a Cloud Service,从主菜单选择​ 工具 > 常规 > 配置浏览器

  2. 选择要编辑的配置,然后在工具栏中选择​ 属性

  3. 选择要添加到配置的任何其他功能。

    note note
    NOTE
    创建配置后,无法取消选择功能。
  4. 使用​ 有效权限 ​按钮查看角色矩阵以及当前授予配置的权限。
    有效权限窗口

  5. 要分配新权限,请在​ 添加新权限 ​部分的​ 选择用户或组 ​字段中输入用户或组名称。

    • 选择用户或组 ​字段提供基于现有用户和角色的自动完成功能。
  6. 从自动完成结果中选择相应的用户或角色。

    • 您可以选择多个用户或角色。
  7. 检查一个或多个选定的用户或角色应具有的访问选项,然后单击​ 添加
    添加对配置的访问权限

  8. 重复这些步骤,以便您可以选择用户或角色,并根据需要分配其他访问权限。

  9. 完成后选择​ 保存并关闭

作为开发人员的配置 configurations-developer

作为开发人员,了解AEM as a Cloud Service如何处理配置以及它如何处理配置解析非常重要。

配置和内容分离 separation-of-config-and-content

虽然管理员和用户可能会将配置视为工作区以管理不同的设置和内容,但务必了解配置和内容由AEM在存储库中单独存储和管理。

  • /content是所有内容的主页。
  • /conf是所有配置的主页。

内容通过cq:conf属性引用其关联的配置。 AEM根据内容及其上下文cq:conf属性执行查找以查找相应的配置。

示例 developer-example

对于此示例,假设您有一些应用程序代码对DAM设置感兴趣。

Conf conf = resource.adaptTo(Conf.class);
ValueMap imageServerSettings = conf.getItem("dam/imageserver");
String bgkcolor = imageServerSettings.get("bgkcolor", "FFFFFF");

所有配置查找的起点是位于/content下的内容资源。 这可以是页面、页面内的组件、资产或DAM文件夹。 这是您正在为其查找适用于此上下文的正确配置的实际内容。

现在,手头有Conf对象,您可以检索您感兴趣的特定配置项。 在本例中,它是dam/imageserver,是与imageserver相关的设置的集合。 getItem调用返回ValueMap。 然后读取bgkcolor字符串属性并提供默认值“FFFFFF”,以防属性(或整个配置项)不存在。

现在,我们来看看相应的JCR内容:

/content/dam/wknd
    + jcr:content
      - cq:conf = "/conf/wknd"
    + image.png [dam:Asset]

/conf/wknd
    + settings
      + dam
        + imageserver [cq:Page]
          + jcr:content
            - bgkcolor = "FF0000"

在此示例中,您可以在此处假定具有WKND特定的DAM文件夹以及相应的配置。 从该文件夹/content/dam/wknd开始,您可以看到名为cq:conf的字符串属性引用了应用于子树的配置。 属性在资产文件夹或页面的jcr:content上设置。 这conf个链接是显式的,因此只需查看CRXDE中的内容即可轻松跟踪它们。

/conf内跳转,跟随引用,查看是否存在/conf/wknd节点。 这是配置。 它的查找对应用程序代码是透明的。 此示例代码从未有它的专用引用,它隐藏在Conf对象后面。 要应用哪种配置,可通过JCR内容进行控制。

您会看到该配置包含一个名为settings的固定节点,该节点包含实际项目,包括您在此情况下所需的dam/imageserver。 此类项目可被认为是“设置文档”,由包含保存实际内容的jcr:contentcq:Page表示。

最后,您会看到此示例代码所需的属性bgkcolor。 从getItem返回的ValueMap基于页面的jcr:content节点。

配置分辨率 configuration-resolution

上述基本示例显示了单个配置。 但在许多情况下,您需要使用不同的配置,例如默认的全局配置、每个品牌的不同配置,以及子项目的特定配置。

为了支持此配置查找,AEM提供了继承和回退机制,其优先顺序如下:

  1. /conf/<siteconfig>/<parentconfig>/<myconfig>

    • cq:conf/content中的某个位置引用的特定配置
    • 层次结构是任意的,可以像网站结构一样设计,知道这一点不是应用程序代码的业务
    • 可由具有配置权限的用户在运行时更改
  2. /conf/<siteconfig>/<parentconfig>

    • 遍历父项以获取回退配置
    • 可由具有配置权限的用户在运行时更改
  3. /conf/<siteconfig>

    • 遍历父项以获取回退配置
    • 可由具有配置权限的用户在运行时更改
  4. /conf/global

    • 系统全局设置
    • 安装的全局默认值
    • admin角色设置
    • 可由具有配置权限的用户在运行时更改
  5. /apps

    • 应用程序默认值
    • 通过应用程序部署修复了
    • 运行时只读
  6. /libs

    • AEM产品默认值
    • 仅可按Adobe更改,不允许项目访问
    • 通过应用程序部署修复了
    • 运行时只读

使用配置 using-configurations

AEM中的配置基于Sling上下文感知配置。 Sling捆绑包提供了可用于获取上下文感知配置的服务API。 上下文感知配置是与内容资源或资源树相关的配置,如上一个示例🔗中所述。

有关上下文感知配置、示例及其使用方式的更多详细信息,请参阅Sling文档。

ConfMgr Web控制台 confmgr-web-console

为了调试和测试目的,https://<host>:<port>/system/console/conf处有一个​ ConfMgr Web控制台,该控制台可以显示给定路径/项的配置。

ConfMgr

只需提供:

  • 内容路径
  • 项目
  • 用户

单击​ 解析,以便查看解析的配置,并获得有助于解析这些配置的代码示例。

上下文感知配置Web控制台 context-aware-web-console

为了调试和测试目的,https://<host>:<port>/system/console/slingcaconfig处有一个​ 上下文感知配置 Web控制台,该控制台允许查询存储库中的上下文感知配置并查看其属性。

上下文感知配置Web控制台

只需提供:

  • 内容路径
  • 配置名称

单击​ 解析,以便检索所选配置的关联上下文路径和属性。

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