Développement dans 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.

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

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

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

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 noeud

Affiche le chemin d’accès au noeud 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 é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. 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 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 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 onglet : vous permet de rechercher du contenu et/ou de la documentation et d’accéder aux ressources des développeurs (documentation, blog des développeurs, 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 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é.

Les autorisations sont divisées en

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

Tout rétablir:

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

- Noeud: un noeud avec un type de noeud arbitraire

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

- Dossier: noeud nt:folder

- 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 de mixin au type de noeud. 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 ...: emplacement où vous pouvez tester l’autorisation pour un certain chemin et/ou une entité de sécurité.

- Exporter le type de noeud: pour exporter les types de noeuds 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 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

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

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.

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

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

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

Création d’un nœud

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

REMARQUE

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é

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

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 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, s’affiche 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

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

REMARQUE

Sur cette page