DokumentationAEMAEM-TutorialsAEM Headless-Tutorial

Kapitel 2 – Verwendung von Inhaltsfragmentmodellen

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Einsteiger
  • Entwickler

AEM-Inhaltsfragmentmodelle definieren Inhaltsschemata, mit denen die Erstellung von Raw-Inhalt durch AEM-Autorinnen und -Autoren in Vorlagen vorkonfiguriert werden kann. Dieser Ansatz ähnelt der Strukturvorlage bzw. dem formularbasierten Authoring. Das Schlüsselkonzept bei Inhaltsfragmenten besteht darin, dass der erstellte Inhalt von der Präsentation unabhängig ist. Das bedeutet, dass er für die Verwendung über mehrere Kanäle vorgesehen ist. Dabei wird über die verarbeitende Anwendung, z. B. AEM, eine Single Page Application oder eine Mobile App, gesteuert, wie der Inhalt Benutzenden angezeigt wird.

Mit dem Inhaltsfragment soll vor allem Folgendes sichergstellt werden:

  1. Der richtige Inhalt wird von der Autorin oder dem Autor erfasst
  2. Der Inhalt kann in einem strukturierten und gut verständlichen Format für die verarbeitenden Anwendungen verfügbar gemacht werden.

In diesem Kapitel werden die Aktivierung und Definition von Inhaltsfragmentmodellen beschrieben, die zum Definieren einer normalisierten Datenstruktur und einer Authoring-Oberfläche für die Modellierung und Erstellung von „Ereignissen“ verwendet werden.

Aktivieren von Inhaltsfragmentmodellen

Inhaltsfragmentmodelle müssen über den AEM-Konfigurations-Browser aktiviert werden.

Wenn Inhaltsfragmentmodelle nicht für eine Konfiguration aktiviert sind, wird die Schaltfläche Erstellen > Inhaltsfragment für die entsprechende AEM-Konfiguration nicht angezeigt.

