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.

Création d’un fragment de contenu

La méthode de création de fragments de contenu est (fondamentalement) la même pour les fragments simples et structurés :

  1. Accédez au dossier de 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 que vous spécifiiez la base du nouveau fragment.

    • Cela peut être :
      • un modèle, par exemple, un Fragment simple ;
      • un modèle utilisé pour créer un fragment qui nécessite du contenu structuré, par exemple, le modèle d’aéroport.
    • Tous les modèles disponibles sont affichés.

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

    chlimage_1
  4. À 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 sera dérivé automatiquement à partir du titre, mais il peut être mis à jour.
  5. Sélectionnez Créer pour terminer l’action, puis ouvrez le fragment pour le modifier ou retournez à la console en utilisant le bouton Terminé.

Actions pour un fragment de contenu

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

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
  • Gérer les balises
  • À la 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.

Ouverture de l’éditeur de fragments

Pour modifier votre fragment :

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

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

    chlimage_1

    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.

  3. Naviguez parmi les trois modes à l’aide des icônes du panneau latéral :

    chlimage_1
  4. Après avoir apporté vos modifications, sélectionnez Enregistrer ou Annuler, selon vos besoins.

    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.

Enregistremet, annulation et versions

L’éditeur comporte deux options :

  • Enregistrer

    Permet d’enregistrer les dernières modifications et de quitter l’éditeur.

    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.

  • Annuler

    Permet de quitter l’éditeur sans enregistrer les dernières modifications.

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 :

  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.

    Pour connaître la valeur par défaut, voir :

    /libs/settings/dam/cfm/jcr:content/autoSaveInterval

  3. Si l’utilisateur sélectionne Annuler pour 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 sélectionne Enregistrer pour conserver les modifications apportées, les éléments ou variations mis à jour sont conservés et le jeton est supprimé pour mettre fin à la session de modification.

Modification du contenu du fragment

Le même éditeur est utilisé pour tous les fragments. Toutefois, il existe des différences mineures dans les options disponibles :

Éditeur de texte enrichi - mode Plein écran

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 :

chlimage_1

L’éditeur propose également :

  • un menu déroulant pour alterner entre les trois options suivantes :

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

  • une action pour afficher les statistiques de texte :

    chlimage_1
  • la possibilité de fermer le mode Plein écran et de retourner au fonctionnement normal de l’éditeur de fragments.

Création et gestion de variations dans un fragment

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.

Création d’une variation

Pour créer une variation :

  1. Ouvrez votre fragment et assurez-vous que le panneau latéral est visible.

  2. Sélectionnez Variations dans la barre d’outils du panneau latéral.

    chlimage_1
    chlimage_1
  3. Sélectionnez Créer une variation.

  4. Une boîte de dialogue s’ouvre alors. Indiquez le Titre et la Description de la nouvelle variation.

    chlimage_1
  5. 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.

Modification d’une variation

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).
chlimage_1

Modification du nom d’une variation

Pour renommer une variation existante :

  1. Ouvrez votre fragment et sélectionnez Variations dans le panneau latéral.
  2. Sélectionnez la variation requise.
  3. Sélectionnez Renommer dans le menu déroulant Actions.
  4. Indiquez le nouveau Titre et/ou la nouvelle Description dans la boîte de dialogue qui s’affiche.
  5. Confirmez l’action Renommer.

Remarque :

Vous ne pouvez pas renommer le gabarit.

Cette opération concerne uniquement le titre de la variation.

Suppression d’une variation

Pour supprimer une variation existante :

  1. Ouvrez le fragment et sélectionnez Variations dans le panneau latéral.
  2. Sélectionnez la variation requise.
  3. Sélectionnez Supprimer dans le menu déroulant Actions.
  4. Confirmez la suppression dans la boîte de dialogue.

Remarque :

Vous ne pouvez pas supprimer le gabarit.

Synchronisation avec 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.

  1. Ouvrez votre fragment de contenu dans l’éditeur de fragments. Assurez-vous que le gabarit a été modifié.

  2. Sélectionnez une variation spécifique, puis ouvrez-la en mode plein écran.

    Attention :

    La synchronisation est uniquement disponible en mode Plein écran.

  3. Sélectionnez l’option de synchronisation avec le gabarit.

    chlimage_1
  4. Le gabarit et la variation seront affichés côte à côte.

    chlimage_1
  5. Sélectionnez Synchroniser. La variation est alors mise à jour et affichée.

  6. Vous pouvez désormais fermer le mode Plein écran et enregistrer le fragment.

Association de contenu au fragment

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.

Ajout de contenu associé

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 :

  1. Ouvrez votre fragment et sélectionnez le contenu associé dans le panneau latéral.

    chlimage_1
  2. Sélectionnez Associer le contenu ou Associer la collection (le cas échéant, selon que des collections ont été associées ou non).

  3. Sélectionnez la collection requise.

    chlimage_1

    Remarque :

    Au cours de cette étape, vous pouvez ajouter le fragment à la collection sélectionnée, car cela facilite le suivi. 

  4. Confirmez (en cochant). La collection sera répertoriée comme associée.

    chlimage_1

Modification du contenu associé

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.

Affichage et modification des métadonnées du fragment

Modification des propriétés/métadonnées

Vous pouvez afficher et modifier les métadonnées (propriétés) des fragments de contenu :

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

  2. Vous pouvez :

    chlimage_1
  3. La section De base contient des options que vous pouvez afficher ou modifier :

    • une miniature : vous pouvez télécharger une image ;
    • Titre
    • Description
    • Balises
    • Créé (affichage uniquement)
    chlimage_1

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

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 :

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.

Suppression d’un fragment de contenu

Pour supprimer un fragment :

  1. Dans la console Ressources, accédez à 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é 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.

Utilisation du fragment de contenu sur une page

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.

Ajout d’un fragment de contenu à une page

Remarque :

Cet exemple est basé sur les nouveaux composants principaux. 

  1. Ouvrez la page à modifier.

  2. Ajoutez le composant du fragment de contenu approprié depuis l’explorateur de composants ou via l’option Insérer un nouveau composant.

  3. Ouvrez la boîte de dialogue Configurer pour le composant.

    Puis :

    • Spécifiez le fragment de contenu à référencer. Le sélecteur vous permet de naviguer jusqu’à l’emplacement voulu.
    • Ajoutez les éléments à afficher ou laissez la zone vide pour afficher tous les éléments.
    chlimage_1
  4. Enregistrez les paramètres en utilisant la coche. Les éléments requis du fragment sélectionné s’affichent.

    chlimage_1

Autres actions de création de pages avec les fragments de contenu

Documentation connexe

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne