I den här delen av AEM Headless Developer Journeyfår du lära dig att modellera innehållsstrukturen. Förverkliga sedan strukturen för Adobe Experience Manager (AEM) med Content Fragments Models och Content Fragments, för återanvändning i alla kanaler.
I början Läs om CMS Headless Development innehållsleverans utan extra kostnad och varför den används. Sedan Komma igång med AEM Headless as a Cloud Service beskrivs AEM Headless i ditt eget projekt.
I det föregående dokumentet om den AEM resan utan headless Vägen till din första upplevelse med AEM utan headlesslärde du dig sedan de steg som krävs för att implementera det första projektet. När du har läst den kan du göra följande:
Den här artikeln bygger på dessa grundläggande funktioner så att du förstår hur du förbereder ett eget AEM headless-projekt.
Datamodellering är ett stort fält, som det används vid utveckling av relationsdatabaser. Det finns många böcker och onlinekällor med information.
Denna resa tar endast hänsyn till aspekter som är av intresse vid modellering av data för användning med AEM Headless.
Det är en stor, dålig värld där ute.
Kanske, men kanske inte. Det är verkligen en komplicerad världen där ute och datamodellering används för att definiera en förenklad representation av ett mycket (mycket) litet underavsnitt, med hjälp av den specifika information som behövs för ett visst ändamål.
När AEM behandlar innehåll kallas den här resan datamodellering för innehållsmodellering.
Till exempel:
Det finns många skolor, men de har alla olika saker gemensamt:
Även i ett sådant litet exempel kan listan verka oändlig. Men om du bara vill att programmet ska utföra en enkel åtgärd bör du begränsa informationen till de viktigaste uppgifterna.
Exempel: annonsera specialevent för alla skolor i området:
Vad du vill beskriva kallas för Enheter - de"saker" som du vill lagra information om.
Informationen som du vill lagra om dem är Attribut (egenskaper), t.ex. namn, och lärarkvalifikationer.
Sedan finns det olika Relationer mellan enheterna. Till exempel har en skola bara en huvudlärare, och många lärare (och vanligtvis är huvudläraren också lärare).
Processen att analysera och definiera informationen, tillsammans med relationerna mellan dem, kallas Innehållsmodellering.
Oftast måste du börja med att skapa en Konceptuellt schema som beskriver enheterna och deras relationer. Vanligtvis är detta en hög nivå (konceptuell).
När detta är stabilt kan du omvandla modellerna till en Logiskt schema som beskriver enheterna, tillsammans med attributen, och relationerna. På den här nivån bör du noggrant granska definitionerna för att undvika duplicering och optimera designen.
Ibland sammanfogas dessa två steg, ofta beroende på hur komplicerat ditt scenario är.
Behöver du till exempel separata enheter för Head Teacher
och Teacher
eller bara ytterligare ett attribut på Teacher
modell?
Dataintegritet krävs för att garantera innehållets exakthet och enhetlighet under hela dess livscykel. Detta innefattar att säkerställa att innehållsförfattare enkelt kan förstå vad de ska lagra var - så följande är viktiga:
Dataredundans inträffar när samma information lagras två gånger i innehållsstrukturen. Detta bör undvikas eftersom det kan leda till missförstånd när innehållet skapas och fel vid frågor, för att inte tala om missbruk av lagringsutrymme.
Genom att optimera strukturen kan du förbättra prestandan, både när det gäller att skapa innehåll och fråga.
Allt är en balansåtgärd, men att skapa en struktur som är för komplex, eller som har för många nivåer, kan vara förvirrande för författare som skapar innehållet. Och det kan påverka prestandan avsevärt om frågan måste få åtkomst till flera kapslade (refererade) innehållsfragment för att hämta det önskade innehållet.
Datamodellering är en uppsättning etablerade tekniker som ofta används vid utvecklade relationsdatabaser, så vad innebär innehållsmodellering för AEM Headless?
För att ditt program ska kunna begära och ta emot nödvändigt innehåll från AEM på ett konsekvent och effektivt sätt måste det här innehållet struktureras.
Detta innebär att din ansökan i förväg vet vilken form av svar det är och därför hur den ska behandlas. Detta är enklare än att ta emot frihandsinnehåll, som måste analyseras för att avgöra vad det innehåller och därför hur det kan användas.
AEM använder Content Fragments för att tillhandahålla de strukturer som behövs för Headless-leverans av ditt innehåll till dina program.
Innehållsmodellens struktur är:
Modellerna för innehållsfragment används också som bas för de AEM GraphQL-scheman som används för att hämta ditt innehåll - mer om det i en senare session.
Begäranden om ditt innehåll görs med AEM GraphQL API, en anpassad implementering av GraphQL standard-API. Med AEM GraphQL API kan du utföra (komplexa) frågor på dina innehållsfragment, där varje fråga anpassas efter en viss modelltyp.
Det returnerade innehållet kan sedan användas av dina program.
I Content Fragment Models finns olika mekanismer som gör att du kan definiera innehållets struktur.
En innehållsfragmentmodell beskriver en enhet.
Du måste aktivera funktionen för innehållsfragment i konfigurationsläsaren så att du kan skapa modeller.
Modellen bör namnges så att innehållsförfattaren vet vilken modell som ska väljas när ett innehållsfragment skapas.
Inom en modell:
Till exempel:
AEM innehåller följande datatyper som du kan använda för att modellera ditt innehåll:
Två datatyper ger referenser till innehåll utanför ett visst fragment:
Innehållsreferens
Detta ger en enkel referens till annat innehåll av valfri typ.
Du kan till exempel referera till en bild på en viss plats.
Fragmentreferens
Detta innehåller referenser till andra innehållsfragment.
Den här typen av referens används för att skapa kapslat innehåll, vilket introducerar de relationer som behövs för att modellera innehållet.
Datatypen kan konfigureras så att fragmentförfattare kan:
Först måste du aktivera Content Fragment Models för webbplatsen. Detta görs i Configuration Browser under verktyg > Allmänt > Konfigurationsläsaren. Du kan antingen välja att konfigurera den globala posten eller skapa en konfiguration. Till exempel:
Se Ytterligare resurser - Innehållsfragment i Configuration Browser
Sedan kan du skapa modellerna för innehållsfragment och definiera strukturen. Detta kan göras under verktyg > Allmänt > Modeller för innehållsfragment. Till exempel:
Se Ytterligare resurser - modeller för innehållsfragment.
Innehållsfragment baseras alltid på en innehållsfragmentmodell. Modellen innehåller strukturen, fragmentet innehåller innehållet.
Det första steget till att skapa innehåll är att skapa ett innehållsfragment. Detta görs med Skapa > Innehållsfragment i den obligatoriska mappen under Resurser > Filer. Guiden vägleder dig genom stegen.
Ett innehållsfragment baseras på en viss innehållsfragmentmodell som du väljer som första steg i skapandet.
När fragmentet har skapats kan du öppna det i redigeraren för innehållsfragment. Här kan du göra följande:
När du har valt lämplig modell öppnas ett innehållsfragment för redigering i redigeraren för innehållsfragment:
Se Ytterligare resurser - Arbeta med innehållsfragment.
En grundläggande struktur som exempel finns i Struktur för exempelinnehållsfragment.
Nu när du har lärt dig att modellera strukturen och skapa innehåll som är beroende av den, är nästa steg att Lär dig hur du använder GraphQL-frågor för att komma åt och hämta innehåll i innehållsfragment. Här presenteras GraphQL och vi diskuterar några exempelfrågor för att se hur det fungerar i praktiken.