Utilisation de fragments de contenu working-with-content-fragments
Avec Adobe Experience Manager (AEM) as a Cloud Service, les fragments de contenu vous permettent de concevoir, créer, organiser et publier du contenu indépendant des pages. Ils vous permettent de préparer du contenu prêt à être utilisé à plusieurs emplacements/sur plusieurs canaux, idéal pour une diffusion sans interface. Ils peuvent également être utilisés avec la gestion multisite pour vous permettre de réutiliser votre contenu.
Les fragments de contenu contiennent du contenu structuré :
-
Ils sont basés sur un modèle de fragment de contenu, servant à prédéfinir une structure pour le fragment résultant.
-
La structure peut varier entre :
-
De base
- Par exemple, un seul champ de texte multilignes.
- Il peut être utilisé pour préparer du contenu simple à utiliser dans la création de pages.
-
Complexe
- Combinaison de nombreux champs de divers types de données, y compris texte, nombre, booléen, données et temps.
- Il peut être utilisé soit pour préparer du contenu plus structuré pour la création de pages, soit pour la diffusion vers votre application.
-
Imbriqué
- Les types de données de référence disponibles vous permettent d’imbriquer votre contenu.
- Tend à être utilisé pour la diffusion à votre application.
-
Les fragments de contenu peuvent également être diffusés au format JSON, à l’aide des fonctionnalités d’exportation du modèle Sling (JSON) des composants principaux d’AEM. Cette forme de diffusion :
- permet d’utiliser le composant pour gérer les éléments d’un fragment à diffuser
- permet la diffusion en masse, en ajoutant plusieurs composants principaux de fragments de contenu sur la page utilisée pour la diffusion de l’API
Cette page et les suivantes portent sur les tâches de création, de configuration, de gestion et d’utilisation de vos fragments de contenu :
- Activation de la fonctionnalité de fragments de contenu pour votre instance
- Modèles de fragment de contenu : activation, création et définition de vos modèles.
- Gérer les fragments de contenu - créer vos fragments de contenu ; puis modifier, publier et référencer
- Variations – création de fragments de contenu : créez le contenu du fragment et créez des variantes du maître.
- Texte (Markdown) : utilisation de la syntaxe Markdown pour votre fragment.
- Utilisation du contenu associé : ajout de contenu associé.
- Métadonnées – propriétés des fragments : affichage et modification des propriétés des fragments.
- Utilisez des fragments de contenu, ainsi que GraphQL, pour diffuser du contenu à utiliser dans vos applications. Pour vous aider, vous pouvez prévisualiser la sortie JSON.
- Réutilisation de fragments de contenu à l’aide de MSM
- Création de page à partir de fragments de contenu.
- Personnalisation et extensions de fragments de contenu
- Fragments de contenu – Configuration des composants pour le rendu
- Prise en charge des fragments de contenu dans l’API HTTP AEM Assets
- API AEM GraphQL à utiliser avec les fragments de contenu
- OpenAPI du modèle de fragment de contenu et de fragment de contenu
Le nombre de canaux de communication augmente tous les ans. En règle générale, les canaux font référence au mécanisme de diffusion :
- Canal physique (par exemple, bureau ou mobile).
- Forme de diffusion dans un canal physique (par exemple, la « page de détails du produit », la « page de catégorie de produit » pour le bureau, ou le « web mobile » et « l’application mobile » pour le mobile).
Cependant, vous ne souhaitez (probablement) pas utiliser le même contenu pour tous les canaux ; vous devez optimiser votre contenu en fonction du canal spécifique.
Les fragments de contenu vous permettent de :
- Étudier comment atteindre efficacement les audiences cibles sur plusieurs canaux.
- Créer et gérer du contenu éditorial neutre pour les canaux.
- Créer des pools de contenu pour divers canaux.
- Concevoir des variations de contenu pour des canaux spécifiques.
- Ajouter des images à votre texte en insérant des ressources (fragments de supports variés).
- Créez du contenu imbriqué afin de refléter la complexité de vos données.
Ces fragments de contenu peuvent ensuite être assemblés pour offrir diverses expériences sur de multiples canaux.
- Les fragments de contenu sont des contenus éditoriaux, avec définition et structure, mais sans conception visuelle et/ou mise en page supplémentaires. Ils peuvent être utilisés pour accéder à des données structurées, notamment du texte, des nombres et des dates.
- Les fragments d’expérience désignent un contenu parfaitement mis en page : un fragment de page web.
Fragments de contenu et services de contenu content-fragments-and-content-services
AEM Content Services est conçu pour généraliser la description et la diffusion de contenu dans/à partir d’AEM à des canaux autres que des pages web.
Il assure la diffusion du contenu aux canaux autres que les pages web AEM classiques, à l’aide de méthodes normalisées qui peuvent être utilisées par tous les clients. Ces canaux peuvent inclure :
- des applications sur une seule page ;
- des applications mobiles natives ;
- d’autres canaux et points de contact externes à AEM.
La diffusion est effectuée au format JSON à l’aide de l’outil d’exportation JSON.
Les fragments de contenu AEM peuvent être utilisés pour décrire et gérer du contenu structuré. Le contenu structuré est défini dans des modèles qui peuvent contenir divers types de contenu, notamment du texte, des données numériques, des valeurs booléennes, des dates et heures, etc.
Associé aux fonctionnalités d’exportation JSON des composants de base AEM, ce contenu structuré peut ensuite être utilisé pour diffuser le contenu AEM sur des canaux autres que les pages AEM.
Type de contenu content-type
Les fragments de contenu sont :
-
stockés en tant que ressources :
- Les fragments de contenu (et leurs variations) peuvent être créés et conservés à partir de la console Ressources.
- Créés et modifiés dans l’éditeur de fragment de contenu.
-
Utilisé dans l’ éditeur de page par le composant Fragment de contenu (référençant le composant) :
- Le composant Fragment de contenu est disponible pour les créateurs de pages. Il leur permet de référencer et de livrer le fragment de contenu requis au format HTML ou JSON.
-
Accessible à l’aide de l’API AEM GraphQL.
Les fragments de contenu sont une structure de contenu qui :
- Ne comportent pas de disposition ou de conception (certaines mises en forme de texte sont possibles en mode Texte enrichi).
- Contenir une ou plusieurs parties constituantes.
- Contient des imagesou peut être connecté à celles-ci.
- Est utilisé contenu intermédiaire lorsqu’il est référencé sur une page.
- Ils sont indépendants du mécanisme de diffusion (c’est-à-dire de la page, du canal).
Fragments avec des ressources visuelles fragments-with-visual-assets
Pour donner aux auteurs et autrices plus de contrôle sur leur contenu, il est possible d’ajouter et/ou d’intégrer des images à un fragment de contenu.
Les ressources peuvent être utilisées avec un fragment de contenu de plusieurs façons ; chacune présentant ses propres avantages :
-
Insérer une ressource dans un fragment (fragments de médias variés)
- Ils font partie du fragment (voir Parties constituantes d’un fragment de contenu).
- Définissent la position de la ressource.
- Reportez-vous à la section Insertion de ressources dans votre fragment dans l’éditeur de fragments pour plus d’informations.
note note NOTE Les ressources visuelles insérées dans le fragment de contenu sont liées au paragraphe précédent. Lorsque le fragment est ajouté à une page, ces ressources sont déplacées avec le paragraphe en question quand du contenu intermédiaire est ajouté. -
Contenu associé
- Connecté à un fragment, mais pas à une partie fixe du fragment (voir Parties constituantes d’un fragment de contenu).
- Dispose d’une certaine flexibilité pour le positionnement.
- Facilement disponible pour utilisation (comme contenu intermédiaire) lors de l’utilisation du fragment sur une page.
Voir Contenu associé pour plus d’informations.
-
Ressources disponibles dans le navigateur Ressources de l’éditeur de page
- Permettent une flexibilité totale pour la sélection d’une ressource.
- Dispose d’une certaine flexibilité pour le positionnement.
- N’appliquent pas le concept d’approbation pour un fragment spécifique.
Voir Explorateur de ressources pour plus d’informations.
Parties constituantes d’un fragment de contenu constituent-parts-of-a-content-fragment
Les ressources de fragment de contenu se composent des parties suivantes (directement ou indirectement) :
-
Éléments de fragment
- Les éléments sont corrélés aux champs de données contenant du contenu.
- Vous utilisez un modèle de contenu pour créer le fragment de contenu. Les éléments (champs) spécifiés dans le modèle définissent la structure du fragment. Ces éléments (champs) peuvent être de différents types de données.
-
Paragraphes de fragment
-
Blocs de texte, souvent multilignes, délimités comme des entités individuelles.
-
Dans les modes Texte enrichi et Markdown, un paragraphe peut être formaté en tant qu’en-tête, auquel cas celui-ci et le paragraphe suivant sont considérés comme une unité.
-
Activez le contrôle du contenu lors de la création de pages.
-
-
Ressources insérées dans un fragment (fragments de supports variés)
-
Ressources (images) insérées dans le fragment et utilisées en tant que contenu interne d’un fragment.
-
Incorporé dans le système de paragraphes du fragment.
-
Peuvent être formatées lorsque le fragment est utilisé/référencé sur une page.
-
Peuvent uniquement être ajoutées, supprimées ou déplacées dans un fragment à l’aide de l’éditeur de fragment. Ces actions ne peuvent pas être effectuées dans l’éditeur de page.
-
Peuvent uniquement être ajoutées, supprimées ou déplacées dans un fragment à l’aide du Format Texte enrichi dans l’éditeur de fragments.
-
Peuvent uniquement être ajoutées aux éléments de texte multiligne (tout type de fragment).
-
Sont liées au texte précédent (paragraphe).
note caution CAUTION Des ressources peuvent être supprimées (par inadvertance) d’un fragment lors du passage au format texte brut. note note NOTE Assets peut également être ajouté en tant que contenu supplémentaire (intermédiaire) lors de l’utilisation d’un fragment sur une page ; à l’aide de contenu associé ou de ressources du navigateur Assets.
-
-
Contenu associé
-
Il s’agit d’un contenu externe à un fragment, mais présentant une pertinence éditoriale pour celui-ci. En règle générale, les images, vidéos ou autres fragments.
-
Les ressources individuelles de la collection peuvent être utilisées avec le fragment dans l’éditeur de page lorsqu’il est ajouté à une page. Cela signifie qu’elles sont facultatives, selon les exigences du canal spécifique.
-
Les ressources sont associées aux fragments par le biais de collections ; les collections associées permettent à l’auteur de décider quelles ressources utiliser lors de la création de la page.
- Les collections peuvent être associées à des fragments, en tant que contenu par défaut, ou selon les auteurs lors de la création du fragment.
- Les Collections de ressources (DAM) constituent la base du contenu associé des fragments.
-
Vous pouvez également ajouter le fragment lui-même à une collection pour faciliter le suivi.
-
-
Métadonnées de fragment
-
Utilisez les Schémas de métadonnées de ressources.
-
Les balises peuvent être créées lorsque vous :
-
Créez et êtes l’auteur ou l’autrice du fragment
-
Ou plus tard :
- En affichant/modifiant les Propriétés du fragment depuis la console
- En modifiant les Métadonnées dans l’éditeur de fragments
-
note caution CAUTION Les profils de traitement des métadonnées ne s’appliquent pas aux fragments de contenu. -
-
Maître
-
Partie du fragment
- Chaque fragment de contenu comporte une instance de Principal.
- Le Principal ne peut pas être supprimé.
-
L’instance maître est accessible dans l’éditeur de fragment sous Variations.
-
L’instance maître n’est pas une variation en tant que telle, mais plutôt la base de toutes les variations.
-
-
Variations
- Il s’agit de rendus de texte de fragment spécifiques à une fin éditoriale. Les variations peuvent être associées au canal, sans que cela soit obligatoire, et elles peuvent également servir à des modifications locales ad hoc.
- Sont créées en tant que copies de Principal, mais peuvent ensuite être modifiées si nécessaire. Il existe un chevauchement de contenu entre les variations elles-mêmes.
- Peuvent être définies lors de la création de fragments.
- Stockées dans le fragment, afin d’éviter l’éparpillement des copies de contenu.
- Les variations peuvent être synchronisées par Principal si le contenu du Principal a été mis à jour.
- Peuvent être résumées afin de tronquer rapidement le texte sur une longueur prédéfinie.
- Disponibles sous l’onglet Variations de l’éditeur de fragment.
Contenu intermédiaire lors de la création de page avec des fragments de contenu in-between-content-when-page-authoring-with-content-fragments
Contenu intermédiaire :
- Disponible dans l’éditeur de page lorsque vous utilisez des fragments de contenu.
- Contenu supplémentaire ajouté dans le flux d’un fragment après son utilisation ou sa référence sur une page.
- Disponible pour une utilisation dans l’ éditeur de page lors de l’utilisation de fragments de contenu.
- Le contenu intermédiaire peut être ajouté à n’importe quel fragment, où seul un élément est visible.
- Le contenu associé peut être utilisé, de même que les ressources et/ou les composants du navigateur approprié.
Conditions requises pour utiliser des fragments required-by-fragments
Pour créer des fragments de contenu, vous devez :
-
Modèles de contenu
- Sont activés à l’aide de l’explorateur de configurations.
- Sont créés à l’aide d’outils.
- Obligatoires pour créer un fragment.
- Définissent la structure d’un fragment (titre, éléments de contenu et définitions de balise).
- Les définitions de modèles de contenu requièrent un titre et un élément de données ; tous les autres attributs sont facultatifs.
- Le modèle peut définir le contenu par défaut, le cas échéant.
- Les auteurs ne peuvent pas modifier la structure définie lors de la création du contenu d’un fragment.
- Les modifications apportées à un modèle après la création de fragments de contenu dépendants peuvent avoir un impact sur ces fragments de contenu.
Pour utiliser vos fragments de contenu pour la création de pages, vous avez également besoin des éléments suivants :
-
Composant Fragment de contenu
- Indicateur pour diffuser le fragment au format HTML ou JSON, ou les deux.
- Obligatoire pour référencer le fragment sur une page.
- Responsable de la disposition et de la diffusion d’un fragment, c’est-à-dire des canaux.
- Les fragments ont besoin d’un ou de plusieurs composants dédiés pour définir la disposition, ainsi que diffuser tous les éléments/variations et le contenu associé.
- Faire glisser un fragment sur une page en mode Création permet d’associer automatiquement le composant requis.
Réutilisation de fragments de contenu avec MSM reusing-content-fragments-with-msm
Lorsque vous y accédez via la console Assets, vous pouvez utiliser MSM et créer des Live Copies pour vos fragments.
Pour plus d’informations, consultez :
Ils activent l’ héritage pour les variations et les champs individuels de vos fragments.
Exemple d’utilisation example-usage
Un fragment, avec ses éléments et ses variations, peut être utilisé afin de créer du contenu homogène sur plusieurs canaux. Lors de la conception de votre fragment, tenez compte de son utilisation et de son emplacement d’utilisation.
Exemple WKND wknd-sample
Les exemples du site WKND sont fournis pour vous aider à en savoir plus sur AEM as a Cloud Service.
Le projet WKND comprend :
-
les modèles de fragments de contenu disponibles sous :
http://<hostname>:<port>/libs/dam/cfm/models/console/content/models.html/conf/wknd -
les fragments de contenu (et autres contenus) disponibles sous :
http://<hostname>:<port>/assets.html/content/dam/wknd/en