Inhoudsfragmenten aanpassen en uitbreiden customizing-and-extending-content-fragments

Creërend en het Leiden de Fragmenten van de Inhouden Pagina Authoring met de Fragmenten van de Inhoudvoor verdere informatie over inhoudsfragmenten.

het Leiden Assetsen het Aanpassen en het Uitbreiden van Assetsvoor verdere informatie over standaardactiva.

Modellen van inhoudsfragmenten:

• Wordt gebruikt voor het definiëren van inhoudsfragmenten die gestructureerde inhoud bevatten.
• Inhoudsfragmentmodellen definiëren de structuur van een inhoudsfragment wanneer dit wordt gemaakt.
• Een fragment verwijst naar het model. Wijzigingen in het model kunnen/zullen daarom van invloed zijn op afhankelijke fragmenten.
• Modellen zijn opgebouwd uit gegevenstypen.
• Functies om nieuwe variaties toe te voegen, enzovoort, moeten het fragment overeenkomstig bijwerken.

Sjablonen voor inhoudsfragmenten:

• Wordt gebruikt voor het definiëren van eenvoudige inhoudsfragmenten.
• Sjablonen definiëren de (basis-, alleen-tekst) structuur van een inhoudsfragment wanneer dit wordt gemaakt.
• De sjabloon wordt naar het fragment gekopieerd wanneer het wordt gemaakt. Verdere wijzigingen in de sjabloon worden dus niet weerspiegeld in bestaande fragmenten.
• Functies om nieuwe variaties toe te voegen, enzovoort, moeten het fragment overeenkomstig bijwerken.
• het fragmentmalplaatjes van de Inhoudwerken op een verschillende manier aan dat van andere het malplaatjes binnen het AEM ecosysteem (bijvoorbeeld, paginasjablonen, etc.). Daarom moeten zij afzonderlijk worden beschouwd.
• Wanneer gebaseerd op een malplaatje wordt het MIME type van de inhoud beheerd op de daadwerkelijke inhoud; dit betekent dat elk element en elke variatie een verschillend MIME type kunnen hebben.

Alle inhoud wordt opgeslagen onder het knooppunt jcr:content/data van het element:

• De elementgegevens worden opgeslagen onder het hoofdsubknooppunt:

  jcr:content/data/master

• Variaties worden opgeslagen onder een subknooppunt met de naam van de variatie:
  bijvoorbeeld, jcr:content/data/myvariation

• De gegevens van elk element worden in het desbetreffende subknooppunt opgeslagen als een eigenschap met de elementnaam:
  De inhoud van element text wordt bijvoorbeeld opgeslagen als eigenschap text on jcr:content/data/master .

Metagegevens en bijbehorende inhoud worden opgeslagen onder jcr:content/metadata
Met uitzondering van de titel en beschrijving, die niet als traditionele metagegevens worden beschouwd en worden opgeslagen op jcr:content

Alle niet-inhoudinformatie van een fragment (zoals titel, beschrijving, metagegevens, structuur) wordt uitsluitend beheerd op het hoofdelement.

De inhoud van het eerste element van een fragment wordt toegewezen aan de oorspronkelijke uitvoering van het hoofdelement.

• De variaties (indien aanwezig) van het eerste element worden toegewezen aan andere uitvoeringen van het hoofdelement.

Aanvullende elementen (indien aanwezig) worden toegewezen aan subactiva van het hoofdactief.

• De belangrijkste inhoud van deze aanvullende elementen is gekoppeld aan de oorspronkelijke uitvoering van het respectieve subactief.
• Andere variaties (indien van toepassing) van eventuele aanvullende elementen die zijn toegewezen aan andere uitvoeringen van het desbetreffende subactief.

De component gebruikt de eigenschap fragmentPath om naar het daadwerkelijke inhoudsfragment te verwijzen. De eigenschap fragmentPath wordt op dezelfde manier afgehandeld als soortgelijke eigenschappen van andere elementtypen, bijvoorbeeld wanneer het inhoudsfragment naar een andere locatie wordt verplaatst.

Met de component kunt u de variatie selecteren die moet worden weergegeven.

Bovendien kunt u een reeks alinea's selecteren om de uitvoer te beperken. Deze alinea kan bijvoorbeeld worden gebruikt voor uitvoer met meerdere kolommen.

De component staat binnen-tussen inhoudtoe:

• Hier kunt u met de component andere elementen (afbeeldingen, enzovoort) tussen de alinea's van het fragment waarnaar wordt verwezen plaatsen.

• Voor tussenliggende inhoud moet u:

  • Houd rekening met de mogelijkheid van instabiele verwijzingen. Tussen de inhoud (die bij het ontwerpen van een pagina wordt toegevoegd) bestaat geen vaste relatie met de alinea die naast de inhoud wordt geplaatst. Er wordt een nieuwe alinea (in de fragmenteditor van de inhoud) ingevoegd voordat de positie van de inliggende inhoud de relatieve positie kan verliezen
  • extra parameters (zoals variatie- en alineasofilters) in overweging nemen om verkeerde positieven in zoekresultaten te voorkomen

types van Middel
U kunt een lijst met sling:resourceTypes opgeven om componenten te definiëren die worden gebruikt voor het renderen van inhoudsfragmenten en waar de achtergrondverwerking moet worden toegepast.

Eigenschappen van de Verwijzing
Een lijst met eigenschappen kan worden geconfigureerd om op te geven waar de verwijzing naar het fragment wordt opgeslagen voor de desbetreffende component.

De naam van de eigenschap waar het te renderen element(en) is gedefinieerd, moet element of elementNames zijn.

De naam van de eigenschap waar de te renderen variatie is gedefinieerd, moet variation of variationName zijn.

Als de uitvoer van meerdere elementen wordt ondersteund (door elementNames te gebruiken om meerdere elementen op te geven), wordt de werkelijke weergavemodus gedefinieerd door de eigenschap displayMode :

• Als de waarde singleText is (en er is slechts één element geconfigureerd), wordt het element gerenderd als tekst met tussenliggende inhoud, layoutondersteuning enzovoort. Dit is de standaardinstelling voor fragmenten waarbij slechts één element wordt gerenderd.
• Anders wordt een veel eenvoudigere aanpak gebruikt (deze kan 'formulierweergave' worden genoemd), waarbij geen tussenliggende inhoud wordt ondersteund en de fragmentinhoud 'zoals deze is' wordt weergegeven.

Als het fragment wordt gerenderd voor displayMode == singleText (impliciet of expliciet), worden de volgende aanvullende eigenschappen afgespeeld:

• paragraphScope definieert of alle alinea's, of alleen een reeks alinea's, moeten worden gerenderd (waarden: all vs. range)

• als paragraphScope == range dan definieert de eigenschap paragraphRange het bereik van alinea's dat moet worden gerenderd

Vertalingen

De Fragmenten van de inhoud zijn volledig geïntegreerd met het AEM vertaalwerkschema. Op architectonisch niveau betekent dit:

• De afzonderlijke vertalingen van een inhoudsfragment zijn eigenlijk afzonderlijke fragmenten, bijvoorbeeld:

  • zij bevinden zich in verschillende taalgebieden :

    /content/dam/<path>/en/<to>/<fragment>

    vs

    /content/dam/<path>/de/<to>/<fragment>

  • maar ze delen exact hetzelfde relatieve pad onder de hoofdmap van de taal :

    /content/dam/<path>/en/<to>/<fragment>

    vs

    /content/dam/<path>/de/<to>/<fragment>

• Naast op regel-gebaseerde wegen, is er geen verdere verbinding tussen de verschillende taalversies van een inhoudsfragment; zij worden behandeld als twee afzonderlijke fragmenten, hoewel UI de middelen verstrekt om tussen de taalvarianten te navigeren.

schema's van Meta-gegevens

• De fragmenten van de inhoud (re)gebruiken de meta-gegevensschema's, die met standaardactiva kunnen worden bepaald.

• CFM biedt een eigen, specifiek schema:

  /libs/dam/content/schemaeditors/forms/contentfragment

  dit kan zo nodig worden verlengd .

• Het respectievelijke schema-formulier is geïntegreerd met de fragmenteditor.

Malplaatje van het Fragment ( FragmentTemplate)

Gebruik FragmentTemplate.createFragment() om een fragment te maken.

Resource templateOrModelRsc = resourceResolver.getResource("...");
FragmentTemplate tpl = templateOrModelRsc.adaptTo(FragmentTemplate.class);
ContentFragment newFragment = tpl.createFragment(parentRsc, "A fragment name", "A fragment description.");

Deze interface vertegenwoordigt:

• een inhoudsfragmentmodel of een fragmentsjabloon voor inhoud op basis waarvan een inhoudsfragment moet worden gemaakt,
• en (na het maken) de structuurgegevens van dat fragment

Deze informatie kan omvatten:

• Toegang tot basisgegevens (titel, beschrijving)

• Sjablonen/modellen openen voor de elementen van het fragment:

  • Elementsjablonen weergeven
  • Structuurgegevens voor een bepaald element ophalen
  • Toegang tot de elementsjabloon (zie ElementTemplate)

• Sjablonen openen voor de variaties van het fragment:

  • Wijzigingssjablonen weergeven
  • Structuurgegevens voor een bepaalde wijziging ophalen
  • Toegang tot de variatiesjabloon (zie VariationTemplate)

• Aanvankelijke gekoppelde inhoud ophalen

Interfaces die belangrijke informatie vertegenwoordigen:

• ElementTemplate

  • Basisgegevens ophalen (naam, titel)
  • Eerste elementinhoud ophalen

• VariationTemplate

  • Basisgegevens ophalen (naam, titel, beschrijving)

Fragment van de Inhoud ( ContentFragment)

Met deze interface kunt u op abstracte wijze met een inhoudsfragment werken.

De interface voorziet u van de middelen:

• Standaardgegevens beheren (bijvoorbeeld naam ophalen; titel/beschrijving ophalen/instellen)

• Toegang tot metagegevens

• Toegangselementen:

  • Lijstelementen

  • Elementen op naam ophalen

  • Creeer nieuwe elementen (zie Gebieden)

  • Gegevens over toegangselementen (zie ContentElement)

• Variaties weergeven die zijn gedefinieerd voor het fragment

• Nieuwe variaties wereldwijd maken

• Gekoppelde inhoud beheren:

  • Lijstverzamelingen
  • Verzamelingen toevoegen
  • Verzamelingen verwijderen

• Open het model of de sjabloon van het fragment

De interfaces die de belangrijkste elementen van een fragment vertegenwoordigen zijn:

• Element van de Inhoud ( ContentElement)

  • Basisgegevens ophalen (naam, titel, beschrijving)

  • Inhoud ophalen/instellen

  • Toegang tot variaties van een element:

    • Variaties weergeven
    • Variaties ophalen op naam
    • Creeer nieuwe variaties (zie Gebieden)
    • Verwijder variaties (zie Gebieden)
    • Toegang krijgen tot variatiegegevens (zie ContentVariation)

  • Sneltoets voor het oplossen van variaties (door een aanvullende, implementatiespecifieke fallback-logica toe te passen als de opgegeven variatie niet beschikbaar is voor een element)

• de Variatie van de Inhoud ( ContentVariation)

  • Basisgegevens ophalen (naam, titel, beschrijving)
  • Inhoud ophalen/instellen
  • Eenvoudige synchronisatie, gebaseerd op laatst gewijzigde informatie

Alle drie de interfaces ( ContentFragment, ContentElement, ContentVariation) breiden de Versionable -interface uit, die versiemogelijkheden toevoegt, die vereist zijn voor inhoudsfragmenten:

• Nieuwe versie van het element maken
• Versies van het element weergeven
• Hiermee wordt de inhoud opgehaald van een specifieke versie van het element met versiebeheer

ContentFragment kan worden aangepast aan:

• Resource - de onderliggende Sling-bron. Wanneer u de onderliggende Resource rechtstreeks bijwerkt, moet u het ContentFragment -object opnieuw opbouwen.

• Asset - De DAM Asset -abstractie die het inhoudsfragment vertegenwoordigt. Wanneer u Asset rechtstreeks bijwerkt, moet u het ContentFragment -object opnieuw opbouwen.

ContentElement kan worden aangepast aan:

• ElementTemplate - voor toegang tot de structuurinformatie van het element.

FragmentTemplate kan worden aangepast aan:

• Resource - het Resource bepalen van het model waarnaar wordt verwezen of de oorspronkelijke sjabloon die is gekopieerd;

  • wijzigingen die zijn aangebracht via de Resource , worden niet automatisch doorgevoerd in de FragmentTemplate .

Resource kan worden aangepast aan:

• ContentFragment
• FragmentTemplate

De API is geïmplementeerd om functionaliteit te bieden die door de UI wordt ondersteund.

Volledige API wordt ontworpen om niet veranderingen automatisch te handhaven (tenzij anders vermeld in API JavaDoc). Zo zult u altijd de middeloplosser van het respectieve verzoek (of resolver moeten begaan u eigenlijk gebruikt).

Taken die extra inspanning zouden kunnen vereisen:

• Door nieuwe elementen te maken/verwijderen wordt de gegevensstructuur van eenvoudige fragmenten (op basis van een fragmentsjabloon) niet bijgewerkt.

• Als u nieuwe variaties maakt vanuit ContentElement , wordt de gegevensstructuur niet bijgewerkt (maar worden deze globaal gemaakt op basis van ContentFragment will).

• Als u bestaande variaties verwijdert, wordt de gegevensstructuur niet bijgewerkt.

filter.xml

Het filter.xml for content fragment management is zo geconfigureerd dat het niet overlapt met het Assets core content package.

Een sessie starten

• Er wordt een nieuwe versie van het inhoudsfragment gemaakt.
• Automatisch opslaan is gestart.
• Cookies worden ingesteld; deze definiëren het momenteel bewerkte fragment en er is een bewerkingssessie geopend.

Een sessie voltooien

• Automatisch opslaan wordt gestopt.

• Bij toewijzen:

  • De laatste gewijzigde informatie wordt bijgewerkt.
  • Cookies worden verwijderd.

• Bij terugdraaien:

  • De versie van het inhoudsfragment dat is gemaakt toen de bewerkingssessie werd gestart, wordt hersteld.
  • Cookies worden verwijderd.

Bewerken

• Alle wijzigingen (automatisch opslaan inbegrepen) worden uitgevoerd op het actieve inhoudsfragment - niet in een gescheiden, beveiligd gebied.
• Deze wijzigingen worden daarom direct doorgevoerd op AEM pagina's die naar het desbetreffende inhoudsfragment verwijzen

Pagina's invoeren

• Controleer of er al een bewerksessie aanwezig is; door het betreffende cookie te controleren.

  • Als er een bestaat, controleert u of de bewerkingssessie is gestart voor het inhoudsfragment dat momenteel wordt bewerkt

    • Als het huidige fragment, herstelt u de sessie.
    • Als dat niet het geval is, probeert u het bewerken voor het eerder bewerkte inhoudsfragment te annuleren en cookies te verwijderen (er is geen bewerkingssessie daarna aanwezig).

  • Als er geen bewerkingssessie bestaat, wacht u op de eerste wijziging die de gebruiker heeft aangebracht (zie hieronder).

• Controleer of er al naar het inhoudsfragment wordt verwezen op een pagina en geef zo ja de juiste informatie weer.

Inhoud wijzigen

• Wanneer de gebruiker inhoud verandert en er geen is geef zitting aanwezig uit, wordt een nieuwe Edit zitting gecreeerd (zie Beginnend een zitting).

Pagina's verlaten

• Als een bewerkingssessie aanwezig is en de wijzigingen niet zijn doorgevoerd, wordt een modaal bevestigingsdialoogvenster weergegeven waarin de gebruiker op de hoogte wordt gebracht van mogelijk verloren inhoud en waarin hij of zij op de pagina kan blijven.

Knooppunt: <*conf-root*>/settings/dam/cfm/jcr:content

Eigenschapnaam: autoSaveInterval

Type: Long

Standaard: 600 (10 minuten); dit is gedefinieerd voor /libs/settings/dam/cfm/jcr:content

Knooppunt: /conf/global/settings/dam/cfm/jcr:content

Eigenschapnaam: autoSaveInterval

Type: Long

Waarde: 300 (5 minuten komt overeen met 300 seconden)