Vous consultez actuellement l'aide de la version:
Les fragments de contenu sont disponibles depuis la version AEM 6.2. Dans AEM 6.2 comme AEM 6.3, ils étaient (principalement) limités à un format textuel uniquement, sans structure prédéfinie.
Avec ce Feature Pack, il existe désormais deux types de fragments de contenu :
- Les fragments simples (comme décrits précédemment)
Ils n’ont pas de structure prédéfinie. Ils contiennent uniquement du texte et des images.
Ils sont basés sur le modèle de fragment simple. - Les fragments contenant du contenu structuré (nouveaux)
Ils sont basés sur un modèle de fragment de contenu, qui prédéfinit une structure pour le fragment résultant.
Ils peuvent également être utilisés pour réaliser des services de contenu à l’aide de l’exportateur JSON.
La méthode de création de fragments de contenu est (fondamentalement) la même pour les fragments simples et structurés :
Dans la console Ressources, différentes actions sont disponibles pour vos fragments de contenu, soit :
- dans la barre d’outils - une fois le fragment sélectionné, toutes les actions appropriées sont disponibles ;
- sous forme d’actions rapides - un sous-ensemble d’actions disponibles pour les différentes cartes de fragments.

Sélectionnez le fragment pour afficher la barre d’outils avec les actions applicables :
- Créer
- Télécharger
- Enregistrez le fragment sous forme d’un fichier ZIP. Vous pouvez indiquer si vous souhaitez inclure des éléments, des variations ou des métadonnées.
- Passage en caisse
- Propriétés
- Permet d’afficher ou de modifier les métadonnées du fragment.
- Édition
- Permet d’ouvrir le fragment pour modifier le contenu ainsi que ses variations, contenu, métadonnées et éléments associés.
- Gérer les balises
- À la collection
- Ajoutez le fragment à une collection.
- Cela peut également être réalisé en associant une collection au fragment.
- Ajoutez le fragment à une collection.
- Copier/Coller
- Déplacer
- Publier/Annuler la publication
- Mettre en relation/Ne plus mettre en relation
- Supprimer
Remarque :
La plupart de ces actions sont standard pour les ressources et/ou l’application de bureau.
-
Ouvrez le fragment à modifier, en procédant de l’une des manières suivantes :
- Cliquez/appuyez sur le fragment ou le lien vers le fragment (selon la vue de la console).
- Une fois le fragment sélectionné, choisissez Modifier dans la barre d’outils.
L’éditeur de fragments s’ouvre :
Remarque :
1. Un message s’affiche si le fragment est déjà référencé sur une page de contenu.
2. Le panneau latéral peut être masqué ou affiché à l’aide de l’icône Activer/désactiver le panneau latéral.
-
Naviguez parmi les trois modes à l’aide des icônes du panneau latéral :
- Variations : Modification du contenu et Gestion des variations
- Contenu associé
- Métadonnées
-
Remarque :
Les boutons Enregistrer et Annuler permettent tous deux de quitter l’éditeur. Pour en savoir plus sur le fonctionnement des deux options pour les fragments de contenu, voir Enregistrement, annulation et versions.
-
Remarque :
Il est possible de rester dans l’éditeur et de réaliser plusieurs modifications avant de sélectionner Enregistrer.
Attention :
L’option Enregistrer vous permet non seulement d’enregistrer vos modifications, mais aussi de mettre à jour les références et de vérifier que le répartiteur est purgé comme requis. Ces modifications peuvent prendre du temps à traiter. Par conséquent, il se peut qu’il y ait un impact sur la performance des systèmes vastes, complexes ou très chargés.
Gardez cela à l’esprit lorsque vous sélectionnez Enregistrer, puis rouvrez rapidement l’éditeur de fragments pour réaliser d’autres modifications et les enregistrer.
Lorsque vous modifiez votre fragment de contenu, AEM crée automatiquement des versions pour que le contenu précédent puisse être restauré si vous annulez les modifications :
-
Lorsqu’un fragment de contenu est ouvert pour modification, AEM vérifie l’existence d’un jeton basé sur les cookies indiquant s’il existe une session de modification :
- Si ce jeton est trouvé, le fragment est considéré comme faisant partie de la session de modification existante.
- Si le jeton n’est pas disponible et que l’utilisateur commence à modifier le contenu, une version est créée et un jeton est envoyé au client pour cette nouvelle session de modification, où il est enregistré dans un cookie.
-
Lors d’une session de modification active, le contenu en cours de modification est automatiquement enregistré toutes les 600 secondes (par défaut).
Remarque :
L’intervalle d’enregistrement automatique est configurable à l’aide du mécanisme /conf.
Pour connaître la valeur par défaut, voir :
/libs/settings/dam/cfm/jcr:content/autoSaveInterval
Le même éditeur est utilisé pour tous les fragments. Toutefois, il existe des différences mineures dans les options disponibles :
-
Pour les fragments simples, vous pouvez :
- modifier le contenu, notamment en utilisant l’éditeur de texte enrichi pour le texte multi-ligne ;
- créer et gérer des variations ;
- associer du contenu ;
- afficher et modifier des métadonnées.
-
Pour les fragments structurés, vous pouvez :
- modifiez le contenu en fonction du type de données, notamment en utilisant l’éditeur de texte enrichi pour le texte multi-ligne ;
- associer du contenu ;
- afficher et modifier des métadonnées.
Remarque :
Pour en savoir plus sur les options disponibles, consultez les informations sur la création de pages avec l’éditeur de texte enrichi.
Pour les deux types de fragments, l’éditeur de texte enrichi est disponible en mode Plein écran lors de l’édition de texte multi-ligne. Par exemple :

