Modellen van inhoudsfragmenten content-fragment-models
De Modellen van het Fragment van de inhoud in AEM bepalen de structuur van inhoud voor uw inhoudsfragmenten,dienend als stichting van uw inhoud zonder kop.
U kunt als volgt modellen van inhoudsfragmenten gebruiken:
- Functionaliteit van inhoudsfragmentmodel inschakelen voor uw instantie
- creeer, en vorm, uw Modellen van het Fragment van de Inhoud
- laat uw Modellen van het Fragment van de Inhoudvoor gebruik toe wanneer het creëren van de Fragmenten van de Inhoud
- sta uw Modellen van het Fragment van de Inhoud op de vereiste omslagen van Assetstoe door Beleid te vormen.
Een inhoudsfragmentmodel maken creating-a-content-fragment-model
-
Navigeer aan Hulpmiddelen, Algemene, dan open Modellen van het Fragment van de Inhoud.
-
Navigeer aan de omslag aangewezen aan uw configuratie, of sub-configuratie.
-
Het gebruik creeert om de tovenaar te openen.
note caution CAUTION Als het gebruik van de modellen van het inhoudsfragment nietis toegelaten, creeer optie zal niet beschikbaar zijn. -
Specificeer de ModelTitel.
U kunt diverse eigenschappen ook bepalen; bijvoorbeeld, voeg Markeringen toe, a Beschrijving, en selecteer model toelaten om het modelindien nodig toe te laten.note note NOTE Voor details over het StandaardPatroon van de Voorproef URL zie Model van het Fragment van de Inhoud - Eigenschappen. -
Het gebruik creeert om het lege model te bewaren. Een bericht zal op het succes van de actie wijzen, kunt u Open selecteren om het model onmiddellijk uit te geven, of Gedaan om aan de console terug te keren.
Het model van het inhoudsfragment definiëren defining-your-content-fragment-model
Het model van het inhoudsfragment bepaalt effectief de structuur van de resulterende inhoudsfragmenten gebruikend een selectie van Types van Gegevens. Gebruikend de modelredacteur kunt u instanties van de gegevenstypes toevoegen, dan hen vormen om de vereiste gebieden tot stand te brengen:
-
Navigeer aan Hulpmiddelen, Algemene, dan open Modellen van het Fragment van de Inhoud.
-
Navigeer naar de map met het fragmentmodel van de inhoud.
-
Open het vereiste model voor uitgeven; gebruik of de snelle actie, of selecteer het model en toen de actie van de toolbar.
Zodra open de modelredacteur toont:
- links: velden al gedefinieerd
- rechts: datatypen voor het maken van velden (en eigenschappen voor gebruik als er velden zijn gemaakt)
note note NOTE Wanneer een gebied zoals Vereist, wordt het Etiket vermeld in de linkerruit duidelijk met een asterix (*).
-
om een Gebied toe te voegen
-
Sleep een vereist gegevenstype naar de vereiste locatie voor een veld:
-
Zodra een gebied aan het model is toegevoegd, zal het juiste paneel de Eigenschappen tonen die voor dat bepaalde gegevenstype kunnen worden bepaald. Hier kunt u definiëren wat voor dat veld is vereist.
-
Vele eigenschappen zijn duidelijk-verklarend, voor extra details zie Eigenschappen.
-
Het typen a Etiket van het Gebied zal de Naam van het Bezit auto-voltooien - als leeg, en het kan achteraf manueel worden bijgewerkt.
note caution CAUTION Wanneer manueel het bijwerken van de naam van het bezit voor een gegevenstype, merk op dat de namen slechts a-Z, a-z, 0-9 en onderstrepingsteken "_"als speciaal karakter moeten bevatten. Als modellen die in eerdere versies van AEM zijn gemaakt, ongeldige tekens bevatten, verwijdert of werkt u die tekens bij.
Bijvoorbeeld:
-
-
-
om een Gebied te verwijderen
Selecteer het vereiste veld en selecteer vervolgens het prullenbakpictogram. U wordt gevraagd de actie te bevestigen.
-
Voeg alle vereiste velden toe en definieer de bijbehorende eigenschappen, zoals vereist. Bijvoorbeeld:
-
Selecteer sparen om de definitie voort te zetten.
Gegevenstypen data-types
Voor het definiëren van uw model zijn verschillende gegevenstypen beschikbaar:
-
Enige lijntekst
- Voeg een of meer velden van één regel tekst toe. De maximumlengte kan worden gedefinieerd
-
Meerdere lijntekst
- Een tekstgebied dat RTF-tekst, normale tekst of markeringen kan bevatten
-
Aantal
- Een of meer numerieke velden toevoegen
-
Van Boole
- Een Booleaans selectievakje toevoegen
-
Datum en tijd
- Een datum en/of tijd toevoegen
-
Opsomming
- Een set selectievakjes, keuzerondjes of vervolgkeuzelijstvelden toevoegen
-
Markeringen
- Hiermee kunnen auteurs van fragmenten gebieden met tags openen en selecteren
-
Verwijzing van de Inhoud
- Verwijzingen andere inhoud, van om het even welk type; kan worden gebruikt om te creëren genestelde inhoud
- Als er naar een afbeelding wordt verwezen, kunt u ervoor kiezen een miniatuur weer te geven
-
Verwijzing van het Fragment
-
Verwijzingen andere inhoudsfragmenten; kan worden gebruikt om te creëren genestelde inhoud
-
Het gegevenstype kan worden geconfigureerd om fragmentauteurs toe te staan:
- Bewerk het fragment waarnaar wordt verwezen rechtstreeks.
- Een nieuw inhoudsfragment maken op basis van het juiste model
-
-
voorwerp JSON
-
Hiermee kan de auteur van het inhoudsfragment JSON-syntaxis invoeren in de overeenkomende elementen van een fragment.
- Om AEM toe te staan direct JSON op te slaan die u van een andere dienst hebt gekopieerd/gekleefd.
- De JSON wordt doorgegeven en uitvoer als JSON in GraphQL.
- Neemt JSON-syntaxismarkering, automatisch aanvullen en foutmarkering op in de inhoudsfragmenteditor.
-
-
Placeholder van het Lusje
-
Hiermee kunt u tabbladen invoeren die u kunt gebruiken bij het bewerken van de inhoud van het inhoudsfragment.
Dit wordt getoond als verdeler in de modelredacteur, die secties van de lijst van inhoudstypes scheidt. Elke instantie vertegenwoordigt het begin van een nieuw lusje.
In de fragmenteditor wordt elke instantie weergegeven als een tab.note note NOTE Dit gegevenstype wordt alleen gebruikt voor opmaak en wordt genegeerd door het schema AEM GraphQL.
-
Eigenschappen properties
Vele eigenschappen zijn voor zichzelf verklarend, voor bepaalde eigenschappen zijn hieronder meer details te vinden:
-
de Naam van het Bezit
Wanneer manueel het bijwerken van dit bezit voor een gegevenstype, merk op dat de namen slechts a-z, a-z, 0-9 en onderstrepingsteken "_"als speciaal karakter moeten bevatten.
note caution CAUTION Als modellen die in eerdere versies van AEM zijn gemaakt, ongeldige tekens bevatten, verwijdert of werkt u die tekens bij. -
geeft terug als
De verschillende opties voor het realiseren/renderen van het veld in een fragment. Met deze eigenschap kunt u vaak definiëren of de auteur één instantie van het veld ziet of meerdere instanties mag maken. Wanneer Veelvoudig Gebied wordt gebruikt kunt u het minimum en maximumaantal punten bepalen - zie Bevestigingvoor verdere details. -
Etiket van het Gebied
Het ingaan van het Etiket van het a Gebied zal autogenerate a Naam van het Bezit, die dan manueel kan worden bijgewerkt indien nodig. -
Bevestiging
De fundamentele bevestiging is beschikbaar door mechanismen zoals het Vereiste bezit. Sommige gegevenstypen hebben extra validatievelden. Zie Bevestigingvoor verdere details. -
Voor het datatype Tekst met meerdere regels is het mogelijk het standaardtype als volgt te definiëren:
- Rijke Tekst
- Markering
- Onbewerkte Tekst
Als gespecificeerd niet, wordt de standaardwaarde Rijke Tekst gebruikt voor dit gebied.
Het wijzigen van het standaardtype in een contentfragmentmodel heeft alleen effect op een bestaand, gerelateerd contentfragment nadat dat fragment is geopend in de editor en opgeslagen.
-
Uniek
De inhoud (voor het specifieke veld) moet uniek zijn in alle inhoudsfragmenten die op basis van het huidige model zijn gemaakt.Dit wordt gebruikt om ervoor te zorgen dat inhoudsauteurs geen inhoud kunnen herhalen die al in een ander fragment van hetzelfde model is toegevoegd.
Bijvoorbeeld, het 1} gebied van de a Enige lijntekst {in het Model van het Fragment van de Inhoud kan niet de waarde
Japan
in twee afhankelijke Fragmenten van de Inhoud hebben.Country
Er wordt een waarschuwing weergegeven wanneer de tweede instantie wordt geprobeerd.note note NOTE Er wordt gezorgd voor uniformiteit per taalwortel. note note NOTE De variaties kunnen de zelfde unieke waarde zoals variaties van het zelfde fragment hebben, maar niet de zelfde waarde zoals die in om het even welke variatie van andere fragmenten wordt gebruikt. note caution CAUTION Als u MSM (dat tot exemplaren van de Fragmenten van de Inhoud leidt) wilt gebruiken, dan zouden om het even welke Unieke beperkingen uit om het even welke Types moeten worden verwijderd van Gegevens die in de respectieve Modellen van het Fragment van de Inhoud worden gebruikt. -
Zie Verwijzing van de Inhoud voor meer details over dat specifieke gegevenstype en zijn eigenschappen.
-
Zie Verwijzing van het Fragment (Genestelde Fragments) voor meer details over dat specifieke gegevenstype en zijn eigenschappen.
-
Vertaalbaar
Het controleren van Vertaalbare checkbox op een gebied in de Modelredacteur van het Fragment van de Inhoud:
- Controleer of de eigenschapsnaam van het veld wordt toegevoegd aan de vertaalconfiguratie, context
/content/dam/<sites-configuration>
, als deze nog niet aanwezig is. - Voor GraphQL: stel een eigenschap
<translatable>
in het veld Inhoudsfragment in opyes
om GraphQL-queryfilter toe te staan voor JSON-uitvoer met alleen vertaalbare inhoud.
- Controleer of de eigenschapsnaam van het veld wordt toegevoegd aan de vertaalconfiguratie, context
Validatie validation
Verschillende gegevenstypen bieden nu de mogelijkheid om validatievereisten te definiëren voor het tijdstip waarop inhoud wordt ingevoerd in het resulterende fragment:
-
Enige lijntekst
- Vergelijk met een vooraf gedefinieerde regex.
-
Aantal
- Controleren op specifieke waarden.
-
Verwijzing van de Inhoud
- Testen op specifieke typen inhoud.
- Er kan alleen worden verwezen naar elementen van een opgegeven bestandsgrootte of kleiner.
- Er kan alleen worden verwezen naar afbeeldingen met een vooraf gedefinieerde breedte en/of hoogte (in pixels).
-
Verwijzing van het Fragment
- Testen op een specifiek inhoudsfragmentmodel.
-
Min Aantal Punten / Max Aantal Punten
De gebieden die als a Veelvoudig Gebied zijn bepaald (die met worden geplaatst teruggeven als) hebben de opties:
- Min Aantal Punten
- Max Aantal Punten
Deze worden gevalideerd:
- De maximumwaarde wordt bevestigd in de originele Redacteur van het Fragment van de Inhoud.
- Beide worden bevestigd in de Redacteur van het Fragment van de Inhoud.
Referenties gebruiken om geneste inhoud te vormen using-references-to-form-nested-content
Inhoudsfragmenten kunnen geneste inhoud vormen met een van de volgende gegevenstypen:
-
- Verstrekt een eenvoudige verwijzing naar andere inhoud; van om het even welk type.
- Kan worden geconfigureerd voor een of meerdere verwijzingen (in het resulterende fragment).
-
Verwijzing van het Fragment (Geneste Fragmenten)
-
Verwijzingen naar andere fragmenten, afhankelijk van de opgegeven modellen.
-
Hiermee kunt u gestructureerde gegevens opnemen/ophalen.
note note NOTE Deze methode is van bijzonder belang samen met Zwaarloze Levering van de Inhoud gebruikend de Fragmenten van de Inhoud met GraphQL. * Kan worden geconfigureerd voor een of meerdere verwijzingen (in het resulterende fragment).
-
-
Content References
Zo voorkomt u dat de gebruiker een verwijzing naar het huidige fragment toevoegt. Dit kan leiden tot een leeg dialoogvenster van de kiezer voor fragmentverwijzing. -
Fragmentverwijzingen in GraphQL
Wanneer u een diepe query maakt die meerdere Content Fragments retourneert waarnaar door elkaar wordt verwezen, wordt null geretourneerd bij de eerste instantie.
Content Reference content-reference
Met de Content Reference kunt u inhoud van een andere bron renderen, bijvoorbeeld een afbeeldings- of inhoudsfragment.
Naast de standaardeigenschappen kunt u opgeven:
-
Het Weg van de Wortel voor om het even welke referenced inhoud
-
De inhoudstypen waarnaar kan worden verwezen
-
Beperkingen voor bestandsgrootten
-
Als naar een afbeelding wordt verwezen:
- Miniatuur tonen
- Hoogte- en breedtebeperkingen voor afbeeldingen
Fragmentverwijzing (geneste fragmenten) fragment-reference-nested-fragments
De fragmentverwijzing verwijst naar een of meer inhoudsfragmenten. Deze functie is vooral van belang bij het ophalen van inhoud voor gebruik in uw app, omdat u gestructureerde gegevens met meerdere lagen kunt ophalen.
Bijvoorbeeld:
- Een model dat details voor een werknemer bepaalt; deze omvatten:
- Een verwijzing naar het model dat de werkgever (onderneming) definieert
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Naast de standaardeigenschappen kunt u definiëren:
-
geeft terug als:
-
multifield - de fragmentauteur kan veelvoudige, individuele, verwijzingen creëren
-
fragmentreference - staat de fragmentauteur toe om één enkele verwijzing naar een fragment te selecteren
-
-
ModelType
U kunt meerdere modellen selecteren. Bij het ontwerpen van het inhoudsfragment moeten fragmenten waarnaar wordt verwezen, met deze modellen zijn gemaakt. -
Weg van de Wortel
Geeft een hoofdpad aan voor alle fragmenten waarnaar wordt verwezen. -
staat het Maken van het Fragment toe
Hierdoor kan de auteur van het fragment een fragment maken op basis van het juiste model.
- fragmentreferencecomposite - staat de fragmentauteur toe om een samenstelling te bouwen, door veelvoudige fragmenten te selecteren
Inhoudsfragmentmodel - eigenschappen content-fragment-model-properties
U kunt Eigenschappen van een Model van het Fragment van de Inhoud uitgeven:
-
Basis
-
ModelTitel
-
Markeringen
-
Beschrijving
-
upload Beeld
-
Standaard het Patroon van URL van de Voorproef
note note NOTE Dit wordt slechts gebruikt door de nieuwe Redacteur van het Fragment van de Inhoud. Zie Modellen van het Fragment van de Inhoudvoor verdere informatie.
-
Een inhoudsfragmentmodel in- of uitschakelen enabling-disabling-a-content-fragment-model
Voor volledige controle over het gebruik van uw modellen van het Fragment van de Inhoud hebben zij een status die u kunt plaatsen.
Een inhoudsfragmentmodel inschakelen enabling-a-content-fragment-model
Wanneer een model wordt gecreeerd moet het worden toegelaten zodat het:
- Deze optie is beschikbaar voor selectie wanneer u een inhoudsfragment maakt.
- Er kan vanuit een inhoudsfragmentmodel naar worden verwezen.
- Is beschikbaar aan GraphQL; zo wordt het schema geproduceerd.
Een model inschakelen dat is gemarkeerd als:
- Ontwerp : mw (nooit toegelaten).
- Gehandicapten : is specifiek onbruikbaar gemaakt.
U gebruikt toelaten optie van één van beiden:
- De bovenste werkbalk als het vereiste model is geselecteerd.
- De corresponderende snelle actie (mouse-over het vereiste model).
toe
Een inhoudsfragmentmodel uitschakelen disabling-a-content-fragment-model
Een model kan ook worden uitgeschakeld, zodat:
-
Het model is niet meer beschikbaar als basis voor het creëren van nieuwe Fragmenten van de Inhoud.
-
Echter:
- Het GraphQL-schema wordt steeds gegenereerd en kan nog steeds worden opgevraagd (om te voorkomen dat JSON API wordt beïnvloed).
- Om het even welke die Inhoudsfragmenten van het model worden gebaseerd kunnen nog van het eindpunt van GraphQL worden gevraagd en zijn teruggekeerd.
-
Er kan niet meer naar het model worden verwezen, maar bestaande verwijzingen blijven ongewijzigd en kunnen nog steeds worden opgevraagd en geretourneerd vanaf het GraphQL-eindpunt.
Om een Model onbruikbaar te maken dat als toegelaten wordt gemarkeerd gebruikt u maak optie van één van beiden onbruikbaar:
- De bovenste werkbalk als het vereiste model is geselecteerd.
- De corresponderende snelle actie (mouse-over het vereiste model).
onbruikbaar
Modellen voor inhoudsfragmenten toestaan in uw Assets-map allowing-content-fragment-models-assets-folder
Om inhoudsbeheer uit te voeren, kunt u Beleid op de omslag van Assets vormen om te controleren welke Modellen van het Fragment van de Inhoud voor de verwezenlijking van het Fragment in die omslag worden toegestaan.
Om het Beleid voor toegelaten Modellen van het Fragment van de Inhoud te vormen:
-
Navigeer en open Eigenschappen voor de vereiste omslag van Assets.
-
Open het Beleid lusje, waar u kunt vormen:
-
Overgenomen van
<folder>
Het beleid wordt automatisch geërft wanneer het creëren van nieuwe kindomslagen; het beleid kan (en de erfenis gebroken) worden opnieuw gevormd als de subomslagen modellen moeten toestaan verschillend aan de ouderomslag.
-
Toegestane Modellen van het Fragment van de Inhoud door Weg
U kunt meerdere modellen toestaan.
-
Toegestane Modellen van het Fragment van de Inhoud door Markering
U kunt meerdere modellen toestaan.
-
-
sparen om het even welke veranderingen.
De modellen van inhoudsfragmenten die zijn toegestaan voor een map, worden als volgt opgelost:
- Het Beleid voor Toegestane Modellen van het Fragment van de Inhoud.
- Als dit leeg is, kunt u het beleid bepalen met behulp van de overervingsregels.
- Als de overervingsketen geen resultaat levert, dan bekijk de Cloud Servicen configuratie voor die omslag (ook eerst direct en dan via overerving).
- Als geen van de bovenstaande resultaten worden behaald, zijn er geen modellen toegestaan voor die map.
Een inhoudsfragmentmodel verwijderen deleting-a-content-fragment-model
Een inhoudsfragmentmodel verwijderen:
-
Navigeer aan Hulpmiddelen, Algemene, dan open Modellen van het Fragment van de Inhoud.
-
Navigeer naar de map met het fragmentmodel van de inhoud.
-
Selecteer uw model, dat door wordt gevolgd Schrapping van de toolbar.
note note NOTE Als naar het model wordt verwezen, wordt een waarschuwing gegeven. Voer de juiste actie uit.
Een inhoudsfragmentmodel publiceren publishing-a-content-fragment-model
Inhoudsfragmentmodellen moeten worden gepubliceerd wanneer/voordat afhankelijke inhoudsfragmenten worden gepubliceerd.
Een fragmentmodel voor inhoud publiceren:
-
Navigeer aan Hulpmiddelen, Algemene, dan open Modellen van het Fragment van de Inhoud.
-
Navigeer naar de map met het fragmentmodel van de inhoud.
-
Selecteer uw model, dat door wordt gevolgd Publish van de toolbar.
De gepubliceerde status wordt vermeld in de console.note note NOTE Als u een inhoudsfragment publiceert waarvoor het model nog niet is gepubliceerd, geeft een selectielijst dit aan en wordt het model gepubliceerd met het fragment.
Publicatie van een inhoudsfragmentmodel ongedaan maken unpublishing-a-content-fragment-model
Inhoudsfragmentmodellen kunnen ongepubliceerd zijn als naar deze modellen niet wordt verwezen door fragmenten.
Publicatie van een inhoudsfragmentmodel ongedaan maken:
-
Navigeer aan Hulpmiddelen, Algemene, dan open Modellen van het Fragment van de Inhoud.
-
Navigeer naar de map met het fragmentmodel van de inhoud.
-
Selecteer uw model, dat door wordt gevolgd unpublish van de toolbar.
De gepubliceerde status wordt vermeld in de console.
Als u probeert de publicatie ongedaan te maken van een model dat momenteel wordt gebruikt door een of meer fragmenten, wordt u hiervan op de hoogte gesteld door een foutwaarschuwing:
Het bericht zal suggereren dat u het paneel van Verwijzingencontroleert om verder te onderzoeken:
Vergrendelde (gepubliceerde) modellen van inhoudsfragmenten locked-published-content-fragment-models
Deze functie biedt beheer voor modellen van inhoudsfragmenten die zijn gepubliceerd.
De uitdaging the-challenge
-
Met Content Fragment Models wordt het schema voor GraphQL-query's in AEM bepaald.
-
AEM GraphQL-schema's worden gemaakt zodra een Content Fragment Model is gemaakt en kunnen bestaan in zowel auteur- als publicatieomgevingen.
-
Schema's bij publiceren zijn het meest kritiek aangezien zij de basis voor levende levering van inhoud van het Fragment van de Inhoud in formaat JSON verstrekken.
-
-
Er kunnen zich problemen voordoen wanneer modellen van inhoudsfragmenten worden gewijzigd of met andere woorden worden bewerkt. Dit betekent dat het schema verandert, wat op zijn beurt bestaande vragen van GraphQL kan beïnvloeden.
-
Het toevoegen van nieuwe velden aan een inhoudsfragmentmodel mag (gewoonlijk) geen nadelige effecten hebben. Als u echter bestaande gegevensvelden wijzigt (bijvoorbeeld hun naam) of velddefinities verwijdert, worden bestaande GraphQL-query's verbroken wanneer deze velden worden aangevraagd.
De vereisten the-requirements
-
Gebruikers bewust maken van de risico's bij het bewerken van modellen die al worden gebruikt voor de levering van live-inhoud (met andere woorden, modellen die zijn gepubliceerd).
-
Ook, om onbedoelde veranderingen te vermijden.
Één van beiden van deze zou vragen kunnen breken als de gewijzigde modellen opnieuw worden gepubliceerd.
De oplossing the-solution
Om deze kwesties te richten, zijn de Modellen van het Fragment van de Inhoud gesloten in een LEZEN-ONLY wijze op auteur - zodra zij zijn gepubliceerd. Dit wordt vermeld door Vergrendelde:
Wanneer het model Vergrendeld (op LEZEN-ONLY wijze) is, kunt u de inhoud en de structuur van modellen zien maar u kunt hen niet uitgeven.
U kunt Vergrendelde modellen van of de console, of modelredacteur beheren:
-
Console
Van de console, kunt u de LEZEN-ONLY wijze met leiden ontgrendelt en ontgrendelt acties in de toolbar:
-
U kunt een model ontgrendelen om uitgeeft toe te laten.
Als u ontgrendelt selecteert, wordt een waarschuwing getoond, en u moet de ontgrendelen actie bevestigen:
Vervolgens kunt u het model openen en bewerken.
-
U kunt het model ook Slot achteraf.
-
Het opnieuw publiceren van het model zal het onmiddellijk in Vergrendelde (LEZEN-ONLY) wijze zetten.
-
-
Modeleditor
-
Wanneer u een model opent dat wordt gesloten, wordt u gewaarschuwd, en met drie acties voorgesteld: annuleert, Mening Gelezen, geeft uit:
-
Als u Mening slechts selecteert leest u de inhoud en de structuur van het model kunt zien:
-
Als u uitgezocht geef uit u kunt uw updates uitgeven en opslaan:
note note NOTE Mogelijk staat er nog een waarschuwing boven aan het scherm, maar dat is wanneer het model al wordt gebruikt door bestaande inhoudsfragmenten. -
annuleert u aan de console zal terugkeren.
-