Developing with CRXDE Lite developing-with-crxde-lite
This section describes how to develop your AEM application using CRXDE Lite.
Please refer to the 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, 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 ishttp://localhost:4502/crx/de. -
Enter your username and password. By default it is
adminandadmin. -
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 new 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:Templatewith Template properties -
A child node of type
cq:PageContentwith Page Content properties
You can add properties to your template: refer to the Creating a Property section.
Creating a Component creating-a-component
The feature described here is only available 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 new nodes.
You can also use the Dialog Editor to edit a dialog. Double clicking the dialog node in CRXDE Lite will bring 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 new 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 new 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 new 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 will be displayed in your browser. Save the information if required.
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 n 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 located 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 current selection by clicking the Pin icon.
- Enable or disable the displaying of messages by clicking the Stop icon.