DocumentationAEM GuidesDocumentation d’AEM Guides

Créer un mappage entre une rubrique et un fragment d’expérience pour Cloud Service

Last update: Fri Apr 10 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Expérimenté
  • Administration

Adobe Experience Manager Guides permet de créer un mappage basé sur JSON entre une rubrique et un modèle de fragment d’expérience. Vous pouvez utiliser ce mappage pour publier dans un fragment d’expérience du contenu présent dans certains éléments d’une rubrique ou dans tous ses éléments.

  1. Pour télécharger le fichier experienceFragmentMapping.json, connectez-vous à Adobe Experience Manager en tant qu’administrateur.

  2. Sélectionnez le lien Adobe Experience Manager en haut et choisissez Outils.

  3. Sélectionnez Guides dans la liste d’outils, puis sélectionnez le Profils de dossier.

  4. Sélectionnez la mosaïque de profil à configurer. Vous pouvez configurer le mappage pour le profil global ou au niveau d’un dossier. Par exemple, sélectionnez la mosaïque Profil global.

  5. Sélectionnez l’onglet Configuration de l’éditeur XML et sélectionnez l’icône Modifier en haut.

  6. Sélectionnez l’icône Télécharger pour télécharger le fichier experienceFragmentMapping.json sur votre système local. Vous pouvez ensuite apporter des modifications au fichier , puis le charger.

  7. Vous devez suivre les validations suivantes :

    1. Il doit s’agir d’un fichier JSON

    2. Il doit contenir un tableau contenant au moins un objet , et chaque objet doit contenir les éléments suivants :

      "template": string

      "mapping": array

      Chaque objet de mappage doit contenir les éléments suivants :

      "name": string

      "class": string

      "resourceType": string

      "attributeMap": array

  8. Enregistrez le fichier et chargez-le.

Experience Manager Guides convertit la rubrique complète en HTML qui peut ensuite être mappée aux composants principaux utilisés dans le fragment d’expérience. Par exemple, le contenu d’une balise <p> peut être mappé pour créer un composant de texte dans le fragment d’expérience.

  • name : spécifiez l’élément HTML. Par exemple, <div>, <img>.
  • class : spécifiez la balise d'élément DITA correspondant à l'élément HTML. Par exemple, <p> <image>
  • resourceType : spécifiez le type de ressource applicable au composant utilisé dans le fragment d’expérience. Par exemple, wcm/foundation/components/text est le type de ressource pour le composant text de gestion de contenu web.
  • attributeMap : fournissez des informations supplémentaires au composant, par exemple si un composant de texte doit être rendu en tant que RichText ou contient le fileReference d’un composant d’image.

Exemple de fichier :

[
  {
    "template": "default",
    "mapping": [
      {
        "name": "#element",
        "resourceType": "wcm/foundation/components/text",
        "attributeMap": [
          {
            "from": "outerHTML",
            "to": "text"
          },
          {
            "value": true,
            "to": "textIsRich"
          }
        ]
      }
    ]
  },
  {
    "template": "/conf/we-retail/settings/wcm/templates/experience-fragment-web-variation",
    "mapping": [
      {
        "name": "div",
        "class": "title",
        "resourceType": "wcm/foundation/components/text",
        "attributeMap": [
          {
            "from": "outerHTML",
            "to": "text"
          },
          {
            "value": true,
            "to": "textIsRich"
          }
        ]
      },
      {
        "name": "h1, h2, h3, h4, h5, h6",
        "resourceType": "wcm/foundation/components/text",
        "attributeMap": [
          {
            "from": "outerHTML",
            "to": "text"
          },
          {
            "value": true,
            "to": "textIsRich"
          }
        ]
      },
      {
        "name": "div",
        "class": "p",
        "resourceType": "wcm/foundation/components/text",
        "attributeMap": [
          {
            "from": "outerHTML",
            "to": "text"
          },
          {
            "value": true,
            "to": "textIsRich"
          }
        ]
      },
      {
        "name": "img",
        "class": "image",
        "resourceType": "wcm/foundation/components/image",
        "attributeMap": [
          {
            "from": "outerHTML",
            "to": "fileReference"
          }
        ]
      },
      {
        "name": "#element",
        "resourceType": "wcm/foundation/components/text",
        "attributeMap": [
          {
            "from": "outerHTML",
            "to": "text"
          },
          {
            "value": true,
            "to": "textIsRich"
          }
        ]
      }
    ]
  }
]

Lors de la publication des fragments d’expérience à partir de l’éditeur web, sélectionnez le Template dans la liste déroulante de la boîte de dialogue Générer un fragment d’expérience pour afficher le mappage disponible pour le modèle dans le champ Mappage. Si aucun mappage personnalisé n’est présent pour un modèle, le mappage par défaut est répertorié. Vous pouvez utiliser le mappage par défaut pour publier la rubrique entière en tant que fragment d’expérience.

Pour plus d’informations, consultez Publication de fragments d’expérience.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178