En savoir plus sur l’utilisation de références dans les fragments de contenu author-headless-references

Un peu d’histoire… story-so-far

Au début du Parcours de création de contenu découplé AEM, l’Introduction présentait les concepts de base et la terminologie relatifs à la création découplée.

Vous avez appris les principes de base de la création CMS découplée grâce à une introduction à la création avec AEMaaCS et en particulier à la création de fragments de contenu.

Cet article s’appuie sur ces éléments afin que vous compreniez comment utiliser des références pour créer votre propre contenu pour votre projet AEM découplé.

Objectif objective

  • Audience  : Niveau avancé

  • Objectif  : découvrez l’utilisation de références pour la création CMS découplée. Quels types de références sont disponibles et à quelles fins :

    • Références du contenu
    • Références de ressources/médias
    • Références à un fragment
    • Références ad hoc depuis un bloc de texte

Que sont les références what-are-references

Les références sont simplement un mécanisme de connexion de vos ressources, qu’il s’agisse d’autres contenus, ressources (comme dans les images) ou autres fragments. Bien que très similaires, il existe des différences.

Certaines références comportent des types de données dédiés (par exemple, Références de contenu et Références de fragment), tandis que d’autres sont simplement ajoutées comme référence dans un bloc de texte (références de ressources et références ad hoc).

Fragments de contenu – Références

Références du contenu content-references

Leur nom est clair : les références de contenu vous permettent de faire référence à tout autre contenu. Vous accédez alors à un navigateur qui vous permet de sélectionner l’élément de contenu.

Références de ressources/médias assets-media-references

Les ressources (images ou médias, par exemple) peuvent être référencées dans un bloc de texte à l’aide de l’option Insérer une ressource. Un navigateur s’ouvre, vous permettant de sélectionner la ressource.

Fragments de contenu – Insérer une ressource

Références à un fragment fragment-references

Encore une fois, les références de fragment font exactement ce que leur nom suggère : elles vous permettent de faire référence à un autre fragment. La raison pour laquelle il est important d’insister sur ce fait nécessite un peu plus d’explications.

Par exemple, les modèles de fragment de contenu suivants peuvent être définis :

  • Ville
  • Entreprise
  • Personne
  • Distinctions

Cela semble évident, mais une entreprise compte à la fois un ou une PDG et des employées et employés…Et chaque élément d’entre eux est défini en tant que personne.

Et une personne peut recevoir une distinction (ou peut-être deux).

  • Mon entreprise – Société

    • PDG – Personne
    • Employé(s) – Personne
      • Récompense(s) personnelle(s) – Distinction

Voilà pour commencer. En fonction du niveau de complexité, une distinction peut être propre à une entreprise, ou le siège social d’une entreprise peut être situé dans une ville donnée.

Vous pouvez représenter ces interconnexions à l’aide de références de fragments, car ils peuvent être compris à la fois par vous (l’auteur) et par les applications découplées.

En tant qu’auteur ou autrice, vous n’êtes pas responsable de la définition de ces relations (l’architecte de contenu les définit lors de la création du modèle de fragment de contenu), mais vous devez savoir comment reconnaître et modifier les références.

Création de fragments imbriqués author-nested-fragment

La création de références de fragments est assez simple (bien que le champ ne soit généralement pas étiqueté comme Référence de fragment). Vous pouvez saisir directement la référence ou (plus couramment) sélectionner l’icône de dossier pour ouvrir un navigateur qui vous permet d’accéder au fragment dont vous avez besoin et de le sélectionner.

Fragments de contenu – Références

La définition du modèle de fragment de contenu contrôle :

  • si vous pouvez choisir d’ajouter plusieurs références ;
  • les types de modèles de fragments de contenu que vous pouvez sélectionner. Le modèle de fragment de contenu définit les modèles de fragment autorisés comme référence. AEM présente donc uniquement les fragments basés sur ces modèles.

En utilisant la variable Arborescence de la structure de l’éditeur de fragment de contenu, vous pouvez parcourir les fragments référencés par votre fragment, puis parcourir toutes les références qu’ils peuvent contenir. La sélection d’une référence ouvre ce fragment en vue de le modifier.

Arborescence de la structure du fragment de contenu.

Références ad hoc adhoc-references

Les références ad hoc peuvent être ajoutées sous la forme d’un simple lien dans un bloc de texte :

Fragments de contenu – Références ad hoc

Prochaines étapes whats-next

Maintenant que vous en savez plus sur les références et la structure dans les fragments de contenu, l’étape suivante consiste à en savoir plus sur les métadonnées et le balisage. Cette section présente et discute de la manière dont vous pouvez définir des métadonnées et des balises pour vos fragments de contenu.

Ressources supplémentaires additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab