Modeller för innehållsfragment

Content Fragment Models i AEM definierar innehållsstrukturen för dina innehållsfragment, fungerar som en grund för ditt headless-innehåll.

Så här använder du modeller för innehållsfragment:

  1. Aktivera funktionen Content Fragment Model för instansen
  2. Skapa och konfigurera modeller för innehållsfragment
  3. Aktivera modeller för innehållsfragment för användning när du skapar innehållsfragment för användning när du skapar innehållsfragment
  4. Tillåt dina modeller för innehållsfragment på mapparna Resurser genom att konfigurera profiler.

Skapa en innehållsfragmentmodell

  1. Navigera till Verktyg, Resurser och öppna sedan Modeller för innehållsfragment.

  2. Navigera till den mapp som passar din konfiguration.

  3. Använd Skapa för att öppna guiden.

    FÖRSIKTIGHET

    Om användningen av innehållsfragmentmodeller inte har aktiverats är alternativet Skapa inte tillgängligt.

  4. Ange modelltitel. Du kan också lägga till taggar, en beskrivning och välja Aktivera modell till aktivera modellen om det behövs.

    titel och beskrivning

  5. Använd Skapa för att spara den tomma modellen. Ett meddelande visar att åtgärden lyckades, du kan välja Öppna om du vill redigera modellen direkt eller Klar om du vill återgå till konsolen.

Definiera innehållsfragmentmodellen

Modellen för innehållsfragment definierar effektivt strukturen för de resulterande innehållsfragmenten med en datatyper. Med modellredigeraren kan du lägga till instanser av datatyperna och sedan konfigurera dem för att skapa de obligatoriska fälten:

FÖRSIKTIGHET

Om du redigerar en befintlig innehållsfragmentmodell kan det påverka beroende fragment.

  1. Navigera till Verktyg, Resurser och öppna sedan Modeller för innehållsfragment.

  2. Navigera till mappen som innehåller innehållsfragmentmodellen.

  3. Öppna önskad modell för Redigera; använd snabbåtgärden eller välj modell och sedan åtgärden från verktygsfältet.

    När du har öppnat modellredigeraren visas följande:

    • vänster: fält har redan definierats
    • höger: Datatyper som är tillgängliga för att skapa fält (och egenskaper som kan användas när fälten har skapats)
    OBSERVERA

    När ett fält är obligatoriskt markeras den etikett som visas i den vänstra rutan med en asterisk (*).

    egenskaper

  4. Lägga till ett fält

    • Dra en obligatorisk datatyp till önskad plats för ett fält:

      datatyp till fält

    • När ett fält har lagts till i modellen visar den högra panelen de egenskaper som kan definieras för den aktuella datatypen. Här definierar du vad som krävs för fältet.

      • Många egenskaper är självförklarande. Mer information finns i Egenskaper.

      • Om du skriver en fältetikett slutförs egenskapsnamnet automatiskt, om det är tomt, och den kan uppdateras manuellt senare.

        FÖRSIKTIGHET

        När du uppdaterar egenskapen Egenskapsnamn manuellt för en datatyp, bör du tänka på att namn endast får innehålla latinska tecken, numeriska siffror och understreck"_" som specialtecken.
        Om modeller som skapats i tidigare versioner av AEM innehåller ogiltiga tecken tar du bort eller uppdaterar dessa tecken.

      Till exempel:

      fältegenskaper

  5. Ta bort ett fält

    Markera det obligatoriska fältet och klicka/tryck sedan på papperskorgsikonen. Du ombeds bekräfta åtgärden.

    remove

  6. Lägg till alla obligatoriska fält och definiera de relaterade egenskaperna efter behov. Till exempel:

    save

  7. Välj Spara om du vill behålla definitionen.

Datatyper

