Kapitel 4 - Definiera mallar för innehållstjänster
Kapitel 4 i AEM Headless-självstudiekursen behandlar rollen AEM redigerbara mallar i AEM Content Services. Redigerbara mallar används för att definiera JSON-innehållsstrukturen AEM Content Services exponerar för klienterna via kompositionen för Content Services-aktiverade AEM Components.
Förstå mallarnas roll i AEM Content Services
AEM Redigerbara mallar används för att definiera de HTTP-slutpunkter som är tillgängliga för att visa händelseinnehållet som JSON.
Traditionellt AEM Redigerbara mallar används för att definiera webbsidor, men det är bara vanligt. Redigerbara mallar kan användas för att komponera valfri-uppsättning med innehåll. Så här kommer innehållet åt: som HTML i en webbläsare, eftersom JSON används av JavaScript (AEM redigeraren) eller en mobilapp är en funktion av hur sidan efterfrågas.
I AEM Content Services används redigerbara mallar för att definiera hur JSON-data ska visas.
För appen WKND Mobile skapar vi en enda redigerbar mall som används för att skapa en enda API-slutpunkt. Det här exemplet är enkelt att illustrera koncepten AEM Headless, men du kan skapa flera sidor (eller slutpunkter) där varje del visar olika uppsättningar innehåll för att skapa ett mer komplext och välorganiserat API.
API-slutpunkten
Om du vill förstå hur du komponerar vår API-slutpunkt och förstå vilket innehåll som ska visas för vår WKND Mobile-app kan du låta oss gå igenom designen igen.
Som vi kan se har vi tre logiska uppsättningar innehåll att leverera till mobilappen.
- Logotypen
- Taggraden
- Listan med händelser
För att göra detta kan vi mappa dessa krav till AEM (och i vårt fall AEM WCM Core Components) för att visa nödvändigt innehåll som JSON.
- Logotypen visas via en Image-komponent
- Taggraden visas via en textkomponent
- Listan med händelser visas via en Content Fragment List-komponent som i sin tur refererar till en uppsättning med händelseinnehållsfragment.
Definiera API-mallen för händelser
-
Navigera till Tools> General > Templates >WKND Mobile.
-
Skapa mallen Events API:
- Tryck på Create i det övre åtgärdsfältet
- Välj mallen WKND Mobile - Empty Page
- Tryck på Next i det övre åtgärdsfältet
- Ange Events API i fältet Template Title
- Tryck på Create i det övre åtgärdsfältet
- Tryck på Open för att öppna den nya mallen för redigering
-
Först tillåter vi att de tre identifierade AEM komponenterna vi behöver modellera innehållet genom att redigera Policy för roten Layout Container. Kontrollera att läget Structure är aktivt, markera Layout Container [Root] och tryck på knappen Policy.
-
Under Properties>Allowed Components söker du efter WKND Mobile. Tillåt följande komponenter från komponentgruppen WKND Mobile så att de kan användas på API-sidan för Events.
-
WKND Mobile > Image
- Programmets logotyp
-
WKND Mobile > Text
- Appens introduktionstext
-
WKND Mobile > Content Fragment List
- Listan med händelsekategorier som är tillgängliga för visning i appen
-
-
Tryck på bockmarkeringen Done i det övre högra hörnet när du är klar.
-
Uppdatera webbläsarfönstret om du vill visa den nya listan Allowed Components i den vänstra listen.
-
Dra i följande AEM komponenter från komponentsökaren i den vänstra listen:
- Image för logotypen
- Text för taggraden
- Content Fragment List för händelserna
-
För var och en av ovanstående komponenter markerar du dem och trycker på knappen unlock .
-
Se dock till att layoutbehållaren är låst för att förhindra att andra komponenter läggs till eller att dessa tre komponenter tas bort.
-
Tryck på Page Information>View in Admin för att återgå till listan med WKND Mobile-mallar. Markera den nyligen skapade mallen Events API och tryck på Enable i det övre åtgärdsfältet.
Nästa steg
Du kan också installera innehållspaketet com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip på AEM Author via AEM Package Manager. Det här paketet innehåller de konfigurationer och det innehåll som beskrivs i det här och föregående kapitel i självstudien.