-
un menu déroulant pour alterner entre les trois options suivantes :
- Texte enrichi ;
- Texte (Markdown) ;
- Texte brut.
Attention :
Si vous sélectionnez Texte brut, vous risquez de perdre le formatage, le markdown ou les ressources que vous avez insérés dans le texte enrichi ou texte (Markdown).
Attention :
Il n’est pas possible de créer des variations supplémentaires pour les fragments structurés (basés sur des modèles).
Les variations vous permettent de faire varier le contenu Maître en fonction de vos besoins, le cas échéant.
-
Sélectionnez Ajouter pour copier le gabarit du fragment dans la nouvelle variation, qui est maintenant ouverte pour modification.
Remarque :
Lors de la création d’une nouvelle variation, c’est toujours le gabarit qui est copié, et non la variation ouverte.
Vous pouvez apporter des modifications (élémentaires) au contenu de la variation après avoir :
- créé votre variation ;
- ouvert une variation existante (en ouvrant les variations puis en sélectionnant la variation appropriée dans le panneau latéral).

Pour renommer une variation existante :
- Ouvrez votre fragment et sélectionnez Variations dans le panneau latéral.
- Sélectionnez la variation requise.
- Sélectionnez Renommer dans le menu déroulant Actions.
- Indiquez le nouveau Titre et/ou la nouvelle Description dans la boîte de dialogue qui s’affiche.
- Confirmez l’action Renommer.
Remarque :
Vous ne pouvez pas renommer le gabarit.
Cette opération concerne uniquement le titre de la variation.
Pour supprimer une variation existante :
- Ouvrez le fragment et sélectionnez Variations dans le panneau latéral.
- Sélectionnez la variation requise.
- Sélectionnez Supprimer dans le menu déroulant Actions.
- Confirmez la suppression dans la boîte de dialogue.
Remarque :
Vous ne pouvez pas supprimer le gabarit.
Le gabarit fait partie intégrante du fragment de contenu. Par définition, il contient la version principale du contenu, tandis que les variations contiennent les différentes versions sur mesure et mises à jour de ce contenu. Lorsque le gabarit est mis à jour, il est possible que ces modifications soient également pertinentes pour les variations et qu’elles doivent donc leur être appliquées.
Lorsque vous modifiez une variation en mode Plein écran, vous avez accès à l’action de synchronisation avec le gabarit. Cela vous permet de copier automatiquement les modifications apportées au gabarit sur la variation requise.
Attention :
La synchronisation peut également servir à copier les modifications du gabarit sur la variation.
Le transfert des modifications d’une variation au gabarit n’est pas une option disponible.
Le contenu associé fait office de liaison pour que les ressources (c’est-à-dire les images) puissent éventuellement être utilisées avec le fragment lorsqu’il est ajouté à une page de contenu. Vous bénéficiez ainsi d’une certaine souplesse, car vous disposez d’une gamme de ressources auxquelles accéder lors de l’utilisation du fragment de contenu sur une page. Cela permet aussi de réduire le temps nécessaire pour rechercher la ressource appropriée.
Remarque :
Il existe différentes méthodes pour ajouter des éléments visuels (des fichiers d’image, par exemple) au fragment et/ou à la page.
Pour effectuer l’association, vous devez d’abord ajouter les ressources multimédias à une collection. Une fois l’ajout effectué, vous pouvez réaliser les étapes suivantes :
Une fois que vous avez associé une collection, vous pouvez :
- supprimer l’association ;
- ajouter des ressources à la collection ;
- sélectionnez une ressource pour effectuer une action ;
- modifier la ressource.
-
Vous pouvez :
- Sélectionnez Afficher les propriétés pour ouvrir les boîtes de dialogue. Une fois la collection ouverte pour consultation, vous pouvez également la modifier.
- Ouvrez le fragment de contenu à modifier, puis sélectionnez les métadonnées dans le panneau latéral.
Attention :
Si votre fragment est basé sur un modèle, vous devez vous assurer que le modèle a été publié.
Les fragments de contenu doivent être publiés pour être utilisés sur une page web dans l’environnement de publication. Ils peuvent être publiés :
- Une fois créés, depuis la console Ressources.
- Lorsque vous publiez une page qui utilise le fragment, celui-ci est répertorié dans les références de la page.
Attention :
Une fois qu’un fragment a été publié et/ou référencé, AEM affiche un avertissement lorsqu’un auteur ouvre à nouveau ce fragment en mode d’édition. Il s’agit de signaler que les modifications apportées au fragment seront répercutées sur les pages référencées.
-
Attention :
Si le fragment est déjà référencé dans une page, un message d’avertissement vous demande de confirmer que vous souhaitez poursuivre et forcer la suppression. Le fragment et son composant de fragment de contenu seront supprimés de toutes les pages de contenu.
Attention :
Pour utiliser les fragments structurés (basés sur un modèle de contenu), assurez-vous d’avoir installé le composant principal approprié. Reportez-vous aux instructions d’installation.
Remarque :
Après avoir ajouté un fragment structuré (basé sur un modèle de contenu) sur la page, vous pouvez l’utiliser pour proposer des services de contenu lors de l’utilisation de l’exportateur JSON.
Les fragments de contenu d’Adobe Experience Manager (AEM) sont créés et gérés en tant que ressources au niveau de la page.
Ils vous permettent de créer du contenu compatible avec tous les canaux, ainsi que des variations (éventuellement spécifiques aux canaux). Vous pouvez ensuite utiliser ces fragments et leurs variantes lors de la création de vos pages de contenu.
Remarque :
Cet exemple est basé sur les nouveaux composants principaux.
Pour plus d’informations sur la création avec des fragments de contenu, consultez la documentation d’AEM 6.3 :