AEM配置用于管理AEM中的设置并用作工作区。
配置可以从两个不同的角度来考虑。
总之:从管理员的角度来看,配置是您如何创建工作区以管理AEM中的设置,而开发人员应该了解AEM如何在存储库中使用和管理这些配置。
无论从何种角度来看,配置在AEM中都有两个主要用途:
AEM管理员和作者可以将配置视为工作区。 这些工作区可用于通过实施这些功能的访问权限,为组织目的收集设置组及其关联内容。
可以在AEM中为许多不同的功能创建配置。
例如,管理员可以为可编辑模板创建两个配置。
然后,管理员可以使用WKND-General配置创建常规页面模板,然后使用WKND-Magazine下的特定于该杂志的模板。
然后,管理员可以将WKND常规与WKND站点的所有内容关联。 但是,WKND-Magazine配置将仅与杂志网站关联。
通过执行以下操作:
不仅对可编辑的模板,对于云配置、ContextHub区段和内容片段模型也可进行类似设置。
通过配置浏览器,管理员可以轻松地在AEM中创建、管理和配置配置配置的访问权限。
仅当用户具有admin
权限时,才可以使用配置浏览器创建配置。 admin
此外,还需要权限才能为配置分配访问权限或以其他方式修改配置。
在AEM中使用配置浏览器创建新配置非常简单。
作为Cloud Service登录AEM,并从主菜单中选择工具 -> 常规 -> 配置浏览器。
点按或单击创建。
为您的配置提供标题和名称。
检查您希望允许的配置类型。
点按或单击创建。
可以嵌套配置。
如果将配置视为工作区,则可以对这些配置设置访问权限,以强制哪些人可以访问这些工作区,哪些人可能不访问这些工作区。
创建配置后,无法取消选择某个特征。
作为开发人员,了解AEM as a Cloud Service如何与配置一起工作以及如何处理配置解析非常重要。
尽管管理员和用户可能将配置视为工作场所来管理不同的设置和内容,但务必要了解,配置和内容由AEM在存储库中单独存储和管理。
/content
是所有内容的主页。/conf
是所有配置的主页。内容通过cq:conf
属性引用其关联的配置。 AEM根据内容及其上下文cq:conf
属性执行查找,以查找相应的配置。
在本例中,假设您有一些对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
。 我们从getItem
返回的ValueMap
基于页面的jcr:content
节点。
上述基本示例显示了单个配置。 但是,在很多情况下,您希望具有不同的配置,例如默认全局配置、每个品牌的不同配置,以及子项目的特定配置。
要支持此功能,AEM中的配置查找将按照以下首选项顺序包含继承和回退机制:
/conf/<siteconfig>/<parentconfig>/<myconfig>
/content
中某处的cq:conf
引用的特定配置/conf/<siteconfig>/<parentconfig>
/conf/<siteconfig>
/conf/global
admin
角色设置/apps
/libs
AEM中的配置基于Sling上下文感知配置。 Sling包提供了一个服务API,可用于获取上下文感知配置。 上下文感知配置是与内容资源或资源树相关的配置,如上一个示例中所述。🔗
有关上下文感知配置、示例以及如何使用这些配置的更多详细信息,请参阅Sling文档。
出于调试和测试目的,在https://<host>:<port>/system/console/conf
处有一个ConfMgr Web控制台,该控制台可显示给定路径/项目的配置。
只需提供:
单击Resolve查看已解析的配置,并接收将解析这些配置的示例代码。
出于调试和测试目的,在https://<host>:<port>/system/console/slingcaconfig
处有一个上下文感知配置 Web控制台,该控制台允许查询存储库中的上下文感知配置并查看其属性。
只需提供:
单击Resolve以检索选定配置的关联上下文路径和属性。