DokumentationAEM 6.4Entwickleranleitung

Anpassen der Konsolen customizing-the-consoles

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer
CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.
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 Mechanismen, mit denen Sie die Konsolen (und die Seitenbearbeitungsfunktionen) Ihrer Authoring-Instanz.

  • Clientbibliotheken

    Mit Clientbibliotheken 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 Clientbibliothek erstellen. Beispielsweise kann sie den Code enthalten, der für Ihre benutzerdefinierte Komponente erforderlich ist.

  • Überlagerungen

    Überlagerungen basieren auf Knotendefinitionen und ermöglichen es Ihnen, 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.

Diese können auf viele Arten verwendet werden, um Ihre AEM Konsolen zu erweitern. Einige davon sind nachstehend (allgemein) beschrieben.

NOTE
Weitere Informationen finden Sie unter:
Dieses Thema wird auch in der AEM Gems-Sitzung Anpassung der Benutzeroberfläche für AEM 6.0 behandelt.
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 für Konfigurations- und sonstige Änderungen sieht wie folgt aus:

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

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

Beispielsweise die folgenden Stellen innerhalb der /libs -Struktur kann ü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 neu anordnen, indem Sie den erforderlichen Eintrag unter überschreiben:

    /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 Weiterleiten an Twitter Aktion 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 eine benutzerdefinierte Rendering-Bedingung verwenden, um die Standardaktion zu überlagern und bestimmte Bedingungen vorzuschreiben, die erfüllt sein müssen, bevor sie gerendert wird.

    Erstellen Sie beispielsweise eine Komponente, um die Renderbedingungen entsprechend der Gruppe zu steuern:

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

So passen Sie die Spalten in der Listenansicht an:

  1. Ü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).

  2. Optional:

    • Falls Sie zusätzliche Daten hinzufügen möchten, müssen Sie einen [PageInforProvider](https://helpx.adobe.com/experience-manager/6-4/sites/developing/using/reference-materials/javadoc/com/day/cq/wcm/api/PageInfoProvider.html) mit einer

      pageInfoProviderType-Eigenschaft schreiben.
      Siehe beispielsweise die angehängte Klasse/das angehängte Bundle (von GitHub) unten.

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

Ressourcen filtern filtering-resources

Bei Verwendung einer Konsole ist es häufig der Fall, dass der Benutzer aus Ressourcen (z. B. Seiten, Komponenten, Assets usw.) auswählen muss. Dies kann in Form einer Liste erfolgen, aus der der Autor beispielsweise 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. Siehe diesem Artikel für Details.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e