Gérer des fragments de contenu

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 :

REMARQUE

Il est possible d’utiliser les fragments de contenu comme suit :

REMARQUE

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.

Console Fragments de contenu

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 :

Créer des fragments de contenu

Création d’un modèle 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é.

Création d’un fragment de contenu

Pour créer un fragment de contenu :

  1. Dans la console Fragments de contenu, sélectionnez Créer (en haut à droite).

    REMARQUE

    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.

  2. La boîte de dialogue Nouveau fragment de contenu s’ouvre. À partir d’ici, vous pouvez spécifier les éléments suivants :

    • Emplacement : l’emplacement actuel sera renseigné automatiquement, mais vous pouvez sélectionner un autre emplacement si nécessaire.
    • Modèle de fragment de contenu : sélectionnez le modèle à utiliser comme base du fragment dans la liste déroulante.
    • Titre
    • Nom : le nom sera automatiquement renseigné en fonction du Titre, mais vous pouvez le modifier si nécessaire.
    • Description

    Boîte de dialogue Nouveau fragment de contenu

  3. Sélectionnez Créer ou Créer et ouvrir pour conserver votre définition.

Statuts des fragments de contenu

Au cours de son existence, un fragment de contenu peut avoir plusieurs statuts, comme indiqué dans la console Fragments de contenu :

  • Nouveau
    Un nouveau fragment de contenu a été créé, mais n’a jamais été modifié, ni ouvert, dans l’éditeur de fragment de contenu.
  • Brouillon
    Quelqu’un a modifié ou ouvert le (nouveau) fragment de contenu dans l’éditeur de fragment de contenu, mais il n’a pas encore été publié.
  • Publié
    Le fragment de contenu a été publié.
  • Modifié
    Le fragment de contenu a été modifié après sa publication (mais avant de publier la modification).
  • Non publié
    La publication du fragment de contenu a été annulée.

Ouverture de l’éditeur de fragments

Pour ouvrir votre fragment à des fins de modification :

ATTENTION

Pour modifier un fragment de contenu, vous devez disposer des autorisations appropriées. Si vous rencontrez des problèmes, contactez votre administrateur système.

  1. Utilisez la console Fragments de contenu afin de naviguer jusqu’à l’emplacement de votre fragment de contenu.

  2. Ouvrez le fragment à modifier en le sélectionnant, puis en cliquant sur Ouvrir dans la barre d’outils.

  3. L’éditeur de fragment s’ouvre alors. Apportez les modifications nécessaires :

    éditeur de fragment

  4. Après avoir apporté vos modifications, cliquez sur Enregistrer, Enregistrer et fermer ou Fermer selon les besoins.

    REMARQUE

    L’option Enregistrer et fermer est disponible dans la liste déroulante Enregistrer.

    REMARQUE

    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.

Modes et actions dans l’éditeur de fragment de contenu

L’éditeur de fragments de contenu comporte différents modes et actions.

Modes dans l’éditeur de fragment de contenu

Naviguez entre les différents modes en utilisant les icônes du panneau latéral :

modes

Barre d’outils d’actions dans l’éditeur de fragment de contenu

Certaines fonctions de la barre d’outils supérieure sont disponibles dans différents modes :

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 :

    • Le nom est également un lien servant à ouvrir l’éditeur de modèles.
  • 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 :

    • Nouveau : gris
    • Version préliminaire : bleu
    • Publié : vert
    • Modifié : orange
    • Désactivé : rouge
  • 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 :

Enregistrer, Fermer et Versions

REMARQUE

L’éditeur possède différentes options :

  • Enregistrer et Enregistrer et fermer

    • Enregistrer enregistrera les dernières modifications et vous resterez dans l’éditeur.
    • Enregistrer et fermer enregistrer les dernières modifications et vous permet de quitter l’éditeur.
    ATTENTION

    Pour modifier un fragment de contenu, vous devez disposer des autorisations appropriées. Si vous rencontrez des problèmes, contactez votre administrateur système.

    REMARQUE

    Pour rester dans l’éditeur, il suffit d’apporter une série de modifications avant d’enregistrer.

    ATTENTION

    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) :

  1. 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 :

    1. Si ce jeton est trouvé, le fragment est considéré comme faisant partie de la session de modification existante.
    2. 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.
  2. 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.

    Valeur par défaut, voir :
      /libs/settings/dam/cfm/jcr:content/autoSaveInterval

  3. 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.

  4. 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.

Modification du contenu du fragment

Une fois que vous avez ouvert le fragment, vous pouvez utiliser l’onglet Variations pour créer votre contenu.

Création et gestion de variations dans un fragment

Une fois que vous avez créé le contenu maître, vous pouvez créer et gérer des Variations de ce contenu.

Association de contenu au fragment

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.

Affichage et modification des métadonnées (propriétés) du fragment

Vous pouvez afficher et modifier les propriétés d’un fragment à l’aide de l’onglet Métadonnées.

Publication et référencement d’un fragment

ATTENTION

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.

De plus, lorsque vous publiez une page qui utilise ce 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 également répercutées sur les pages référencées.

Annuler la publication d’un fragment

Pour annuler la publication de fragments de contenu, sélectionnez un ou plusieurs fragments, puis cliquez sur Annuler la publication.

REMARQUE

L’action Annuler la publication est visible lorsque des fragments publiés sont disponibles.

ATTENTION

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.

Suppression d’un fragment

Pour supprimer un fragment :

  1. Dans la console Fragments de contenu, naviguez jusqu’à l’emplacement de votre fragment de contenu.

  2. Sélectionnez le fragment.

    REMARQUE

    L’action Supprimer n’est pas proposée comme action rapide.

  3. Sélectionnez Supprimer dans la barre d’outils.

  4. Confirmez l’action Supprimer.

    ATTENTION

    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.

Recherche des références parentes du fragment

Les détails des références parentes sont accessibles à partir de la colonne Références de la Console Fragments de contenu.

Recherche des copies de langue du fragment

Les détails des copies de langue sont accessibles à partir de la colonne Langue de la Console Fragments de contenu.

Chronologie pour les fragments de contenu

REMARQUE

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

    • Supprimer
REMARQUE

Les commentaires :

  • Une fonctionnalité standard pour toutes les ressources
  • Réalisés dans la chronologie
  • Liés à la ressource de fragment
    Les annotations (pour les fragments de contenu) sont :
  • Entrées dans l’éditeur de fragments
  • Spécifiques à un segment de texte sélectionné au sein du fragment

Par exemple :

chronologie

Comparaison des versions de fragments

REMARQUE

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 ;

    • le texte supprimé est en rouge ;
    • le texte inséré est en vert ;
    • le texte remplacé est en bleu.
  • 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

REMARQUE

Vous ne pouvez pas modifier le contenu du fragment lors de la comparaison des fragments.

comparaison

Restauration vers une version spécifique

REMARQUE

Cette fonctionnalité n’est disponible que dans la console Ressources.

Vous pouvez restaurer vers une version spécifique de votre fragment :

Sur cette page