Génération de modèles automatique scaffolding

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.

Il peut arriver que vous deviez créer un grand ensemble de pages partageant la même structure mais ayant un contenu différent. Par le biais de l’interface d’AEM standard, vous devez créer chaque page, faire glisser les composants appropriés sur la page et remplir chacune d’elles individuellement.

Avec la génération de modèles automatique, vous pouvez créer un formulaire (un modèle automatique) avec des champs qui reflètent la structure souhaitée pour vos pages, puis utiliser ce formulaire pour créer facilement des pages en fonction de cette structure.

NOTE
La génération de modèles automatique (IU classique) respecte l’héritage du MSM.

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 le Outils puis cliquez sur Génération de modèles automatique de page par défaut.

  • Sous ce clic, geometrixx.

  • Sous geometrixx vous trouverez un page scaffold appelé News. Double-cliquez pour ouvrir cette page.

howscaffolds_work

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.

pageprops

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, il s’appelle "News".

  • Description: Celui-ci 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’une Page de contenu Geometrixx modèle.

  • Chemin 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 Texte sur la page résultant du processus.

  • 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 secondaire de l’image.

  • Image / Avancé  : Description  : description de l’image.

  • Image/Avancé: Taille: Taille de l’image.

  • Balises/Mots-clés: Métadonnées à attribuer à cette page. Ce champ est toujours présent sur chaque modèle automatique.

Création d’un modèle automatique creating-a-scaffold

Pour créer un modèle automatique, accédez à la console Outils, puis cliquez sur Génération de modèles automatique 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 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.

cq5_dialog_editor

À 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 s’appliquent :

  • 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 la section News scaffold 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:resourceType du 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 Masqué champs pour envoyer ces informations lors de la création de la page.

Un aperçu de l’exemple News la boîte de dialogue scaffold dans l’éditeur de boîte de dialogue permet d’expliquer comment cela fonctionne. Passez en mode de 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 dialogue Dialogue > Volet Onglets > Texte > Texte, comme illustré ci-dessous :

textedit

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 :

list_of_properties

Notez la propriété name de ce champ. Il a la valeur

./jcr:content/par/text/text

Il s’agit du nom de la propriété à 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 noeud représentant la page à créer. Il spécifie le texte de propriété, sous le texte du noeud, qui se trouve sous le noeud par, qui est lui-même un enfant du noeud jcr:content sous le noeud 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 résultant du processus.

Notez que dans une boîte de dialogue de composant normale, vous n’avez pas à spécifier ces informations, car elles sont implicites dans le fait que 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é Dialogue > Volet Onglets > Texte > Masqué, comme illustré ci-dessous :

hidden

Les propriétés de ce champ masqué sont les suivantes :

hidden_list_props

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 texte enrichi, nous définissons la propriété value de ce champ sur true.

CAUTION
L’éditeur de boîte de dialogue permet à l’utilisateur de modifier les valeurs des propriétés existantes dans la définition de la boîte de dialogue. Pour ajouter une nouvelle propriété, l’utilisateur doit utiliser CRXDE Lite. Par exemple, lorsqu’un nouveau champ masqué est ajouté à une définition de boîte de dialogue à l’aide de l’éditeur de boîte de dialogue, il n’a pas de value (c’est-à-dire, une propriété nommée "valeur"). Si le champ masqué en question nécessite une valeur par défaut value pour être définie, cette propriété doit être ajoutée manuellement avec l’un des outils CRX. La valeur ne peut pas être ajoutée avec l’éditeur de boîte de dialogue lui-même. Cependant, une fois la propriété présente, sa valeur peut être modifiée à l’aide de l’éditeur de boîte de dialogue.

Le second champ masqué est visible en cliquant dessus comme suit :

hidden2

Les propriétés de ce champ masqué sont les suivantes :

hidden_list_props2

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 Cliquez pour annuler l’héritage (pour les composants Image).

Elles indiquent que le composant ne peut pas être modifié tant que l’héritage n’a pas été annulé.

chlimage_1

Cliquez sur le symbole de verrouillage 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.

chlimage_1-1

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.

NOTE
Si l’héritage est annulé au niveau de la page (dans l’onglet Livecopy des propriétés de la page), tous les composants sont modifiables en mode Génération de modèles automatique (ils s’affichent à l’état déverrouillé).
recommendation-more-help
5955305e-451f-43a0-8168-b6ad4159b4ca