Modellen voor inhoudsfragmenten definiëren defining-content-fragment-models
De Modellen van het Fragment van de inhoud in Adobe Experience Manager (AEM) as a Cloud Service bepalen de structuur voor de inhoud van uw Fragmenten van de Inhoud. Deze fragmenten kunnen vervolgens worden gebruikt voor het ontwerpen van pagina's of als basis voor inhoud zonder kop.
Op deze pagina wordt uitgelegd hoe u het fragmentmodel van de inhoud definieert met behulp van de toegewezen editor. Zie Leiden uw Modellen van het Fragment van de Inhoudvoor verdere taken en opties beschikbaar zodra uw fragmenten, met inbegrip van acties beschikbaar van de Console van Fragmenten van de Inhoudworden gecreeerd, toestaand het model op uw omslagen het publiceren van uw model.
Het model van het inhoudsfragment definiëren defining-your-content-fragment-model
Het model van het Fragment van de Inhoud bepaalt effectief de structuur van de resulterende Fragmenten van de Inhoud 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:
-
In de Console van het Fragment van de Inhoud, selecteer het paneel voor Modellen van het Fragment van de Inhouden navigeer aan de omslag die uw model van het Fragment van de Inhoud houdt.
note note NOTE U kunt een model ook direct openen na creërend het. -
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 als Vereist wordt bepaald, wordt het Etiket dat in de linkerruit wordt vermeld 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, toont het juiste paneel de Eigenschappen die voor dat bepaalde gegevenstype kunnen worden bepaald. Hier kunt u definiëren wat voor dat veld is vereist.
-
Vele eigenschappen zijn zelf-verklarend, voor extra details zie Eigenschappen (de Types van Gegevens).
-
Het typen a Etiket van het Gebied auto-voltooit de Naam van het Bezit - 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, moeten de namen slechts a-z, a-z, 0-9 en onderstrepingsteken "_"als speciaal karakter 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
- Een veld toevoegen voor één regel tekst; de maximumlengte kan worden gedefinieerd
- Het veld kan zo worden geconfigureerd dat fragmentauteurs nieuwe instanties van het veld kunnen maken
-
Meerdere lijntekst
- Een tekstgebied dat RTF-tekst, platte tekst of Markering kan zijn
- Het veld kan zo worden geconfigureerd dat fragmentauteurs nieuwe instanties van het veld kunnen maken
note note NOTE Of het tekstgebied Rijke Tekst, Onbewerkte Tekst, of Markting is, wordt bepaald in het model door het bezit StandaardType. Dit formaat kan niet van de redacteur van het Fragment van de Inhoudworden veranderd, maar slechts van het Model. -
Aantal
- Een numeriek veld toevoegen
- Het veld kan zo worden geconfigureerd dat fragmentauteurs nieuwe instanties van het veld kunnen maken
-
Van Boole
- Een Booleaans selectievakje toevoegen
-
Datum en tijd
- Een datum- en/of tijdveld toevoegen
-
Opsomming
- Een set selectievakjes, keuzerondjes of vervolgkeuzelijsten toevoegen
- U kunt de opties specificeren beschikbaar aan de fragmentauteur
- Een set selectievakjes, keuzerondjes of vervolgkeuzelijsten toevoegen
-
Markeringen
- Hiermee kunnen auteurs van fragmenten gebieden met tags openen en selecteren
-
Verwijzing van het Fragment
-
Verwijzingen andere Fragmenten van de Inhoud; kan worden gebruikt om genestelde inhoudtot stand te brengen
-
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
- Nieuwe instanties van het veld maken
-
De verwijzing geeft het pad naar de resource waarnaar wordt verwezen aan, bijvoorbeeld
/content/dam/path/to/resource
-
-
Verwijzing van het Fragment (UUID)
-
Verwijzingen andere Fragmenten van de Inhoud; kan worden gebruikt om genestelde inhoudtot stand te brengen
-
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
- Nieuwe instanties van het veld maken
-
In de redacteur, specificeert de verwijzing de weg aan het referenced middel; intern wordt de verwijzing gehouden als universeel unieke identiteitskaart (UUID) die verwijzingen het middel
- U hoeft de UUID niet te weten; in de fragmenteditor kunt u naar het vereiste fragment bladeren
-
-
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
- Het veld kan zo worden geconfigureerd dat fragmentauteurs nieuwe instanties van het veld kunnen maken
- De verwijzing geeft het pad naar de resource waarnaar wordt verwezen aan, bijvoorbeeld
/content/dam/path/to/resource
-
Verwijzing van de Inhoud (UUID)
- 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
- Het veld kan zo worden geconfigureerd dat fragmentauteurs nieuwe instanties van het veld kunnen maken
- In de redacteur, specificeert de verwijzing de weg aan het referenced middel; intern wordt de verwijzing gehouden als universeel unieke identiteitskaart (UUID) die verwijzingen het middel
- U hoeft de UUID niet te weten; in de fragmenteditor kunt u naar de vereiste elementbron bladeren
-
voorwerp JSON
-
Hiermee stelt u de auteur van inhoudsfragment in staat JSON-syntaxis in te voeren in de overeenkomende elementen van een fragment.
- AEM toestaan direct JSON op te slaan dat u hebt gekopieerd/geplakt van een andere service.
- 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.
- Deze worden getoond als verdelers in de modelredacteur, scheidend secties van de lijst van inhoudstypes. 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 AEM GraphQL-schema.
-
Eigenschappen (gegevenstypen) 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, moeten de namen slechts a-z, a-z, 0-9 en onderstrepingsteken "_"als speciaal karakter 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. Hierdoor kunt u vaak definiëren of de auteur één exemplaar van het veld ziet of meerdere exemplaren 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 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 veranderen van het StandaardType in een model van het Fragment van de Inhoud zal slechts op bestaand, verwant, het Fragment van de Inhoud van kracht worden nadat dat fragment in de redacteur wordt geopend en wordt bewaard.
-
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
Japanin twee afhankelijke Fragmenten van de Inhoud hebben.CountryEr 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. -
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 opyesom 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 model van een inhoudsfragment.
-
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 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.
-
Verstrekt door de gegevenstypes:
- Verwijzing van de Inhoud - gebaseerd weg
- Verwijzing van de Inhoud (UUID) - gebaseerd UUID
-
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.
-
Verstrekt door de gegevenstypes:
- Verwijzing van het Fragment - gebaseerd weg
- Verwijzing van het Fragment (UUID) - gebaseerd UUID
-
Hiermee kunt u gestructureerde gegevens opnemen/ophalen.
note note NOTE Deze methode is van bijzonder belang wanneer u Zwaarloze Levering van de Inhoud gebruikend de Fragmenten van de Inhoud met GraphQLgebruikt. * Kan worden geconfigureerd voor een of meerdere verwijzingen (in het resulterende fragment).
-
-
Content References
Hierdoor wordt voorkomen dat de gebruiker een verwijzing naar het huidige fragment toevoegt en kan dit 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, retourneert deze null bij de eerste instantie.
Content Reference content-reference
De Verwijzing van de Inhoud en Verwijzing van de Inhoud (UUID) gegevenstypes staan u toe om inhoud van een andere bron terug te geven; bijvoorbeeld, beeld, pagina of het Fragment van de Ervaring.
Naast de standaardeigenschappen kunt u opgeven:
-
Het Weg van de Wortel, dat specificeert, of vertegenwoordigt, waar om het even welke referenced inhoud op te slaan
note note NOTE Dit is verplicht als u afbeeldingen in dit veld rechtstreeks wilt uploaden en ernaar wilt verwijzen wanneer u de Content Fragment-editor gebruikt. Zie de Beelden van de Verwijzingvoor verdere details. -
De inhoudstypen waarnaar kan worden verwezen
note note NOTE Deze moeten Beeld omvatten als u direct beelden op dit gebied wilt uploaden en van verwijzingen voorzien wanneer het gebruiken van de redacteur van het Fragment van de Inhoud. Zie de Beelden van de Verwijzingvoor verdere details. -
Beperkingen voor bestandsgrootten
-
Als naar een afbeelding wordt verwezen:
- Miniatuur tonen
- Hoogte- en breedtebeperkingen voor afbeeldingen
Fragmentverwijzing (geneste fragmenten) fragment-reference-nested-fragments
De Verwijzing van het Fragment en Verwijzing van het Fragment (UUID) gegevenstypes kunnen één, of meer, de Fragmenten van de Inhoud van verwijzingen voorzien. Deze functie is met name van belang wanneer u inhoud ophaalt die u in uw app wilt gebruiken, aangezien u gestructureerde gegevens met meerdere lagen kunt ophalen.
Bijvoorbeeld:
- Een model dat details voor een werknemer bepaalt; met inbegrip van:
- 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. Wanneer u verwijzingen toevoegt aan een inhoudsfragment, moeten fragmenten waarnaar wordt verwezen, met deze modellen zijn gemaakt. -
Weg van de Wortel
Hiermee geeft u een hoofdpad op of vertegenwoordigt u dit 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
