Découvrez comment utiliser la console Fragments de contenu pour gérer vos fragments de contenu AEM. Ils peuvent être utilisés pour la création de pages ou comme base de votre contenu headless.
Après avoir défini vos modèles de fragment de contenu, vous pouvez les utiliser pour créer vos fragments de contenu.
L’éditeur de fragment de contenu fournit différents modes vous permettant :
Il est possible d’utiliser les fragments de contenu comme suit :
Les fragments de contenu sont stockés sous forme de ressources. Ils sont principalement gérés à partir de la console Fragments de contenu mais peuvent également être gérés à partir de la console Ressources.
La console Fragments de contenu permet d’accéder directement à vos fragments et aux tâches qui s’y rapportent. Pour plus d’informations, consultez la section suivante :
Structure de base et gestion de la console Fragments de contenu
Actions pour un fragment de contenu dans la console Fragments de contenu
Personnaliser les colonnes disponibles dans la console Fragments de contenu
Les modèles de fragments de contenu peuvent être activés et créés, avant de créer des fragments de contenu avec le contenu structuré.
Pour créer un fragment de contenu :
Dans la console Fragments de contenu, sélectionnez Créer (en haut à droite).
Pour prédéfinir l’emplacement du nouveau fragment, vous pouvez accéder au dossier dans lequel vous souhaitez créer le fragment ou spécifier l’emplacement pendant le processus de création.
La boîte de dialogue Nouveau fragment de contenu s’ouvre. À partir d’ici, vous pouvez spécifier les éléments suivants :
Sélectionnez Créer ou Créer et ouvrir pour conserver votre définition.
Au cours de son existence, un fragment de contenu peut avoir plusieurs statuts, comme indiqué dans la console Fragments de contenu :
Pour ouvrir votre fragment à des fins de modification :
Pour modifier un fragment de contenu, vous devez disposer des autorisations appropriées. Si vous rencontrez des problèmes, contactez votre administrateur système.
Utilisez la console Fragments de contenu afin de naviguer jusqu’à l’emplacement de votre fragment de contenu.
Ouvrez le fragment à modifier en le sélectionnant, puis en cliquant sur Ouvrir dans la barre d’outils.
L’éditeur de fragment s’ouvre alors. Apportez les modifications nécessaires :
Après avoir apporté vos modifications, cliquez sur Enregistrer, Enregistrer et fermer ou Fermer selon les besoins.
L’option Enregistrer et fermer est disponible dans la liste déroulante Enregistrer.
Les options Enregistrer et fermer et Fermer vous font quitter l’éditeur. Pour plus d’informations sur le fonctionnement des différentes options avec les fragments de contenu, voir Enregistrer, Fermer et Versions.
L’éditeur de fragments de contenu comporte différents modes et actions.
Naviguez entre les différents modes en utilisant les icônes du panneau latéral :
Variations : Modification du contenu et Gestion des variations
Certaines fonctions de la barre d’outils supérieure sont disponibles dans différents modes :
Un message s’affiche si le fragment est déjà référencé dans une page de contenu. Vous pouvez Fermer le message.
Le panneau latéral peut être masqué/affiché en appuyant sur l’icône Activer/désactiver le panneau latéral.
Sous le nom du fragment, vous pouvez voir le nom du Modèle de fragment de contenu utilisé pour créer le fragment actif :
Voir le statut du fragment, par exemple, les informations relatives à la date et à l’heure de création, de modification ou de publication. Le statut est également codé par couleur :
Enregistrer permet d’accéder à l’option Enregistrer et fermer.
La liste déroulante marquée des trois points (…) donne accès à des actions supplémentaires :
Les versions peuvent également être créées, comparées et rétablies à partir de la chronologie.
L’éditeur possède différentes options :
Enregistrer et Enregistrer et fermer
Pour modifier un fragment de contenu, vous devez disposer des autorisations appropriées. Si vous rencontrez des problèmes, contactez votre administrateur système.
Pour rester dans l’éditeur, il suffit d’apporter une série de modifications avant d’enregistrer.
En plus de simplement enregistrer vos modifications, ces actions mettent également à jour les références éventuelles et s’assurent que le Dispatcher est nettoyé si nécessaire. Le traitement de ces modifications peut prendre un certain temps. Cela peut donc avoir un impact sur les performances d’un système étendu/complexe/fortement chargé.
Prenez cela en compte lorsque vous exécutez Enregistrer et fermer puis rouvrez aussitôt l’éditeur de fragments afin d’apporter d’autres modifications et de les enregistrer.
Fermer
Quittera l’éditeur sans enregistrer les dernières modifications (c’est-à-dire effectuées depuis le dernier 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 (en cliquant sur Fermer sans enregistrer) :
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 :
Lors d’une session de modification active, le contenu en cours de modification est automatiquement enregistré toutes les 600 secondes (par défaut).
L’intervalle d’enregistrement automatique est configurable à l’aide du mécanisme /conf
.
Valeur par défaut, voir :
/libs/settings/dam/cfm/jcr:content/autoSaveInterval
Si l’utilisateur choisit d’annuler la modification, la version créée au début de la session de modification est restaurée et le jeton est supprimé afin de mettre fin à la session de modification.
Si l’utilisateur choisit d’enregistrer les modifications apportées, les éléments/variations mis à jour sont conservés et le jeton est supprimé pour mettre fin à la session de modification.
Une fois que vous avez ouvert le fragment, vous pouvez utiliser l’onglet Variations pour créer votre contenu.
Une fois que vous avez créé le contenu maître, vous pouvez créer et gérer des Variations de ce contenu.
Vous pouvez également associer du contenu à un fragment. Cela fournit une 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 pouvez afficher et modifier les propriétés d’un fragment à l’aide de l’onglet Métadonnées.
Si votre fragment est basé sur un modèle, vous devez vous assurer que le modèle a été publié.
Si vous publiez un fragment de contenu pour lequel le modèle n’a pas encore été publié, une liste de sélection indique cela, ainsi que le fait que le modèle sera publié avec le fragment.
Les fragments de contenu doivent être publiés pour être utilisés dans l’environnement de publication. Pour ce faire, utilisez la fonctionnalité Ressources standard.
À partir de l’option Publier dans la barre d’outils de la console Fragments de contenu.
Si nécessaire, vous devrez spécifier la Date d’activation et les références à publier. Par exemple :
À partir de l’éditeur de fragment de contenu.
De plus, lorsque vous publiez une page qui utilise ce fragment, celui-ci est répertorié dans les références de la page.
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 également répercutées sur les pages référencées.
Pour annuler la publication de fragments de contenu, sélectionnez un ou plusieurs fragments, puis cliquez sur Annuler la publication.
L’action Annuler la publication est visible lorsque des fragments publiés sont disponibles.
Si le fragment est déjà référencé à partir d’un autre fragment ou d’une page, alors un message d’avertissement s’affiche et vous devez confirmer que vous souhaitez poursuivre.
Pour supprimer un fragment :
Dans la console Fragments de contenu, naviguez jusqu’à l’emplacement de votre fragment de contenu.
Sélectionnez le fragment.
L’action Supprimer n’est pas proposée comme action rapide.
Sélectionnez Supprimer dans la barre d’outils.
Confirmez l’action Supprimer.
Si le fragment est déjà référencé à partir d’un autre fragment ou d’une page, un message d’avertissement s’affiche et vous devez confirmer que vous souhaitez procéder à une suppression forcée. Le fragment et son composant de fragment de contenu seront supprimés de toutes les pages de contenu.
Les détails des références parentes sont accessibles à partir de la colonne Références de la Console Fragments de contenu.
Les détails des copies de langue sont accessibles à partir de la colonne Langue de la Console Fragments de contenu.
Cette fonctionnalité n’est disponible que dans la console Ressources.
Outre les options standard, la Chronologie fournit les informations et les actions spécifiques aux fragments de contenu :
Affichage des informations sur les versions, commentaires et annotations
Actions pour les versions
Revenir à cette version (sélectionner un fragment existant, puis une version spécifique)
Comparer à actuel (sélectionner un fragment existant, puis une version spécifique)
Ajouter une étiquette et/ou un commentaire (sélectionner un fragment existant, puis une version spécifique)
Enregistrer comme version (sélectionner un fragment existant, puis la flèche du haut au bas de la chronologie)
Actions pour les annotations
Les commentaires :
Par exemple :
Cette fonctionnalité n’est disponible que dans la console Ressources.
L’action de comparer à la version actuelle est disponible dans la chronologie après avoir sélectionné une version spécifique.
Cette opération va ouvrir :
la version actuelle (la plus récente) (à gauche) ;
la version sélectionnée v<x.y> (à droite).
Elles sont affichées dans des versions côte à côte dans lesquelles :
les différences sont mises en surbrillance ;
L’icône en plein écran permet d’ouvrir l’une ou l’autre version seule, puis de revenir en mode parallèle.
Vous pouvez rétablir la version spécifique
Terminé vous ramène à la console
Vous ne pouvez pas modifier le contenu du fragment lors de la comparaison des fragments.
Cette fonctionnalité n’est disponible que dans la console Ressources.
Vous pouvez restaurer vers une version spécifique de votre fragment :
Directement à partir de la chronologie.
Sélectionnez la version requise, puis l’action Revenir à cette version.
Lors de la comparaison d’une version à la version actuelle, vous pouvez restaurer la version sélectionnée.