Developing with CRXDE Lite developing-with-crxde-lite
This section describes how to develop your Adobe Experience Manager (AEM) application using CRXDE Lite.
Seethe overview documentation for more information on the different development environments that are available.
CRXDE Lite is embedded into AEM and enables you to perform standard development tasks in the browser. With CRXDE Lite, you can create a project, create, and edit files (like .jsp and .java), folders, templates, components, dialogs, nodes, properties, and bundles while logging.
CRXDE Lite is recommended when you do not have direct access to the AEM server. Or, when you develop an application by extending or modifying the out-of-the-box components and Java™ bundles, or when you do not need a dedicated debugger, code completion and syntax highlighting.
Users are redirected to the login screen.
Getting Started with CRXDE Lite getting-started-with-crxde-lite
To get started with CRXDE Lite, proceed as follows:
-
Install AEM.
-
In your browser, enter
https://<host>:<port>/crx/de
. By default it ishttps://localhost:4502/crx/de
. -
Enter your username and password. By default it is
admin
andadmin
. -
Click OK.
The CRXDE Lite User Interface looks as follows in your browser:
You can now use CRXDE Lite to develop your application.
Overview of the User Interface overview-of-the-user-interface
CRXDE Lite offers the following functionality:
Creating a Folder creating-a-folder
To create a folder with CRXDE Lite:
-
Open CRXDE Lite in your browser.
-
In the Navigation pane, right-click the folder under which you want to create the folder, select Create …, then Create Folder ….
-
Enter the folder Name and click OK.
-
Click Save All to save the changes on the server.
Creating a Template creating-a-template
To create a template with CRXDE Lite:
-
Open CRXDE Lite in your browser.
-
In the Navigation pane, right-click the folder where you want to create the template, select Create …, then Create Template ….
-
Enter the Label, Title, Description, Resource Type, and Ranking of the template. Click Next.
-
This step is optional: set the Allowed Paths. Click Next
-
This step is optional: set the Allowed Parents. Click Next.
-
This step is optional: set the Allowed Children. Click OK.
-
Click Save All to save the changes on the server.
It creates:
-
A node of type
cq:Template
with Template properties -
A child node of type
cq:PageContent
with Page Content properties
You can add properties to your template: see the Creating a Property section.
Creating a Component creating-a-component
The feature described here is only available if CQ5 is installed, that is if the node type cq:Component
is available in the repository.
To create a component with CRXDE Lite:
-
Open CRXDE Lite in your browser.
-
In the Navigation pane, right-click the folder where you want to create the component, select Create …, then Create Component ….
-
Enter the Label, Title, Description, Super Resource Type, and Group of the component. Click Next.
-
This step is optional: set the component properties Is Container, No Decoration, Cell Name, and Dialog Path. Click Next.
-
This step is optional: set the component property Allowed Parents. Click Next.
-
This step is optional: set the component property Allowed Children. Click OK.
-
Click Save All to save the changes on the server.
It creates:
- A node of type
cq:Component
- Component properties
- A component .jsp script
Creating a Dialog creating-a-dialog
To create a dialog with CRXDE Lite:
-
Open CRXDE Lite in your browser.
-
In the Navigation pane, right-click the component where you want to create the dialog, select Create …, then Create Dialog ….
-
Enter the Label and the Title. Click OK.
-
Click Save Al l to save the changes on the server.
It creates a dialog with the following structure:
dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]
You can now adapt the dialog to your needs by modifying properties or creating nodes.
You can also use the Dialog Editor to edit a dialog. Double-clicking the dialog node in CRXDE Lite brings up the editor. More information about the Dialog Editor can be found here.
Creating a Node creating-a-node
To create a node with CRXDE Lite:
- Open CRXDE Lite in your browser.
- In the Navigation pane, right-click the node where you want to create the node, select Create …, then Create Node ….
- Enter the Name and the Type. Click OK.
- Click Save All to save the changes on the server.
You can now adapt the node to your needs by modifying properties or creating nodes.
nt:unstructured
node as a child of nt:folder
node).Creating a Property creating-a-property
To create a property with CRXDE Lite:
-
Open CRXDE Lite in your browser.
-
In the Navigation pane, select the node where you want to add the new property.
-
In the Properties tab in the bottom pane, enter the Name, the Type, and the Value. Click Add.
-
Click Save All to save the changes on the server.
Creating a Script creating-a-script
To create a script:
-
Open CRXDE Lite in your browser.
-
In the Navigation pane, right-click the component where you want to create the script, select Create …, then Create File ….
-
Enter the File Name including its extension. Click OK.
-
The new file opens as a tab in the Edit pane.
-
Edit the file.
-
Click Save All to save the changes.
Exporting and Importing Node Types exporting-and-importing-node-types
With CRXDE Lite, you can import and/or export node type definitions in CND (Compact Namespace and Node Type Definition) notation.
To export a node type definition:
-
Open CRXDE Lite in your browser.
-
Select your required node.
-
Select Tools then Export Node Type.
-
The definition, in cnd notation, is displayed in your browser. Save the information, if necessary.
To import a node type definition:
-
Open CRXDE Lite in your browser.
-
Select Tools then Import Node Type….
-
Enter the CND notation for the definition in the text box.
-
Check Allow Update if you are updating an existing definition.
-
Click Import.
Logging logging
With CRXDE Lite, you can display the file error.log
that is on the file system at <crx-install-dir>/crx-quickstart/server/logs
and filter it with the appropriate log level. Proceed as follows:
-
Open CRXDE Lite in your browser.
-
In the Console tab at the bottom of the window, in the drop-down menu on the right, select Server Logs.
-
Click the Stop icon to display the messages.
You can:
- Adjust the log parameters in the Felix Console by clicking the Logging Configurations icon.
- Clear the messages by clicking the Brush icon.
- Pin the message at the selection by clicking the Pin icon.
- Enable or disable the displaying of messages by clicking the Stop icon.