Lär dig grunderna i innehållsmodellering för Headless med AEM

Story hittills

I början av AEM Headless Content Architect Journey den Introduktion De grundläggande begrepp och termer som är relevanta för att modellera innehåll för headless.

Den här artikeln bygger på dessa så att du förstår hur du modellerar innehåll för AEM headless-projekt.

Syfte

  • Målgrupp: Nybörjare
  • Syfte: Presentera koncepten för innehållsmodellering för Headless CMS.

Innehållsmodellering med modeller för innehållsfragment

Modellering av innehåll (data) är en uppsättning etablerade tekniker som ofta används i utvecklade relationsdatabaser, så vad innebär innehållsmodellering för AEM Headless?

Varför?

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 mycket 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.

Introduktion till Hur?

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:

  • som realiseras av definitionen av din innehållsfragmentmodell,
  • används som bas för de innehållsfragment som används för att generera innehåll.
OBSERVERA

Modellerna för innehållsfragment används också som bas för AEM GraphQL-scheman, som används för att hämta ditt innehåll - mer om det på Developer Journey.

Begäranden om ditt innehåll görs med AEM GraphQL API, en anpassad implementering av standard-API:t GraphQL. Med AEM GraphQL API kan program utföra (komplexa) frågor på dina innehållsfragment, där varje fråga följer en viss modelltyp.

Det returnerade innehållet kan sedan användas av dina program.

Skapa strukturen med Content Fragment Models

I Content Fragment Models finns olika mekanismer som gör att du kan definiera innehållets struktur.

En innehållsfragmentmodell beskriver en enhet.

OBSERVERA

Funktionen för innehållsfragment måste vara aktiverad i Configuration Browser så att du kan skapa nya modeller.

TIPS

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:

  1. Datatyper gör att du kan definiera de enskilda attributen.
    Definiera till exempel fältet som innehåller en lärares namn som Text och deras tjänsteår som Nummer.
  2. Datatyperna Innehållsreferens och Fragmentreferens gör att du kan skapa relationer till annat innehåll i AEM.
  3. The Fragmentreferens datatypen gör att du kan realisera flera strukturnivåer genom att kapsla dina innehållsfragment (enligt modelltypen). Detta är viktigt för er innehållsmodellering.

Till exempel:

Innehållsmodellering med innehållsfragment

Datatyper

AEM innehåller följande datatyper som du kan använda för att modellera ditt innehåll:

  • Enkelradig text
  • Flerradstext
  • Siffra
  • Boolesk
  • Datum och tid
  • Uppräkning
  • Taggar
  • Innehållsreferens
  • Fragmentreferens
  • JSON-objekt
OBSERVERA

Mer information finns under Content Fragment Models - Data Types.

Referenser och kapslat 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:

    • Redigera det refererade fragmentet direkt.
    • Skapa ett nytt innehållsfragment, baserat på lämplig modell
OBSERVERA

Du kan också skapa ad hoc-referenser genom att använda länkar i textblock.

Strukturnivåer (kapslade fragment)

För innehållsmodellering Fragmentreferens Med datatypen kan du skapa flera nivåer av struktur och relationer.

Med den här referensen kan du koppla olika modeller för innehållsfragment som representerar inbördes relationer. Detta gör att det headless-program kan följa anslutningarna och komma åt innehållet efter behov.

OBSERVERA

Detta bör användas med försiktighet och den bästa metoden kan definieras som kapsla så mycket som behövs, men så lite som möjligt.

Fragmentreferenser gör just det - de gör att du kan referera till ett annat fragment.

Du kan till exempel ha definierat följande modeller för innehållsfragment:

  • Ort
  • Företag
  • Person
  • Utmärkelser

Det verkar ganska okomplicerat, men ett företag har förstås både en koncernchef och anställda …och dessa är alla människor, var och en definierade som en person.

Och en person kan ha en utmärkelse (eller kanske två).

  • Mitt företag - Företag
    • VD - person
    • Medarbetare - person
      • Personliga utmärkelser - Utmärkelse

Och det är bara till att börja med. Beroende på komplexiteten kan en utmärkelse vara företagsspecifik eller ett företag ha sitt huvudkontor i en viss stad.

Att representera dessa inbördes relationer kan uppnås med Fragmentreferenser, så som de tolkas av dig (arkitekten), innehållsförfattaren och de headless-program som du använder.

What's Next

Nu när du har lärt dig grunderna är nästa steg att Läs om hur du skapar modeller för innehållsfragment i AEM. Här presenteras och behandlas de olika referenser som finns tillgängliga och hur du skapar strukturnivåer med fragmentreferenserna - en viktig del av modelleringen för headless.

Ytterligare resurser

På denna sida