Hoofdstuk 4 - Templates voor inhoudsservices definiëren
Hoofdstuk 4 van de AEM zelfstudie zonder titel behandelt de rol van AEM bewerkbare sjablonen in de context van AEM Content Services. Bewerkbare sjablonen worden gebruikt om de JSON-inhoudsstructuur te definiëren AEM Content Services wordt aangeboden aan klanten via de compositie van Content Services die is ingeschakeld AEM Components.
De rol van sjablonen in AEM Content Services begrijpen
AEM Bewerkbare sjablonen worden gebruikt om de HTTP-eindpunten te definiëren die worden benaderd om de Event-inhoud beschikbaar te maken als JSON.
Traditioneel worden AEM bewerkbare sjablonen gebruikt om webpagina's te definiëren, maar dit gebruik is gewoon een conventie. Bewerkbare Malplaatjes kunnen worden gebruikt om om het even welke reeks inhoud samen te stellen; hoe die inhoud wordt betreden: als HTML in browser, zoals JSON die door JavaScript (AEM Redacteur SPA) wordt verbruikt of een Mobiele App is een functie van hoe die pagina wordt gevraagd.
In AEM Content Services worden bewerkbare sjablonen gebruikt om te definiëren hoe de JSON-gegevens worden weergegeven.
Voor de WKND Mobile -toepassing maken we één bewerkbare sjabloon die wordt gebruikt om één API-eindpunt te maken. Hoewel dit voorbeeld eenvoudig is om de concepten AEM Headless te illustreren, kunt u meerdere Pagina's (of Eindpunten) maken die elk verschillende sets inhoud blootstellen om een complexere, en beter georganiseerde API te maken.
Het API-eindpunt
Als u wilt weten hoe u ons API-eindpunt kunt samenstellen en begrijpen welke inhoud beschikbaar moet worden gesteld voor onze WKND Mobile -app, kunt u het ontwerp opnieuw bekijken.
Zoals we kunnen zien, hebben we drie logische sets met inhoud die aan de mobiele app moeten worden geleverd.
- Het logo
- De Lijn van de Markering
- De lijst van Gebeurtenissen
Om dit te doen, kunnen wij deze vereisten aan AEM Componenten (en in ons geval, AEM de Componenten van de Kern WCM) in kaart brengen om de vereiste inhoud als JSON bloot te stellen.
- Het Logo wordt bedekt via een component van het Beeld
- De Lijn van de Markering wordt bedekt via de component van de a Tekst
- De lijst van Gebeurtenissen wordt bedekt via de component van de Lijst van het Fragment van de a Inhoud die beurtelings, verwijzingen een reeks Fragmenten van de Inhoud van de Gebeurtenis.
De API-sjabloon voor gebeurtenissen definiëren
-
Navigeer naar Tools> General > Templates >WKND Mobile .
-
Maak de sjabloon Events API :
- Tik Create op de bovenste actiebalk
- Selecteer de sjabloon WKND Mobile - Empty Page
- Tik Next op de bovenste actiebalk
- Voer Events API in het veld Template Title in
- Tik Create op de bovenste actiebalk
- Tik op de nieuwe sjabloon Open om deze te bewerken
-
Ten eerste staan we de drie geïdentificeerde AEM componenten toe die we nodig hebben om de inhoud te modelleren door de Policy van de hoofdmap Layout Container te bewerken. Zorg ervoor dat de modus Structure actief is, selecteer Layout Container [Root] en tik op de knop Policy .
-
Onder Properties>Allowed Components Zoeken naar WKND Mobile . De volgende componenten uit de componentgroep WKND Mobile toestaan, zodat ze op de API-pagina van Events kunnen worden gebruikt.
-
WKND Mobile > Image
- Het logo voor de app
-
WKND Mobile > Text
- De inleidende tekst van de app
-
WKND Mobile > Content Fragment List
- De lijst met gebeurteniscategorieën die beschikbaar zijn voor weergave in de app
-
-
Tik na voltooiing op het vinkje van Done in de rechterbovenhoek.
-
verfrist zich het browser venster om nieuwe Allowed Components lijst in het linkerspoor te zien.
-
Sleep vanuit de Finder Componenten in de linkerspoorstaaf in de volgende AEM Componenten:
- Image voor het logo
- Text voor de taglijn
- Content Fragment List voor de gebeurtenissen
-
voor elk van de bovengenoemde componenten, selecteer hen en druk ontgrendelen knoop.
-
Nochtans, verzeker de lay-outcontainer wordt gesloten om andere componenten te verhinderen worden toegevoegd, of deze drie componenten worden verwijderd.
-
Tik op Page Information>View in Admin om terug te keren naar de lijst met WKND Mobile sjablonen. Selecteer de nieuw gemaakte Events API sjabloon en tik Enable op de bovenste actiebalk.
Volgende stappen
Naar keuze, installeer com.adobe.aem.guides.wknd-mobile.content.chapter-4.zipinhoudspakket op AEM Auteur via AEM de Manager van het Pakket. Dit pakket bevat de configuraties en inhoud die in dit en vorige hoofdstukken van de zelfstudie worden beschreven.