Entwickeln mit CRXDE Lite
Erstellt für:
- Entwickler
In diesem Abschnitt wird beschrieben, wie Sie Ihre Adobe Experience Manager(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. Oder, 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.
Benutzer werden zum Anmeldebildschirm weitergeleitet.
Erste Schritte mit CRXDE Lite
Gehen Sie für die ersten Schritte mit CRXDE Lite wie folgt vor:
-
Installieren Sie AEM.
-
Geben Sie in Ihrem Browser
https://<host>:<port>/crx/de
ein. Standardmäßig ist dieshttps://localhost:4502/crx/de
. -
Geben Sie Ihren Benutzernamen und Ihr Kennwort ein. Standardmäßig ist es
admin
undadmin
. -
Klicken Sie auf OK.
Die Benutzeroberfläche von CRXDE Lite sieht in Ihrem Browser wie folgt aus:
Jetzt können Sie CRXDE Lite verwenden, um Ihr Programm zu entwickeln.
Überblick über die Benutzeroberfläche
CRXDE Lite bietet folgende Funktionen:
Zeigt den Pfad zum ausgewählten Knoten.
Sie können es auch verwenden, um zu einem Knoten zu springen, indem Sie den Pfad manuell eingeben oder ihn von woanders einfügen und die Eingabetaste drücken.
Es bietet auch Unterstützung für die Suche nach Knoten mit einem bestimmten Knotennamen. Geben Sie den Namen des Knotens ein, den Sie suchen möchten, 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 es funktioniert. Wenn ein oder mehrere bestimmte Knoten in das Explorer-Fenster geladen werden, wird die Liste angezeigt, in der Sie einen Pfad auswählen und die Eingabetaste drücken können, um dorthin zu navigieren. Dies funktioniert nur für die Knoten, die in der CRXDE-Client-Anwendung im Browser geladen sind. Wenn Sie das gesamte Repository durchsuchen möchten, verwenden Sie „Tools“ > „Abfrage“.
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, im Repository die Knoten zu filtern, deren Name den Eingabetext enthält. Gilt nur für Knoten, die lokal geladen wurden.
Registerkarte Home: Ermöglicht die Suche nach Inhalten und/oder Dokumentation sowie den Zugang zu Entwicklerressourcen (Dokumentation, Entwickler-Blog, Knowledgebase) und Support (Adobe-Homepage und Support Center).
Doppelklicken Sie auf eine Datei im Explorer-Bereich, um den zugehörigen Inhalt anzuzeigen. Beispielsweise eine .jsp- oder eine .java-Datei. Anschließend können Sie diesen ändern und die Änderungen speichern.
Sobald eine Datei im Bearbeitungsbereich bearbeitet wurde, sind die folgenden Tools in der Symbolleiste verfügbar:
- In Struktur anzeigen: Zeigt die Datei in der Repository-Baumstruktur an.
– Suchen/Ersetzen: Führt einen Suchen- oder Ersetzen-Vorgang 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.
Zeigt Berechtigungen basierend auf dem Pfad, Repository-Level oder Prinzipal an.
Die Berechtigungen werden wie folgt aufgeschlüsselt:
– Gültige Richtlinie für die Zugriffssteuerung: Die Richtlinien, die auf die aktuelle Auswahl angewendet werden können.
– Richtlinien zur lokalen Zugriffssteuerung: Die Richtlinien, die lokal auf die Auswahl angewendet werden.
– Gültige Richtlinien zur Zugriffssteuerung: Die Richtlinien, die auf die Auswahl angewendet werden. Sie können lokal festgelegt oder von übergeordneten Knoten übernommen werden.
Hinweis. Um die Zugriffssteuerungsinformationen überhaupt zu sehen, muss die Person, die sich bei CRXDE Lite angemeldet hat, über Berechtigungen zum Lesen von ACL-Einträgen verfügen. Eine anonyme Person kann diese Informationen nicht standardmäßig sehen – melden Sie sich z. B. als Admin an, um die Informationen zu sehen.
Server-Protokolle:
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 Versionskontrollmeldungen an.
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 für den ausgewählten Knoten vorgenommen haben, und lädt dann den 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, und lädt dann den Status des Repositorys erneut.
Dropdown-Menü, um Folgendes unter dem ausgewählten Knoten zu erstellen:
- Knoten: Knoten mit einem beliebigen Knotentyp
- Datei: nt:file-Knoten und dessen nt:ressource-Unterknoten
- Ordner: nt:folder-Knoten
- Vorlage: AEM-Vorlage
- Komponente: AEM-Komponente
- Dialogfeld: AEM-Dialogfeld
Dropdown-Menü mit den folgenden Tools:
- Server-Konfiguration: Zum Zugreifen auf die Felix-Konsole
- Abfrage: Zum Abfragen des Repositorys
- Berechtigungen: Zum Öffnen der Rechteverwaltung, in der Sie Berechtigungen anzeigen und hinzufügen können
– Zugriffssteuerung testen…: Ein Ort, an dem Sie die Berechtigung für einen bestimmten Pfad und/oder Prinzipal testen können.
- Knotentyp exportieren: Zum Exportieren von Knotentypen im System als CND-Notation
- Knotentyp importieren: Zum Importieren von Knotentypen unter Verwendung der CND-Notation
- SiteCatalyst Debugger installieren: Anweisungen zum Installieren von Analytics Debugger
Zeigt die angemeldeten Benutzenden und den Arbeitsbereich an, bei dem sie jeweils angemeldet sind, z. B. „admin@crx.default“.
Klicken Sie darauf, um sich als eine bestimmte Person anzumelden bzw. erneut anzumelden. Wenn Sie keinen Arbeitsbereich angeben, um sich anzumelden, werden Sie beim Standardarbeitsbereich, crx.default, angemeldet.
Wenn Sie das Repository anonym 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 (z. B. weil sie abgelaufen ist), zeigt das Anmelde-Widget „Nicht autorisiert – Anmelden…“ an. 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, und 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 eine Bezeichnung, einen Titel, eine Beschreibung, einen Ressourcentyp und die Rangfolge der Vorlage an. 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 im Abschnitt 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 die Beschriftung, den Titel, die Beschreibung, den 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 das Label und den Titel ein. Klicken Sie auf OK.
-
Klicken Sie auf Alle speichern, um die Änderungen auf dem Server zu speichern.
Es wird ein Dialogfeld mit der folgenden Struktur erstellt:
dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]
Sie können nun das Dialogfeld an Ihre Bedürfnisse anpassen, indem Sie die Eigenschaften ändern oder Knoten erstellen.
Sie können den Dialogfeldeditor auch verwenden, um ein Dialogfeld zu bearbeiten. Mit einem Doppelklick auf den Dialogfeldknoten in CRXDE Lite wird der Editor geöffnet. Weitere Informationen finden Sie unter Dialogfeldeditor.
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 Knoten erstellen möchten, und 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.
nt:unstructured
-Knoten als untergeordneten Knoten eines nt:folder
-Knotens 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
Erstellen eines Skripts:
-
Öffnen Sie CRXDE Lite in Ihrem Browser.
-
Klicken Sie im Navigationsbereich 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 Bearbeitungsbereich 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 den 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 Update 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.
-
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 Nadel-Symbol klicken.
- Aktivieren oder deaktivieren Sie die Anzeige von Meldungen, indem Sie auf das Stopp-Symbol klicken.