Det finns ett urval datatyper som du kan använda för att definiera din modell:

  • Enkelradig text
    • Lägg till ett eller flera fält på en textrad, maxlängden kan definieras
  • Flerradstext
    • Ett textområde som kan vara RTF, Oformaterad text eller Markering
  • Siffra
    • Lägg till ett eller flera numeriska fält
  • Boolesk
    • Lägg till en boolesk kryssruta
  • Datum och tid
    • Lägg till ett datum och/eller en tid
  • Uppräkning
    • Lägga till en uppsättning kryssrutor, alternativknappar eller listrutefält
  • Taggar
    • Tillåter fragmentförfattare att komma åt och markera taggområden
  • Innehållsreferens
    • Hänvisningar till annat innehåll, oavsett typ. kan användas för att skapa kapslat innehåll
    • Om det finns referenser till en bild kan du välja att visa en miniatyrbild
  • Fragmentreferens
    • Hänvisar till andra innehållsfragment. kan användas för att skapa kapslat innehåll
    • Datatypen kan konfigureras så att fragmentförfattare kan:
      • Redigera det refererade fragmentet direkt.
      • Skapa ett nytt innehållsfragment, baserat på lämplig modell
  • JSON-objekt
    • Gör att innehållsfragmentets författare kan ange JSON-syntax i motsvarande element i ett fragment.
      • För att AEM ska kunna lagra direkt JSON som du har kopierat/klistrat in från en annan tjänst.
      • JSON skickas och skrivs ut som JSON i GraphQL.
      • Innehåller JSON-syntaxmarkering, automatisk komplettering och felmarkering i innehållsfragmentredigeraren.
  • Platshållare för flik
    • Tillåter introduktion av flikar som kan användas när innehållet i innehållsfragmentet redigeras.
      Detta visas som en avgränsare i modellredigeraren, som avgränsar avsnitt i listan med innehållsdatatyper. Varje instans representerar början på en ny flik.
      I fragmentredigeraren visas varje instans som en flik.

      OBSERVERA

      Den här datatypen används endast för formatering, den ignoreras av det AEM GraphQL-schemat.

Egenskaper

Många egenskaper är självförklarande, för vissa egenskaper finns ytterligare information nedan:

  • Egenskapsnamn

    När du uppdaterar den här egenskapen manuellt för en datatyp bör du tänka på att namn måste endast innehålla latinska tecken, numeriska siffror och understreck "_" som specialtecken.

    FÖRSIKTIGHET

    Om modeller som skapats i tidigare versioner av AEM innehåller ogiltiga tecken tar du bort eller uppdaterar dessa tecken.

  • Återge
    somDe olika alternativen för att realisera/återge fältet i ett fragment. Detta gör ofta att du kan ange om författaren ska se en enda instans av fältet eller om den ska kunna skapa flera instanser.

  • Field
    LabelAnge en
    Fältetiketter genererar automatiskt ett egenskapsnamn som sedan kan uppdateras manuellt om det behövs.


  • ValidationBasic-validering är tillgänglig via mekanismer som egenskapen ​Required. Vissa datatyper har ytterligare valideringsfält. Mer information finns i Validering.

  • För datatypen Flerradig text går det att definiera standardtypen som endera:

    • RTF-text
    • Markdown
    • Oformaterad text

    Om inget anges används standardvärdet RTF för det här fältet.

    Om du ändrar standardtypen i en innehållsfragmentmodell börjar detta bara gälla för ett befintligt, relaterat innehållsfragment efter att fragmentet har öppnats i redigeraren och sparats.


  • UniqueContent (för det specifika fältet) måste vara unikt för alla innehållsfragment som skapas från den aktuella modellen.

    Detta används för att säkerställa att innehållsförfattare inte kan upprepa innehåll som redan har lagts till i ett annat fragment av samma modell.

    Ett enradigt textfält med namnet Country i modellen för innehållsfragment kan till exempel inte ha värdet Japan i två beroende innehållsfragment. En varning kommer att skickas när ett försök görs att utföra den andra instansen.

    OBSERVERA

    Unikitet säkerställs per språkrot.

    OBSERVERA

    Variationer kan ha samma unika-värde som varianter av samma fragment, men inte samma värde som används i andra variationer av fragment.

  • Mer information om den specifika datatypen och dess egenskaper finns i Innehållsreferens.

  • Mer information om den specifika datatypen och dess egenskaper finns i Fragmentreferens (kapslade fragment).

Validering

Olika datatyper kan nu definiera valideringskrav för när innehåll anges i det resulterande fragmentet:

  • Enkelradig text
    • Jämför med ett fördefinierat regex.
  • Siffra
    • Kontrollera om det finns specifika värden.
  • Innehållsreferens
    • Testa för specifika typer av innehåll.
    • Det går endast att referera till resurser med en angiven filstorlek eller mindre.
    • Det går endast att referera till bilder inom ett fördefinierat intervall med bredd och/eller höjd (i pixlar).
  • Fragmentreferens
    • Testa om det finns en specifik innehållsfragmentmodell.

