Les modèles de fragment de contenu d’AEM définissent la structure du contenu de vos fragments de contenu et servent de base à votre contenu découplé.
Pour utiliser des modèles de fragments de contenu, procédez comme suit :
Accédez à Outils, Général, puis ouvrez les modèles de fragment de contenu.
Accédez au dossier adapté à votre configuration, ou sous-configuration.
Utilisation Créer pour ouvrir l’assistant.
Si l’utilisation des modèles de contenu du fragment n’a pas été activée, l’option Créer n’est pas disponible.
Spécifiez le Titre du modèle.
Vous pouvez également définir différentes propriétés ; par exemple, ajouter Balises, un Description, puis sélectionnez Activer le modèle to activer le modèle ; si nécessaire.
Pour plus d’informations sur la variable Modèle d’URL d’aperçu par défaut see Modèle de fragment de contenu - Propriétés.
Utilisation Créer pour enregistrer le modèle vide. Un message indique le succès de l’action. Vous pouvez sélectionner Ouvrir pour modifier immédiatement le modèle ; ou Terminé pour revenir à la console.
Le modèle de fragment de contenu définit effectivement la structure des fragments de contenu résultants à l’aide d’une sélection de Types de données. Grâce à l’éditeur de modèles, vous pouvez ajouter des instances de types de données, puis les configurer pour créer les champs requis :
La modification d’un modèle de fragment de contenu existant peut avoir un impact sur les fragments dépendants.
Accédez à Outils, Général, puis ouvrez les modèles de fragment de contenu.
Accédez au dossier contenant votre modèle de fragment de contenu.
Ouvrez le modèle requis pour Modifier; utilisez l’action rapide ou sélectionnez le modèle, puis l’action dans la barre d’outils.
Une fois ouvert, l’éditeur de modèles affiche :
Lorsqu’un champ est défini sur Obligatoire, la variable Libellé indiqué dans le volet de gauche est marqué d’un astérisque (*).
Pour ajouter un champ
Faites glisser un type de données à l’emplacement souhaité pour un champ :
Une fois qu’un champ a été ajouté au modèle, le panneau de droite affiche les propriétés qui peuvent être définies pour ce type de données spécifique. Vous pouvez définir ce qui est obligatoire pour ce champ.
De nombreuses propriétés s’expliquent d’elles-mêmes. Pour plus d’informations, voir Propriétés.
Si vous entrez un libellé de champ, le nom de propriété est automatiquement renseigné. S’il est vide, il peut être mis à jour manuellement par la suite.
Lors de la mise à jour manuelle de la propriété Nom de la propriété pour un type de données, notez que les noms ne doivent contenir que des caractères A-Z, a-z, 0-9 et le trait de soulignement « _ » comme caractère spécial.
Si les modèles créés dans des versions antérieures d’AEM contiennent des caractères interdits, supprimez ou mettez à jour ces caractères.
Par exemple :
Pour supprimer un champ
Sélectionnez le champ requis, puis cliquez/appuyez sur l’icône corbeille. Vous êtes invité à confirmer l’action.
Ajoutez tous les champs obligatoires et définissez les propriétés connexes, le cas échéant. Par exemple :
Sélectionnez Enregistrer pour conserver la définition.
Une sélection de types de données est disponible pour la définition de votre modèle :
Ce type de données est uniquement utilisé à des fins de mise en forme. Il est ignoré par le schéma GraphQL AEM.
De nombreuses propriétés s’expliquent d’elles-mêmes. Pour certaines propriétés, les détails supplémentaires sont les suivants :
Nom de la propriété
Lors de la mise à jour manuelle de cette propriété pour un type de données, notez que les noms ne doivent contenir que les caractères A-Z, a-z, 0-9 et le trait de soulignement « _ » comme caractère spécial.
Si les modèles créés dans des versions antérieures d’AEM contiennent des caractères interdits, supprimez ou mettez à jour ces caractères.
Rendu comme
Les différentes options permettant de réaliser/rendre le champ dans un fragment. Cette propriété vous permet souvent de définir si l’auteur voit une seule instance du champ ou s’il est autorisé à créer plusieurs instances.
Libellé du champ
Saisie d’un Libellé du champ génère automatiquement une Nom de la propriété, qui peut ensuite être mis à jour manuellement si nécessaire.
Validation
La validation de base est disponible par le biais de mécanismes tels que la propriété Requis. Certains types de données comportent des champs de validation supplémentaires. Voir Validation pour plus de détails.
Pour le type données texte multiligne, il est possible de définir le type par défaut en tant que :
Si elle n’est pas spécifiée, la valeur par défaut Texte enrichi est utilisée pour ce champ.
La modification du type par défaut dans un modèle de fragment de contenu prend effet uniquement sur un fragment de contenu existant et lié après l’ouverture et l’enregistrement du fragment dans l’éditeur.
Unique
Le contenu (du champ spécifique) doit être unique dans tous les fragments de contenu créés à l’aide du modèle actuel.
Cette propriété permet de s’assurer que les auteurs de contenu ne peuvent pas répéter le contenu déjà ajouté dans un autre fragment du même modèle.
Par exemple, un champ Une seule ligne de texte appelé Country
dans le modèle de fragment de contenu ne peut pas avoir la valeur Japan
dans deux fragments de contenu dépendants. Un avertissement s’affiche lorsque la seconde instance est tentée.
L’unicité est assurée par la racine de langue.
Les variations peuvent avoir la même valeur unique que les variations du même fragment, mais pas la même valeur que celle utilisée dans une variation d’autres fragments.
Si vous souhaitez utiliser MSM (qui crée des copies de fragments de contenu), toute Unique Les contraintes doivent être supprimées de tous les types de données utilisés dans les modèles de fragment de contenu respectifs.
Consultez la section Référence de contenu pour plus d’informations sur ce type de données spécifique et ses propriétés.
Voir la section Référence du fragment (Fragments imbriqués) pour plus d’informations sur ce type de données spécifique et ses propriétés.
Traduisible
Activez la case à cocher Traduisible dans un champ de l’éditeur de modèle de fragment de contenu pour :
/content/dam/<sites-configuration>
de contexte, s’il n’est pas déjà présent ;<translatable>
dans le champ Fragment de contenu sur yes
afin d’autoriser le filtre de requête GraphQL pour la sortie JSON avec du contenu traduisible uniquement.Différents types de données incluent désormais la possibilité de définir les exigences de validation lorsque le contenu est saisi dans le fragment résultant :
Les fragments de contenu peuvent former du contenu imbriqué à l’aide de l’un des types de données suivants :
Référence du fragment (fragments imbriqués)
Fait référence à d’autres fragments, en fonction des modèles spécifiques spécifiés.
Vous permet d’inclure/de récupérer des données structurées.
Cette méthode présente un intérêt particulier en conjonction avec la Diffusion de contenu découplé utilisant des fragments de contenu à l’aide de GraphQL.
AEM dispose d’une protection récurrente pour :
Références du contenu
Cela empêche l’utilisateur d’ajouter une référence au fragment actif. Cette approche peut conduire à une boîte de dialogue vide dans le sélecteur de référence du fragment.
Références de fragment dans GraphQL
Si vous créez une requête profonde qui renvoie plusieurs fragments de contenu référencés les uns par les autres, elle renvoie la valeur « null » lors de la première occurrence.
La référence de contenu vous permet d’effectuer le rendu du contenu à partir d’une autre source, par exemple une image ou un fragment de contenu.
Outre les propriétés standard, vous pouvez spécifier les éléments suivants :
La référence du fragment fait référence à un ou plusieurs fragments de contenu. Cette fonctionnalité présente un intérêt particulier lors de la récupération de contenu à utiliser dans votre application, car elle vous permet de récupérer des données structurées avec plusieurs couches.
Par exemple :
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Cette méthode présente un intérêt particulier en conjonction avec la Diffusion de contenu découplé utilisant des fragments de contenu à l’aide de GraphQL.
Outre les propriétés standard, vous pouvez définir les éléments suivants :
Afficher comme :
multifield : l’auteur du fragment peut créer plusieurs références individuelles
fragmentreference : permet à l’auteur du fragment de sélectionner une référence unique à un fragment.
Type de modèle
Il est possible de sélectionner plusieurs modèles. Lors de la création du fragment de contenu, tous les fragments référencés doivent avoir été créés à l’aide de ces modèles.
Chemin racine
Indique un chemin racine pour tout fragment référencé.
Autoriser la création de fragments
Cette propriété permet à l’auteur du fragment de créer un nouveau fragment en fonction du modèle approprié.
Un mécanisme de protection contre les répétitions est en place. Il interdit à l’utilisateur de sélectionner le fragment de contenu actif dans la référence au fragment. L’approche peut conduire à une boîte de dialogue vide du sélecteur de référence du fragment.
Il existe également une protection contre les répétitions pour les références de fragments dans GraphQL. Si vous créez une requête profonde entre deux fragments de contenu qui se référencent mutuellement, elle renvoie la valeur « null ».
Vous pouvez modifier les propriétés d’un modèle de fragment de contenu :
Titre du modèle
Balises
Description
Télécharger l’image
Modèle d’URL de prévisualisation par défaut
Cette propriété n’est utilisée que par la variable new Éditeur de fragment de contenu. Voir Modèles de fragment de contenu pour plus d’informations.
Pour un contrôle total de l’utilisation de vos modèles de fragments de contenu, ils contiennent un état que vous pouvez définir.
Une fois qu’un modèle a été créé, il doit être activé pour :
Pour activer un modèle marqué comme :
Vous utilisez l’option Activer de l’une des manières suivantes :
Un modèle peut également être désactivé afin que :
Pour désactiver un modèle marqué comme Activé, utilisez l’option Désactiver de l’une des deux manières suivantes :
Pour mettre en œuvre une gouvernance du contenu, vous pouvez configurer des Politiques sur le dossier de ressources pour contrôler les modèles de fragment de contenu autorisés pour la création de fragments dans ce dossier.
Le mécanisme est similaire à l’autorisation de modèles de page pour une page et ses enfants, dans les propriétés avancées d’une page.
Pour configurer les politiques des modèles de fragments de contenu autorisés :
Recherchez et ouvrez les Propriétés pour le dossier de ressources requis.
Ouvrez l’onglet Politiques pour configurer les éléments suivants :
Hérité de<folder>
Les politiques sont automatiquement héritées lors de la création de dossiers enfants ; il peut se produire une reconfiguration de la politique (et une rupture de l’héritage) si des sous-dossiers doivent autoriser des modèles différents du dossier parent.
Modèles de fragments de contenu autorisés par chemin
Il est possible d’autoriser plusieurs modèles.
Modèles de fragments de contenu autorisés par balise
Il est possible d’autoriser plusieurs modèles.
Enregistrez les modifications.
Les modèles de fragment de contenu autorisés pour un dossier sont résolus comme suit :
La suppression d’un modèle de fragment de contenu peut avoir un impact sur les fragments dépendants.
Pour supprimer un modèle de fragment de contenu :
Accédez à Outils, Général, puis ouvrez les Modèles de fragment de contenu.
Accédez au dossier contenant votre modèle de fragment de contenu.
Sélectionnez votre modèle, suivi de Supprimer dans la barre d’outils.
Si le modèle est référencé, un avertissement s’affiche. Agissez de manière appropriée.
Les modèles de fragment de contenu doivent être publiés avant ou pendant la publication des fragments de contenu dépendants.
Pour publier un modèle de fragment de contenu :
Accédez à Outils, Général, puis ouvrez les Modèles de fragment de contenu.
Accédez au dossier contenant votre modèle de fragment de contenu.
Sélectionnez votre modèle, puis l’option de publication dans la barre d’outils.
L’état publié est indiqué dans la console.
Si vous publiez un fragment de contenu pour lequel le modèle n’a pas encore été publié, une liste de sélection l’indique et le modèle est publié avec le fragment.
Les modèles de fragment de contenu peuvent être dépubliés s’ils ne sont référencés par aucun fragment.
Pour dépublier un modèle de fragment de contenu :
Accédez à Outils, Général, puis ouvrez les Modèles de fragment de contenu.
Accédez au dossier contenant votre modèle de fragment de contenu.
Sélectionnez votre modèle, puis l’option Dépublier dans la barre d’outils.
L’état publié est indiqué dans la console.
Si vous essayez de dépublier un modèle actuellement utilisé par un ou plusieurs fragments, un avertissement d’erreur vous en informe :
Le message vous invite à vérifier le panneau Références pour en savoir plus :
Cette fonctionnalité fournit une gouvernance pour les modèles de fragment de contenu qui ont été publiés.
Les modèles de fragment de contenu déterminent le schéma des requêtes GraphQL dans AEM.
Les schémas GraphQL AEM sont créés dès qu’un modèle de fragment de contenu est créé. Ils peuvent exister dans les environnements de création et de publication.
Les schémas en environnement de publication sont les plus critiques, car ils fournissent les bases de la diffusion en direct du contenu de fragment de contenu au format JSON.
Des problèmes peuvent survenir lorsque des modèles de fragment de contenu sont modifiés. Cela signifie que le schéma change, ce qui peut à son tour affecter les requêtes GraphQL existantes.
L’ajout de nouveaux champs à un modèle de fragment de contenu ne doit (généralement) avoir aucun effet négatif. Toutefois, la modification de champs de données existants (par exemple, le nom) ou la suppression de définitions de champ rompt les requêtes GraphQL existantes lorsqu’elles interrogent ces champs.
Sensibiliser les utilisateurs aux risques de la modification de modèles déjà utilisés pour la diffusion de contenu en direct (c’est-à-dire des modèles qui ont déjà été publiés).
Éviter également toute modification imprévue.
L’un ou l’autre peut causer une interruption des requêtes si les modèles modifiés sont republiés.
Pour résoudre ces problèmes, les modèles de fragment de contenu sont verrouillés en mode LECTURE SEULE pour l’auteur dès leur publication. Ce verrouillage est indiqué par la mention Verrouillé :
Lorsque le modèle est Verrouillé (en mode LECTURE SEULE ), vous pouvez voir le contenu et la structure des modèles, mais vous ne pouvez pas les modifier.
Vous pouvez gérer les modèles verrouillés à partir de la console ou de l’éditeur de modèles :
Console
Dans la console, vous pouvez gérer le mode LECTURE SEULE avec les actions Déverrouiller et Verrouiller dans la barre d’outils :
Vous pouvez Déverrouiller un modèle pour activer les modifications.
Si vous sélectionnez Déverrouiller, un avertissement s’affiche et vous devez confirmer la variable Déverrouiller action :
Vous pouvez ensuite ouvrir le modèle pour le modifier.
Vous pouvez également Verrouiller le modèle par la suite.
La republication du modèle le rebascule immédiatement en mode Verrouillé (LECTURE SEULE).
Éditeur de modèles
Lorsque vous ouvrez un modèle verrouillé, vous êtes averti et trois actions s’affichent : Annuler, Afficher en lecture seule, Modifier:
Si vous sélectionnez Afficher en lecture seule, vous pouvez voir le contenu et la structure du modèle :
Si vous sélectionnez Modifier, vous pouvez modifier et enregistrer vos mises à jour :
Un avertissement peut toujours s’afficher en haut de l’écran, mais seulement lorsque le modèle est déjà utilisé par les fragments de contenu existants.
Annuler vous ramène à la console.