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

Cette section décrit comment développer votre application Adobe Experience Manager (AEM) à l’aide de CRXDE Lite.

Consultez 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. CRXDE Lite vous permet de créer un projet, de créer et de modifier des fichiers (tels que .jsp et .java), des dossiers, des modèles, des composants, des boîtes de dialogue, des noeuds, des propriétés et des lots lors de la journalisation.
CRXDE Lite est recommandé lorsque vous n’avez pas d’accès direct au serveur AEM. Ou, lorsque vous développez une application en étendant ou modifiant les composants prêts à l’emploi et les lots Java™, ou lorsque vous n’avez pas besoin d’un débogueur dédié, la fin du code et la mise en surbrillance de la syntaxe.

NOTE
À 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.
NOTE
Adobe recommande d’utiliser la variable AEM Outils de développement pour Eclipse et la variable 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, 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 overview-of-the-user-interface

CRXDE Lite offre les fonctionnalités suivantes :

Barre de commutation supérieure
Basculez rapidement entre CRXDE Lite, Package Manager et Package Share.
Widget de chemin de nœud

Affiche le chemin d’accès au noeud 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 également de rechercher des noeuds avec un nom de noeud spécifique. Saisissez le nom du noeud que vous souhaitez rechercher et patientez (ou appuyez sur le symbole de recherche sur le côté droit). Vous pouvez essayer de saisir, par exemple, la chaîne oak dans le widget pour voir comment il fonctionne. Si un ou plusieurs noeuds 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. Il ne fonctionne que pour les noeuds 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 noeud afin d’afficher ses propriétés dans le 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 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  : vous permet de rechercher du contenu et/ou de la documentation et d’accéder aux ressources des développeurs et développeuses (documentation, blog de développement, base de connaissances) et à l’assistance (page d’accueil et centre d’assistance d’Adobe).

Cliquez deux fois sur un fichier dans la variable Explorateur pour afficher son contenu. Par exemple, un fichier .jsp ou .java . Vous pouvez ensuite le modifier et enregistrer les modifications.

Une fois le fichier modifié dans le volet de modification, 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...  : permet d’effectuer 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é.

Les autorisations sont classées comme suit.

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

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

- Stratégies de contrôle d’accès efficaces: les stratégies appliquées à la sélection peuvent être définies localement ou héritées des noeuds parents.

Remarque. Pour pouvoir visualiser les informations de contrôle d’accès, l’utilisateur connecté au CRXDE Lite doit disposer de droits d’accès en lecture aux entrées ACL. Par défaut, l’utilisateur anonyme ne peut pas afficher ces informations : connectez-vous en tant qu’administrateur pour voir les informations, par exemple.

Onglet Réplication
Affichez l’état de réplication du noeud. Vous pouvez répliquer et répliquer et supprimer le noeud.
Onglet Console

Journaux de serveur  :

Affiche les messages de journaux. Vous pouvez configurer le niveau de journal, effacer la console, épingler à la position de défilement sélectionnée et activer ou désactiver l’affichage des messages.

Gestion de version  :

Affiche les messages de gestion de versions.

Onglet Infos sur le build
Affiche des informations lorsqu’un lot est en cours de création.
Actualiser
Actualise la sélection. 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 affectées.
Enregistrer tout

Enregistrer tout  :

Enregistre toutes les modifications que vous avez apportées. Tant que vous n’avez pas cliqué sur Enregistrer, les modifications sont temporaires et perdues lorsque vous quittez 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 du référentiel pour le noeud sélectionné.

Rétablir tout  :

Ignore toutes les modifications que vous avez apportées dans tout le référentiel depuis la dernière action d’enregistrement, puis recharge l’état du référentiel.

Créer ...

Menu déroulant permettant de créer les éléments suivants sous le noeud sélectionné :