Använda referenser till kapslat innehåll

Innehållsfragment kan skapa kapslat innehåll med någon av följande datatyper:

  • Innehållsreferens

    • ger en enkel referens till annat innehåll, av alla typer.
    • Kan konfigureras för en eller flera referenser (i det resulterande fragmentet).
  • Fragmentreferens (kapslade fragment)

    • Refererar till andra fragment, beroende på vilka specifika modeller som anges.

    • Gör att du kan ta med/hämta strukturerade data.

      OBSERVERA

      Den här metoden är av särskilt intresse i samband med leverans av Headless-innehåll med innehållsfragment med GraphQL.

      * Kan konfigureras för en eller flera referenser (i det resulterande fragmentet).
OBSERVERA

AEM har ett upprepningsskydd för:

  • Innehållsreferenser
    Detta förhindrar att användaren lägger till en referens till det aktuella fragmentet. Detta kan leda till en tom dialogruta för fragmentreferensväljaren.
  • Fragmentreferenser i GraphQL
    Om du skapar en djup fråga som returnerar flera innehållsfragment som refereras av varandra, returneras null vid den första förekomsten.

Innehållsreferens

Med innehållsreferensen kan du återge innehåll från en annan källa; till exempel bild- eller innehållsfragment.

Förutom standardegenskaper kan du ange:

  • Rotsökväg för refererat innehåll
  • De innehållstyper som kan refereras
  • Begränsningar för filstorlekar
  • Om det refereras till en bild:
    • Visa miniatyrbild
    • Bildbegränsningar för höjd och bredd

Innehållsreferens

Fragmentreferens (kapslade fragment)

Fragmentreferensen refererar till ett eller flera innehållsfragment. Den här funktionen är särskilt intressant när du hämtar innehåll som ska användas i appen, eftersom den gör det möjligt att hämta strukturerade data med flera lager.

Till exempel:

  • En modell som definierar detaljer för en anställd. bland annat följande:
    • En referens till modellen som definierar arbetsgivaren (företaget)
type EmployeeModel {
    name: String
    firstName: String
    company: CompanyModel
}

type CompanyModel {
    name: String
    street: String
    city: String
}
OBSERVERA

Detta är särskilt intressant i samband med Headless Content Delivery med hjälp av Content Fragments with GraphQL.

Förutom standardegenskaper kan du definiera:

  • Återge som:

    • multifield - fragmentförfattaren kan skapa flera, enskilda, referenser

    • fragmentreferens - gör att fragmentförfattaren kan välja en enskild referens till ett fragment

  • Du kan välja
    flera modeller av modelltyp. När du redigerar innehållsfragmentet måste alla refererade fragment ha skapats med dessa modeller.

  • Rotsökväg
    Anger en rotsökväg för alla fragment som refereras.

  • Tillåt skapande av fragment

    Detta gör att fragmentförfattaren kan skapa ett nytt fragment baserat på lämplig modell.

    • fragmentreferenssammansatt - gör att fragmentförfattaren kan skapa en sammansatt bild genom att välja flera fragment

    Fragmentreferens

OBSERVERA

Det finns en mekanism för återkommande skydd. Användaren kan inte välja det aktuella innehållsfragmentet i fragmentreferensen. Detta kan leda till en tom dialogruta för fragmentreferensväljaren.
Det finns också ett upprepningsskydd för fragmentreferenser i GraphQL. Om du skapar en djup fråga i två innehållsfragment som refererar till varandra returneras null.

Aktivera eller inaktivera en innehållsfragmentmodell

För fullständig kontroll över användningen av dina modeller för innehållsfragment har de en status som du kan ange.

Aktivera en innehållsfragmentmodell

När en modell har skapats måste den aktiveras så att den:

  • Kan markeras när du skapar ett nytt innehållsfragment.
  • Kan refereras inifrån en Content Fragment-modell.
  • Finns för GraphQL, så att schemat genereras.

Så här aktiverar du en modell som har flaggats som antingen:

  • Utkast : mew (aldrig aktiverad).
  • Inaktiverad : har specifikt inaktiverats.

Du använder alternativet Aktivera från antingen:

  • Det övre verktygsfältet när den obligatoriska modellen är markerad.
  • Motsvarande snabbåtgärd (mouse-over the required Model).

Aktivera ett utkast eller en inaktiverad modell

