Modellen van inhoudsfragmenten

Content Fragment Models in AEM de structuur van de inhoud voor uw inhoudsfragmenten, fungeren als basis voor uw inhoud zonder kop.

Als u modellen van inhoudsfragmenten wilt gebruiken, kunt u:

1. Functionaliteit van inhoudsfragmentmodel inschakelen voor uw instantie.
2. Maken, en vormen, uw modellen van inhoudsfragmenten.
3. Modellen van inhoudsfragmenten inschakelen voor gebruik bij het maken van Content Fragments.
4. Modellen van inhoudsfragmenten toestaan in de vereiste mappen Middelen door te vormen Beleid.

Een inhoudsfragmentmodel maken

1. Navigeren naar Gereedschappen, Activa en vervolgens openen Modellen van inhoudsfragmenten.

2. Navigeer naar de map die geschikt is voor uw configuratie.

3. Gebruiken Maken om de wizard te openen.

   LET OP

   Als de gebruik van inhoudsfragmentmodellen is niet ingeschakeldde Maken is niet beschikbaar.

4. Geef de modeltitel op. U kunt ook toevoegen Tags, Beschrijving en selecteert u Model inschakelen tot het model inschakelen indien nodig.

   

5. Gebruiken Maken het lege model opslaan. Een bericht geeft het succes van de handeling aan. U kunt Openen het model onmiddellijk te bewerken, of Gereed om naar de console terug te keren.

Het model van het inhoudsfragment definiëren

Het inhoudsfragmentmodel definieert effectief de structuur van de resulterende inhoudsfragmenten met behulp van een selectie van Gegevenstypen. Gebruikend de modelredacteur kunt u instanties van de gegevenstypes toevoegen, dan hen vormen om de vereiste gebieden tot stand te brengen:

1. Navigeren naar Gereedschappen, Activa en vervolgens openen Modellen van inhoudsfragmenten.

2. Navigeer naar de map met het fragmentmodel van de inhoud.

3. Open het vereiste model voor Bewerken; gebruik de snelle actie of selecteer het model en vervolgens de actie op de werkbalk.

   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)
   OPMERKING

   Wanneer een veld als Vereist de Label aangegeven in het linkerdeelvenster is gemarkeerd met een asterix (*).

   

4. Een veld toevoegen

   • Sleep een vereist gegevenstype naar de vereiste locatie voor een veld:

     

   • Nadat een veld aan het model is toegevoegd, wordt in het rechterdeelvenster het volgende weergegeven: Eigenschappen die voor dat bepaalde gegevenstype kunnen worden gedefinieerd. Hier kunt u definiëren wat voor dat veld is vereist.

     • Veel eigenschappen zijn niet-verklarend, voor meer details zie Eigenschappen.

     • Een Veldlabel automatisch voltooit het Eigenschapnaam - indien leeg, en het kan achteraf handmatig worden bijgewerkt.

       LET OP

       Wanneer u de eigenschap handmatig bijwerkt Eigenschapnaam voor een gegevenstype, moeten de namen slechts A-Z, a-z, 0-9, en het 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:

     

5. Een veld verwijderen

   Selecteer het vereiste veld en klik op het prullenbakpictogram. U wordt gevraagd de actie te bevestigen.

   

6. Voeg alle vereiste velden toe en definieer de bijbehorende eigenschappen, al naar gelang de vereisten. Bijvoorbeeld:

   

7. Selecteren Opslaan om de definitie te handhaven.

Gegevenstypen

Voor het definiëren van uw model zijn verschillende gegevenstypen beschikbaar:

• Tekst met één regel
  • Voeg een of meer velden van één regel tekst toe. De maximumlengte kan worden gedefinieerd
• Tekst met meerdere regels
  • Een tekstgebied dat RTF-tekst, platte tekst of Markering kan zijn
• Getal
  • Een of meer numerieke velden toevoegen
• Boolean
  • Een Booleaans selectievakje toevoegen
• Datum en tijd
  • Een datum en/of tijd toevoegen
• Opsomming
  • Een set selectievakjes, keuzerondjes of vervolgkeuzelijsten toevoegen
• Tags
  • Hiermee kunnen auteurs van fragmenten gebieden met tags openen en selecteren
• Content Reference
  • Verwijzingen naar andere inhoud, van elk type; kan worden gebruikt voor geneste inhoud maken
  • Als er naar een afbeelding wordt verwezen, kunt u ervoor kiezen een miniatuur weer te geven
• Fragmentverwijzing
  • Verwijzingen naar andere inhoudsfragmenten; kan worden gebruikt om geneste inhoud maken
  • Het gegevenstype kan worden geconfigureerd om fragmentauteurs toe te staan:
    • Bewerk het fragment waarnaar wordt verwezen rechtstreeks.
    • Een inhoudsfragment maken op basis van het juiste model
• JSON-object
  • 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 en gekleefd.
    • De JSON wordt doorgegeven en uitvoer als JSON in GraphQL.
    • Neemt JSON-syntaxismarkering, automatisch aanvullen en foutmarkering op in de inhoudsfragmenteditor.
• Tijdelijke aanduiding voor tab

  • 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.

    OPMERKING

    Dit gegevenstype wordt alleen gebruikt voor opmaak en wordt genegeerd door het schema AEM GraphQL.

Eigenschappen

Vele eigenschappen zijn voor zichzelf verklarend, voor bepaalde eigenschappen zijn hieronder meer details te vinden:

• Eigenschapnaam

  Wanneer u deze eigenschap handmatig bijwerkt voor een gegevenstype, worden de namen moet bevatten alleen A-Z, a-z, 0-9, en het onderstrepingsteken "_" als speciaal karakter.

  LET OP

  Als modellen die in eerdere versies van AEM zijn gemaakt, ongeldige tekens bevatten, verwijdert of werkt u die tekens bij.

• Renderen als
  De verschillende opties voor het realiseren/renderen van het veld in een fragment. Hier kunt u vaak definiëren of de auteur één instantie van het veld ziet of meerdere instanties mag maken.

• Veldlabel
  Een Veldlabel automatisch een Eigenschapnaam, die indien nodig handmatig kan worden bijgewerkt.

• Validatie
  De basisbevestiging is beschikbaar door mechanismen zoals Vereist eigenschap. Sommige gegevenstypen hebben aanvullende validatievelden. Zie Validatie voor nadere bijzonderheden.

• Voor het datatype Tekst met meerdere regels is het mogelijk het standaardtype als volgt te definiëren:

  • RTF
  • Markering
  • Onbewerkte tekst

  Indien niet opgegeven, wordt de standaardwaarde RTF wordt gebruikt voor dit veld.

  Het wijzigen van Standaardtype in een inhoudsfragmentmodel heeft alleen effect op een bestaand, verwant inhoudsfragment 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 een Tekst met één regel veld aangeroepen Country in het inhoudsfragmentmodel kan de waarde niet hebben Japan in twee afhankelijke inhoudsfragmenten. Er wordt een waarschuwing weergegeven wanneer de tweede instantie wordt geprobeerd.

  OPMERKING

  Er wordt gezorgd voor uniformiteit per taalwortel.

  OPMERKING

  Variaties kunnen hetzelfde hebben uniek waarde als variaties van hetzelfde fragment, maar niet dezelfde waarde als bij variaties van andere fragmenten.

• Zie Content Reference voor meer details over dat specifieke gegevenstype en zijn eigenschappen.

• Zie Fragmentverwijzing (geneste fragmenten) voor meer details over dat specifieke gegevenstype en zijn eigenschappen.

Validatie

Verschillende gegevenstypen bieden nu de mogelijkheid om validatievereisten te definiëren voor het tijdstip waarop inhoud wordt ingevoerd in het resulterende fragment:

• Tekst met één regel
  • Vergelijk met een vooraf gedefinieerde regex.
• Getal
  • Controleren op specifieke waarden.
• Content Reference
  • 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).
• Fragmentverwijzing
  • Testen op een specifiek inhoudsfragmentmodel.

Referenties gebruiken om geneste inhoud te vormen

Inhoudsfragmenten kunnen geneste inhoud vormen met een van de volgende gegevenstypen:

• Content Reference

  • Verstrekt een eenvoudige verwijzing naar andere inhoud; van om het even welk type.
  • Het kan voor één verwijzing of veelvoudige verwijzingen (in het resulterende fragment) worden gevormd.

• Fragmentverwijzing (Geneste fragmenten)

  • Verwijzingen naar andere fragmenten, afhankelijk van de opgegeven modellen.

  • Hiermee kunt u gestructureerde gegevens opnemen/ophalen.

    OPMERKING

    Deze methode is van bijzonder belang voor Levering van inhoud zonder kop met gebruik van inhoudsfragmenten met GraphQL.

    * Het kan voor één verwijzing of veelvoudige verwijzingen (in het resulterende fragment) worden gevormd.

Content Reference

Met de Content Reference kunt u inhoud van een andere bron renderen, bijvoorbeeld een afbeelding of een inhoudsfragment.

Naast de standaardeigenschappen kunt u opgeven:

• De Hoofdpad voor inhoud waarnaar wordt verwezen
• 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)

De fragmentverwijzing verwijst naar een of meer inhoudsfragmenten. Deze functie is vooral van belang wanneer u inhoud ophaalt die u in uw app wilt gebruiken, 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:

• Renderen als:

  • multifield - de auteur van het fragment kan meerdere, afzonderlijke, verwijzingen maken

  • fragmentreference - Hiermee kan de auteur van het fragment één verwijzing naar een fragment selecteren

• Modeltype
  U kunt meerdere modellen selecteren. Bij het ontwerpen van het inhoudsfragment moeten fragmenten waarnaar wordt verwezen, met deze modellen zijn gemaakt.

• Hoofdpad
  Geeft een hoofdpad aan voor alle fragmenten waarnaar wordt verwezen.

