Gestion des fragments de contenu

Découvrez comment utiliser la console Assets pour gérer vos fragments de contenu AEM à la base de votre contenu découplé.

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 :

• de modifier du contenu et de gérer des variations ;
• d’annoter votre fragment ;
• d’associer du contenu à votre fragment ;
• de configurer des métadonnées ;
• d’affcher l’arborescence de la structure ;
• de générer un aperçu de la représentation JSON.

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

La méthode de création d’un fragment de contenu est la suivante :

1. Accédez au dossier Ressources dans lequel vous souhaitez créer le fragment.

2. Pour ouvrir l’assistant, sélectionnez Créer, puis Fragment de contenu.

3. La première étape de l’assistant nécessite de spécifier la base du nouveau fragment.

   • Modèle - utilisé pour créer un fragment qui nécessite du contenu structuré ; par exemple, la fonction Adventure model

     • Tous les modèles disponibles s’affichent.

   Après la sélection, cliquez ou appuyez sur Suivant pour continuer.

   

4. Dans l’étape Propriétés, spécifiez :

   • De base

     • Titre

       Titre du fragment.

       Obligatoire.

     • Description

     • Balises

   • Avancé

     • Nom

       Nom utilisé pour former l’URL.

       Obligatoire, il est dérivé automatiquement du titre, mais il peut être modifié.

5. Sélectionnez Créer pour terminer l’action, puis ouvrez le fragment en mode d’édition ou revenez à la console en sélectionnant Terminé.

   REMARQUE

   En mode Liste de la console, vous pouvez mettre à jour les Paramètres d’affichage pour activer la colonne Modèle de fragment de contenu.

Actions pour un fragment de contenu dans la console de ressources

Dans la console Ressources, vous pouvez exécuter diverses actions pour vos fragments de contenu :

• Dans la barre d’outils, une fois le fragment sélectionné, toutes les actions appropriées sont disponibles :
• Comme actions rapides ; un sous-ensemble d’actions disponibles pour les cartes de fragments individuelles.

Sélectionnez le fragment pour afficher la barre d’outils avec les actions applicables :

• Retraiter les éléments

• 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, ou les deux, les métadonnées du fragment.

• Modifier

  • Permet : ouvrir le fragment pour modifier le contenu ; ainsi que ses éléments, variations, contenu et métadonnées associés.

• Publication rapide

• Gérer la publication

• Gérer les balises

• À la collection

• Copier (et coller)

• Déplacer

• Supprimer

Ouverture de l’éditeur de fragments

Pour ouvrir votre fragment à des fins de modification :

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

2. Ouvrez le fragment à modifier, en effectuant l’une des opérations suivantes :

   • Cliquer/appuyer sur le fragment ou le lien du fragment (cela dépend de l’affichage de la console).
   • Sélectionnez le fragment, puis cliquez sur Modifier dans la barre d’outils.

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

   

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

   REMARQUE

   Enregistrer et fermer est disponible au moyen de la fonction Enregistrer liste déroulante.

   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 :

• Variations : Modification du contenu et Gestion des variations

• Annotations

• Contenu associé

• Métadonnées

• Arborescence de la structure

• Aperçu

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 :

• 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 qui ouvre 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

• Un bouton permet de Essayer un nouvel éditeur, en ouvrant directement le new Éditeur de fragment de contenu accessible via le Console Fragments de contenu.

  AVERTISSEMENT

  Le nouvel éditeur s’ouvre dans le même onglet. Il est déconseillé d’ouvrir les deux éditeurs en même temps.

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

  • Mettre à jour les références de page
    • Cette option met à jour toutes les références de la page.
  • Publication rapide
  • Gérer la publication

Enregistrer, Fermer et Versions

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 administration 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 du temps. Ce délai peut avoir un impact sur les performances d’un système volumineux/complexe/lourdement chargé.

  Prenez cela en compte lorsque vous cliquez sur Enregistrer et fermer. Rouvrez aussitôt l’éditeur de fragments afin d’apporter d’autres modifications et de les enregistrer.

• Fermer

  Quitte l’éditeur sans enregistrer les dernières modifications (c’est-à-dire celles effectuées depuis la dernière fois que vous avez cliqué sur 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 le 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 ou l’utilisatrice 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. Vous fournissez ainsi une connexion afin que les ressources (les images, par exemple) puissent (éventuellement) être utilisées avec le fragment lorsqu’il est ajouté à une page de contenu.

Afficher et modifier 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.

Chronologie pour les fragments de contenu

Outre les options standard, la Chronologie fournit les informations et les actions spécifiques aux fragments de contenu :

• Affichage d’informations sur les versions, les commentaires et les 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 vers le haut située en bas du journal)

• Actions pour les annotations

  • Supprimer

Par exemple :

Comparaison des versions de fragments

L’action Comparer avec la version actuelle est disponible à partir du Journal après avoir sélectionné une version spécifique.

Cette action s’ouvre :

• la version actuelle (la plus récente) (à gauche) ;

• la version sélectionnée v<x.y> (à droite).

Ces dernières 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 plein écran vous permet d’ouvrir l’une des versions seule, puis de revenir à la vue parallèle.

• Vous pouvez rétablir la version spécifique

• Terminé vous ramène à la console.

Restauration vers une version spécifique

Vous pouvez rétablir une version spécifique de votre fragment :

• Directement à partir du Journal.

  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.

Publication et référencement d’un fragment

Les fragments de contenu doivent être publiés pour être utilisés dans l’environnement de publication. Pour ce faire, utilisez la fonctionnalité Assets standard :

• Publication rapide
• Gérer la publication

Vous pouvez y accéder des façons suivantes :

• Après la création, en utilisant les actions disponibles dans la console de ressources.
• Dans 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.

Suppression d’un fragment

Pour supprimer un fragment :

1. Dans la console Assets, naviguez jusqu’à l’emplacement du 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é 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 sont supprimés de toutes les pages de contenu.