Génération de modèles automatique scaffolding
Il peut arriver que vous deviez créer un grand nombre de pages qui partagent la même structure mais dont le contenu est différent. Par le biais de l’interface standard d'Adobe Experience Manager (AEM), vous devez créer chaque page, faire glisser les composants appropriés sur la page et remplir chacune d’elles individuellement.
Grâce à la fonction de génération de modèles automatiques, vous pouvez créer un formulaire (un modèle automatique) avec des champs qui reflètent la structure que vous souhaitez pour vos pages, puis utiliser ce formulaire pour créer facilement des pages basées sur cette structure.
Fonctionnement de la génération de modèles automatique how-scaffolding-works
Les modèles automatiques sont stockés dans la console Outils de l’administrateur du site.
- Ouvrez la console Outils puis cliquez sur Génération de modèles automatiques de page par défaut.
- Cliquez ensuite sur Geometrixx.
- Sous Geometrixx, vous trouverez une page de modèle automatique appelée News. Double-cliquez pour ouvrir cette page.
Le modèle automatique est constitué d’un formulaire avec un champ pour chaque élément de contenu qui compose la page à créer et de quatre paramètres importants accessibles par le biais des propriétés de page de la page du modèle automatique.
Les propriétés de la page de génération de modèles automatique sont les suivantes :
- Texte du titre : il s’agit du nom de cette page de génération de modèles automatique. Dans cet exemple, elle s’appelle « News ».
- Description : elle s’affiche sous le titre de la page de génération de modèles automatique.
- Modèle cible : il s’agit du modèle que ce modèle automatique utilisera lors de la création d’une page. Dans cet exemple, il s’agit d’un modèle de page de contenu Geometrixx.
- Chemin d'accès cible : il s’agit du chemin d’accès de la page parente au-dessous de laquelle ce modèle automatique créera de nouvelles pages. Dans cet exemple, le chemin d’accès est /content/geometrixx/en/news.
Le contenu du modèle automatique est le formulaire. Lorsqu’un utilisateur souhaite crée une page à l’aide du modèle automatique, il remplit le formulaire et clique sur Créer, au bas du formulaire. Dans l’exemple Actualités ci-dessus, le formulaire se compose des champs suivants :
- Titre : il s’agit du nom de la page à créer. Ce champ est toujours présent sur chaque modèle automatique.
- Texte : ce champ correspond à un composant de texte sur la page qui en résulte.
- Image : ce champ correspond à un composant Image sur la page qui en résulte.
- Image/Avancé : Titre : titre de l’image.
- Image/Avancé : Texte de remplacement : texte de remplacement de l’image.
- Image / Avancé : Description : description de l’image.
- Image/Avancé : Taille : taille de l’image.
- Balises/Mots-clés : métadonnées à affecter à cette page. Ce champ est toujours présent sur chaque modèle automatique.
Créer un modèle automatique creating-a-scaffold
Pour créer un nouveau modèle automatique, accédez à la console Outils, puis cliquez sur Génération de modèles automatiques de page par défaut et créez une page. Un seul type de modèle de page est disponible : Modèle de génération de modèles automatique.
Accédez aux Propriétés de la page de la nouvelle page et définissez le texte du titre, la description, le modèle cible et le chemin d'accès cible, comme décrit ci-dessus.
Vous devez ensuite définir la structure de la page qui sera créée par ce modèle automatique. Pour ce faire, accédez au mode Conception dans la page de modèle automatique. Un lien s’affiche alors pour vous permettre de modifier le modèle automatique dans l’éditeur de boîte de dialogue.
À l’aide de l’éditeur de boîte de dialogue, spécifiez les propriétés qui seront créées chaque fois qu’une nouvelle page est créée à l’aide de ce modèle automatique.
La définition de boîte de dialogue d’un modèle automatique fonctionne de la même manière que celle d’un composant (voir Composants). Toutefois, quelques différences importantes existent :
- Les définitions de boîte de dialogue de composant sont rendues comme des boîtes de dialogue normales (comme illustré dans le volet central de l’éditeur de boîte de dialogue, par exemple), tandis que les définitions de boîte de dialogue de modèle automatique, bien qu’elles apparaissent comme des boîtes de dialogue normales dans l’éditeur de boîte de dialogue, sont rendues sur la page de modèle automatique sous la forme d’un formulaire de modèle automatique (comme illustré dans le modèle automatique News ci-dessus).
- Les boîtes de dialogue de composant ne contiennent que les champs nécessaires pour définir le contenu d’un seul composant spécifique. Une boîte de dialogue de modèle automatique doit fournir des champs pour chaque propriété de chaque paragraphe de la page à créer.
- Dans le cas des boîtes de dialogue de composant, le composant utilisé pour le rendu du contenu spécifié est implicite. Par conséquent, la propriété
sling:resourceTypedu paragraphe est complétée automatiquement lors de la création du paragraphe. Avec un modèle automatique, toutes les informations définissant le contenu et le composant affecté pour un paragraphe donné doivent être fournies par la boîte de dialogue elle-même. Dans les boîtes de dialogue de modèle automatique, ces informations doivent être fournies en utilisant les champs masqués pour envoyer ces informations lors de la création de la page.
Un aperçu de l’exemple de la boîte de dialogue de modèle automatique News dans l’éditeur de boîte de dialogue permet d’expliquer comment cela fonctionne. Passez en mode conception sur la page du modèle automatique, puis cliquez sur le lien de l’éditeur de boîte de dialogue.
Cliquez à présent sur le champ de la boîte de dialogue Boîte de dialogue > Volet Onglets > Texte > Texte, comme illustré ci-dessous :
La liste des propriétés de ce champ s’affiche sur le côté droit de l’éditeur de boîte de dialogue, comme ceci :
Notez la propriété de nom de ce champ. Sa valeur est
./jcr:content/par/text/text
Il s’agit du nom de la propriété pour laquelle le contenu de ce champ sera écrit lorsque le modèle automatique est utilisé pour créer une page. La propriété est indiquée comme chemin relatif à partir du nœud représentant la page à créer. Il spécifie le texte de propriété, sous le texte du nœud, qui se trouve sous le nœud par, qui est lui-même un enfant du nœud jcr:content sous le nœud de page.
Cela définit l’emplacement de stockage du contenu pour le texte qui sera saisi dans ce champ. Cependant, nous devons également spécifier deux caractéristiques supplémentaires pour ce contenu :
- le fait que la chaîne en cours de stockage ici doit être interprétée comme texte enrichi ; et
- le composant à utiliser pour effectuer le rendu de ce contenu sur la page qui en résulte.
Dans une boîte de dialogue de composant normale, vous n’avez pas à spécifier ces informations, car implicitement, la boîte de dialogue est déjà liée à un composant spécifique.
Pour spécifier ces deux informations, vous utilisez des champs masqués. Cliquez sur le premier champ masqué Boîte de dialogue > Volet Onglets > Texte > Masqué, comme illustré ci-dessous :
Les propriétés de ce champ masqué sont les suivantes :
La propriété name de ce champ masqué est
./jcr:content/par/text/textIsRich
Il s’agit d’une propriété booléenne utilisée pour interpréter la chaîne de texte stockée à l’adresse ./jcr:content/par/text/text.
Puisque nous savons que le texte doit être interprété comme un texte enrichi, nous définissons la propriété value de ce champ sur true.
Le second champ masqué est visible en cliquant dessus comme suit :
Les propriétés de ce champ masqué sont les suivantes :
La propriété name de ce champ masqué est
./jcr:content/par/text/sling:resourceType
et la valeur fixe spécifiée pour cette propriété est
foundation/components/textimage
Cela indique que le composant à utiliser pour effectuer le rendu du contenu texte de ce paragraphe est le composant Texte et Image. La valeur booléenne isRichText spécifiée dans l’autre champ masqué permet au composant d’effectuer le rendu de la chaîne de texte réelle stockée dans ./jcr:content/par/text/text de la manière choisie.
Génération de modèles automatique avec l’héritage du MSM scaffolding-with-msm-inheritance
Dans l’IU classique, la génération de modèles automatique est entièrement intégrée à l’héritage du MSM (le cas échéant).
Lorsque vous ouvrez une page en mode Génération de modèles automatique (à l’aide de l’icône située dans la partie inférieure du sidekick), tous les composants soumis à l’héritage sont indiqués par :
- un cadenas (pour la plupart des composants, par exemple Texte et Titre) ;
- un masque avec le texte Cliquer pour annuler l’héritage (pour les composants Image).
Ces deux indications montrent que le composant ne peut pas être modifié, tant que l’héritage n’a pas été annulé.
Cliquez sur le verrou ou sur l’icône d’image pour rompre l’héritage :
- Le symbole se transforme en cadenas ouvert.
- Une fois déverrouillé, vous pouvez modifier le contenu.
Après le déverrouillage, vous pouvez restaurer l’héritage en cliquant sur le symbole de cadenas ouvert. Vous perdrez les modifications que vous avez apportées.