L’API AEM GraphQL pour la Diffusion Fragments de contenu est disponible sur demande.
Contactez le support Adobe pour activer l'API pour votre AEM en tant que programme Cloud Service.
Les fragments de contenu sont stockés en tant que Ressources, et ils sont donc principalement gérés par l’intermédiaire de la console Ressources.
Les fragments de contenu peuvent être utilisés :
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é.
La méthode de création d’un fragment de contenu est la suivante :
Accédez au dossier Ressources dans lequel vous souhaitez créer le fragment.
Pour ouvrir l’assistant, sélectionnez Créer, puis Fragment de contenu.
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, le modèle Adventure.
Après la sélection, cliquez ou appuyez sur Suivant pour continuer.
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 sera dérivé automatiquement du titre, mais il peut être modifié.
Sélectionnez Créer pour terminer l’action, puis ouvrez le fragment en mode d’édition ou revenez à la console en sélectionnant Terminé.
Dans la console Ressources, différentes actions sont disponibles pour vos fragments de contenu, soit :
Sélectionnez le fragment pour afficher la barre d’outils avec les actions applicables :
Retraiter les éléments
Créer
Téléchargement
Passage en caisse
Propriétés
Modifier
Publication rapide
Gérer la publication
Gérer les balises
À la collection
Copier (et Coller)
Déplacer
Supprimer
La plupart de ces actions sont standard pour Assets et/ou l’application de bureau AEM.
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.
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 Assets afin de naviguer jusqu’à l’emplacement de votre fragment de contenu.
Ouvrez le fragment en mode édition, en effectuant l’une des opérations suivantes :
L’éditeur de fragment s’ouvre alors :
Naviguez parmi les trois modes à l’aide des icônes du panneau latéral :
Variations : Modification du contenu et Gestion des variations
Après avoir effectué les modifications, utilisez Enregistrer ou Annuler selon le cas.
Les options Enregistrer et Annuler vous font quitter l’éditeur. Pour plus d’informations sur le fonctionnement des deux options avec les fragments de contenu, voir Enregistrer, Annuler et Versions.
Les versions peuvent également être créées, comparées et rétablies à partir de la chronologie.
L’éditeur possède deux options :
Enregistrer
Enregistre les dernières modifications et quitte l’éditeur.
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 de sélectionner Enregistrer.
En plus de simplement enregistrer vos modifications, l’option Enregistrer met à jour les références éventuelles et s’assure 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é.
Veuillez en tenir compte lorsque vous exécutez Enregistrer, puis rouvrez aussitôt l’éditeur de fragments afin d’apporter d’autres modifications et de les enregistrer.
Annuler
Ferme 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 :
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.
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 un libellé 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 :
Les annotations (pour les fragments de contenu) sont :
Par exemple :
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 seront affichées côte à côte, où :
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 restaurer à 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.
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.
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. Ils peuvent être publiés :
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 supprimer un fragment :
Dans la console Ressources, 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é 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.