• Fragment maken toestaan

  Hierdoor kan de auteur van het fragment een fragment maken op basis van het juiste model.

  • fragmentreferencecomponent - stelt de auteur van het fragment in staat een samenstelling samen te stellen door meerdere fragmenten te selecteren

  

Een inhoudsfragmentmodel in- of uitschakelen

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

Nadat een model is gemaakt, moet het zijn ingeschakeld zodat:

• Deze kan worden geselecteerd wanneer u een inhoudsfragment maakt.
• Er kan vanuit een inhoudsfragmentmodel naar worden verwezen.
• Deze is beschikbaar voor GraphQL. Het schema wordt dus gegenereerd.

Een model inschakelen dat is gemarkeerd als:

• Concept : mew (nooit ingeschakeld).
• Uitgeschakeld : is uitgeschakeld.

U kunt de Inschakelen optie van:

• De bovenste werkbalk als het vereiste model is geselecteerd.
• De corresponderende snelle actie (mouse-over het vereiste model).

Een inhoudsfragmentmodel uitschakelen

Een model kan ook worden uitgeschakeld, zodat:

• Het model is niet meer beschikbaar als basis voor het maken van new Inhoudsfragmenten
• Echter:
  • Het GraphQL-schema wordt steeds gegenereerd en kan nog steeds worden opgevraagd (om geen invloed op de JSON API te hebben).
  • 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.

Een model uitschakelen dat is gemarkeerd als Ingeschakeld, gebruikt u de Uitschakelen optie van:

• De bovenste werkbalk als het vereiste model is geselecteerd.
• De corresponderende snelle actie (mouse-over het vereiste model).

Modellen voor inhoudsfragmenten toestaan in de middelenmap

Om inhoudsbeheer uit te voeren, kunt u vormen Beleid in een map Middelen om te bepalen welke modellen van inhoudsfragmenten mogen worden gemaakt voor fragmenten in die map.

Om te vormen Beleid for Modellen voor toegestane inhoudsfragmenten:

1. Navigeren en openen Eigenschappen voor de map met vereiste middelen.

2. Open de Beleid tab, waar u kunt configureren:

   • Overgenomen van<folder>

     Het beleid wordt automatisch geërft wanneer het creëren van kindomslagen; het beleid kan (en de erfenis gebroken) worden opnieuw gevormd als de subomslagen modellen moeten toestaan verschillend aan de ouderomslag.

   • Modellen van inhoudsfragmenten op pad toestaan

     U kunt meerdere modellen toestaan.

   • Modellen voor inhoudsfragmenten zijn toegestaan op tag

     U kunt meerdere modellen toestaan.

   

3. Opslaan eventuele wijzigingen.

De modellen van inhoudsfragmenten die zijn toegestaan voor een map, worden als volgt opgelost:

• De Beleid for Modellen voor toegestane inhoudsfragmenten.
• Als dit leeg is, kunt u het beleid bepalen met behulp van de overervingsregels.
• Als de overervingsketen geen resultaat oplevert, kijkt u naar de Cloud Servicen configuratie voor die map (ook eerst rechtstreeks en vervolgens via overerving).
• Als geen van de bovenstaande resultaten worden behaald, zijn er geen modellen toegestaan voor die map.

Een inhoudsfragmentmodel verwijderen

Een inhoudsfragmentmodel verwijderen:

1. Navigeren naar Gereedschappen, Activa en vervolgens openen Modellen van inhoudsfragmenten.

2. Navigeer naar de map met het fragmentmodel van de inhoud.

3. Selecteer uw model, gevolgd door Verwijderen op de werkbalk.

   OPMERKING

   Als naar het model wordt verwezen, wordt een waarschuwing gegeven. Voer de nodige maatregelen uit.

Een inhoudsfragmentmodel publiceren

Inhoudsfragmentmodellen moeten worden gepubliceerd wanneer/voordat afhankelijke inhoudsfragmenten worden gepubliceerd.

Een fragmentmodel voor inhoud publiceren:

1. Navigeren naar Gereedschappen, Activa en vervolgens openen Modellen van inhoudsfragmenten.

2. Navigeer naar de map met het fragmentmodel van de inhoud.

3. Selecteer uw model, gevolgd door Publiceren op de werkbalk.
   De gepubliceerde status wordt vermeld in de console.

   OPMERKING

   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

Inhoudsfragmentmodellen kunnen ongepubliceerd zijn als naar deze modellen niet wordt verwezen door fragmenten.

Publicatie van een inhoudsfragmentmodel ongedaan maken:

1. Navigeren naar Gereedschappen, Activa en vervolgens openen Modellen van inhoudsfragmenten.

2. Navigeer naar de map met het fragmentmodel van de inhoud.

3. Selecteer uw model, gevolgd door Publiceren ongedaan maken op de werkbalk.
   De gepubliceerde status wordt vermeld in de console.

Inhoudsfragmentmodel - eigenschappen

U kunt de Eigenschappen van een inhoudsfragmentmodel:

• Basis
  • Modeltitel
  • Tags
  • Beschrijving
  • Afbeelding uploaden