DokumentationAEM GuidesDokumentation zu AEM Guides

Erstellen einer Zuordnung zwischen einem Thema und einem Experience Fragment

Last update: Thu Dec 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Experte
  • Admin

Adobe Experience Manager Guides bietet die Funktion zum Erstellen einer JSON-basierten Zuordnung zwischen einem Thema und einer Experience Fragment-Vorlage. Sie können diese Zuordnung verwenden, um Inhalte, die in einigen oder allen Elementen innerhalb eines Themas vorhanden sind, in einem Experience Fragment zu veröffentlichen.

  1. Um die Datei experienceFragmentMapping.json herunterzuladen, melden Sie sich bei Adobe Experience Manager als Administrator an.

  2. Klicken Sie oben auf den Adobe Experience Manager-Link und anschließend auf Tools.

  3. Wählen Sie Guides aus der Liste der Tools und wählen Sie den Ordnerprofile aus.

  4. Wählen Sie die Profilkachel aus, die Sie konfigurieren möchten. Sie können die Zuordnung für das globale Profil oder ein Profil auf Ordnerebene konfigurieren. Wählen Sie beispielsweise die Kachel Globales Profil aus.

  5. Wählen Sie die Registerkarte XML Editor-Konfiguration) und klicken Sie oben auf Symbol Bearbeiten“.

  6. Wählen Sie das Symbol Herunterladen aus, um die experienceFragmentMapping.json-Datei auf Ihr lokales System herunterzuladen. Anschließend können Sie Änderungen an der Datei vornehmen und diese dann hochladen.

  7. Sie müssen die folgenden Validierungen durchführen:

    1. Es sollte eine JSON-Datei sein

    2. Sie sollte ein -Array enthalten, das mindestens ein Objekt enthält, und jedes Objekt sollte Folgendes enthalten:

      "template": string

      "mapping": array

      Jedes Zuordnungsobjekt muss Folgendes enthalten:

      "name": string

      "class": string

      "resourceType": string

      "attributeMap": array

  8. Speichern Sie die Datei und laden Sie sie hoch.

Experience Manager Guides konvertiert das gesamte Thema in HTML. Dieses kann dann den im Experience Fragment verwendeten Kernkomponenten zugeordnet werden. Beispielsweise kann der Inhalt in einem <p>-Tag zugeordnet werden, um eine Textkomponente im Experience Fragment zu erstellen.

  • name: Angabe des HTML-Elements. Zum Beispiel <div>, <img>
  • class: Geben Sie das DITA-Element-Tag an, das dem HTML-Element entspricht. Beispiel: <p> <image>
  • resourceType: Geben Sie den Ressourcentyp an, der für die in Experience Fragment verwendete Komponente gilt. Beispielsweise ist wcm/foundation/components/text der resourceType für die wcm-text.
  • attributeMap: Geben Sie zusätzliche Informationen für die Komponente an, z. B. ob eine Textkomponente als RichText gerendert werden soll oder die fileReference einer Bildkomponente enthält.

Beispieldatei:

[
  {
    "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"
          }
        ]
      }
    ]
  }
]

Wählen Sie beim Veröffentlichen der Experience Fragments über den Web-Editor die Template aus der Dropdown-Liste im Dialogfeld Experience Fragment generieren aus, um die für die Vorlage verfügbare Zuordnung im Feld Zuordnung anzuzeigen. Wenn für eine Vorlage keine benutzerdefinierte Zuordnung vorhanden ist, wird die Standardzuordnung aufgelistet. Sie können die Standardzuordnung verwenden, um das gesamte Thema als Experience Fragment zu veröffentlichen.

Weitere Informationen finden Sie unter Publish Experience Fragments.

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