Content Fragment Models in AEM define the structure of content for your innehållsfragment, som en grund för ert headless-innehåll.
Så här använder du modeller för innehållsfragment:
Navigera till verktyg, Allmäntöppna Modeller för innehållsfragment.
Navigera till den mapp som passar dina konfiguration eller underkonfiguration.
Använd Skapa för att öppna guiden.
Om användning av innehållsfragmentmodeller inte har aktiverats, Skapa kommer inte att vara tillgängligt.
Ange modelltitel.
Du kan också definiera olika egenskaper, till exempel lägga till Taggar, a Beskrivning och markera Aktivera modell till aktivera modellen vid behov.
Mer information om URL-mönster för standardförhandsvisning se Content Fragment Model - egenskaper.
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, Allmäntö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 kommer att slutföra Egenskapsnamn - om den är tom, och sedan kan den uppdateras manuellt.
När egenskapen uppdateras manuellt Egenskapsnamn för en datatyp, observera att namn bara får innehålla A-Z, a-z, 0-9 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:
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:
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
Observera följande namn när den här egenskapen uppdateras manuellt för en datatyp måste innehåller endast A-Z, a-z, 0-9 och understreck "_" 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. Med den här egenskapen kan du ofta 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 genererar automatiskt en Egenskapsnamn, som sedan kan uppdateras manuellt vid behov.
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.
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.
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.
Om du vill använda MSM (som skapar kopior av innehållsfragment) kan du använda Unik begränsningar ska tas bort från alla datatyper som används i respektive Content Fragment Models.
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.
Översättningsbar
Kontrollerar Översättningsbar kryssrutan för ett fält i redigeraren för innehållsfragmentmodellen:
/content/dam/<sites-configuration>
, om det inte redan finns.<translatable>
egenskapen i fältet Innehållsfragment till yes
, för att tillåta GraphQL-frågefilter för JSON-utdata med endast översättningsbart innehåll.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 av särskilt intresse i kombination med 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, till exempel bild- eller innehållsfragment.
Förutom standardegenskaper kan du ange:
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 programmet, 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 i kombination med 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 nytt 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.
Du kan redigera Egenskaper för en innehållsfragmentmodell:
Modelltitel
Taggar
Beskrivning
Överför bild
URL-mönster för standardförhandsvisning
Detta används endast av new Innehållsfragmentsredigeraren. Se Modeller för innehållsfragment för ytterligare information.
För 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 den:
Så här aktiverar du en modell som har flaggats som antingen:
Du använder Aktivera från antingen
En modell kan också inaktiveras så att:
Inaktivera en modell som är flaggad som Aktiverad du använder Inaktivera från antingen
Om du vill implementera innehållsstyrning kan du konfigurera Profiler i resursmappen för att kontrollera 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>
Profiler ärvs automatiskt när nya underordnade mappar skapas. Profilen 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, Allmäntö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 åtgärder på lämpligt sätt.
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, Allmäntö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, Allmäntö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.
Om du försöker avpublicera en modell som för närvarande används av ett eller flera fragment visas en felvarning om detta:
Meddelandet föreslår att du kontrollerar Referenser panel för vidare utredning:
Den här funktionen tillhandahåller styrning för publicerade modeller för innehållsfragment.
Content Fragment Models bestämmer schemat för GraphQL-frågor i AEM.
AEM GraphQL-scheman skapas så snart en innehållsfragmentmodell skapas, och de kan finnas både i författar- och publiceringsmiljöer.
Publiceringsscheman är de viktigaste eftersom de utgör grunden för leverans av innehåll i innehållsfragment i JSON-format.
Problem kan uppstå när modeller för innehållsfragment ändras, eller med andra ord redigeras. Det innebär att schemat ändras, vilket i sin tur kan påverka befintliga GraphQL-frågor.
Att lägga till nya fält i en innehållsfragmentmodell bör (vanligtvis) inte ha några skadliga effekter. Om du ändrar befintliga datafält (t.ex. namn) eller tar bort fältdefinitioner kommer befintliga GraphQL-frågor att brytas när de begär dessa fält.
Att göra användarna medvetna om riskerna vid redigering av modeller som redan används för leverans av direktsänt innehåll, med andra ord, modeller som har publicerats).
För att undvika oönskade ändringar.
Någon av dessa kan göra att frågor bryts om de ändrade modellerna publiceras på nytt.
För att åtgärda dessa problem finns följande modeller för innehållsfragment: låst i läget SKRIVSKYDDAD vid författare - så snart de har publicerats. Detta anges av Låst:
När modellen är Låst (i läget SKRIVSKYDDAD) kan du se innehållet i och strukturen på modeller, men du kan inte redigera dem.
Du kan hantera Låst modeller från antingen konsolen eller modellredigeraren:
Konsol
I konsolen kan du hantera skrivskyddat läge med Lås upp och Lås åtgärder i verktygsfältet:
Du kan Lås upp en modell för att aktivera redigering.
Om du väljer Lås upp, visas en varning och du måste bekräfta Lås upp åtgärd:
Du kan sedan öppna modellen för redigering.
Du kan också Lås modellen efteråt.
Om modellen publiceras på nytt kommer den omedelbart att användas igen Låst (SKRIVSKYDDAT) läge.
Modellredigerare
När du öppnar en låst modell får du en varning och tre åtgärder: Avbryt, Visa skrivskyddad, Redigera:
Om du väljer Visa skrivskyddad du kan se modellens innehåll och struktur:
Om du väljer Redigera kan du redigera och spara dina uppdateringar:
Det kan fortfarande finnas en varning överst, men det är när modellen redan används av befintliga innehållsfragment.
Avbryt kommer du tillbaka till konsolen.