Entwickeln mit CRXDE Lite

In diesem Abschnitt wird beschrieben, wie Sie Ihre AEM-Anwendung mit CRXDE Lite entwickeln.

Weitere Informationen zu den verschiedenen verfügbaren Entwicklungsumgebungen finden Sie in der Übersichtsdokumentation.

CRXDE Lite ist in AEM integriert und ermöglicht Ihnen die Durchführung von Standardentwicklungsaufgaben im Browser. Mit CRXDE Lite können Sie ein Projekt erstellen und Dateien (wie .jsp und .java), Ordner, Vorlagen, Komponenten, Dialogfelder, Knoten, Eigenschaften und Pakete erstellen und bearbeiten, während Sie protokollieren.
CRXDE Lite wird empfohlen, wenn Sie keinen direkten Zugriff auf den AEM-Server haben, wenn Sie eine Anwendung entwickeln, indem Sie die im Lieferumfang enthaltenen Komponenten und Java-Bundle erweitern oder modifizieren, oder wenn Sie keinen dedizierten Debugger, Code-Vervollständigung und Syntaxhervorhebung benötigen.

HINWEIS

Ab AEM 6.5.5.0 ist der anonyme Zugriff auf CRXDE Lite nicht mehr möglich.
Benutzer werden zum Anmeldebildschirm weitergeleitet.

HINWEIS

Während der Projektentwicklung wird empfohlen, die AEM Developer Tools for Eclipse und die AEM HTL Brackets Extension zu verwenden.

Erste Schritte mit CRXDE Lite

Um mit CRXDE Lite zu beginnen, gehen Sie wie folgt vor:

Installieren Sie AEM.
Geben Sie in Ihrem Browser https://<host>:<port>/crx/de ein. Standardmäßig ist dies https://localhost:4502/crx/de.
Geben Sie Ihren Benutzernamen und Ihr Kennwort ein. Standardmäßig ist es admin und admin.
Klicken Sie auf OK.

Die Benutzeroberfläche von CRXDE Lite sieht in Ihrem Browser wie folgt aus:

chlimage_1-18

Jetzt können Sie CRXDE Lite verwenden, um Ihr Programm zu entwickeln.

Überblick über die Benutzeroberfläche

CRXDE Lite bietet folgende Funktionen:

Obere Wechselleiste	Ermöglicht es Ihnen, schnell zwischen CRXDE Lite, Package Manager und Package Share zu wechseln.
Knotenpfad-Widget	Zeigt den Pfad zum aktuell ausgewählten Knoten. Sie können es auch verwenden, um zu einem Knoten zu springen, indem Sie den Pfad von Hand eingeben oder ihn von woanders einfügen und die Eingabetaste drücken. Es bietet auch Unterstützung für die Suche nach Knoten mit bestimmtem Knotennamen. Geben Sie den Namen des Knotens, den Sie suchen möchten, ein, und warten Sie (oder klicken Sie auf das Suchsymbol auf der rechten Seite). Sie können z. B. versuchen, die Zeichenfolge oak in das Widget einzugeben, um zu sehen, wie dies funktioniert. Wenn ein bestimmte Knoten im Explorer-Fenster geladen werden, wird die Liste angezeigt und Sie können den Pfad auswählen und die Eingabetaste drücken, um dorthin zu navigieren. Beachten Sie, dass dies nur für die Knoten funktioniert, die derzeit im CRXDE-Client-Programm im Browser geladen sind. Wenn Sie das gesamte Repository durchsuchen möchten, verwenden Sie „Tools“ > „Anfrage“.
Explorer-Fenster	Zeigt eine Baumstruktur aller Knoten im Repository an. Klicken Sie auf einen Knoten, um seine Eigenschaften auf der Registerkarte Eigenschaften anzuzeigen. Nachdem Sie auf einen Knoten geklickt haben, können Sie eine Aktion in der Symbolleiste auswählen. Klicken Sie erneut auf den Knoten, um ihn umzubenennen. Baumstrukturnavigationsfilter (Fernglassymbol): ermöglicht es Ihnen, die Knoten im Repository zu filtern, deren Name den Eingabetext enthält. Gilt nur für Knoten, die lokal geladen wurden.
Bearbeitungsfenster	Registerkarte Home: ermöglicht die Suche nach Inhalt und/oder Dokumentation und Zugang zu Entwicklerressourcen (Dokumentation, Entwicklerblog, Wissensdatenbank) und Support (Adobe-Homepage und Support-Center). Doppelklicken Sie im Explorer-Fenster auf eine Datei, wie z. B. eine .jsp- oder eine .java-Datei, um deren Inhalt anzuzeigen. Anschließend können Sie diesen ändern und die Änderungen speichern. Sobald eine Datei im Bearbeitungsfenster bearbeitet wurde, sind die folgenden Werkzeuge in der Symbolleiste verfügbar: - In Struktur anzeigen: zeigt die Datei in der Repository-Baumstruktur an. - Suchen/Ersetzen...: führen Sie Suchen oder Ersetzungen durch. Durch einen Doppelklick auf die Statuszeile des Bearbeitungsfensters öffnen Sie das Dialogfeld Zu Zeile wechseln, in dem Sie eine bestimmte Zeilennummer eingeben können, um dorthin zu gelangen.
Registerkarte „Eigenschaften“	Zeigt die Eigenschaften des Knotens, den Sie ausgewählt haben. Sie können neue Eigenschaften hinzufügen oder die vorhandenen löschen.
Registerkarte „Zugriffssteuerung“	Zeigt Berechtigungen basierend auf dem aktuellen Pfad, Repository-Level oder Prinzipal an. Die Berechtigungen werden aufgeschlüsselt in - Gültige Richtlinie für die Zugriffssteuerung: Die Richtlinien, die auf die aktuelle Auswahl angewendet werden können. - Richtlinien zur lokalen Zugriffssteuerung: Die aktuellen Richtlinien, die lokal auf die aktuelle Auswahl angewendet werden. - Gültige Richtlinien zur Zugriffssteuerung: Die aktuellen Richtlinien, die auf die aktuelle Auswahl angewendet werden, sie können lokal festgelegt oder von übergeordneten Knoten übernommen werden. Hinweis. Um die Zugriffssteuerungsinformationen überhaupt zu sehen, muss der Benutzer, der sich bei CRXDE Lite angemeldet hat, über Berechtigungen zum Lesen von ACL-Einträgen verfügen. Der anonyme Benutzer kann diese Informationen nicht standardmäßig sehen - melden Sie sich z. B. als Admin an, um die Informationen zu sehen.
Registerkarte „Replikation“	Zeigt den Replikationsstatus des aktuellen Knotens an. Sie können den aktuellen Knoten replizieren oder replizieren und löschen.
Registerkarte „Konsole“	Serverprotokolle: Zeigt Protokollmeldungen an. Sie können die Protokollebene konfigurieren, die Konsole löschen, an der ausgewählten Bildlaufposition anheften und die Anzeige von Meldungen aktivieren/deaktivieren. Versionskontrolle: Zeigt Versionssteuerungsnachrichten an.
Registerkarte „Build-Informationen“	Zeigt Informationen an, wenn ein Paket erstellt wird.
Aktualisieren	Aktualisiert die aktuelle Auswahl. Änderungen von anderen Benutzern werden in Ihrer Ansicht des Repositorys aktualisiert. Änderungen, die Sie vorgenommen haben, sind nicht betroffen.
Alle speichern	Alle speichern: Speichert alle von Ihnen vorgenommenen Änderungen. Solange Sie nicht auf „Speichern“ klicken, sind die Änderungen vorübergehend und gehen verloren, wenn Sie die Konsole verlassen. Zurück zur letzten Version: Verwirft alle Änderungen, die Sie seit dem letzten Speichervorgang auf dem ausgewählten Knoten vorgenommen haben, lädt dann den aktuellen Status des Repositorys für den ausgewählten Knoten erneut. Alle zurücksetzen: Verwirft alle Änderungen, die Sie seit dem letzten Speichervorgang im gesamten Repository vorgenommen haben, lädt dann den aktuellen Status des Repositorys erneut.
Erstellen ...	Dropdown-Menü, um Folgendes unter dem ausgewählten Knoten zu erstellen: - Knoten: ein Knoten mit einem beliebigen Knotentyp - Datei: nt:file-Knoten und dessen nt:ressource-Unterknoten - Ordner: nt:folder-Knoten - Vorlage: AEM-Vorlage - Komponente: AEM-Komponente - Dialog: AEM-Dialogfeld
Löschen	Löscht den ausgewählten Knoten.
Kopieren	Kopiert den ausgewählten Knoten.
Einfügen	Fügt den kopierten Knoten unter dem ausgewählten Knoten ein.
Verschieben ...	Verschiebt den ausgewählten Knoten zu dem Knoten, der über das Dialogfeld festgelegt wurde.
Umbenennen ...	Benennt den ausgewählten Knoten um.
Mixins ...	Ermöglicht es Ihnen, dem Knotentyp Mixin-Typen hinzuzufügen. Die Mixin-Typen werden meist verwendet, um erweiterte Funktionen wie Versionierung, Zugriffssteuerung, Referenzierung und Knotensperre hinzuzufügen.
Tools	Dropdown-Menü mit den folgenden Tools: - Serverkonfiguration...: zum Zugriff auf die Felix-Konsole. - Abfrage...: für Abfragen im Repository. - Berechtigungen...: um die Rechteverwaltung zu öffnen, in der Sie Berechtigungen anzeigen und hinzufügen können. - Zutrittssteuerung testen...: ein Ort, an dem Sie die Berechtigung für einen bestimmten Pfad und/oder Prinzipal testen können. - Knotentyp exportieren: um Knotentypen im System als CND-Notation zu exportieren. - Knotentyp importieren...: um Knotentypen unter Verwendung von CND-Notation zu importieren. - SiteCatalyst Debugger installieren...: Anweisungen zum Installieren von Analytics-Debugger.
Login-Widget	Zeigt die aktuell angemeldeten Benutzer und den Arbeitsbereich an, bei dem sie angemeldet sind, z. B. admin@crx.default. Klicken Sie es, um sich als bestimmter Benutzer anzumelden bzw. erneut anzumelden. Wenn Sie keinen Arbeitsbereich angeben, um sich anzumelden, werden Sie beim Standardarbeitsbereich, crx.default, angemeldet. Wenn Sie das Repository als anonymer Benutzer durchsuchen möchten, verwenden Sie Anonym als Anmeldenamen und ein beliebiges Kennwort (z. B. ein Leerzeichen oder einen Punkt). Wenn Ihre Autorisierung nicht mehr gültig ist (weil sie z. B. abgelaufen ist), zeigt das Login-Widget Nicht autorisiert – Anmelden.... Klicken Sie darauf, um sich erneut anzumelden.

