En savoir plus sur la création de modèles de fragment de contenu dans AEM architect-headless-content-fragment-models

Un peu d’histoire… story-so-far

Au début du Parcours de création de contenu découplé AEM, la section Bases de la modélisation de contenu pour le découplage avec AEM présentait les concepts de base et la terminologie relatifs à la création découplée.

Cet article s’appuie sur ces connaissances préalables afin que vous compreniez comment créer vos propres modèles de fragment de contenu pour votre projet AEM découplé.

Objectif objective

  • Audience  : débutant
  • Objectif  : les concepts et les mécanismes de la modélisation du contenu pour votre CMS découplé à l’aide de modèles de fragments de contenu.

Création de modèles de fragment de contenu creating-content-fragment-models

Ensuite, les modèles de fragments de contenu peuvent être créés et la structure définie. Ces actions peuvent être réalisées dans Outils > Ressources > Modèles de fragment de contenu.

Modèles de fragment de contenu dans les outils

Après avoir sélectionné cette option, accédez à l’emplacement de votre modèle et sélectionnez Créer. Vous pouvez saisir ici différentes informations importantes.

L’option Activer le modèle est activé par défaut. Cela signifie que votre modèle sera disponible pour être utilisé (dans la création de fragments de contenu) dès que vous l’aurez enregistré. Vous pouvez désactiver cette option si vous le souhaitez. Par la suite, vous pourrez activer (ou désactiver) un modèle existant.

Création de modèles de fragment de contenu

Confirmez en cliquant sur Créer et vous pourrez Ouvrir votre modèle pour commencer à en définir la structure.

Définition de modèles de fragment de contenu defining-content-fragment-models

Lorsque vous ouvrez un nouveau modèle pour la première fois, vous verrez un grand espace vide à gauche et une longue liste de Types de données à droite :

Modèle vide

Alors, que faire ?

Vous pouvez faire glisser des instances de Types de données dans l’espace gauche, et ainsi commencer à définir votre modèle.

Définition de champs

Une fois que vous avez ajouté un type de données, vous devrez définir les Propriétés de ce champ. Celles-ci dépendent du type utilisé. Par exemple :

Propriétés des données

Vous pouvez ajouter autant de champs que vous le souhaitez. Par exemple :

Modèle de fragment de contenu

Vos auteurs de contenu your-content-authors

Les auteurs de contenu ne voient pas les types de données et les propriétés que vous avez utilisés pour créer vos modèles. Cela signifie que vous devrez peut-être fournir de l’aide et des informations sur la façon dont ils doivent remplir des champs spécifiques. Pour fournir des informations de base, vous pouvez utiliser le libellé du champ et la valeur par défaut, mais il se peut qu’une documentation spécifique au projet plus complexe soit nécessaire.

NOTE
Consultez les Ressources supplémentaires – Modèles de fragment de contenu.

Gestion des modèles de fragment de contenu managing-content-fragment-models

La gestion de vos modèles de fragment de contenu comprend :

  • l’activation (ou la désactivation) de ces fragments, ce qui les rend disponibles pour les auteurs lors de la création de fragments de contenu.
  • la suppression : la suppression est toujours nécessaire, mais vous devez savoir lorsque vous supprimez un modèle déjà utilisé pour les fragments de contenu, en particulier pour les fragments déjà publiés.

Publication publishing

Les modèles de fragment de contenu doivent être publiés avant ou pendant la publication des fragments de contenu dépendants.

NOTE
Si un auteur essaye de publier un fragment de contenu pour lequel le modèle n’a pas encore été publié, une liste de sélection l’indique, ainsi que le fait que le modèle sera publié avec le fragment.

Dès qu’un modèle est publié, il est verrouillé en mode LECTURE SEULE sur l’auteur. Cette fonctionnalité a pour but d’empêcher les modifications qui provoqueraient des erreurs dans les schémas et requêtes GraphQL existants, en particulier dans l’environnement de publication. Ce statut est indiqué dans la console par la mention Verrouillé.

Lorsque le modèle est Verrouillé (en mode LECTURE SEULE), vous pouvez en voir le contenu et la structure, mais vous ne pouvez pas les modifier directement ; vous pouvez cependant gérer les modèles Verrouillés dans la console ou dans l’éditeur de modèles.

Prochaines étapes whats-next

Maintenant que vous en savez plus sur les bases, l’étape suivante consiste à commencer à créer vos propres modèles de fragment de contenu.

Ressources supplémentaires additional-resources

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