Kapitel 5 – Inhaltserstellung für Inhaltsdienstseiten
Kapitel 5 des AEM Headless-Tutorials behandelt die Erstellung der Seite aus den in Kapitel 4 definierten Vorlagen. Die in diesem Kapitel erstellte Seite dient als JSON-HTTP-Endpunkt für die Mobile App.
/content/wknd-mobile/en/api wurde vorkonfiguriert. Die Basisseiten en und api dienen einem architektonischen und organisatorischen Zweck, sind aber nicht unbedingt erforderlich. Wenn API-Inhalte möglicherweise lokalisiert werden, empfiehlt es sich, die üblichen Best Practices für die Sprachkopie und die Multi-Site-Manager-Seitenorganisation zu befolgen, da die API-Seite wie jede andere AEM Sites-Seite lokalisiert werden kann.Erstellen der Ereignis-API-Seite
-
Navigieren Sie zu AEM > Sites > WKND Mobile > English >API.
-
Tippen Sie auf den Titel der API-Seite und tippen Sie dann auf Erstellen in der oberen Aktionsleiste und erstellen Sie eine neue API-Seite für Ereignisse unter der API-Seite.
- Tippen Sie Erstellen in der oberen Aktionsleiste
- Wählen Sie die Ereignis-API-Vorlage aus
- In das Feld Name geben Sie Ereignisse ein.
- In das Feld Titel geben Sie Ereignis-API ein.
- Tippen Sie auf Erstellen in der oberen Aktionsleiste, um die Seite zu erstellen
- Tippen Sie auf Fertig, um zum AEM Sites-Administrator zurückzukehren
Bearbeiten der API-Seite für Ereignisse
-
Bearbeiten Sie die Seite Ereignis-API, indem Sie zu AEM > Sites > WKND Mobile > Englisch > API navigieren, die Seite Ereignis-API auswählen und in der oberen Aktionsleiste auf Bearbeiten tippen.
-
Fügen Sie ein Logobild hinzu, das in der Anwendung angezeigt werden soll, indem Sie es aus dem Asset-Finder auf den Platzhalter der Bildkomponente ziehen und ablegen.
- Verwenden Sie das bereitgestellte Logo unter
/content/dam/wknd-mobile/images/wknd-logo.png.
- Verwenden Sie das bereitgestellte Logo unter
-
Fügen Sie eine Tag-Zeile hinzu, die über den Ereignissen angezeigt wird.
- Bearbeiten Sie die Text-Komponente
- Geben Sie den Text ein:
The WKND is here.
-
Wählen Sie die Ereignisse aus, die angezeigt werden sollen:
-
Stellen Sie die folgende Konfiguration auf der Registerkarte Eigenschaften ein:
- Modell: Ereignis
- Übergeordneter Pfad: /content/dam/wknd-mobile/en/events
- Tags: <Leave blank>
-
Stellen Sie die folgende Konfiguration auf der Registerkarte Elemente ein:
- Entfernen Sie alle aufgelisteten Elemente, um sicherzustellen, dass ALLE Elemente der Ereignis-Inhaltsfragmente verfügbar gemacht werden.
-
Überprüfen Sie die JSON-Ausgabe der API-Seite
Die JSON-Ausgabe und ihr Format können überprüft werden, indem die Seite mit dem Selektor .model.json angefordert wird.
Diese JSON-Struktur (oder das Schema) muss von den Nutzerinnen und Nutzern dieser API gut verstanden werden. Es ist wichtig, dass API-Nutzerinnen und -Nutzer verstehen, welche Aspekte der Struktur fest sind (d. h. das Logo (Bild) und das Tag live (Text) der Ereignis-API, die fließend sind (d. h. die Ereignisse, die unter Inhaltsfragmentlisten-Komponente aufgeführt sind).
Wenn Sie diesen Vertrag für eine veröffentlichte API brechen, kann dies zu einem fehlerhaften Verhalten in den konsumierenden Apps führen.
-
Fordern Sie in neuen Browser-Registerkarten die Seiten der Ereignis-API mit dem Selektor
.model.jsonan, der den JSON-Exporter von AEM Content Services aufruft und die Seite und die Komponenten in eine normalisierte, klar definierte JSON-Struktur serialisiert.Die von diesen Seiten erzeugte JSON-Struktur ist die Struktur, an die Apps ausgerichtet werden müssen.
-
Anfordern der Ereignis-API-Seite als JSON.
Das Ergebnis sollte in etwa wie folgt aussehen:
.tidy verwendet wird:Nächster Schritt
Installieren Sie optional das Inhaltspaket com.adobe.aem.guides.wknd-mobile.content.chapter-5.zip über AEM Package Manager in AEM Author. Dieses Paket enthält die in diesem und den vorangegangenen Kapiteln des Tutorials beschriebenen Konfigurationen und Inhalte.