DokumentationAEM 6.5Benutzerhandbuch

Anpassen der Konsolen customizing-the-consoles

Last update: Tue Aug 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Entwickler
CAUTION
In diesem Dokument wird beschrieben, wie Sie Konsolen in der modernen, Touch-optimierten Benutzeroberfläche anpassen. Es gilt nicht für die klassische Benutzeroberfläche.

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

  • Client-Bibliotheken
    Mit Client-Bibliotheken können Sie die Standardimplementierung um neue Funktionen erweitern und gleichzeitig Standardfunktionen, -objekte und -methoden wiederverwenden. Bei der Anpassung können Sie unter /apps. Ihre eigene Client-Bibliothek erstellen. Sie kann beispielsweise den Code enthalten, der für Ihre benutzerdefinierte Komponente erforderlich ist.

  • Überlagerungen
    Überlagerungen basieren auf Knotendefinitionen und ermöglichen es Ihnen, die Standardfunktionen (in /libs) mit Ihren eigenen benutzerdefinierten Funktionen (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 auf viele Arten zum Erweitern Ihrer AEM-Konsolen verwendet werden. Einige davon sind nachstehend (allgemein) beschrieben.

NOTE
Weitere Informationen finden Sie unter:
CAUTION
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:

  1. Erstellen Sie das erforderliche Element unter /apps neu (d. h. wie es in /libs existiert).

  2. Nehmen Sie die gewünschten Änderungen in /apps vor.

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

  • Konsolen (alle Konsolen basierend auf Seiten der Granite-Benutzeroberfläche); zum Beispiel:

    • /libs/wcm/core/content
NOTE
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 customizing-the-default-view-for-a-console

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

  1. Sie können die Ansichten durch Überlagern des erforderlichen Eintrags wie folgt neu anordnen:

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

    Der erste Eintrag ist die Standardeinstellung.

    Die verfügbaren Knoten korrelieren mit den verfügbaren Anzeigeoptionen:

    • column
    • card
    • list

  2. 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

Hinzufügen neuer Aktionen zur Symbolleiste add-new-action-to-the-toolbar

  1. Sie können eigene Komponenten erstellen und die entsprechenden Client-Bibliotheken für benutzerdefinierte Aktionen einschließen. Beispiel: eine Aktion Auf Twitter bewerben 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

Beschränken einer Symbolleistenaktion auf eine bestimmte Gruppe restrict-a-toolbar-action-to-a-specific-group

  1. 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 je nach Gruppe:

    /apps/myapp/components/renderconditions/group

  2. 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

  3. 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 von Eigenschaften auf diesem Knoten können Sie die groups definieren, die die spezifische Aktion ausführen dürfen, beispielsweise administrators.

Anpassen von Spalten in der Listenansicht customizing-columns-in-the-list-view

NOTE
Diese Funktion ist für Spalten mit Textfeldern optimiert. Für andere Datentypen können Sie cq/gui/components/siteadmin/admin/listview/columns/analyticscolumnrenderer in /apps überlagern.

Anpassen von Spalten in der Listenansicht:

  1. Überlagern Sie die Liste der verfügbaren Spalten.

    • Auf dem Knoten:

      code language-none 
             /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).

  2. Optional:

    • Falls Sie zusätzliche Daten hinzufügen möchten, müssen Sie einen PageInforProvider mit einer
      pageInfoProviderType-Eigenschaft schreiben.

    Ein Beispiel sehen Sie im unten (aus GitHub) angehängten Class-Bundle.

  3. Sie können jetzt die Spalte im Spaltenkonfigurator der Listenansicht auswählen.

Filtern von Ressourcen filtering-resources

Ein häufiges Nutzungsszenario beim Verwenden der Konsole ist die Auswahl von Ressourcen (etwa Seiten, Komponenten, Assets) durch Benutzende. Dabei kann beispielsweise eine Liste verwendet werden, aus der die Autorin odbzw.er der Autor ein Element auswählen muss.

Um die Liste in einer angemessenen Größe und auch für den Anwendungsfall relevant zu halten, kann ein Filter in Form eines benutzerdefinierten Prädikats implementiert werden. Weitere Informationen finden Sie unter Anpassung des Seiten-Authorings – Filtern von Ressourcen.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2