Erstellen eines Ordners

So erstellen Sie einen Ordner mit CRXDE Lite:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Klicken Sie im Navigationsfenster mit der rechten Maustaste auf den Ordner, unter dem Sie den neuen Ordner erstellen möchten, wählen Sie Erstellen… und dann Ordner erstellen… aus.
Geben Sie den Namen des Ordners ein und klicken Sie auf OK.
Klicken Sie auf Alle speichern, um die Änderungen auf dem Server zu speichern.

Erstellen einer Vorlage

So erstellen Sie eine Vorlage mit CRXDE Lite:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Klicken Sie im Navigationsfenster mit der rechten Maustaste auf den Ordner, in dem Sie die Vorlage erstellen möchten, wählen Sie Erstellen… und dann Vorlage erstellen….
Geben Sie Beschriftung, Titel, Beschreibung, Ressourcentyp und Rangfolge der Vorlage ein. Klicken Sie auf Weiter.
Dieser Schritt ist optional: Legen Sie die zugelassenen Pfade fest. Klicken Sie auf Weiter
Dieser Schritt ist optional: Legen Sie die zugelassenen übergeordneten Elemente fest. Klicken Sie auf Weiter.
Dieser Schritt ist optional: Legen Sie die zugelassenen untergeordneten Elemente fest. Klicken Sie auf OK.
Klicken Sie auf Alle speichern, um die Änderungen auf dem Server zu speichern.

