Modeller för innehållsfragment content-fragment-models
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:
- Aktivera funktionen Content Fragment Model för instansen.
- Skapaoch konfigurera, era modeller för innehållsfragment.
- Aktivera modeller för innehållsfragment för användning när du skapar innehållsfragment.
- Tillåt dina modeller för innehållsfragment i de resursmappar som krävs efter konfigurering Profiler.
Skapa en innehållsfragmentmodell creating-a-content-fragment-model
-
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.
note caution CAUTION 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.
Definiera innehållsfragmentmodellen defining-your-content-fragment-model
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:
-
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:
- 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)
note note NOTE 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.
note caution CAUTION 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 önskat fält och klicka 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.
Datatyper data-types
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 med en enda textrad. Den maximala längden kan definieras
-
Flerradstext
- Ett textområde som kan vara RTF, Oformaterad text eller Markering
-
Nummer
- Lägg till ett eller flera numeriska fält
-
Boolean
- 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 nedrullningsbara fält
-
Taggar
- Tillåter fragmentförfattare att komma åt och markera taggområden
-
Innehållsreferens
- Refererar till annat innehåll, oavsett typ, som kan användas för skapa kapslat innehåll
- Om en bild refereras kan du välja att visa en miniatyrbild
-
Fragmentreferens
-
Refererar till andra innehållsfragment; kan användas till skapa kapslat innehåll
-
Datatypen kan konfigureras så att fragmentförfattare kan:
- Redigera det refererade fragmentet direkt.
- Skapa ett 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 och 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 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.note note NOTE Den här datatypen används endast för formatering, den ignoreras av AEM GraphQL-schema.
-
Egenskaper properties
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.
note caution CAUTION 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:
- RTF
- Markdown
- Oformaterad text
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ärdetJapan
i två beroende innehållsfragment. En varning skickas när ett försök görs att utföra den andra instansen.note note NOTE Unikitet säkerställs per språkrot. note note NOTE 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.
Validering validation
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.
-
Nummer
- Sök efter specifika värden.
-
Innehållsreferens
- Testa om det finns 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 using-references-to-form-nested-content
Innehållsfragment kan skapa kapslat innehåll med någon av följande datatyper:
-
- Ger en enkel referens till annat innehåll, av alla typer.
- Den 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.
note note NOTE Denna metod är särskilt intressant med tanke på Headless Content Delivery using Content Fragments with GraphQL. * Den kan konfigureras för en eller flera referenser (i det resulterande fragmentet).
-
-
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 content-reference
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:
-
The Rotsökväg för refererat innehåll
-
De innehållstyper som kan refereras
-
Begränsningar för filstorlekar
-
Om en bild refereras:
- Visa miniatyrbild
- Bildbegränsningar för höjd och bredd
Fragmentreferens (kapslade fragment) fragment-reference-nested-fragments
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:
- En modell som definierar detaljer för en medarbetare. Dessa omfattar:
- 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
}
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.
- fragmentreferencecomposite - låter fragmentförfattaren skapa en sammansatt bild genom att markera flera fragment
Aktivera eller inaktivera en innehållsfragmentmodell enabling-disabling-a-content-fragment-model
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.
Aktivera en innehållsfragmentmodell enabling-a-content-fragment-model
När en modell har skapats måste den aktiveras så att:
- Det kan markeras när du skapar ett innehållsfragment.
- Den kan refereras inifrån en innehållsfragmentmodell.
- Det är tillgängligt för GraphQL, så schemat genereras.
Så här aktiverar du en modell som har flaggats som antingen:
- Utkast : mew (aldrig aktiverad).
- Handikappade : har inaktiverats.
Du kan använda Aktivera 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 innehållsfragmentmodell disabling-a-content-fragment-model
En modell kan också inaktiveras så att:
-
Modellen är inte längre tillgänglig som grund för att skapa new Innehållsfragment.
-
Men:
- GraphQL-schemat fortsätter att genereras och är fortfarande frågningsbart (för att inte påverka JSON-API:t).
- Alla innehållsfragment som är baserade på modellen kan fortfarande efterfrågas och returneras från GraphQL slutpunkt.
-
Det går inte att referera till modellen längre, men befintliga referenser behålls orörda och kan fortfarande läsas och returneras från GraphQL-slutpunkten.
Inaktivera en modell som är flaggad som Aktiverad använder du Inaktivera från antingen
- Det övre verktygsfältet när den obligatoriska modellen är markerad.
- Motsvarande snabbåtgärd (mouse-over the required Model).
Tillåt modeller för innehållsfragment i resursmappen allowing-content-fragment-models-assets-folder
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.
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:
- The Profiler for 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 kan du titta på Cloud Service -konfiguration för den mappen (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 deleting-a-content-fragment-model
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.
note note NOTE Om modellen refereras visas en varning. Vidta lämpliga åtgärder.
Publicera en innehållsfragmentmodell publishing-a-content-fragment-model
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.note note NOTE 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 unpublishing-a-content-fragment-model
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.
Content Fragment Model - egenskaper content-fragment-model-properties
Du kan redigera Egenskaper för en innehållsfragmentmodell:
-
Grundläggande
- Modelltitel
- Taggar
- Beskrivning
- Överför bild