Hantera modeller för innehållsfragment managing-content-fragment-models
Från konsolen Innehållsfragment kan du hantera dina modeller för innehållsfragment och sedan öppna redigeraren för att definiera strukturen.
Content Fragment Models i Adobe Experience Manager (AEM) as a Cloud Service definierar strukturen för innehållet i dina Content Fragments. Dessa fragment kan sedan användas som grund för ditt headless-innehåll eller för att skapa sidor.
Så här arbetar du med modeller för innehållsfragment how-to-work-with-content-fragment-models
En mycket snabb översikt om hur du arbetar med Content Fragment Models:
- Aktivera funktionen Content Fragment Model för instansen
- Skapa din innehållsfragmentmodell.
- Nu kan du även aktivera modellen (som kan användas när du skapar innehållsfragment).
- Definiera modellens struktur.
- Aktivera innehållsfragmentmodellen om det inte redan är gjort.
- Tillåt dina modeller för innehållsfragment i de nödvändiga Assets-mapparna genom att konfigurera Profiler.
Grundläggande struktur och hantering av modeller för innehållsfragment i konsolen basic-structure-handling-content-fragment-models-console
Du kan använda panelen längst till vänster i konsolen Innehållsfragment för att välja Modeller för innehållsfragment som resurstyp för att visa, bläddra och hantera:
Då öppnas vyn för Content Fragment Models:
Här ser du att det finns tre huvudområden:
-
Det övre verktygsfältet
- Tillhandahåller AEM standardfunktioner
- Visar även din IMS-organisation
- Tillhandahåller olika åtgärder
-
Den vänstra panelen
- Visar sökvägarna till alla konfigurationer som listas som mappar
- Här kan du dölja eller visa mappträdet
- Du kan välja en specifik mapp i trädet
- Storleken kan ändras för att visa kapslade mappar (underkonfigurationer)
- Förutom modeller för innehållsfragment kan du visa innehållsfragment eller Assets. Du kan även komprimera, eller expandera, länkar till panelerna
-
Den högra panelen - härifrån kan du:
-
Se listan över alla modeller för innehållsfragment som finns i den valda mappen:
-
Modeller för innehållsfragment från den valda mappen och alla undermappar visas:
- Platsen anges av vägbeskrivningarna. Dessa kan även användas för att ändra platsen:
-
Olika fält med information om en modell för innehållsfragment innehåller länkar. Beroende på fältet kan dessa:
- Öppna lämplig modell i redigeraren
- Visa information om sökvägen till konfigurationen
- Visa information om modellens status
-
Vissa andra fält med information om en innehållsfragmentmodell kan användas för Snabb filtrering:
- Markera ett värde i kolumnen så tillämpas det omedelbart som ett filter
- Snabb filtrering stöds för kolumnerna Ändrad av, Publicerad av och Status.
-
Genom att använda musen på kolumnrubrikerna visas en listruta med åtgärdsväljare och breddreglage. Med dessa kan du:
- Sortera - välj lämplig åtgärd för antingen stigande eller fallande
Då sorteras hela tabellen efter den kolumnen. Sortering är bara tillgängligt för lämpliga kolumner. - Ändra storlek på kolumnen med antingen funktionsmakrot eller breddreglagen
- Sortera - välj lämplig åtgärd för antingen stigande eller fallande
-
Välj en eller flera modeller för ytterligare åtgärd
-
-
Öppna filterpanelen
-
Det finns ett urval av kortkommandon som kan användas i den här konsolen
-
Information om dina modeller för innehållsfragment information-content-fragment-models
Huvudpanelen/den högra panelen (tabellvyn) i konsolen innehåller en rad information om dina modeller för innehållsfragment. Vissa objekt har också direkta länkar till ytterligare åtgärder och/eller information:
-
Namn
- Tillhandahåller en länk för att öppna modellen i redigeraren.
-
Låst (hänglåsikon)
- När modellen är låst visas den med en hänglåsikon.
-
Sökväg
- Anger sökvägen som en länk för att öppna konfigurationen i konsolen.
Vid hovring över mappnamnet visas JCR-sökvägen.
- Anger sökvägen som en länk för att öppna konfigurationen i konsolen.
-
Status
- Endast information.
- Kan användas för snabb filtrering
-
Ändrad
- Endast information.
-
Ändrad av
- Endast information.
- Kan användas för snabb filtrering.
-
Taggar
- Endast information.
- Visar alla taggar som är relaterade till modellen.
- Kan användas för snabb filtrering.
-
Publicerad
- Endast information.
-
Publicerad av
- Endast information.
- Kan användas för snabb filtrering.
Modegenskaper model-properties
När du väljer en viss modell visas modellens egenskaper (som de definieras när modellen skapas). Om modellen inte är låst kan vissa objekt uppdateras. Du kan också använda informationsikonen (bredvid modellen Title) för att öppna och stänga den här informationspanelen.
-
Titel
-
Taggar
-
Beskrivning
-
Förhandsgranska URL-mönster
Med Content Fragment Models kan författare Förhandsgranska sitt innehåll i ett externt klientprogram. När förhandsgranskningstjänsten har konfigurerats lägger du till URL:en för klientprogrammet.
URL:en för förhandsgranskning bör följa detta mönster:
https://<preview_url>?param=${expression}Tillgängliga uttryck är:
${contentFragment.path}${contentFragment.model.path}${contentFragment.model.name}${contentFragment.variation}${contentFragment.id}
Åtgärder actions
När du har markerat en mapp (i den vänstra panelen) finns det en rad åtgärder som du kan använda, antingen direkt eller efter att du har valt en viss modell:
- Olika åtgärder är direkt tillgängliga från konsolen
- Du kan välja en eller flera innehållsfragmentmodeller för att visa lämpliga åtgärder
Åtgärder (omarkerade) actions-unselected
Vissa åtgärder är tillgängliga från konsolen - efter att du har valt en mapp, men utan att välja en specifik modell för innehållsfragment:
- Skapa en ny (tom) modell
Åtgärder för en innehållsfragmentmodell i konsolen för innehållsfragment actions-selected-content-fragment-models
Om du väljer en viss modell öppnas ett verktygsfält som fokuserar på de åtgärder som är tillgängliga för den modellen. Du kan också välja flera modeller - de tillgängliga åtgärderna justeras därefter.
- Redigera om du vill definiera innehållsfragmentmodellen.
- Publicera på nivåerna Publicera eller Förhandsgranska.
- Lås/Lås upp för att kontrollera om en användare får ändra modellen.
- Aktivera/Inaktivera för att kontrollera om en användare får skapa innehållsfragment baserat på den här modellen.
Om du väljer en enskild modell visas även modellegenskaperna i den högra panelen.
Markera kolumner som visas i konsolen select-columns-console
Precis som med andra konsoler kan du konfigurera de kolumner som är synliga och tillgängliga för åtgärder:
Här visas en lista med kolumner som du kan dölja eller visa:
Filtrera fragmentmodeller för innehåll filter-content-fragment-models
På panelen Filter finns:
-
Ett urval av prediater.
- inklusive statusfält, taggar, användare med flera
- ett eller flera predikat kan markeras och kombineras för att skapa filtret
När du har valt alternativet Filtrera efter visas alternativen (högst upp på huvudpanelen). De kan avmarkeras därifrån. Till exempel:
Snabb filtrering fast-filtering
Du kan också välja ett predikat genom att klicka på ett visst kolumnvärde i listan. Du kan välja ett eller flera värden för att kombinera predikat.
Välj till exempel Aktiverad i kolumnen Status. När du har valt det här alternativet visas det som ett filterpredikat och listan filtreras därefter.
Skapa en innehållsfragmentmodell creating-a-content-fragment-model
-
Navigera till den mapp som passar din konfiguration eller underkonfiguration.
-
Använd Skapa för att öppna dialogrutan.
note caution CAUTION Alternativet Skapa är bara tillgängligt: - Om användningen av Content Fragment Models har aktiverats
- när du har valt den mapp där du vill skapa modellen.
-
Markera sökvägen till konfigurationen och ange namnet.
note note NOTE Konfigurationen fylls i automatiskt med den aktuella konfigurationen (mappen du befinner dig i). Du kan också ändra konfigurationen genom att klicka på mappikonen. Du kan också definiera olika egenskaper:
- Titel
Om du anger Title först genereras Name utifrån det. - en beskrivning
- Aktivera modellen för att aktivera modellen
note note NOTE Mer information finns i Modell för innehållsfragment - Egenskaper. 
- Titel
-
Använd Skapa om du vill spara den tomma modellen eller Skapa och öppna.
Aktivera en innehållsfragmentmodell enabling-a-content-fragment-model
När en modell har skapats måste den aktiveras så att den:
- Kan markeras när du skapar ett innehållsfragment.
- Kan refereras inifrån en innehållsfragmentmodell.
- Är tillgängligt för GraphQL, så schemat genereras.
Du kan aktivera en modell:
- När en ny modell skapas
- Ett alternativ visas i dialogrutan.
- När en modell specifikt har inaktiverats
- När den obligatoriska modellen har valts är åtgärden Aktivera tillgänglig i det övre verktygsfältet.
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 nya 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.
Om du vill inaktivera en modell som är flaggad som Aktiverad använder du alternativet Inaktivera från:
- Det övre verktygsfältet när den obligatoriska modellen är markerad.
Tillåt modeller för innehållsfragment i din Assets-mapp allowing-content-fragment-models-assets-folder
Om du vill implementera innehållsstyrning kan du konfigurera profiler i Assets-mappen för att styra vilka innehållsfragmentmodeller som tillåts för att skapa fragment i den mappen.
Så här konfigurerar du principer för Tillåtna modeller för innehållsfragment:
-
Navigera och öppna Egenskaper för den Assets-mapp som krävs.
-
Öppna fliken Profiler där du kan konfigurera:
-
Ärvd från
<folder>Principer ärvs automatiskt när nya 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 via 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:
- 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å konfigurationen Cloud Services 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.
Publicera en innehållsfragmentmodell publishing-a-content-fragment-model
Content Fragment Models måste publiceras när/innan beroende Content Fragments publiceras.
Så här publicerar du en innehållsfragmentmodell:
-
Navigera till och markera innehållsfragmentmodellen. Du kan välja flera modeller.
-
Välj Publicera i verktygsfältet.
-
I dialogrutan Publicera väljer du Mål:
- Publiceringstjänst
- Förhandsgranskningstjänst
-
Arbetsflödet för publicering av de valda modellerna och deras referenser startas. Publiceringsstatusen visas sedan i konsolen.
Låsta modeller för innehållsfragment locked-content-fragment-models
Med den här funktionen kan du styra om en modell kan uppdateras, men den tillhandahåller även styrning för publicerade modeller för innehållsfragment.
Utmaningen the-challenge
-
Content Fragment Models bestämmer schemat för GraphQL-frågor i AEM.
-
AEM GraphQL-scheman skapas så snart en Content Fragment Model skapas, och de kan finnas både i skribent- 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.
Krav the-requirements
-
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ågot av dessa villkor kan göra att frågor bryts om de ändrade modellerna publiceras på nytt.
Lösningen the-solution
För att åtgärda dessa problem är Content Fragment Models låst i READ-ONLY-läge när de har skapats - så snart de har publicerats. Den här statusen anges av Låst.
När modellen är Låst (i läget SKRIVSKYDDAD) kan du se innehållet och strukturen för modellerna, men du kan inte redigera dem.
Du kan hantera låsta modeller från konsolen eller modellredigeraren:
-
Konsol
Från konsolen kan du hantera läget SKRIVSKYDDAT med åtgärderna Lås upp och Lås i verktygsfältet.
-
Du kan Lås upp en modell om du vill aktivera redigeringar.
Om du väljer Lås upp visas en varning och du måste bekräfta åtgärden Lås upp.
Du kan sedan öppna modellen för redigering.
-
Du kan också låsa modellen i efterhand.
-
Om du publicerar om modellen återgår den omedelbart till läget Låst (SKRIVSKYDDAT).
-
-
Modellredigerare
-
När du öppnar en låst modell får du en varning och tre åtgärder visas: Avbryt, Visa skrivskyddad, Redigera.
-
Om du väljer Visa skrivskyddat kan du se modellens innehåll och struktur.
-
Om du väljer Redigera kan du redigera och spara dina uppdateringar:
note note NOTE Det kan fortfarande finnas en varning överst, men det är när modellen redan används av befintliga innehållsfragment. -
Avbryt returnerar dig till konsolen.
-