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 sjablonen kunnen worden gebruikt om samen te stellen alle set met inhoud; hoe die inhoud wordt benaderd: als HTML in een browser, zoals JSON gebruikt door JavaScript (AEM SPA Editor) of een Mobile-toepassing, is een functie van de manier waarop die pagina wordt opgevraagd.

In AEM Content Services worden bewerkbare sjablonen gebruikt om te definiëren hoe de JSON-gegevens worden weergegeven.

Voor de WKND Mobile App, zullen wij één enkel Bewerkbaar Malplaatje creëren dat wordt gebruikt om één enkel API eindpunt te drijven. 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

Om te begrijpen hoe te om ons API eindpunt samen te stellen, en te begrijpen welke inhoud aan ons zou moeten worden blootgesteld WKND Mobile App, laten we het ontwerp opnieuw bekijken.

API voor gebeurtenissen Decomposition

Zoals we kunnen zien, hebben we drie logische sets met inhoud die aan de mobiele app moeten worden geleverd.

  1. De Logo
  2. De Lijn met tag
  3. 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.

  1. De Logo is via een Afbeeldingscomponent
  2. De Lijn met tag is via een Tekstcomponent
  3. De lijst van Gebeurtenissen is via een component Lijst met inhoudsfragmenten dat op zijn beurt verwijst naar een set gebeurtenisinhoudfragmenten.
NOTE
Om de JSON-export van pagina's en componenten van AEM Content Service te ondersteunen, moeten de pagina's en componenten afgeleid van AEM WCM Core Components.
AEM WCM Core-componenten beschikken over ingebouwde functionaliteit ter ondersteuning van een genormaliseerd JSON-schema van geëxporteerde pagina's en componenten. Alle mobiele WKND-componenten die in deze zelfstudie worden gebruikt (pagina, afbeelding, tekst en lijst met inhoudsfragmenten), zijn afgeleid van AEM WCM Core-componenten.

De API-sjabloon voor gebeurtenissen definiëren

  1. Navigeren naar Tools> General > Templates >WKND Mobile.

  2. Maak de Events API sjabloon:

    1. Tikken Create in de bovenste actiebalk
    2. Selecteer de WKND Mobile - Empty Page template
    3. Tikken Next in de bovenste actiebalk
    4. Enter Events API in de Template Title field
    5. Tikken Create in de bovenste actiebalk
    6. Tikken Open de nieuwe sjabloon openen voor bewerken
  3. 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. Zorg ervoor dat Structure is actief, selecteert u de Layout Container [Root] en tik op de knop Policy knop.

  4. Onder Properties>Allowed Components zoeken naar WKND Mobile. De volgende componenten toestaan vanuit de WKND Mobile componentgroep zodat deze op de Events API-pagina.

    • 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
  5. Tik op de knop Done vinkje in de rechterbovenhoek wanneer dit is voltooid.

  6. Vernieuwen het browservenster om het nieuwe venster te zien Allowed Components lijst in de linkerrail.

  7. Sleep vanuit de Finder Componenten in de linkerspoorstaaf in de volgende AEM Componenten:

    1. Image voor het logo
    2. Text voor de taglijn
    3. Content Fragment List voor de gebeurtenissen
  8. Voor elk van de bovenstaande onderdelen, selecteert u deze en drukt u op ontgrendelen knop.

  9. De lay-outcontainer is vergrendeld om te voorkomen dat andere componenten worden toegevoegd of dat deze drie componenten worden verwijderd.

  10. Tikken Page Information>View in Admin om terug te keren naar de WKND Mobile aanbieding van sjablonen. Selecteer de zojuist gemaakte Events API sjabloon en tikken Enable in de bovenste actiebalk.

NOTE
De componenten die worden gebruikt om de inhoud te bedekken, worden aan de sjabloon zelf toegevoegd en vergrendeld. Op deze manier kunnen auteurs de vooraf gedefinieerde componenten bewerken, maar niet willekeurig componenten toevoegen of verwijderen, omdat het wijzigen van de API zelf de veronderstellingen rond de JSON-structuur kan onderbreken en de gebruikte apps kan onderbreken. Alle API's moeten stabiel zijn.

Volgende stappen

Installeer desgewenst de com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip inhoudspakket op AEM auteur via AEM Package Manager. Dit pakket bevat de configuraties en inhoud die in dit en vorige hoofdstukken van de zelfstudie worden beschreven.

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