Nœud  : un nœud de type 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 le contrôle de version, le contrôle d’accès, le référencement et le verrouillage au nœud.
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 ...: emplacement où vous pouvez tester l’autorisation pour un certain chemin et/ou une entité de sécurité.

- 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 SiteCatalyst Debugger  : instructions pour l’installation d’Analytics Debugger.

Widget de connexion

Affiche les utilisateurs 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 comme un utilisateur spécifique. Si vous ne spécifiez pas d’espace de travail auquel vous connecter, vous êtes 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 "Non autorisé - Connexion...". 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 dossier, puis 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. Saisissez le 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.

Les éléments suivants sont alors créés :

  • 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 : voir Création d’une propriété .

Création d’un composant creating-a-component

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. Saisissez le Libellé, Titre, Description, Super Resource Type, et Groupe du composant. Cliquez sur Suivant.

  4. Cette étape est facultative : définissez les propriétés du composant. Conteneur , Pas de décoration, Nom de la 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.

Les éléments suivants sont alors créés :

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

Une boîte de dialogue est alors créée sous 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 des noeuds.

Vous pouvez également utiliser l’éditeur de boîte dialogue pour modifier une boîte de dialogue. Double-cliquez sur le noeud dialog dans CRXDE Lite pour afficher l’éditeur. Vous trouverez ici plus d’informations sur l’éditeur de boîte de dialogue.

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

Pour créer un nœud avec CRXDE Lite, procédez comme suit :

  1. Ouvrez CRXDE Lite dans un navigateur.
  2. Dans le volet de navigation, cliquez avec le bouton droit sur le noeud dans lequel vous souhaitez créer le noeud, puis sélectionnez Créer …, puis Créer un noeud ….
  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 noeud à vos besoins en modifiant les propriétés ou en créant des noeuds.

NOTE
La plupart des opérations de modification, y compris Create Node, conservent toutes les modifications en mémoire et les stockent uniquement dans le référentiel lors de l’enregistrement (au moyen du bouton "Enregistrer tout"). Cependant, certaines opérations telles que le déplacement sont automatiquement conservées.
La validation portant sur l’autorisation du noeud nouvellement créé par le type de noeud du noeud parent est également effectuée en premier par le référentiel JCR lors de l’enregistrement des modifications. Si vous recevez un message d’erreur lors de l’enregistrement d’un noeud, vérifiez si la structure de contenu est valide (vous ne pouvez pas créer un nt:unstructured noeud en tant qu’enfant de 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 le Propriétés dans le volet inférieur, saisissez la Nom, la variable Type, et la variable Valeur. Cliquez sur Ajouter.

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

Créer un script creating-a-script

Pour créer un script :

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. Dans le volet Explorateur, cliquez avec le bouton droit sur le composant dans lequel vous souhaitez créer le fichier, 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 exporting-and-importing-node-types

Avec CRXDE Lite, vous pouvez importer et/ou exporter des définitions de type de noeud dans Notation CND (Compact Namespace et définition de type de noeud).

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

  1. Ouvrez CRXDE Lite dans un navigateur.

  2. Sélectionnez le nœud requis.

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

  4. La définition, en notation cnd, s’affiche 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. Saisissez la notation CND pour la définition dans la zone de texte.

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

  5. Cliquez sur Importer.

Journalisation logging

Avec CRXDE Lite, vous pouvez afficher le fichier error.log qui se trouve sur le système de fichiers à l’adresse <crx-install-dir>/crx-quickstart/server/logs et filtrez-le avec le niveau de journalisation approprié. Procédez comme suit :

  1. Ouvrez CRXDE Lite dans un navigateur.

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

  3. Cliquez sur l’icône Arrêter pour afficher les messages.

Vous pouvez effectuer les actions suivantes :

  • 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 l’icône Pinceau.
  • Epinglez le message à la sélection en cliquant sur le bouton Epinglage Icône
  • Activer ou désactiver l’affichage des messages en cliquant sur l’icône Stop.

Contrôle d’accès access-control

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2