NOTE
Bei AEM-Konfigurationen handelt es sich um kontextsensitive Mandantenkonfigurationen, die unter /conf gespeichert sind. Normalerweise korrelieren AEM-Konfigurationen mit einer bestimmten in AEM Sites verwalteten Website oder einer Geschäftseinheit, die für eine Untergruppe von Inhalten (Assets, Seiten usw.) in AEM verantwortlich ist.
Damit sich eine Konfiguration auf eine Inhaltshierarchie auswirkt, muss die Konfiguration über die cq:conf-Eigenschaft in dieser Inhaltshierarchie referenziert werden (wie bei der WKND Mobile-Konfiguration in Schritt 5 unten).
Wenn die global-Konfiguration verwendet wird, gilt die Konfiguration für alle Inhalte, und cq:conf muss nicht festgelegt werden.
Weitere Informationen finden Sie in der Dokumentation zum Konfigurations-Browser.

  1. Melden Sie sich bei AEM Author mit entsprechenden Benutzerberechtigungen an, um die fragliche Konfiguration zu ändern.

    • In diesem Tutorial kann dafür admin verwendet werden.

  2. Navigieren Sie zu Tools > Allgemein > Konfigurations-Browser

  3. Tippen Sie auf das Ordnersymbol neben WKND Mobile, um den Ordner auszuwählen, und tippen Sie dann oben links auf die Schaltfläche Bearbeiten.

  4. Wählen Sie Inhaltsfragmentmodelle aus und tippen Sie oben rechts auf Speichern und schließen.

    Dies ermöglicht Inhaltsfragmentmodelle in Inhaltsstrukturen von Asset-Ordnern, auf die die WKND Mobile-Konfiguration angewendet wurde.

    note note
    NOTE
    Diese Konfigurationsänderung kann nicht über die Web-Benutzeroberfläche AEM-Konfiguration rückgängig gemacht werden. So machen Sie diese Konfiguration rückgängig:
    code language-none 
    1. Öffnen Sie [CRXDE Lite](http://localhost:4502/crx/de)
1. Navigieren Sie zu `/conf/wknd-mobile/settings/dam/cfm`
1. Löschen Sie den `models`-Knoten
    Alle mit dieser Konfiguration erstellten vorhandenen Inhaltsfragmentmodelle werden gelöscht und ihre Definitionen werden unter /conf/wknd-mobile/settings/dam/cfm/models gespeichert.

  5. Wenden Sie die WKND Mobile-Konfiguration auf den WKND Mobile-Asset-Ordner an, damit Inhaltsfragmente aus Inhaltsfragmentmodellen in dieser Assets-Ordnerhierarchie erstellt werden können:

    1. Navigieren Sie zu AEM > Assets > Dateien
    2. Wählen Sie den Ordner WKND Mobile aus
    3. Tippen Sie in der oberen Aktionsleiste auf die Schaltfläche Eigenschaften, um die Ordnereigenschaften zu öffnen
    4. Tippen Sie unter Ordnereigenschaften auf die Registerkarte Cloud-Services
    5. Vergewissern Sie sich, dass das Feld Cloud-Konfiguration auf /conf/wknd-mobile eingestellt ist
    6. Tippen Sie oben rechts auf Speichern und schließen, um Änderungen beizubehalten

https://video.tv.adobe.com/v/28336?quality=12&learn=on

WARNING
Inhaltsfragmentmodelle wurden von Tools > Assets nach Tools > Allgemein verschoben.

Grundlegendes zum Erstellen von Inhaltsfragmentmodellen

Vor der Definition des Inhaltsfragmentmodells sollten wir uns das vorgesehene Erlebnis ansehen, um sicherzustellen, dass wir alle erforderlichen Datenpunkte erfassen. Dazu werden wir das App-Design überprüfen und die Design-Elemente dem zu erfassenden Inhalt zuordnen.

Wir können die Datenpunkte, die ein Ereignis definieren, wie folgt aufschlüsseln:

Erstellen des Inhaltsfragmentmodells

Mittels Zuordnung können wir Inhaltsfragmente definieren, die zur Erfassung und letztendlich zur Bereitstellung der Ereignisdaten verwendet werden.

Erstellen des Inhaltsfragmentmodells

  1. Navigieren Sie zu Tools > Allgemein > Inhaltsfragmentmodelle.
  2. Tippen Sie auf den Ordner WKND Mobile, um ihn zu öffnen.
  3. Tippen Sie auf Erstellen, um den Assistenten zur Erstellung von Inhaltsfragmentmodellen zu öffnen.
  4. Geben Sie Event als Modelltitel ein (Beschreibung ist optional) und tippen Sie auf Erstellen, um ihn zu speichern.

https://video.tv.adobe.com/v/28337?quality=12&learn=on

Definieren der Struktur des Inhaltsfragmentmodells

  1. Navigieren Sie zu Tools > Allgemein > Inhaltsfragmentmodelle >WKND.

  2. Wählen Sie das Inhaltsfragmentmodell Event aus und tippen Sie in der oberen Aktionsleiste auf Bearbeiten.

  3. Ziehen Sie rechts aus der Registerkarte Datentypen die Einzelzeilentext-Eingabe in den linken Ablagebereich, um das Feld Question zu definieren.

  4. Stellen Sie sicher, dass die neue Einzelzeilentext-Eingabe auf der linken Seite und die Registerkarte Eigenschaften auf der rechten Seite ausgewählt ist. Füllen Sie die Eigenschaftsfelder wie folgt aus:

    • Rendern als: textfield
    • Feldbezeichnung: Event Title
    • Eigenschaftsname: eventTitle
    • Max. Länge: 25
    • Erforderlich: Yes

Wiederholen Sie diese Schritte entsprechend den unten stehenden Eingabedefinitionen, um den Rest des Ereignis-Inhaltsfragmentmodells zu erstellen.

NOTE
Die Felder Eigenschaftsname MÜSSEN exakt übereinstimmen, da die Android-Anwendung so programmiert ist, dass sie diese Namen verwendet.

Ereignisbeschreibung

  • Datentyp: Multi-line text
  • Feldbezeichnung: Event Description
  • Eigenschaftsname: eventDescription
  • Standardtyp: Rich text

Ereignisdatum und -uhrzeit

  • Datentyp: Date and time
  • Feldbezeichnung: Event Date and Time
  • Eigenschaftsname: eventDateAndTime
  • Erforderlich: Yes

Ereignistyp

  • Datentyp: Enumeration
  • Feldbezeichnung: Event Type
  • Eigenschaftsname: eventType
  • Optionen: Art,Music,Performance,Photography

Ticketpreis

  • Datentyp: Number
  • Rendern als: numberfield
  • Feldbezeichnung: Ticket Price
  • Eigenschaftsname: eventPrice
  • Typ: Integer
  • Erforderlich: Yes

Ereignisbild

  • Datentyp: Content Reference
  • Rendern als: contentreference
  • Feldbezeichnung: Event Image
  • Eigenschaftsname: eventImage
  • Stammverzeichnis: /content/dam/wknd-mobile/images
  • Erforderlich: Yes

Ortsbezeichnung

  • Datentyp: Single-line text
  • Rendern als: textfield
  • Feldbezeichnung: Venue Name
  • Eigenschaftsname: venueName
  • Max. Länge: 20
  • Erforderlich: Yes

Stadt

  • Datentyp: Enumeration
  • Feldbezeichnung: Venue City
  • Eigenschaftsname: venueCity
  • Optionen: Basel,London,Los Angeles,Paris,New York,Tokyo

https://video.tv.adobe.com/v/28335?quality=12&learn=on

NOTE
Der Eigenschaftsname umfasst sowohl den JCR-Eigenschaftsnamen, in dem dieser Wert gespeichert wird, als auch den Schlüssel in der JSON-Datei. Dies sollte ein semantischer Name sein, der sich während der Lebensdauer des Inhaltsfragmentmodells nicht ändert.

Nachdem Sie die Erstellung des Inhaltsfragmentmodells abgeschlossen haben, sollten Sie eine Definition vorliegen haben, die in etwa wie folgt aussieht:

Ereignis-Inhaltsfragmentmodell

Nächster Schritt

Installieren Sie in AEM Author optional das Inhaltspaket com.adobe.aem.guides.wknd-mobile.content.chapter-2.zip über den Package Manager von AEM. Dieses Paket enthält die Konfigurationen und Inhalte, die in diesem Teil des Tutorials beschrieben wurden.

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4