Content Fragment Models in AEM define the structure of content for your innehållsfragment, som en grund för ert headless-innehåll.
Om du vill använda modeller för innehållsfragment kan du:
Navigera till verktyg, Resurseröppna Modeller för innehållsfragment.
Navigera till den mapp som passar dina konfiguration.
Använd Skapa för att öppna guiden.
Om användning av innehållsfragmentmodeller inte har aktiverats, Skapa alternativet är inte tillgängligt.
Ange modelltitel. Du kan också lägga till Taggar, a Beskrivning och markera Aktivera modell till aktivera modellen vid behov.
Använd Skapa för att spara den tomma modellen. Ett meddelande visar att åtgärden lyckades. Du kan välja Öppna för att omedelbart redigera modellen, eller Klar för att återgå till konsolen.
Modellen för innehållsfragment definierar effektivt strukturen för de resulterande innehållsfragmenten med hjälp av en markering av Datatyper. Med modellredigeraren kan du lägga till instanser av datatyperna och sedan konfigurera dem för att skapa de obligatoriska fälten:
Om du redigerar en befintlig innehållsfragmentmodell kan det påverka beroende fragment.
Navigera till verktyg, Resurseröppna Modeller för innehållsfragment.
Navigera till mappen som innehåller innehållsfragmentmodellen.
Öppna den modell som krävs för Redigera, använd snabbåtgärden eller välj modellen och sedan åtgärden från verktygsfältet.
När du har öppnat modellredigeraren visas följande:
När ett fält är Obligatoriskt, Etikett som anges i den vänstra rutan är markerad med ett asterix (*).
Lägga till ett fält
Dra en obligatorisk datatyp till önskad plats för ett fält:
När ett fält har lagts till i modellen visas den högra panelen 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.
Skriva ett Fältetikett fyller i Egenskapsnamn - om den är tom, och sedan kan den uppdateras manuellt.
När egenskapen uppdateras manuellt Egenskapsnamn för en datatyp får namn bara innehålla A-Z, a-z, 0-9 och understrecket"_" som specialtecken.
Om modeller som skapats i tidigare versioner av AEM innehåller ogiltiga tecken tar du bort eller uppdaterar dessa tecken.
Till exempel:
Ta bort ett fält
Markera det obligatoriska fältet och klicka/tryck sedan på papperskorgsikonen. Du ombeds bekräfta åtgärden.
Lägg till alla obligatoriska fält och definiera de relaterade egenskaperna efter behov. Till exempel:
Välj Spara för att behålla definitionen.
Det finns ett urval datatyper som du kan använda för att definiera din modell:
Tillåter att flikar 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.
Den här datatypen används endast för formatering, den ignoreras av AEM GraphQL-schema.
Många egenskaper är självförklarande, för vissa egenskaper finns ytterligare information nedan:
Egenskapsnamn
När den här egenskapen uppdateras manuellt för en datatyp, anges namnen måste innehåller endast A-Z, a-z, 0-9 och understrecket "_" som specialtecken.
Om modeller som skapats i tidigare versioner av AEM innehåller ogiltiga tecken tar du bort eller uppdaterar dessa tecken.
Återge som
De olika alternativen för att realisera/återge fältet i ett fragment. Detta gör ofta att du kan definiera om författaren ska se en enda instans av fältet eller om han eller hon ska kunna skapa flera instanser.
Fältetikett
Ange en Fältetikett autogenererar en Egenskapsnamn som sedan kan uppdateras manuellt, om det behövs.
Validering
Grundläggande validering är tillgängligt via funktioner som Obligatoriskt -egenskap. Vissa datatyper har ytterligare valideringsfält. Se Validering för mer information.
För datatypen Flerradig text går det att definiera standardtypen som endera:
Om inget anges används standardvärdet RTF används för det här fältet.
Ändra Standardtyp i en modell för innehållsfragment börjar bara gälla för ett befintligt, relaterat innehållsfragment efter att fragmentet har öppnats i redigeraren och sparats.
Unik
Innehållet (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.
Till exempel en Enkelradig text fältet anropades Country
i Content Fragment Model får inte ha värdet Japan
i två beroende innehållsfragment. En varning skickas när ett försök görs att utföra den andra instansen.
Unikitet säkerställs per språkrot.
Variationer kan ha samma unik som variationer av samma fragment, men inte samma värde som används i andra variationer av fragment.
Se Innehållsreferens om du vill ha mer information om den specifika datatypen och dess egenskaper.
Se Fragmentreferens (kapslade fragment) om du vill ha mer information om den specifika datatypen och dess egenskaper.
Olika datatyper kan nu definiera valideringskrav för när innehåll anges i det resulterande fragmentet:
Innehållsfragment kan skapa kapslat innehåll med någon av följande datatyper:
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.
Denna metod är särskilt intressant med tanke på Headless Content Delivery using Content Fragments with GraphQL.
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.
Med Innehållsreferens kan du återge innehåll från en annan källa, t.ex. en bild eller ett innehållsfragment.
Förutom standardegenskaper kan du ange:
Fragmentreferensen refererar till ett eller flera innehållsfragment. Den här funktionen är av särskilt intresse när du hämtar innehåll som ska användas i appen, eftersom du kan hämta strukturerade data med flera lager.
Till exempel:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Detta är av särskilt intresse för Headless Content Delivery using Content Fragments with GraphQL.
Förutom standardegenskaper kan du definiera:
Återge som:
multifält - fragmentförfattaren kan skapa flera, enskilda, referenser
fragmentreferens - låter fragmentförfattaren välja en enskild referens till ett fragment
Modelltyp
Du kan välja flera modeller. När du redigerar innehållsfragmentet måste alla refererade fragment ha skapats med dessa modeller.
Rotsökväg
Detta 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 fragment baserat på lämplig modell.
Det finns en mekanism för upprepningsskydd. 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.
Om du vill ha fullständig kontroll över användningen av dina modeller för innehållsfragment har de en status som du kan ange.
När en modell har skapats måste den aktiveras så att:
Så här aktiverar du en modell som har flaggats som antingen:
Du kan använda Aktivera från antingen
En modell kan också inaktiveras så att:
Inaktivera en modell som är flaggad som Aktiverad använder du Inaktivera från antingen
Om du vill implementera innehållsstyrning kan du konfigurera Profiler i en resursmapp för att styra vilka innehållsfragmentmodeller som tillåts för att skapa fragment i den mappen.
Mekanismen liknar tillåta sidmallar för en sida och dess underordnade sidor i avancerade egenskaper för en sida.
Konfigurera Profiler for Tillåtna modeller för innehållsfragment:
Navigera och öppna Egenskaper för den resursmapp som krävs.
Öppna Profiler där du kan konfigurera:
Ärvs från<folder>
Principer ärvs automatiskt när underordnade mappar skapas. Principen kan konfigureras om (och arvet brytas) om undermappar 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.
Spara eventuella ändringar.
De Content Fragment-modeller som tillåts för en mapp löses enligt följande:
Om du tar bort en innehållsfragmentmodell kan det påverka beroende fragment.
Så här tar du bort en innehållsfragmentmodell:
Navigera till verktyg, Resurseröppna Modeller för innehållsfragment.
Navigera till mappen som innehåller innehållsfragmentmodellen.
Välj modell, följt av Ta bort i verktygsfältet.
Om modellen refereras visas en varning. Vidta lämpliga åtgärder.
Modeller för innehållsfragment måste publiceras när/innan beroende innehållsfragment publiceras.
Så här publicerar du en innehållsfragmentmodell:
Navigera till verktyg, Resurseröppna Modeller för innehållsfragment.
Navigera till mappen som innehåller innehållsfragmentmodellen.
Välj modell, följt av Publicera i verktygsfältet.
Publiceringsstatusen anges i konsolen.
Om du publicerar ett innehållsfragment för vilket modellen ännu inte har publicerats, visas detta i en urvalslista och modellen publiceras med fragmentet.
Modeller för innehållsfragment kan avpubliceras om de inte refereras av några fragment.
Så här avpublicerar du en innehållsfragmentmodell:
Navigera till verktyg, Resurseröppna Modeller för innehållsfragment.
Navigera till mappen som innehåller innehållsfragmentmodellen.
Välj modell, följt av Avpublicera i verktygsfältet.
Publiceringsstatusen anges i konsolen.
Du kan redigera Egenskaper för en innehållsfragmentmodell: