Anpassen der Konsolen

VORSICHT

In diesem Dokument wird beschrieben, wie Sie Konsolen in der modernen, Touch-optimierten Benutzeroberfläche anpassen. Die Hinweise gelten nicht für die klassische Benutzeroberfläche.

AEM bietet verschiedene Methoden zum Anpassen von Konsolen (und der Seitenbearbeitungsfunktionen) Ihrer Autoreninstanz.

Clientlibs

Mit clientlibs können Sie die Standardimplementierung erweitern, um neue Funktionen zu realisieren, während Sie die Standardfunktionen, -objekte und -methoden wiederverwenden. Beim Anpassen können Sie Ihre eigene clientlib unter /apps. erstellen. Sie können beispielsweise den für Ihre benutzerdefinierte Komponente erforderlichen Code speichern.
Überlagerungen

Überlagerungen basieren auf Knotendefinitionen und ermöglichen es Ihnen, die Standardfunktionalität (in /libs) mit Ihrer eigenen benutzerdefinierten Funktionalität (in /apps) zu überlagern. Wenn Sie eine Überlagerung erstellen, ist keine 1:1-Kopie des Originals erforderlich, da die Sling-Ressourcenzusammenführung das Vererben zulässt.

Überlagerungen können vielseitig zum Erweitern von AEM-Konsolen verwendet werden. Einige davon sind nachstehend (allgemein) beschrieben.

HINWEIS

Weitere Informationen finden Sie unter:

Verwenden und Erstellen von Clientbibliotheken.
Verwenden und Erstellen von Überlagerungen.
Granite

Dieses Thema wird auch in der AEM Gems-Sitzung Anpassung der Benutzeroberfläche für AEM 6.0 behandelt.

VORSICHT

Sie dürfen keinerlei Änderungen im Pfad /libs vornehmen,

da der Inhalt von /libs überschrieben wird, wenn Sie die Instanz das nächste Mal aktualisieren. (Außerdem kann der Inhalt auch durch Anwenden von Hotfixes oder Feature Packs überschrieben werden.)

Die empfohlene Methode zur Konfiguration und für andere Änderungen sieht wie folgt aus:

Erstellen Sie das erforderliche Element (d. h. wie es in /libs vorhanden ist) unter /apps neu
Nehmen Sie die gewünschten Änderungen in /apps vor.

Beispielsweise können die folgenden Stellen innerhalb der /libs-Struktur überlagert werden:

Konsolen (alle Konsolen basierend auf Seiten der Granite-Benutzeroberfläche); zum Beispiel:
- /libs/wcm/core/content

HINWEIS

Weitere Tipps und Informationen zu Tools finden Sie im Knowledge-Base-Artikel Beheben von Fehlern in der Touch-optimierten AEM-Benutzeroberfläche.

Anpassen der Standardansicht für eine Konsole

Sie können die Standardansicht (Spalte, Karte, Liste) für eine Konsole anpassen:

Sie können die Ansichten durch Überlagern des erforderlichen Eintrags unter folgendem Pfad neu anordnen:

/libs/wcm/core/content/sites/jcr:content/views

Der erste Eintrag ist die Standardeinstellung.

Die verfügbaren Nodes korrelieren mit den verfügbaren Optionen für die Ansicht:
- column
- card
- list
Beispiel: In einer Überlagerung für die Liste:

/apps/wcm/core/content/sites/jcr:content/views/list

Definieren Sie folgende Eigenschaften:
- Name: sling:orderBefore
- Typ: String
- Wert: column

Sie können Ihre eigenen Komponenten einschließlich der entsprechenden Clientbibliotheken für benutzerdefinierte Aktionen erstellen. Beispielsweise eine Twitter-Werbeaktion unter:

/apps/wcm/core/clientlibs/sites/js/twitter.js

Diese kann mit einem Symbolleistenelement in Ihrer Konsole verbunden sein:

/apps/<yourProject>/admin/ext/launches

Beispielsweise im Auswahlmodus:

content/jcr:content/body/content/header/items/selection/items/twitter

Sie können die Standardaktion mit einer benutzerdefinierten Render-Bedingung überlagern und bestimmte Bedingungen festlegen, die vor dem Rendern erfüllt sein müssen.

Erstellen Sie beispielsweise eine Komponente zum Steuern der Render-Bedingungen nach Gruppe:

/apps/myapp/components/renderconditions/group
Um diese auf die Aktion „Site erstellen“ in der Site-Konsole anzuwenden:

/libs/wcm/core/content/sites

Erstellen Sie die Überlagerung:

/apps/wcm/core/content/sites
Fügen Sie dann die Render-Bedingung für die Aktion hinzu:

jcr:content/body/content/header/items/default/items/create/items/createsite/rendercondition

Mithilfe der Eigenschaften auf diesem Knoten können Sie die groups definieren, die für die Ausführung der spezifischen Aktion zulässig ist. zum Beispiel administrators

Anpassen von Spalten in der Listenansicht

HINWEIS

Diese Funktion ist für Spalten von Textfeldern optimiert. Bei anderen Datentypen ist es möglich, cq/gui/components/siteadmin/admin/listview/columns/analyticscolumnrenderer in /apps zu überlagern.

Anpassen von Spalten in der Listenansicht:

Überlagern Sie die Liste der verfügbaren Spalten.
- Auf dem Knoten:
  
  /apps/wcm/core/content/common/availablecolumns
- Fügen Sie die neuen Spalten hinzu oder entfernen Sie vorhandene.
Weitere Informationen finden Sie unter Verwenden von Überlagerungen (und der Sling-Ressourcenzusammenführung).
Optional:
- Wenn Sie zusätzliche Daten einfügen möchten, müssen Sie eine [PageInforProvider](https://helpx.adobe.com/de/experience-manager/6-4/sites/developing/using/reference-materials/javadoc/com/day/cq/wcm/api/PageInfoProvider.html) mit einer
  
  pageInfoProviderType.
  Ein Beispiel sehen Sie im unten (aus GitHub) angehängten Class-Bundle.
Sie können jetzt die Spalte im Spaltenkonfigurator der Listenansicht auswählen.

Filtern von Ressourcen

Ein häufiges Nutzungsszenario beim Verwenden der Konsole ist die Auswahl von Ressourcen (z. B. Seiten, Komponenten, Assets usw.) durch den Benutzer. Dabei kann beispielsweise eine Liste verwendet werden, aus der der Autor ein Element auswählen muss.

Um die Größe der Liste (auf die relevanten Einsatzszenarios) zu beschränken, kann ein Filter in Form eines benutzerdefinierten Prädikats implementiert werden. Weitere Informationen finden Sie in diesem Artikel.