Folgendes wird erstellt:

Ein Knoten vom Typ cq:Template mit Vorlageneigenschaften
Ein untergeordneter Knoten vom Typ cq:PageContent mit Seiteninhaltseigenschaften

Sie können Ihrer Vorlage Eigenschaften hinzufügen: weitere Informationen finden Sie unter Erstellen einer Eigenschaft.

Erstellen einer Komponente

Die Funktion, die hier beschrieben wird, ist nur verfügbar, wenn CQ5 installiert ist, d. h. wenn der Knoten cq:Component im Repository verfügbar ist.

So erstellen Sie eine Komponente mit CRXDE Lite:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Klicken Sie im Navigationsfenster mit der rechten Maustaste auf den Ordner, in dem die Komponente erstellt werden soll, wählen Sie Erstellen… und dann Komponente erstellen….
Geben Sie Beschriftung, Titel, Beschreibung, Superressourcentyp und die Gruppe der Komponente ein. Klicken Sie auf Weiter.
Dieser Schritt ist optional: legen Sie die Komponenteneigenschaften fest: Ist Container, Keine Auszeichnung, Zellenname und Dialogpfad. Klicken Sie auf Weiter.
Dieser Schritt ist optional: legen Sie die Komponenteneigenschaft Zugelassene übergeordnete Elemente fest. Klicken Sie auf Weiter.
Dieser Schritt ist optional: legen Sie die Komponenteneigenschaft Zugelassene untergeordnete Elemente fest. Klicken Sie auf OK.
Klicken Sie auf Alle speichern, um die Änderungen auf dem Server zu speichern.

Folgendes wird erstellt:

Ein Knoten vom Typ cq:Component
Komponenteneigenschaften
Ein Komponenten-.jsp-Skript

Erstellen eines Dialogfelds

So erstellen Sie ein Dialogfeld mit CRXDE Lite:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Klicken Sie im Navigationsfenster mit der rechten Maustaste auf die Komponente, in der Sie das Dialogfeld erstellen möchten, wählen Sie Erstellen… und dann Dialogfeld erstellen….
Geben Sie Beschriftung und Titel ein. Klicken Sie auf OK.
Klicken Sie auf Alle speichern, um die Änderungen auf dem Server zu speichern.

Ein Dialogfeld mit folgender Struktur wird erstellt:

dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]

Sie können das Dialogfeld jetzt Ihren Anforderungen anpassen, indem Sie die Eigenschaften ändern oder neue Knoten erstellen.

Sie können den Dialogfeld-Editor auch verwenden, um ein Dialogfeld zu bearbeiten. Mit einem Doppelklick auf den Dialogfeldknoten in CRXDE Lite wird der Editor geöffnet. Weitere Informationen über den Dialogfeld-Editor finden Sie hier.

Erstellen eines Knotens

So erstellen Sie einen Knoten mit CRXDE Lite:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Klicken Sie im Navigationsfenster mit der rechten Maustaste auf den Knoten, in dem Sie den neuen Knoten erstellen möchten, wählen Sie Erstellen… und dann Knoten erstellen….
Geben Sie den Namen und den Typ ein. Klicken Sie auf OK.
Klicken Sie auf Alle speichern, um die Änderungen auf dem Server zu speichern.

Jetzt können Sie den Knoten an Ihre Anforderungen anpassen, indem Sie die Eigenschaften ändern oder neue Knoten erstellen.

