[AEM_Sites]{class="badge positive" title="S’applique à AEM Sites)."}
Définition de modèles de fragment de contenu defining-content-fragment-models
Les modèles de fragment de contenu dans Adobe Experience Manager (AEM) as a Cloud Service définissent la structure du contenu de vos fragments de contenu. Ces fragments peuvent ensuite être utilisés pour la création de pages ou comme base pour votre contenu découplé.
Cette page explique comment définir votre modèle de fragment de contenu à l’aide de l’éditeur dédié. Voir Gestion de vos modèles de fragment de contenu pour accéder à d’autres tâches et options disponibles une fois vos fragments créés, y compris les actions disponibles à partir de la console Fragments de contenu, l’autorisation du modèle sur votre dossier et la publication de votre modèle.
- « Un schéma d’interface utilisateur personnalisé est configuré pour ce modèle. L’ordre des champs affichés dans cette interface utilisateur peut ne pas correspondre au schéma d’interface utilisateur. Pour afficher les champs alignés avec le schéma d’interface utilisateur, vous devez passer au nouvel éditeur de fragment de contenu. »
Définition de votre modèle de fragment de contenu defining-your-content-fragment-model
Le modèle de fragment de contenu définit efficacement 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 :
-
Dans la console Fragments de contenu, sélectionnez le panneau des Modèles de fragment de contenu et accédez au dossier contenant votre modèle de fragment de contenu.
note NOTE Vous pouvez également ouvrir un modèle directement après sa création. -
Ouvrez le modèle requis pour Modifier ; utilisez l’un des liens d’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 :
-
haut :
- Icône Accueil
- option permettant de basculer entre le original et le nouvel éditeur
- Annuler
- Enregistrer
-
gauche : Types de données disponible pour la création de champs
-
au milieu : champs déjà définis avec l’option Ajouter
-
à droite : à l’aide des icônes situées à l’extrémité droite, vous pouvez choisir entre :
- Propriétés : définit et affiche les propriétés du champ sélectionné
- Détails du modèle : afficher le statut Activé, Titre du modèle, Balises, Description et URL d’aperçu
-
-
Pour ajouter un champ
-
Vous pouvez effectuer les actions suivantes :
- Faites glisser un type de données du panneau de gauche vers l’emplacement souhaité pour un champ dans le panneau du milieu.
- Sélectionnez l’icône + en fonction d’un type de données pour l’ajouter en bas de la liste des champs.
- Sélectionnez Ajouter dans le panneau du milieu, puis le type de données requis dans la liste déroulante qui en résulte pour ajouter un champ au bas de la liste.
note NOTE Les champs espace réservé pour tabulation doivent toujours apparaître au-dessus des champs existants. -
Vous pouvez repositionner un champ en formant des points à gauche de la zone de champ :
-
Une fois qu’un champ a été ajouté au modèle (et est sélectionné), le panneau de droite affiche les Propriétés qui peuvent être définies pour ce type de données particulier. Vous pouvez définir ici ce qui est requis pour le spécifique
champ .-
De nombreuses propriétés s’expliquent d’elles-mêmes. Pour plus d’informations, consultez Propriétés (types de données).
-
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.
note caution CAUTION Lors de la mise à jour manuelle de la propriété Nom de la propriété pour un type de données, les noms doivent contenir uniquement 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 modifiez ces caractères.
Par exemple :
note NOTE Lorsqu’un champ est défini comme Obligatoire, le Libellé indiqué dans le volet central est signalé par un astérisque (*). -
-
-
Pour supprimer un champ
Sélectionnez l’icône de corbeille pour le champ approprié dans le panneau du milieu.
-
Ajoutez tous les champs obligatoires et définissez les propriétés connexes, le cas échéant.
-
Sélectionnez Enregistrer pour conserver la définition.
Types de données data-types
Une sélection de types de données est disponible pour la définition de votre modèle :
-
Une seule ligne de texte
- Ajouter un champ pour une seule ligne de texte ; la longueur maximale peut être définie
- Le champ peut être configuré pour permettre aux auteurs de fragments de créer de nouvelles instances du champ
-
Plusieurs lignes de texte
- Zone de texte pouvant contenir du texte enrichi, du texte brut ou du texte Markdown.
- Le champ peut être configuré pour permettre aux auteurs de fragments de créer de nouvelles instances du champ
note NOTE Que la zone de texte soit du texte enrichi, du texte brut ou Markdown, est définie dans le modèle par la propriété Type par défaut. Ce format ne peut pas être modifié à partir de l’éditeur de fragment de contenu, mais uniquement à partir du modèle. -
Nombre
- Ajouter un champ numérique
- Le champ peut être configuré pour permettre aux auteurs de fragments de créer de nouvelles instances du champ
-
Booléen
- Ajoutez une case à cocher booléenne
-
Date et heure
- Ajouter un champ de date et/ou d’heure
-
Énumération
- Ajouter un ensemble de champs Case à cocher, Bouton radio ou Liste déroulante
- Vous pouvez spécifier les options disponibles pour l’auteur du fragment
- Ajouter un ensemble de champs Case à cocher, Bouton radio ou Liste déroulante
-
Balises
- Permet aux auteurs de fragments d’accéder à des zones de balises et de les sélectionner.
-
Référence du fragment
-
Fait référence à d’autres fragments de contenu ; peut être utilisé pour créer du contenu imbriqué
-
Le type de données peut être configuré pour permettre aux auteurs de fragments de procéder aux opérations suivantes :
- Modifier directement le fragment référencé.
- Créer un fragment de contenu basé sur le modèle approprié
- Création de nouvelles instances du champ
-
La référence spécifie le chemin d’accès à la ressource référencée ; par exemple,
/content/dam/path/to/resource
-
-
Référence de contenu
- Fait référence à d’autres contenus, tous types confondus ; peut être utilisée pour créer du contenu imbriqué.
- Si une image est référencée, vous pouvez choisir d’afficher une miniature.
- Le champ peut être configuré pour permettre aux auteurs de fragments de créer de nouvelles instances du champ
- La référence spécifie le chemin d’accès à la ressource référencée ; par exemple,
/content/dam/path/to/resource
-
Composite
-
Le type de données composite peut être utilisé pour créer du contenu imbriqué
-
Le type de données composite permet aux fragments de contenu de stocker des données hiérarchiques et structurées
- Pour ce faire, les champs peuvent contenir des sous-champs imbriqués
- Les sous-champs sont structurés
- Les sous-champs sont structurés en fonction des modèles de fragment de contenu
- Les sous-champs sont limités aux modèles de fragment de contenu que vous spécifiez lors de la définition du sous-champ
-
Cette fonctionnalité permet de modéliser des structures de données complexes dans un fragment unique, de la même manière que des objets imbriqués dans JSON ou des documents incorporés dans des bases de données NoSQL
note warning WARNING Le type de données Composite peut être utilisé : - dans l’interface utilisateur tactile (original) Éditeur de modèle de fragment de contenu ;
- dans le nouvel éditeur de fragment de contenu ;
Le nouvel éditeur de modèle de fragment de contenu et l’éditeur de fragment de contenu de l’interface utilisateur tactile (d’origine) bloqueront l’accès au type de données composite et à tous les champs dépendants. Pour les champs composites, le message suivant s’affiche dans le nouvel éditeur de modèle de fragment de contenu : enregistrez le moteur de rendu pour le type « composite ». -
-
Objet JSON.
-
Permet à l’auteur du fragment de contenu de saisir la syntaxe JSON dans les éléments correspondants d’un fragment.
- Permettre à AEM de stocker directement du JSON que vous avez copié/collé à partir d’un autre service.
- Le JSON est transmis tel quel et généré au format JSON dans GraphQL.
- Inclut la mise en surbrillance de la syntaxe JSON, la saisie automatique et la mise en surbrillance des erreurs dans l’éditeur de fragment de contenu.
-
-
Espace réservé pour tabulation
-
Permet l’introduction d’onglets à utiliser lors de la modification du contenu du fragment de contenu.
- Elles s’affichent sous forme de séparateurs dans l’éditeur de modèles et séparent les sections de la liste des types de données de contenu. Chaque instance représente le début d’un nouvel onglet.
- Dans l’éditeur de fragments, chaque instance s’affiche sous la forme d’un onglet.
note NOTE Ce type de données est uniquement utilisé à des fins de mise en forme. Il est ignoré par le schéma GraphQL d’AEM. Les champs espace réservé pour tabulation doivent toujours apparaître au-dessus des champs existants.
-
Propriétés (types de données) properties
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, les noms doivent contenir uniquement A-Z, a-z, 0-9 et le trait de soulignement « _ » comme caractère spécial.
note caution CAUTION Si les modèles créés dans des versions antérieures d’AEM contiennent des caractères interdits, supprimez ou modifiez ces caractères. -
Rendre en tant que
Les différentes options de réalisation/rendu du champ dans un fragment. Souvent, cela vous permet de définir si l’auteur verra une seule instance du champ ou sera autorisé à créer plusieurs instances. Lorsque le champ multiple est utilisé, vous pouvez définir le nombre minimal et maximal d’éléments. Voir Validation pour plus de détails.
-
Libellé du champ
La saisie d’un Libellé du champ génère automatiquement un Nom de la propriété, qui peut ensuite être mis à jour manuellement si nécessaire. -
Validation
La validation de base est disponible par des mécanismes tels que la propriété Required. 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 :
- Texte enrichi
- Texte (Markdown)
- Texte brut
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 ne prend effet sur un fragment de contenu existant et associé qu’une fois ce fragment ouvert dans l’éditeur et enregistré.
-
Unique
Le contenu (pour le champ spécifique) doit être unique pour tous les fragments de contenu créés à partir 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é
Countrydans le modèle de fragment de contenu ne peut pas avoir la valeurJapandans deux fragments de contenu dépendants. Un avertissement est émis en cas de tentative concernant la deuxième instance.note NOTE L’unicité est assurée par la racine de langue. note NOTE 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. -
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 Référence du fragment 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 :
- vous assurer que le nom de la propriété du champ est ajouté à la configuration de traduction,
/content/dam/<sites-configuration>de contexte, s’il n’est pas déjà présent ; - Pour GraphQL : définir une propriété
<translatable>dans le champ Fragment de contenu suryesafin d’autoriser le filtre de requête GraphQL pour la sortie JSON avec du contenu traduisible uniquement.
- vous assurer que le nom de la propriété du champ est ajouté à la configuration de traduction,
Validation validation
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 :
-
Une seule ligne de texte
- Comparaison avec une expression régulière prédéfinie (regex).
-
Nombre
- Vérification de valeurs spécifiques.
-
Référence de contenu
- Test de types de contenu spécifiques.
- Seuls peuvent être référencés des fichiers de taille de fichier spécifiée ou inférieure.
- Seules les images comprises dans une plage prédéfinie de largeur et/ou de hauteur (en pixels) peuvent être référencées.
-
Référence du fragment
- Testez un modèle de fragment de contenu spécifique.
-
Nombre minimum d’éléments / Nombre maximum d’éléments
Les champs qui ont été définis comme un champ multiple (défini avec Rendre en tant que) ont les options suivantes :
- Nombre minimum d’éléments
- Nombre maximal d’éléments
Elles sont validées dans l’Éditeur de fragment de contenu.
Contenu imbriqué nested-content
Les fragments de contenu peuvent former du contenu imbriqué à l’aide de l’un des types de données suivants :
-
- Fournit une référence simple à un autre contenu, quel que soit son type.
- Fourni par le type de données Référence de contenu
- Peut être configuré pour une ou plusieurs références (dans le fragment résultant).
-
-
Fait référence à d’autres fragments, en fonction des modèles spécifiés.
-
Les fragments référencés sont distincts et séparés du fragment de référence.
-
Fourni par le type de données Référence de fragment.
-
Permet d’inclure/récupérer des données structurées.
note NOTE Cette méthode est particulièrement intéressante lorsque vous utilisez diffusion de contenu découplée à l’aide de fragments de contenu avec GraphQL. -
Peut être configuré pour une ou plusieurs références (dans le fragment résultant).
-
Adapté lorsque du contenu modulaire et réutilisable est requis.
-
-
Type de données composite :
- Fait référence à d’autres fragments, en fonction des modèles spécifiés.
- Les fragments référencés sont entièrement incorporés au fragment de référencement et lui font partie intégrante. Ils ont une véritable relation parent-enfant.
- Le type de données composite vous permet de définir un groupe de champs sous la forme d’une structure intégrée et répétable dans un fragment parent au lieu de pointer vers une référence de fragment distincte.
- Les champs composites sont modifiés dans la même session d’éditeur que le fragment parent.
- Permet d’inclure/récupérer des données structurées.
- Convient aux champs composites à plusieurs valeurs où la réutilisation modulaire n’est pas l’objectif principal.
- Permet d’utiliser des structures de contenu plus plates et plus faciles à gérer et peut également améliorer les performances du système et des API.
-
Références du contenu
Cela empêche l’utilisateur d’ajouter une référence au fragment actif et 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.
Référence de contenu content-reference
Le type de données Référence de contenu vous permet d’effectuer le rendu du contenu à partir d’une autre source, par exemple une image, une page ou un fragment d’expérience.
Outre les propriétés standard, vous pouvez spécifier les éléments suivants :
-
Le Chemin racine, qui spécifie ou représente l’emplacement de stockage de tout contenu référencé
note NOTE Ceci est obligatoire si vous souhaitez charger et référencer directement des images dans ce champ lors de l’utilisation de l’éditeur de fragment de contenu. Voir Images de référence pour plus d’informations. -
Types de contenu pouvant être référencés
note NOTE Ils doivent inclure Image si vous souhaitez charger et référencer directement des images dans ce champ lors de l’utilisation de l’éditeur de fragment de contenu. Voir Images de référence pour plus d’informations. -
Limites relatives aux tailles de fichier
-
Si une image est référencée :
- Afficher la miniature
- Limites de hauteur et de largeur pour l’image
Référence de fragment fragment-reference
Le type de données Référence de fragment peut référencer un ou plusieurs fragments de contenu. Cette fonctionnalité est particulièrement intéressante 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 calques.
Par exemple :
- Modèle définissant les détails d’un employé, notamment :
- Référence au modèle qui définit l’employeur (entreprise)
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Outre les propriétés standard, vous pouvez définir les éléments suivants :
-
Afficher comme :
-
Plusieurs champs - l’auteur du fragment peut créer plusieurs références individuelles
-
Référence du fragment : permet à l’auteur du fragment de sélectionner une référence unique à un fragment
-
-
Type de modèle
Plusieurs modèles peuvent être sélectionnés. Lors de l’ajout de références à un fragment de contenu, tous les fragments référencés doivent avoir été créés à l’aide de ces modèles. -
Chemin racine
Cette propriété spécifie ou représente un chemin racine pour tous les fragments référencés. -
Autoriser la création de fragments
Cette propriété permet à la personne chargée de la création du fragment de créer un fragment en fonction du modèle approprié.
Données composites composite-data
Le type de données composite permet aux fragments de contenu de stocker des données hiérarchiques et structurées en autorisant les champs à contenir des sous-champs imbriqués. Les enfants (sous-champs) sont eux-mêmes du contenu structuré, défini par des modèles de fragment de contenu spécifiés par l’utilisateur et entièrement incorporé dans le fragment parent.
Le type de données composite permet de modéliser des structures de données complexes dans un fragment unique, de la même manière que des objets imbriqués dans des documents JSON ou des documents incorporés dans des bases de données NoSQL.
Un champ composite présente les propriétés et caractéristiques suivantes :
-
Spécifier un ou plusieurs modèles de fragment de contenu
- Lors de la définition d’un champ composite dans un modèle de fragment de contenu, vous devez définir les modèles pouvant être utilisés pour les éléments composites.
- Plusieurs modèles peuvent être sélectionnés, de sorte que l’auteur puisse choisir le modèle à utiliser lors de l’ajout réel d’un élément.
-
Création
- Les éléments composites sont modifiés dans la même session d’éditeur que leur fragment parent, sans ouvrir de fragment de contenu distinct.
-
Procédure pas à pas et répétition en tant que champ multiple
- Un composite à plusieurs valeurs prend en charge l’ajout, la suppression et la réorganisation d’éléments.
-
Composite multi-modèles
- Un seul champ composite peut accepter des éléments provenant de plusieurs modèles autorisés.
- L’auteur sélectionne le modèle à utiliser lors de l’ajout d’un nouvel élément.
-
Variations
- Les variations de niveau supérieur s’appliquent aux arborescences composites : une variation peut avoir un nombre d’éléments composites différent de celui du gabarit, ou un contenu différent par élément.
- La sélection s’effectue uniquement au niveau supérieur ; le contenu imbriqué reflète la variation choisie.
-
Rechercher
- Le texte des éléments composites peut faire l’objet de recherches. Le contenu correspondant renvoie le fragment de contenu parent dans les résultats de recherche.
-
Diffusion native
- GraphQL et OpenAPI renvoient un contenu composite sous la forme de données imbriquées dans la payload parente, sans résoudre une ressource de fragment de contenu distincte.
-
Nettoyer la sémantique de référence
-
Vous pouvez modéliser le contenu qui appartient à son parent et qui n’est pas réutilisé.
note NOTE Réserver les références aux fragments pour le contenu véritablement réutilisable. Les deux sont complémentaires, et non substituables.
-
Outre les propriétés standard, vous pouvez définir les éléments suivants :
-
Rendre en tant que
Spécifiez l’une des options suivantes :
- Plusieurs champs prend en charge l’ajout, la suppression et la réorganisation avec des contraintes min./max.
- Champ composite contient au maximum un élément.
-
Nombre d’éléments min./max.
Pour les composites à plusieurs valeurs, définissez des limites min. et max. pour le nombre d’éléments
-
Type
Spécifiez un ou plusieurs modèles de fragment de contenu. Les champs de ces modèles s’affichent en tant qu’éléments composites. Plusieurs modèles peuvent être sélectionnés. L’auteur choisit ensuite le modèle à ajouter à un élément.
- dans l’éditeur de modèle de fragment de contenu IU tactile (original)
- dans le nouvel éditeur de fragment de contenu ;
Avantages de la technologie composite benefits-of-composite
Le type de données Composite offre plusieurs avantages lors de la modélisation des données :
-
Gestion plus facile des structures de contenu.
- Comme les types de données composites sont directement incorporés dans un fragment de contenu, il n’est pas nécessaire de gérer des dossiers ou des structures de stockage distincts pour le contenu composite, comme c’est le cas avec les fragments référencés.
- Cela se traduit par des structures de contenu plus plates et moins encombrées qui simplifient la gouvernance et facilitent la découverte du contenu composite.
-
Création simplifiée avec prise en charge native des champs composites à plusieurs valeurs.
- Les éléments dans des composites à plusieurs valeurs peuvent être créés et modifiés dans la même session d’éditeur que le fragment parent.
- Les composites peuvent réduire la surcharge liée aux références et aux fragments de métadonnées.
-
Amélioration de la gestion de contenu et des performances de diffusion.
- Des structures de contenu plus simples avec moins de références de fragment réduisent la surcharge de la résolution de référence lors des opérations de création, de publication et de diffusion.
- Des structures de contenu plus simples réduisent également la taille et la complexité des payloads JSON, ce qui contribue à améliorer l’efficacité des API et les performances globales côté client.
Quand utiliser le composite ? when-to-use-composite
L’utilisation du type de données Composite doit être soigneusement prise en compte, car votre cas d’utilisation peut déterminer quel type de contenu imbriqué est la meilleure solution pour vous.
-
Recommandé lorsque vous :
- Créez contenu de type page ou liste de cartes où les enfants ne sont réutilisés nulle part ailleurs.
- rencontrent des problèmes de performances du graphique de référence, soit au moment de la diffusion, soit au moment de la publication ;
- Demandez aux auteurs de se plaindre des workflows de changement de tabulation pour le contenu imbriqué.
- Groupes étape-et-répétition à champs multiples nécessaires qui nécessitent actuellement des types de données personnalisés ou des outils externes.
-
Soyez prudent lorsque :
- Votre contenu est véritablement réutilisable sur l’ensemble des fragments. Les références aux fragments restent la bonne réponse pour le contenu partagé ; les références composites concernent le contenu intégré.
- Vous n’utilisez que l’éditeur d’IU tactile (d’origine). Le composite est pris en charge dans le nouvel éditeur de fragment de contenu, mais l’éditeur d’IU tactile d’origine bloque la modification des champs composites.
Limites des composants composites limitations-of-composite
La liste ci-dessous consolide les limites actuelles du type de données Composite :
-
Surface de création
- Éditeur de fragment d’interface utilisateur tactile (éditeur d’origine)
- Les champs composites ne sont pas pris en charge.
- Nouvel éditeur de modèle de fragment de contenu (découplé)
- Le type composite n’est pas encore pris en charge. La création de modèles utilise l’éditeur de modèles de l’interface utilisateur tactile d’origine.
Pour les champs composites, le message suivant s’affiche : Veuillez enregistrer le rendu pour le type « composite ».
- Le type composite n’est pas encore pris en charge. La création de modèles utilise l’éditeur de modèles de l’interface utilisateur tactile d’origine.
- Éditeur de fragment d’interface utilisateur tactile (éditeur d’origine)
-
Prise en charge de plusieurs fonctionnalités
-
MSM (Multi Site Manager)
-
L’héritage ne peut être rompu que pour les champs de niveau supérieur.
- Il est possible de rompre l’héritage pour un champ composite entier.
- La rupture de l’héritage pour les champs individuels des éléments composites n’est pas prise en charge.
-
-
Lancements
- Les fragments de contenu contenant des champs composites ne sont pas pris en charge dans les lancements, qu’ils soient sélectionnés directement ou inclus par le biais de références de fragment. Ces actions ne sont pas acceptées et échoueront.
-
Composants principaux et exporteur de modèle Sling
- Le rendu de page via les composants principaux et l’exportateur de modèle Sling (
.model.json) ne prend pas encore en charge les champs composites.
- Le rendu de page via les composants principaux et l’exportateur de modèle Sling (
-
Fragments de contenu visuels (fragments de contenu avec des modèles HTML)
- Les fragments de contenu visuel (fragments de contenu avec des modèles HTML) ne prennent actuellement pas en charge les champs composites.
-