Développement dans CRXDE Lite

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.

REMARQUE

À 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.

REMARQUE

Il est recommandé d’utiliser AEM Developer Tools for Eclipse et AEM HTL Brackets Extension pendant le développement du projet.

Prise en main de CRXDE Lite

Pour commencer avec CRXDE Lite, procédez comme suit :

  1. Installez AEM.

  2. Dans votre navigateur, entrez https://<host>:<port>/crx/de. Par défaut, le paramètre est https://localhost:4502/crx/de.

  3. Entrez votre nom d’utilisateur et votre mot de passe. Par défaut, il s’agit de admin et admin.

  4. Cliquez sur OK.

L’interface utilisateur de CRXDE Lite est la suivante dans votre navigateur :

chlimage_1-18

Vous pouvez désormais utiliser CRXDE Lite pour développer votre application.

Présentation de l’interface utilisateur

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 :

- Afficher dans l’arborescence : affiche le fichier dans l’arborescence du référentiel.
- 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.

Création d’un dossier

Pour créer un dossier avec CRXDE Lite :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. 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….

  3. Entrez le nom du dossier et cliquez sur OK.

  4. Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.

Création d’un modèle

Pour créer un modèle avec CRXDE Lite :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. 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 ….

  3. Définissez les champs Libellé, Titre, Description, Type de ressource et Classement du modèle. Cliquez sur Suivant.

  4. Cette étape est facultative : définissez Chemins autorisés. Cliquez sur Suivant.

  5. Cette étape est facultative : définissez les Parents autorisés. Cliquez sur Suivant.

  6. Cette étape est facultative : définissez les Enfants autorisés. Cliquez sur OK.

  7. 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é.

Création d’un composant

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 :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. 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 ….

  3. Définissez les champs Libellé, Titre, Description, Super type ressource et Groupe du modèle. Cliquez sur Suivant.

  4. 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.

  5. Cette étape est facultative : définissez la propriété de composant Parents autorisés. Cliquez sur Suivant.

  6. Cette étape est facultative : définissez la propriété de composant Enfant autorisé. Cliquez sur OK.

  7. Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.

Cela crée :

  • un nœud de type cq:Component.
  • Les propriétés du composant
  • Un script .jsp de composant

Création d’une boîte de dialogue

Pour créer une boîte de dialogue avec CRXDE Lite :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. 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 ….

  3. Entrez le Libellé et le Titre. Cliquez sur OK.

  4. 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.

Création d’un nœud

Pour créer un nœud avec CRXDE Lite :

  1. Ouvrez CRXDE Lite dans un navigateur.
  2. Dans le volet de navigation, cliquez avec le bouton droit sur le nœud où vous souhaitez créer le nouveau nœud, sélectionnez Créer …, puis Créer un nœud ….
  3. Entrez le Nom et le Type. Cliquez sur OK.
  4. Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.

Vous pouvez désormais adapter le nœud à vos besoins en modifiant les propriétés ou en ajoutant de nouveaux nœuds.

REMARQUE

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).

Création d’une propriété

Pour créer une propriété avec CRXDE Lite :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. Dans le volet de navigation, sélectionnez le nœud dans lequel vous souhaitez ajouter la nouvelle propriété.

  3. Dans l’onglet Propriétés du volet inférieur, entrez le Nom, le Type et la Valeur. Cliquez sur Ajouter.

  4. Cliquez sur Enregistrer tout pour enregistrer les modifications sur le serveur.

Création d’un script

Pour créer un script :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. 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 ….

  3. Entrez le nom du fichier, y compris son extension. Cliquez sur OK.

  4. Le nouveau fichier s’ouvre en tant qu’onglet dans le volet de modification.

  5. Modifiez le fichier.

  6. Cliquez sur Enregistrer tout pour enregistrer les modifications.

Exportation et importation de types de nœuds

Avec CRXDE Lite, vous pouvez importer et exporter des définitions de type de nœud dans la notation CND (Compact Namespace et Node Type Definition).

Pour exporter une définition de type de nœud :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. Sélectionnez le nœud en question.

  3. Sélectionnez Outils, puis Exporter le type de nœud.

  4. 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 :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. Sélectionnez Outils, puis Importer le type de nœud….

  3. Entrez la notation CND pour la définition dans la zone de texte.

  4. Cochez Autoriser la mise à jour si vous mettez à jour une définition existante.

  5. Cliquez sur Importer.

Journalisation

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 :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. Dans l’onglet Console en bas de la fenêtre, dans le menu déroulant à droite, sélectionnez Journaux de serveur.

  3. Cliquez sur l’icône Stop pour afficher les messages.

Vous pouvez :

  • Ajuster les paramètres du journal dans la console Felix en cliquant sur l’icône Configurations de journalisation.
  • Effacer les messages en cliquant sur l’icône Pinceau.
  • Épingler le message à la sélection en cours en cliquant sur l’icône Épingler.
  • Activer ou désactiver l’affichage des messages en cliquant sur l’icône Stop.

Contrôle d’accès

REMARQUE

Sur cette page