HINWEIS

Die meisten Bearbeitungsvorgänge, einschließlich der Knotenerstellung, behalten alle Änderungen im Speicher und speichern sie erst beim Speichern im Repository (über die Schaltfläche „Alle speichern“). Einige Vorgänge wie das Verschieben werden jedoch automatisch beibehalten.

Die Prüfung, ob der neu erstellte Knoten vom Knotentyp des übergeordneten Knoten zugelassen ist, wird auch zuerst vom JCR-Repository ausgeführt, wenn Änderungen gespeichert werden sollen. Wenn Sie beim Speichern eines Knotens eine Fehlermeldung erhalten, überprüfen Sie, ob die Inhaltsstruktur gültig ist (Sie können z. B. keinen Knoten nt:unstructured als untergeordneten Knoten des Knotens nt:folder erstellen).

Erstellen einer Eigenschaft

So erstellen Sie eine Eigenschaft mit CRXDE Lite:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Wählen Sie im Navigationsbereich den Knoten aus, an dem Sie die neue Eigenschaft hinzufügen möchten.
Geben Sie auf der Registerkarte Eigenschaften im unteren Fensterbereich den Namen, den Typ und den Wert ein. Klicken Sie auf Hinzufügen.
Klicken Sie auf Alle speichern, um die Änderungen auf dem Server zu speichern.

Erstellen eines Skripts

So erstellen Sie ein neues Skript:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Klicken Sie im Navigationsfenster mit der rechten Maustaste auf die Komponente, in der Sie das Skript erstellen möchten, wählen Sie Erstellen… und dann Datei erstellen….
Geben Sie den Dateinamen mit der Erweiterung ein. Klicken Sie auf OK.
Die neue Datei wird als Registerkarte im Bearbeitungsfenster geöffnet.
Bearbeiten Sie die Datei.
Klicken Sie auf Alle speichern, um die Änderungen zu speichern.

Exportieren und Importieren von Knotentypen

Mit CRXDE Lite können Sie Knotentypdefinitionen in der CND-Notation (Compact Namespace and Node Type Definition) importieren und/oder exportieren.

So exportieren Sie eine Knotentypdefinition:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Wählen Sie Ihren gewünschten Knoten aus.
Wählen Sie Tools und dann Knotentyp exportieren aus.
Die Definition wird in CND-Notation in Ihrem Browser angezeigt. Speichern Sie die Informationen (falls erforderlich).

So importieren Sie eine Knotentypdefinition:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Wählen Sie Tools und dann Knotentyp importieren….
Geben Sie die CND-Notation für die Definition in das Textfeld ein.
Aktivieren Sie Aktualisierung zulassen, wenn Sie eine vorhandene Definition aktualisieren.
Wählen Sie Importieren.

Protokollierung

Mit CRXDE Lite können Sie die Datei error.log anzeigen, die sich im Dateisystem unter <crx-install-dir>/crx-quickstart/server/logs befindet, und sie mit der entsprechenden Protokollebene filtern. Gehen Sie wie folgt vor:

Öffnen Sie CRXDE Lite in Ihrem Browser.
Wählen Sie auf der Registerkarte Konsole am unteren Rand des Fensters im Dropdown-Menü auf der rechten Seite Serverprotokolle aus.
Klicken Sie auf das Stopp-Symbol, um die Nachrichten anzuzeigen.

Sie haben folgende Möglichkeiten:

Passen Sie die Protokollparameter in der Felix-Konsole an, indem Sie auf das Symbol Protokollierungskonfigurationen klicken.
Löschen Sie die Meldungen, indem Sie auf das Pinselsymbol klicken.
Heften Sie die Nachricht an der aktuellen Auswahl an, indem Sie auf das Pin-Symbol klicken.
Aktivieren oder deaktivieren Sie die Anzeige von Meldungen, indem Sie auf das Stopp-Symbol klicken.