Verwenden des Sling Resource Mergers in AEM as a Cloud Service using-the-sling-resource-merger-in-aem

Überlagerungen von Ressourcen unter Verwendung der Suchpfade.

Überschreibungen von Komponentendialogfeldern für die Touch-optimierte Benutzeroberfläche (cq:dialog) unter Verwendung der Ressourcentyphierarchie (anhand der Eigenschaft sling:resourceSuperType).

Der Inhalt der angepassten Definition hat eine höhere Priorität als der des Originals (d. h. er überlagert oder überschreibt dieses).

Wo nötig, geben bei der Anpassung definierte Eigenschaften an, wie aus dem Original zusammengeführte Inhalte zu verwenden sind.

Sicherstellen, dass Anpassungsänderungen nicht in /libs vorgenommen werden

Die Struktur reduzieren, die von /libs repliziert wird

Bei Verwendung des Sling Resource Merger wird nicht empfohlen, die gesamte Struktur aus /libs zu kopieren, da so zu viele Informationen in der Anpassung (im Allgemeinen /apps) gespeichert werden würden. Das unnötige Duplizieren von Daten erhöht die Wahrscheinlichkeit von Problemen, wenn für das System ein Upgrade jedweder Art durchgeführt wird.

sling:hideProperties ( String oder String[])

Gibt die Eigenschaft bzw. Liste der Eigenschaften an, die ausgeblendet werden sollen.

Der Platzhalter * blendet alles aus.

sling:hideResource ( Boolean)

Gibt an, ob die Ressourcen vollständig ausgeblendet werden sollen, einschließlich ihrer untergeordneten Elemente.

sling:hideChildren ( String oder String[])

Enthält den untergeordneten Knoten bzw. die Liste der untergeordneten Knoten, die ausgeblendet werden sollen. Die Eigenschaften des Knotens werden beibehalten.

Der Platzhalter * blendet alles aus.

sling:orderBefore ( String)

Enthält den Namen des gleichrangigen Knotens, vor dem der aktuelle Knoten platziert werden soll.

Überlagerung

• Die Definition des Navigationseintrags für die Sites-Konsole, wie sie in der Leiste angezeigt ist, wird definiert unter:

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

• Erstellen Sie zum Überlagern folgenden Knoten:

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

  Aktualisieren Sie dann die Eigenschaft jcr:title nach Bedarf.

Überschreibung

• Die Definition des Touch-fähigen Dialogfelds für die Textkonsole ist definiert unter:

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

• Um dies zu überschreiben, erstellen Sie den folgenden Knoten, z. B.:

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

Eigenschaft hinzufügen

Die Eigenschaft ist nicht in der /libs-Definition vorhanden, ist in der /apps-Überlagerung/-Überschreibung aber erforderlich.

1. Erstellen Sie den entsprechenden Knoten in /apps.
2. Erstellen Sie die neue Eigenschaft auf diesem Knoten.

Eigenschaft neu definieren (nicht automatisch erstellte Eigenschaften)

Die Eigenschaft ist in /libs definiert, aber für die /apps-Überlagerung/-Überschreibung ist ein neuer Wert erforderlich.

1. Erstellen Sie den entsprechenden Knoten in /apps.

2. Erstellen Sie die entsprechende Eigenschaft auf diesem Knoten (unter /apps).

   • Die Eigenschaft verfügt über eine Priorität, die auf der Konfiguration des Sling Resource Resolver basiert.

   • Das Ändern des Eigenschaftstyps wird unterstützt.

     Wenn Sie einen Eigenschaftstyp verwenden, der sich von dem in /libs verwendeten unterscheidet, wird der von Ihnen definierte Eigenschaftstyp verwendet.

Automatisch erstellte Eigenschaft neu definieren

Standardmäßig unterliegen automatisch erstellte Eigenschaften (z. B. jcr:primaryType) keinen Überlagerungen/Überschreibungen, um sicherzustellen, dass der aktuell unter /libs befindliche Knotentyp respektiert wird. Um eine Überschreibung/Überlagerung vorzuschreiben, müssen Sie den Knoten in /apps neu erstellen, die Eigenschaft ausdrücklich ausblenden und neu definieren:

1. Erstellen Sie den entsprechenden Knoten unter /apps mit dem gewünschten jcr:primaryType.

2. Erstellen Sie die Eigenschaft sling:hideProperties auf diesem Knoten, wobei der Wert auf den Wert der automatisch erstellten Eigenschaft eingestellt ist, zum Beispiel jcr:primaryType.

   Diese Eigenschaft, die unter /apps definiert wird, hat jetzt Vorrang vor der Eigenschaft, die unter /libs definiert wurde.

Knoten und zugehörige untergeordnete Elemente neu definieren

Der Knoten und seine untergeordneten Elemente sind in /libs definiert, aber in der /apps-Überlagerung/Überschreibung wird eine neue Konfiguration benötigt.

1. Kombinieren Sie folgende Aktionen:

   1. Untergeordnete Elemente eines Knotens ausblenden (wobei die Eigenschaften des Knotens beibehalten werden)
   2. Eigenschaft(en) neu definieren

Eigenschaft ausblenden

Die Eigenschaft ist in /libs definiert, ist aber für die /apps-Überlagerung/-Überschreibung nicht erforderlich.

1. Erstellen Sie den entsprechenden Knoten in /apps.

2. Erstellen Sie eine Eigenschaft sling:hideProperties vom Typ String oder String[]. Geben Sie hiermit an, ob die Eigenschaften verborgen/ignoriert werden sollen. Platzhalter können auch verwendet werden. Beispiel:

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

Knoten und zugehörige untergeordnete Elemente ausblenden

Der Knoten und seine untergeordneten Elemente sind in /libs definiert, aber für die /apps-Überlagerung/-Überschreibung nicht erforderlich.

1. Erstellen Sie den entsprechenden Knoten unter /apps.

2. Erstellen Sie eine Eigenschaft sling:hideResource.

   • Typ: Boolean
   • Wert: true

Untergeordnete Elemente eines Knotens ausblenden (wobei die Eigenschaften des Knotens beibehalten werden)

Der Knoten, seine Eigenschaften und seine untergeordneten Elemente sind in /libs definiert. Der Knoten und seine Eigenschaften sind in der /apps-Überlagerung/-Überschreibung erforderlich, aber einige oder alle der untergeordneten Knoten sind in der /apps-Überlagerung/-Überschreibung nicht erforderlich.

1. Erstellen Sie den entsprechenden Knoten unter /apps

2. Erstellen Sie die Eigenschaft sling:hideChildren:

   • Typ: String[]
   • Wert: eine Liste der auszublendenden/zu ignorierenden untergeordneten Knoten (wie definiert in /libs)

   Mit dem Platzhalter * können Sie alle untergeordneten Knoten ausblenden/ignorieren.

Knoten neu anordnen

Der Knoten und die ihm gleichrangigen Elemente sind in /libs definiert. Eine neue Position ist erforderlich, damit der Knoten in der /apps-Überlagerung/-Überschreibung neu erstellt wird, wobei die neue Position als Verweis auf den entsprechenden gleichrangigen Knoten in /libs definiert ist.

• Verwenden Sie die Eigenschaft sling:orderBefore:

  1. Erstellen Sie den entsprechenden Knoten unter /apps

  2. Erstellen Sie die Eigenschaft sling:orderBefore:

     Dies gibt den Knoten (wie in /libs) an, vor dem der aktuelle Knoten positioniert werden soll:

     • Typ: String
     • Wert: <before-SiblingName>

Überlagerung:

• Zweck: Ressourcen anhand ihrer Suchpfade zusammenführen

• Einhängepunkt: /mnt/overlay

• Anwendung: mount point + relative path

• Beispiel:

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

Überschreibung:

• Zweck: Ressourcen anhand ihrer Supertypen zusammenführen

• Einhängepunkt: /mnt/overide

• Anwendung: mount point + absolute path

• Beispiel:

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