DocumentationAEM 6.4Guide de développement

Développement dans CRXDE Lite developing-with-crxde-lite

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Developer
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Cette section décrit comment développer votre application AEM à l’aide de CRXDE Lite.

Pour plus d’informations sur les différents environnements de développement disponibles, reportez-vous à la documentation de présentation .

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.

NOTE
À partir de la version 6.4.8.1 d’AEM, l’accès anonyme de CRXDE Lite n’est plus possible.
Les utilisateurs sont redirigés vers l’écran de connexion.
NOTE
Il est recommandé d’utiliser la variable AEM Outils de développement pour Eclipse et le AEM extension HTL Brackets pendant le développement du projet.

Prise en main de CRXDE Lite getting-started-with-crxde-lite

Pour commencer à utiliser CRXDE Lite, procédez comme suit :

  1. Installez AEM.

  2. Dans votre navigateur, saisissez https://<host>:<port>/crx/de. Par défaut, le paramètre est http://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-238

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

Présentation de l’interface utilisateur overview-of-the-user-interface

CRXDE Lite offre les fonctionnalités suivantes :

Barre de commutation supérieure
Permet de basculer rapidement entre CRXDE Lite, Package Manager et Package Share.
Widget de chemin de noeud

Affiche le chemin d’accès au noeud actuellement sélectionné.

Vous pouvez également l’utiliser pour accéder à un noeud, en entrant le chemin à la main ou en le collant à partir d’un autre emplacement, puis 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. Si vous souhaitez effectuer une recherche dans l’ensemble du référentiel, utilisez Outils, puis Requête.

Volet Explorateur

Affiche une arborescence de tous les noeuds 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 de nouveau sur le noeud 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 Modifier

Accueil tab : vous permet de rechercher du contenu et/ou de la documentation et d’accéder aux ressources des développeurs (documentation, blog de développeur, base de connaissances) et à l’assistance (page d’accueil et centre d’assistance d’Adobe).

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 qu’un fichier est modifié dans la fonction 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.
- Rechercher/remplacer...: effectuez une recherche ou un remplacement.

Double-cliquez sur la ligne d’état du Modifier ouvre la fenêtre Aller à la ligne pour saisir un numéro de ligne spécifique à laquelle vous souhaitez 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 d’accès, du niveau du référentiel ou de l’entité de sécurité actuelle.

Les autorisations sont divisées en

- Stratégie de contrôle d’accès applicable: Stratégies pouvant être appliquées à la sélection en cours.

- Stratégies de contrôle d’accès locales: Stratégies actuelles appliquées localement à la sélection actuelle.

- Stratégies de contrôle d’accès efficaces: Les stratégies actuelles appliquées à la sélection actuelle peuvent être définies localement ou héritées des noeuds 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. L’utilisateur anonyme ne peut pas voir ces informations par défaut. Connectez-vous en tant qu’administrateur, par exemple 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 du 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 contrôle de version.

Onglet Infos sur le build
Affiche des informations lorsqu’un lot est en cours de création.
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 n’avez pas cliqué sur Enregistrer, les modifications sont temporaires et seront perdues lorsque vous quitterez la console.

Rétablir  :

Ignore toutes les modifications que vous avez apportées au noeud sélectionné depuis la dernière action d’enregistrement, puis recharge l’état actuel du référentiel pour le noeud sélectionné.

Tout rétablir:

Ignore toutes les modifications que vous avez apportées à l’ensemble du référentiel depuis la dernière action d’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 noeud sélectionné :

- Noeud: un noeud avec un type de noeud arbitraire ;

- Fichier  : nœud nt:file et son sous-nœud nt:resource

- Dossier: nt:folder node

- Modèle: Modèle AEM

- Composant: Composant AEM

- Boîte de dialogue: Boîte de dialogue AEM

Supprimer
Supprime le noeud sélectionné.
Copier
Copie le noeud sélectionné.
Coller
Colle le nœud copié sous le nœud sélectionné.
Déplacer ...
Déplace le noeud sélectionné vers le noeud défini dans la boîte de dialogue.
Renommer ...
Renomme le noeud sélectionné.
Mixins ...
Permet d’ajouter des types mixin au type de nœud. Les types de mixin sont principalement utilisés pour ajouter des fonctionnalités avancées telles que le contrôle de version, le contrôle d’accès, le référencement et le verrouillage au noeud.
Outils

Menu déroulant avec les outils suivants :

- Configuration du serveur ...: pour accéder à la console Felix.

- Requête ...: pour interroger le référentiel.

- Privilèges ...: pour ouvrir la gestion des privilèges, où vous pouvez afficher et ajouter des privilèges.

- Tester le contrôle d’accès ...: un emplacement où vous pouvez tester l’autorisation pour un chemin et/ou une entité.

- Exporter le type de noeud: pour exporter les types de noeud dans le système en tant que notation cnd.

- Importer le type de noeud...: pour importer des types de noeuds à l’aide de la notation cnd.

- Installer SiteCatalyst Debugger...: instructions sur l’installation d’Analytics Debugger.

Widget de connexion

Affiche les utilisateurs actuellement connectés et l’espace de travail dans lequel 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 anonyme comme nom de connexion et tout 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 creating-a-folder

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 creating-a-template

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.

Il crée les éléments suivants :

  • 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 creating-a-component

La fonctionnalité décrite ici n’est disponible que si le type de noeud 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.

Il crée les éléments suivants :

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

Création d’une boîte de dialogue creating-a-dialog

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 l 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 maintenant adapter la boîte de dialogue à vos besoins en modifiant les propriétés ou en créant de nouveaux noeuds.

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. Vous trouverez plus d’informations sur l’éditeur de boîte de dialogue here.

Création d’un nœud creating-a-node

Pour créer un noeud 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.

NOTE
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é creating-a-property

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 creating-a-script

Pour créer un script :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. Dans le volet de navigation, cliquez avec le bouton droit de la souris sur le composant dans lequel vous souhaitez créer le script, puis 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 sous la forme d’un onglet dans le volet Modifier.

  5. Modifiez le fichier.

  6. Cliquez sur Enregistrer tout pour enregistrer les modifications.

Exportation et importation de types de nœuds exporting-and-importing-node-types

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 noeud :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. Sélectionnez le noeud requis.

  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 noeud :

  1. Ouvrez CRXDE Lite dans un navigateur.

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

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

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

  5. Cliquez sur Importer.

Journalisation logging

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 le Console au bas de la fenêtre, dans le menu déroulant à droite, sélectionnez Journaux du serveur.

  3. Cliquez sur le bouton Arrêter 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.
  • Effacez les messages en cliquant sur le bouton Pinceau icône .
  • É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 access-control

NOTE
Consultez Administration des utilisateurs, groupes et droits d’accès pour plus d’informations.
recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e