Inaktivera en innehållsfragmentmodell

En modell kan också inaktiveras så att:

  • Modellen är inte längre tillgänglig som grund för att skapa nya innehållsfragment.
  • Men:
    • GraphQL-schemat genereras och är fortfarande frågningsbart (för att inte påverka JSON API).
    • Alla innehållsfragment som är baserade på modellen kan fortfarande efterfrågas och returneras från GraphQL-slutpunkten.
  • Det går inte att referera till modellen längre, men befintliga referenser behålls orörda och kan fortfarande frågas och returneras från GraphQL-slutpunkten.

Om du vill inaktivera en modell som är flaggad som Aktiverad använder du alternativet Inaktivera från antingen:

  • Det övre verktygsfältet när den obligatoriska modellen är markerad.
  • Motsvarande snabbåtgärd (mouse-over the required Model).

Inaktivera en aktiverad modell

Tillåt modeller för innehållsfragment i resursmappen

Om du vill implementera innehållsstyrning kan du konfigurera principer i resursmappen för att styra vilka innehållsfragmentmodeller som tillåts för att skapa fragment i den mappen.

OBSERVERA

Mekanismen liknar att tillåta sidmallar för en sida och dess underordnade sidor i en sidas avancerade egenskaper.

Så här konfigurerar du principer för Tillåtna modeller för innehållsfragment:

  1. Navigera och öppna Egenskaper för mappen Resurser.

  2. Öppna fliken Profiler där du kan konfigurera:

    • Ärvs från<folder>

      Profiler ärvs automatiskt när nya underordnade mappar skapas; principen kan konfigureras om (och arvet brytas) om undermapparna måste tillåta modeller som skiljer sig från den överordnade mappen.

    • Tillåtna modeller för innehållsfragment efter sökväg

      Flera modeller kan tillåtas.

    • Tillåtna modeller för innehållsfragment efter tagg

      Flera modeller kan tillåtas.
      Princip för innehållsfragmentmodell

  3. ​Spara eventuella ändringar.

De Content Fragment-modeller som tillåts för en mapp löses enligt följande:

  • Profiler för Tillåtna modeller för innehållsfragment.
  • Om den är tom kan du försöka identifiera principen med arvsreglerna.
  • Om arvskedjan inte ger något resultat ska du titta på Cloud Servicens-konfigurationen för den mappen (även först direkt och sedan via arv).
  • Om inget av ovanstående ger några resultat finns det inga tillåtna modeller för den mappen.

Ta bort en innehållsfragmentmodell

FÖRSIKTIGHET

Om du tar bort en innehållsfragmentmodell kan det påverka beroende fragment.

Så här tar du bort en innehållsfragmentmodell:

  1. Navigera till Verktyg, Resurser och öppna sedan Modeller för innehållsfragment.

  2. Navigera till mappen som innehåller innehållsfragmentmodellen.

  3. Markera modellen följt av Ta bort från verktygsfältet.

    OBSERVERA

    Om det refereras till modellen visas en varning. Vidta lämpliga åtgärder.

Publicera en innehållsfragmentmodell

Modeller för innehållsfragment måste publiceras när/innan beroende innehållsfragment publiceras.

Så här publicerar du en innehållsfragmentmodell:

  1. Navigera till Verktyg, Resurser och öppna sedan Modeller för innehållsfragment.

  2. Navigera till mappen som innehåller innehållsfragmentmodellen.

  3. Välj modell följt av Publicera i verktygsfältet.
    Publiceringsstatusen anges i konsolen.

    OBSERVERA

    Om du publicerar ett innehållsfragment för vilket modellen ännu inte har publicerats, visas detta i en urvalslista och modellen publiceras med fragmentet.

Avpublicera en innehållsfragmentmodell

Modeller för innehållsfragment kan avpubliceras om de inte refereras av några fragment.

Så här avpublicerar du en innehållsfragmentmodell:

  1. Navigera till Verktyg, Resurser och öppna sedan Modeller för innehållsfragment.

  2. Navigera till mappen som innehåller innehållsfragmentmodellen.

  3. Markera modellen, följt av Avpublicera från verktygsfältet.
    Publiceringsstatusen anges i konsolen.

Content Fragment Model - egenskaper

Du kan redigera egenskaperna för en modell för innehållsfragment:

  • Grundläggande
    • Modelltitel
    • Taggar
    • Beskrivning
    • Överför bild

På denna sida