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

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. Vous pouvez effectuer cette action dans Outils  -> Général  -> Modèles de fragment de contenu.

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

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 :

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

Après avoir 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 :

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

Vos auteurs de contenu your-content-authors

Les auteurs et autrices 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.

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

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

Publication publishing

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

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