Utiliser des fragments de contenu

Avec Adobe Experience Manager (AEM) as a Cloud Service, les fragments de contenu vous permettent de concevoir, de créer, d’organiser et de publier du contenu indépendant des pages. Ils vous permettent de préparer du contenu prêt à être utilisé à plusieurs emplacements ou sur plusieurs canaux, idéal pour une diffusion découplée.

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.
    • Peut être utilisée pour préparer du contenu simple à utiliser pour 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.
    • Peut être utilisée soit pour la préparation de contenu plus structuré pour la création de pages, soit pour la diffusion à 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 Fragments de contenu, ainsi que GraphQL, pour diffuser du contenu à utiliser dans vos applications. Pour vous aider, vous pouvez prévisualiser la sortie JSON.

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 exactement 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 d’effectuer les opérations suivantes :

• Étudions comment atteindre efficacement les audiences cibles sur plusieurs canaux.
• Créez et gérez du contenu éditorial neutre pour les canaux.
• Créez des pools de contenu pour divers canaux.
• Concevez des variations de contenu pour des canaux spécifiques.
• Ajoutez des images à votre texte en insérant des ressources (fragments de supports variés).
• Créez du contenu imbriqué pour 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.

Fragments de contenu et services de contenu

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 ; texte, données numériques, valeur booléenne, date et heure, etc.

Associé aux fonctionnalités d’exportation JSON des composants de base AEM, ce contenu structuré peut ensuite être utilisé pour livrer le contenu AEM à des canaux autres que les pages AEM.

Type de contenu

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 fonction Ressources console.
  • Créés et modifiés dans l’éditeur de fragment de contenu.

• Utilisés dans l’éditeur de page au moyen du composant Fragment de contenu (qui fait référence au 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 sont pas mises en page ou mises en page (certaines mises en forme de texte sont possibles en mode Texte enrichi) ;

• Contenir un ou plusieurs parties constituantes.

• Peut contenir des images ou être connecté à celles-ci ;.

• peut utiliser du contenu intermédiaire en cas de référencement sur une page ;

• est indépendant du mécanisme de livraison (c’est-à-dire de la page ou du canal).

Fragments avec des ressources visuelles

Pour donner aux auteurs 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 supports variés)

  • font partie intégrante du fragment (voir Parties constituantes d’un fragment de contenu).
  • Définissez la position de la ressource.
  • Voir Insertion de ressources dans votre fragment dans l’éditeur de fragments pour plus d’informations.
  REMARQUE

  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 lorsque du contenu intermédiaire est ajouté.

• Contenu associé

  • sont connectés à un fragment ; mais pas une partie fixe du fragment (voir Parties constituantes d’un fragment de contenu).
  • Permettent une certaine souplesse de positionnement.
  • Sont facilement disponibles 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.
  • Permettent une certaine souplesse de 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

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.

  • Sont intégrées dans le système de paragraphe du fragment.

  • Peut être formaté lorsque la variable fragment 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 de 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).

    ATTENTION

    Des ressources peuvent être supprimées (par inadvertance) d’un fragment lors du passage au format texte brut.

    REMARQUE

    Les ressources peuvent également être ajoutées en tant que contenu supplémentaire (intermédiaire) lors de l’utilisation d’un fragment sur une page ; à l’aide du contenu associé ou des ressources de l’explorateur de ressources.

• 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, 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 via des collections ; les collections associées permettent à l’auteur de déterminer les ressources à utiliser lors de la création d’une 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.
    • Collections de ressources (DAM) sont 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 la variable Schémas de métadonnées Assets.

  • Les balises peuvent être créées lorsque vous :

    • Création et création du fragment

    • Ou plus tard :

      • En affichant/modifiant le fragment Propriétés depuis la console
      • En modifiant les Métadonnées dans l’éditeur de fragments
  ATTENTION

  Les profils de traitement des métadonnées ne s’appliquent pas aux fragments de contenu.

• Maître

  • Partie intégrante 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 à 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 l’instance maître, mais peuvent ensuite être modifiées si besoin. Il existe généralement un chevauchement de contenu entre les différentes variations.
  • 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é 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

Contenu intermédiaire :

• Il est disponible dans l’éditeur de page lorsque vous utilisez des fragments de contenu.
• Il s’agit de contenu supplémentaire ajouté dans le flux d’un fragment une fois qu’il a été utilisé ou référencé sur une page.
• Il est disponible dans l’éditeur de page lorsque vous utilisez des 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

Pour créer des fragments de contenu, vous devez disposer des éléments suivants :

• 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 de fragment de contenu

  • Utilitaire de diffusion du fragment au format HTML et/ou JSON.
  • Obligatoire pour référencer le fragment sur une page.
  • Responsable de la mise en page 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 mise en page, 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.

Exemple d’utilisation

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 d’un fragment, vous devez prendre en compte où vous utiliserez chacun de ses éléments.

Exemple WKND

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

Ressources Business.Adobe.com