Cette section explique comment développer votre application AEM à l’aide de CRXDE Lite.
Reportez-vous à la documentation de présentation pour plus d’informations sur les différents environnements de développement disponibles.
CRXDE Lite est intégré à CRX/CQ et permet d’effectuer des tâches de développement standard dans le navigateur. En vous connectant à CRXDE Lite, vous pouvez créer un projet, créer et modifier des fichiers (en .jsp et .java, par exemple), des dossiers, des modèles, des composants, des boîtes de dialogue, des nœuds, des propriétés et des bundles.
CRXDE Lite est recommandé si vous ne disposez pas d’un accès direct au serveur AEM, lorsque vous développez une application en étendant ou en modifiant les composants prêts à l’emploi et les bundles Java ou lorsque vous n’avez pas besoin d’un débogueur dédié, de la complétion de code et de la mise en surbrillance de la syntaxe.
À partir de la version 6.5.5.0 d’AEM, l’accès anonyme de CRXDE Lite n’est plus possible.
Les utilisateurs sont redirigés vers l’écran de connexion.
Il est recommandé d’utiliser AEM Developer Tools for Eclipse et AEM HTL Brackets Extension pendant le développement du projet.
Pour commencer avec CRXDE Lite, procédez comme suit :
Installez AEM.
Dans votre navigateur, entrez https://<host>:<port>/crx/de
. Par défaut, le paramètre est https://localhost:4502/crx/de
.
Entrez votre nom d’utilisateur et votre mot de passe. Par défaut, il s’agit de admin
et admin
.
Cliquez sur OK.
L’interface utilisateur de CRXDE Lite est la suivante dans votre navigateur :
Vous pouvez désormais utiliser CRXDE Lite pour développer votre application.
CRXDE Lite offre les fonctionnalités suivantes :
Barre de commutation supérieure | Vous permet de basculer rapidement entre CRXDE Lite, le gestionnaire de modules et le partage de modules. |
Widget de chemin de nœud | Affiche le chemin d’accès au nœud actuellement sélectionné. Vous pouvez également l’utiliser pour sauter vers un nœud, en entrant le chemin à la main ou en le collant à partir d’un autre endroit et en appuyant sur Entrée. Il permet aussi de rechercher des nœuds par nom de nœud. Entrez le nom du nœud que vous souhaitez rechercher et patientez (ou appuyez sur le symbole de recherche sur le côté droit). Entrez par exemple la chaîne oak dans le widget pour voir comment la recherche fonctionne. Si un ou plusieurs nœuds sont chargés dans le volet de l’explorateur, la liste s’affiche et vous pouvez sélectionner le chemin et appuyer sur Entrée pour y accéder. Notez que la recherche ne fonctionne que pour les nœuds actuellement chargés dans l’application cliente CRXDE dans le navigateur. Pour effectuer une recherche dans tout le référentiel, utilisez Outils, puis Requête. |
Volet de l’explorateur | Affiche une arborescence de tous les nœuds du référentiel. Cliquez sur un nœud pour afficher ses propriétés dans l’onglet Propriétés. Après avoir cliqué sur un nœud, vous pouvez sélectionner une action dans la barre d’outils. Cliquez à nouveau sur le nœud pour le renommer. Filtre de navigation dans l’arborescence (icône en forme de paire de jumelles) : vous permet de filtrer les nœuds du référentiel pour lesquels le nom contient le texte saisi. S’applique uniquement aux nœuds qui ont été chargés localement. |
Volet de modification | Onglet Accueil : permet de rechercher du contenu et/ou de la documentation et d’accéder aux ressources de développeurs (documentation, blog, base de connaissances) et au support (page d’accueil Adobe et centre de support). Double-cliquez sur un fichier dans le volet de l’explorateur pour afficher son contenu, par exemple un fichier .jsp ou un fichier .java. Vous pouvez ensuite le modifier et enregistrer les modifications. Une fois le fichier modifié dans le volet Modifier, les outils suivants sont disponibles dans la barre d’outils : - Recherche/Remplacement ... : recherche ou remplacement. Double-cliquez sur la ligne d’état du volet Modifier pour ouvrir la boîte de dialogue Aller à la ligne et entrer un numéro de ligne spécifique à laquelle accéder. |
Onglet Propriétés |
Affiche les propriétés du nœud que vous avez sélectionné. Vous pouvez ajouter de nouvelles propriétés ou supprimer celles qui existent déjà. |
Onglet Contrôle d’accès | Afficher les autorisations en fonction du chemin actuel, du niveau du référentiel ou du chemin principal. Les autorisations sont décomposées en - Politiques de contrôle d’accès applicables : politiques qui peuvent être appliquées à la sélection en cours. - Stratégies de contrôle d’accès local : stratégies actuelles appliquées localement à la sélection en cours. - Stratégies de contrôle d’accès en vigueur : les stratégies actuelles appliquées à la sélection en cours peuvent être définies localement ou héritées des nœuds parents. Remarque. Pour pouvoir voir les informations de contrôle d’accès, l’utilisateur connecté à CRXDE Lite doit avoir le droit de lire les entrées ACL. Par défaut, l’utilisateur anonyme ne peut pas voir cette information - veuillez vous connecter sous admin par ex., pour voir les informations. |
Onglet Réplication | Affiche l’état de la réplication du nœud actif. Vous pouvez répliquer et supprimer la réplication du nœud actif. |
Onglet Console |
Journaux de serveur : Affiche les messages de journaux. Vous pouvez configurer le niveau de journalisation, effacer la console, épingler à la position de défilement sélectionnée et activer/désactiver l’affichage des messages. Gestion de version : Affiche les messages de gestion des versions. |
Onglet Infos sur le build |
Affiche des informations lors de la création d’un bundle. |
Actualiser |
Actualise la sélection actuelle. Les modifications des autres utilisateurs sont mises à jour dans votre vue du référentiel. Les modifications que vous avez apportées ne sont pas concernées. |
Enregistrer tout | Enregistrer tout : Enregistre tous les changements que vous avez apportés. Tant que vous ne cliquez pas sur Enregistrer, les modifications sont temporaires. Elles seront perdues lorsque vous quitterez la console. Rétablir : Ignore toutes les modifications que vous avez apportées au nœud sélectionné depuis le dernier enregistrement, puis recharge l’état actuel du référentiel pour le nœud sélectionné. Tout rétablir : Ignore toutes les modifications que vous avez apportées au référentiel entier depuis le dernier enregistrement, puis recharge l’état actuel du référentiel. |
Créer ... |
Menu déroulant permettant de créer les éléments suivants sous le nœud sélectionné : - Nœud : nœud avec un type de nœud arbitraire - Fichier : nœud nt:file et son sous-nœud nt:resource - Dossier : nœud nt:folder - Modèle : modèle AEM - Composant : composant AEM - Boîte de dialogue : boîte de dialogue AEM |
Supprimer |
Supprime le nœud sélectionné. |
Copier | Copie le nœud sélectionné. |
Coller |
Colle le nœud copié sous le nœud sélectionné. |
Déplacer ... |
Déplace le nœud sélectionné vers le nœud défini dans la boîte de dialogue. |
Renommer ... |
Renomme le nœud sélectionné. |
Mixins ... |
Permet d’ajouter des types mixin au type de nœud. Les types mixin sont principalement utilisés pour ajouter des fonctionnalités avancées telles que la gestion des versions, le contrôle d’accès, le référencement et le verrouillage du nœud. |
Outils |
Menu déroulant avec les outils suivants : - Config serveur ... : pour accéder à la console Felix. - Requête ... : pour interroger le référentiel. - Privilèges ... : pour ouvrir la gestion des privilèges, laquelle permet d’afficher et d’ajouter des privilèges. - Test du contrôle d’accès ... : emplacement où vous pouvez tester l’autorisation pour certains chemins et/ou le chemin principal. - Exporter le type de nœud : pour exporter les types de nœud dans le système en tant que notation cnd. - Importer le type de nœud ... : pour importer les types de nœud en utilisant la notation cnd. - Installer le débogueur SiteCatalyst ... : instructions sur l’installation de Analytics Debugger. |
Widget de connexion |
Affiche les utilisateurs actuellement connectés et l’espace de travail auquel ils sont connectés, par exemple, admin@crx.default. Cliquez dessus pour vous connecter ou vous reconnecter en tant qu’utilisateur spécifique. Si vous ne spécifiez pas d’espace de travail auquel vous connecter, vous serez connecté à l’espace de travail par défaut, crx.default. Si vous souhaitez parcourir le référentiel en tant qu’utilisateur anonyme, utilisez anonymous comme nom de connexion et n’importe quel mot de passe (par exemple, un espace ou un point). Si votre autorisation n’est plus valide (par exemple, elle a expiré), le widget de connexion affiche « Connexion - Non autorisée ... ». Cliquez dessus pour vous reconnecter. |
Pour créer un dossier avec CRXDE Lite :
Ouvrez CRXDE Lite dans un navigateur.
Dans le volet de navigation, cliquez avec le bouton droit sur le dossier sous lequel vous souhaitez créer le nouveau dossier, sélectionnez Créer…, puis Créer un dossier….
Entrez le nom du dossier et cliquez sur OK.
Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.
Pour créer un modèle avec CRXDE Lite :
Ouvrez CRXDE Lite dans un navigateur.
Dans le volet de navigation, cliquez avec le bouton droit sur le dossier dans lequel vous souhaitez créer le modèle, sélectionnez Créer …, puis Créer un modèle ….
Définissez les champs Libellé, Titre, Description, Type de ressource et Classement du modèle. Cliquez sur Suivant.
Cette étape est facultative : définissez Chemins autorisés. Cliquez sur Suivant.
Cette étape est facultative : définissez les Parents autorisés. Cliquez sur Suivant.
Cette étape est facultative : définissez les Enfants autorisés. Cliquez sur OK.
Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.
Cela crée :
un nœud de type cq:Template
avec les propriétés du modèle ;
un nœud enfant de type cq:PageContent
avec les propriétés de contenu de page.
Vous pouvez ajouter des propriétés à votre modèle : reportez-vous à la section Création d’une propriété.
La fonctionnalité décrite ici n’est disponible que si CQ5 est installé, c’est-à-dire si le type de nœud cq:Component
est disponible dans le référentiel.
Pour créer un composant avec CRXDE Lite :
Ouvrez CRXDE Lite dans un navigateur.
Dans le volet de navigation, cliquez avec le bouton droit sur le dossier dans lequel vous souhaitez créer le composant, sélectionnez Créer …, puis Créer un composant ….
Définissez les champs Libellé, Titre, Description, Super type ressource et Groupe du modèle. Cliquez sur Suivant.
Cette étape est facultative : définissez les propriétés du composant Est conteneur, Pas de décoration, Nom de cellule et Chemin de la boîte de dialogue. Cliquez sur Suivant.
Cette étape est facultative : définissez la propriété de composant Parents autorisés. Cliquez sur Suivant.
Cette étape est facultative : définissez la propriété de composant Enfant autorisé. Cliquez sur OK.
Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.
Cela crée :
cq:Component
.Pour créer une boîte de dialogue avec CRXDE Lite :
Ouvrez CRXDE Lite dans un navigateur.
Dans le volet de navigation, cliquez avec le bouton droit sur le composant dans lequel vous souhaitez créer la boîte de dialogue, sélectionnez Créer …, puis Créer une boîte de dialogue ….
Entrez le Libellé et le Titre. Cliquez sur OK.
Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.
Il crée une boîte de dialogue avec la structure suivante :
dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]
Vous pouvez désormais adapter la boîte de dialogue à vos besoins en modifiant les propriétés ou en ajoutant de nouveaux nœuds.
Vous pouvez également utiliser l’éditeur de boîte dialogue pour modifier une boîte de dialogue. Un double-clic sur le nœud dialog dans CRXDE Lite fait apparaître l’éditeur. Plus d’informations sur l’éditeur de boîte de dialogue sont disponibles ici.
Pour créer un nœud avec CRXDE Lite :
Vous pouvez désormais adapter le nœud à vos besoins en modifiant les propriétés ou en ajoutant de nouveaux nœuds.
La plupart des opérations de modification, y compris Créer un nœud, conserve toutes les modifications en mémoire et les stocke dans le référentiel lors de l’enregistrement uniquement (avec le bouton Enregistrer tout). Cependant, certaines opérations telles que le déplacement sont automatiquement conservées.
La validation du nœud nouvellement créé qui est ou non autorisé par le type de nœud du nœud parent est également effectuée par le référentiel JCR en premier, lors de l’enregistrement des modifications. Si vous recevez un message d’erreur lors de l’enregistrement d’un nœud, vérifiez si la structure du contenu est valide (par exemple, vous ne pouvez pas créer un nœud nt:unstructured
en tant qu’enfant du nœud nt:folder
).
Pour créer une propriété avec CRXDE Lite :
Ouvrez CRXDE Lite dans un navigateur.
Dans le volet de navigation, sélectionnez le nœud dans lequel vous souhaitez ajouter la nouvelle propriété.
Dans l’onglet Propriétés du volet inférieur, entrez le Nom, le Type et la Valeur. Cliquez sur Ajouter.
Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.
Pour créer un script :
Ouvrez CRXDE Lite dans un navigateur.
Dans le volet de navigation, cliquez avec le bouton droit sur le composant dans lequel vous souhaitez créer le script, sélectionnez Créer …, puis Créer un fichier ….
Entrez le nom du fichier, y compris son extension. Cliquez sur OK.
Le nouveau fichier s’ouvre en tant qu’onglet dans le volet de modification.
Modifiez le fichier.
Cliquez sur Enregistrer tout pour enregistrer les modifications.
Pour exporter une définition de type de nœud :
Ouvrez CRXDE Lite dans un navigateur.
Sélectionnez le nœud en question.
Sélectionnez Outils, puis Exporter le type de nœud.
La définition, en notation cnd, est affichée dans votre navigateur. Enregistrez les informations si nécessaire.
Pour importer une définition de type de nœud :
Ouvrez CRXDE Lite dans un navigateur.
Sélectionnez Outils, puis Importer le type de nœud….
Entrez la notation CND pour la définition dans la zone de texte.
Cochez Autoriser la mise à jour si vous mettez à jour une définition existante.
Cliquez sur Importer.
CRXDE Lite permet d’afficher le fichier error.log
qui se trouve sur le système de fichiers sous <crx-install-dir>/crx-quickstart/server/logs
et de filtrer selon le niveau de journalisation approprié. Procédez comme suit :
Ouvrez CRXDE Lite dans un navigateur.
Dans l’onglet Console en bas de la fenêtre, dans le menu déroulant à droite, sélectionnez Journaux de serveur.
Cliquez sur l’icône Stop pour afficher les messages.
Vous pouvez :
Consultez Administration des utilisateurs, groupes et droits d’accès pour plus d’informations.