在AEM中使用Sling资源合并器

用途

Sling资源合并器提供访问和合并资源的服务。 它为以下两种情况提供了不同（差异）机制：

• 叠加 资源，使用 已配置的搜索路径.

• 覆盖 触屏UI的组件对话框数量(cq:dialog)，使用资源类型层次结构(通过属性 sling:resourceSuperType)。

通过Sling资源合并器，叠加/覆盖资源和/或属性与原始资源/属性合并：

• 自定义定义的内容比原始定义的内容优先级更高(即 叠加 或 覆盖 it)。

• 必要时， 属性 在自定义设置中定义，指示如何使用从原始内容合并的内容。

AEM目标

在AEM中使用Sling资源合并器的目标是：

• 确保自定义更改不会在中进行 /libs.

• 减少复制自以下对象的结构： /libs.

  在使用Sling资源合并器时，不建议从以下位置复制整个结构 /libs 因为这会导致自定义设置中包含过多的信息(通常 /apps)。 无论以何种方式升级系统时，不必要地复制信息都会增加出现问题的机会。

属性

资源合并器提供以下属性：

• sling:hideProperties ( String 或 String[])

  指定要隐藏的属性或属性列表。

  通配符 * 隐藏所有。

• sling:hideResource ( Boolean)

  指示资源是否应完全隐藏，包括其子项。

• sling:hideChildren ( String 或 String[])

  包含要隐藏的子节点或子节点列表。 将维护节点的属性。

  通配符 * 隐藏所有。

• sling:orderBefore ( String)

  包含当前节点应位于其前面的同级节点的名称。

这些属性如何影响相应的/原始资源/属性(来自 /libs)由叠加/覆盖使用(通常在 /apps)。

创建结构

要创建叠加或覆盖，您需要在目标下重新创建具有对等结构的原始节点(通常是 /apps)。 例如：

• 叠加

  • 站点控制台的导航条目（如边栏中所示）的定义定义定义如下：

    /libs/cq/core/content/nav/sites/jcr:title

  • 要叠加此节点，请创建以下节点：

    /apps/cq/core/content/nav/sites

    然后更新属性 jcr:title 根据需要。

• 替代

  • 文本控制台的触屏启用对话框的定义定义如下：

    /libs/foundation/components/text/cq:dialog

  • 要覆盖此节点，请创建以下节点 — 例如：

    /apps/the-project/components/text/cq:dialog

要创建其中任一结构，您只需重新创建骨架结构。 要简化结构的重新创建，所有中间节点都可以是 nt:unstructured (它们不必反映原始节点类型；例如，在 /libs)。

因此，在上述覆盖示例中，需要以下节点：

/apps
  /cq
    /core
      /content
        /nav
          /sites

用例

这些功能与标准功能相结合，使您能够：

• 添加资产

  属性不存在于 /libs 定义，但在 /apps 覆盖/覆盖。

  1. 在中创建对应的节点 /apps
  2. 在此节点上创建新属性»

• 重新定义属性（非自动创建的属性）

  在中定义属性 /libs，但中需要新值 /apps 覆盖/覆盖。

  1. 在中创建对应的节点 /apps

  2. 在此节点上创建匹配属性（在/下） apps)

     • 该资产的优先级将基于Sling资源解析程序配置。

     • 支持更改属性类型。

       如果您使用的属性类型与中使用的属性类型不同 /libs，则将使用您定义的属性类型。

  注意

  支持更改属性类型。

• 重新定义自动创建的属性

  默认情况下，自动创建的属性(例如 jcr:primaryType)不受覆盖/覆盖的约束，以确保当前在下的节点类型 /libs 受到尊重。 要实施覆盖/覆盖，您必须在以下位置重新创建节点： /apps，显式隐藏属性并重新定义它：

  1. 在下创建对应的节点 /apps 具有所需的 jcr:primaryType

  2. 创建资产 sling:hideProperties ，其值设置为自动创建的属性的值；例如， jcr:primaryType

     此属性，在下定义 /apps，现在优先级将高于下定义的优先级 /libs

• 重新定义节点及其子节点

  节点及其子节点定义于 /libs，但是中需要新配置 /apps 覆盖/覆盖。

  1. 合并以下各项的操作：

     1. 隐藏节点的子节点（保留节点的属性）
     2. 重新定义属性/属性

• 隐藏资产

  在中定义属性 /libs，但不必在 /apps 覆盖/覆盖。

  1. 在中创建对应的节点 /apps

  2. 创建资产 sling:hideProperties 类型 String 或 String[]. 使用此选项可指定要隐藏/忽略的属性。 也可以使用通配符。 例如：

     • *
     • ["*"]
     • jcr:title
     • ["jcr:title", "jcr:description"]

• 隐藏节点及其子节点

  节点及其子节点定义于 /libs，但不必在 /apps 覆盖/覆盖。

  1. 在/apps下创建对应的节点

  2. 创建资产 sling:hideResource

     • 类型: Boolean
     • 值: true

• 隐藏节点的子节点（同时保留节点的属性）

  节点、其属性及其子节点定义于 /libs. 节点及其属性需要在 /apps 覆盖/覆盖，但部分或全部子节点在中不是必需的 /apps 覆盖/覆盖。

  1. 在下创建对应的节点 /apps

  2. 创建资产 sling:hideChildren：

     • 类型: String[]
     • 值：子节点的列表（如中的定义）。 /libs)以隐藏/忽略

     通配符&ast；可用于隐藏/忽略所有子节点。

• 重新排序节点

  节点及其同级节点定义于 /libs. 需要新位置，以便在中重新创建节点 /apps 覆盖/覆盖，其中新位置是参考中相应的同级节点定义的 /libs.

  • 使用 sling:orderBefore 属性：

    1. 在下创建对应的节点 /apps

    2. 创建资产 sling:orderBefore：

       这会指定节点(如 /libs)当前节点应位于以下位置之前：

       • 类型: String
       • 值: <before-SiblingName>

从代码中调用Sling资源合并器

Sling资源合并器包含两个自定义资源提供程序 — 一个用于叠加，另一个用于覆盖。 可以使用挂载点在代码中调用其中的每项：

• 叠加:

  • 用途：根据资源的搜索路径合并资源

  • 装入点： /mnt/overlay

  • 用法： mount point + relative path

  • 示例：

    • getResource('/mnt/overlay' + '<relative-path-to-resource>');

• 替代:

  • 用途：根据资源的超类型合并资源

  • 装入点： /mnt/overide

  • 用法： mount point + absolute path

  • 示例：

    • getResource('/mnt/override' + '<absolute-path-to-resource>');

使用示例

介绍了一些示例：

• 叠加:

  • 自定义控制台
  • 自定义页面创作

• 替代:

  • 配置页面属性

Business.Adobe.com 资源

Style System Auto Form Fill Embedded Charts Dynamic Media Dynamic Forms Digital Asset Management