配置和配置浏览器 configuration-browser

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
管理

创建对象：

管理员

CAUTION

AEM 6.4已结束扩展支持，本文档将不再更新。有关更多详细信息，请参阅技术支助期. 查找支持的版本此处.

AEM配置用于管理AEM中的设置并用作工作区。

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

配置可以从两个不同的角度来考虑。

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

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

无论从何种角度来看，配置在AEM中都有两个主要用途：

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

管理员身份的配置 configurations-administrator

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

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

示例 administrator-example

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

WKND-General
WKND-Magazine

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

然后，管理员可以将WKND常规与WKND站点的所有内容关联。但是，WKND-Magazine配置将仅与杂志网站关联。

通过执行以下操作：

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

不仅对可编辑的模板，对于云配置、ContextHub区段和内容片段模型也可进行类似设置。

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

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

NOTE

仅当用户具有 admin 权限。 admin 此外，还需要权限才能为配置分配访问权限或以其他方式修改配置。

创建配置 creating-a-configuration

在AEM中使用配置浏览器创建新配置非常简单。

登录AEMas a Cloud Service，然后从主菜单中选择工具 -> 常规 -> 配置浏览器.
点按或单击创建。
提供配置的标题和名称。
- 标题应为描述性的。
- 名称将成为存储库中的节点名称。
  - 它会根据标题自动生成，并根据 AEM 命名约定进行调整。
  - 如有必要可以调整。
检查您希望允许的配置类型。
点按或单击创建。

TIP

可以嵌套配置。

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

如果将配置视为工作区，则可以对这些配置设置访问权限，以强制哪些人可以访问这些工作区，哪些人可能不访问这些工作区。

登录AEMas a Cloud Service，然后从主菜单中选择工具 -> 常规 -> 配置浏览器.
选择要修改的配置，然后点按或单击属性工具栏中。

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

note note
NOTE
创建配置后，无法取消选择某个特征。

1. 使用 **有效权限** 按钮以查看角色矩阵及其当前授予配置的权限。 ![有效权限窗口](https://experienceleague.adobe.com/docs/experience-manager-64/assets/configuration-effective-permissions.png?lang=zh-Hans)

要分配新权限，请在 选择用户或组 字段 添加新权限 中。
- 的 选择用户或组 字段可根据现有用户和角色提供自动完成功能。
从自动完成结果中选择相应的用户或角色。
- 您可以选择多个用户或角色。
检查选定用户或角色应具有的访问选项，然后单击添加.
重复这些步骤以选择用户或角色，并根据需要分配其他访问权限。
点按或单击 保存并关闭 完成。

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

作为开发人员，了解AEMas 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 字符串属性，并在属性（或整个配置项）不存在时提供默认值“FFFFF”。

现在，让我们查看相应的JCR内容：

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

/conf/wkns
    + 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 我们需要我们的。此类项目可以视为“设置文档”，通常由 cq:Page 包括 jcr:content 保存实际内容。

最后，我们看到了 bgkcolor 我们的示例代码所需的。的 ValueMap 我们从 getItem 基于页面的 jcr:content 节点。

配置分辨率 configuration-resolution

上述基本示例显示了单个配置。但是，在很多情况下，您希望具有不同的配置，例如默认全局配置、每个品牌的不同配置，以及子项目的特定配置。

要支持此功能，AEM中的配置查找将按照以下首选项顺序包含继承和回退机制：

/conf/<siteconfig>/<parentconfig>/<myconfig>
- 引用的特定配置 cq:conf 某处 /content
- 层次结构是任意的，并且可以像您的站点结构一样进行设计，要了解这一点，并非应用程序代码的业务
- 具有配置权限的用户在运行时可更改
/conf/<siteconfig>/<parentconfig>
- 遍历备用配置的父项
- 具有配置权限的用户在运行时可更改
/conf/<siteconfig>
- 遍历备用配置的父项
- 具有配置权限的用户在运行时可更改
/conf/global
- 系统全局设置
- 通常是安装的全局默认值
- 由 admin 角色
- 具有配置权限的用户在运行时可更改
/apps
- 应用程序默认值
- 已通过应用程序部署修复
- 运行时为只读
/libs
- AEM产品默认值
- 仅可按Adobe更改，不允许项目访问
- 已通过应用程序部署修复
- 运行时为只读