Werken met inhoudsfragmenten working-with-content-fragments
Met Adobe Experience Manager (AEM) as a Cloud Service, laten de Fragmenten van de Inhoud u, pagina-onafhankelijke inhoud ontwerpen tot stand brengen, leiden en publiceren . Zo kunt u inhoud voorbereiden die klaar is voor gebruik op meerdere locaties/via meerdere kanalen, ideaal voor levering zonder kop. Zij kunnen ook samen met multi-Plaats Beheer worden gebruikt om u toe te laten om uw inhoud opnieuw te gebruiken.
Inhoudsfragmenten bevatten gestructureerde inhoud:
-
Zij zijn gebaseerd op het Model van het Fragment van de a Inhoud , dat vooraf een structuur voor het resulterende fragment bepaalt.
-
De structuur kan liggen tussen:
-
Basis
- Bijvoorbeeld een tekstveld met één regel tekst.
- Deze kan worden gebruikt voor het voorbereiden van eenvoudige inhoud voor gebruik in paginaontwerp.
-
Complex
- Een combinatie van een groot aantal velden met verschillende gegevenstypen, zoals tekst, getal, boolean, gegevens en tijd.
- Deze kan worden gebruikt voor het voorbereiden van gestructureerde inhoud voor het ontwerpen van pagina's of voor levering aan uw toepassing.
-
Genest
- Met de beschikbare gegevenstypen waarnaar wordt verwezen, kunt u de inhoud nesten.
- Dit wordt doorgaans gebruikt voor levering aan uw toepassing.
-
Inhoudsfragmenten kunnen ook worden geleverd in JSON-indeling, waarbij gebruik wordt gemaakt van de JSON-exportmogelijkheden (Sling Model) van AEM-kerncomponenten. Deze leveringsvorm:
- biedt u de mogelijkheid om de component te gebruiken om te beheren welke elementen van een fragment moeten worden geleverd
- staat bulklevering toe, door veelvoudige inhoudfragment kerncomponenten op de pagina toe te voegen die voor levering API wordt gebruikt
Deze en de volgende pagina's bevatten de taken voor het maken, configureren, onderhouden en gebruiken van uw inhoudsfragmenten:
- Functionaliteit van inhoudsfragment inschakelen voor uw instantie
- Modellen van het Fragment van de Inhoud - toelatend, creërend, en bepalend uw modellen
- het Leiden de Fragmenten van de Inhoud - creeer uw inhoudsfragmenten; dan geef, publiceer, en verwijzing uit
- Variaties - het Authoring Inhoud van het Fragment - auteur de fragmentinhoud en creeer variaties van de Meester
- Markering - het gebruiken van prijsdalingssyntaxis voor uw fragment
- Gebruikend Bijbehorende Inhoud - toevoegend bijbehorende inhoud
- Meta-gegevens - de Eigenschappen van het Fragment - het bekijken van en het uitgeven van de fragmenteigenschappen
- Gebruik de Fragmenten van de Inhoud, samen met GraphQL, zodat kunt u inhoud voor gebruik in uw toepassingen leveren. Om met dit te helpen, kunt u voorproef output JSON .
- Inhoudsfragmenten opnieuw gebruiken met MSM
- het Authoring van de Pagina met de Fragmenten van de Inhoud .
- Contentfragmenten aanpassen en uitbreiden
- Contentfragmenten die componenten voor rendering configureren
- Ondersteuning voor contentfragmenten in HTTP-API van AEM Assets
- AEM GraphQL API voor gebruik met de Fragmenten van de Inhoud
- Het ModelOpenAPIs van het Fragment van de Inhoud en van het Fragment van de Inhoud
Het aantal communicatiekanalen neemt jaarlijks toe. Doorgaans verwijzen kanalen naar het leveringsmechanisme, als:
- Fysiek kanaal, bijvoorbeeld desktop, mobiel.
- Leveringsvorm via een fysiek kanaal, bijvoorbeeld de pagina met productdetails, de pagina met productcategorieën voor desktops of de pagina Mobiel web en de pagina Mobiele apps voor mobiele apparaten.
(Waarschijnlijk) wilt u echter niet voor alle kanalen dezelfde inhoud gebruiken. U moet de inhoud optimaliseren op basis van het specifieke kanaal.
Met inhoudelementen kunt u:
- Overweeg hoe u doelpubliek efficiënt langs verschillende kanalen kunt bereiken.
- Kanaalneutrale redactionele inhoud maken en beheren.
- Stel inhoudsgroepen samen voor een reeks kanalen.
- Ontwerpinhoudvariaties voor specifieke kanalen.
- Voeg afbeeldingen aan de tekst toe door elementen (gemengde-mediafragmenten) in te voegen.
- Maak geneste inhoud, zodat u de complexiteit van uw gegevens weerspiegelt.
Deze inhoudsfragmenten kunnen vervolgens worden samengevoegd om via verschillende kanalen ervaringen op te doen.
- de Fragmenten van de Inhoud zijn redactionele inhoud, met definitie en structuur, maar zonder extra visueel ontwerp en/of lay-out. Ze kunnen worden gebruikt om onder andere toegang te krijgen tot gestructureerde gegevens, zoals tekst, cijfers en datums.
- de Fragmenten van de Ervaring zijn volledig opgemaakt inhoud; een fragment van een Web-pagina.
Inhoudsfragmenten en inhoudsservices content-fragments-and-content-services
AEM Content Services is ontworpen om de beschrijving en levering van inhoud in of vanuit AEM te veralgemenen, maar niet alleen op webpagina's.
Ze leveren inhoud aan kanalen die geen traditionele AEM-webpagina's zijn, met behulp van gestandaardiseerde methoden die door elke client kunnen worden gebruikt. Deze kanalen kunnen zijn:
- Toepassingen voor één pagina
- Systeemeigen mobiele toepassingen
- andere kanalen en aanraakpunten buiten AEM
De levering wordt uitgevoerd in JSON-indeling met behulp van de JSON Exporter.
Met AEM Content Fragments kunt u gestructureerde inhoud beschrijven en beheren. Gestructureerde inhoud wordt gedefinieerd in modellen die verschillende inhoudstypen kunnen bevatten, zoals tekst, numerieke gegevens, booleaanse gegevens, datum en tijd en meer.
Samen met de JSON-exportmogelijkheden van AEM-kerncomponenten kan deze gestructureerde inhoud vervolgens worden gebruikt om AEM-inhoud te leveren aan andere kanalen dan AEM-pagina's.
Inhoudstype content-type
Inhoudsfragmenten zijn:
-
Opgeslagen als Assets:
- De fragmenten van de inhoud (en hun variaties) kunnen van de Assets console worden gecreeerd en worden gehandhaafd.
- Gemaakt en bewerkt in de Inhoudsfragmenteditor.
-
Gebruikt in de paginaredacteur door de component van het Fragment van de Inhoud (van verwijzingen voorzien component):
- De component van het Fragment van 0} Inhoud {is beschikbaar aan paginaauteurs. Hiermee kunnen ze naar het vereiste inhoudsfragment in HTML- of JSON-indeling verwijzen en dit leveren.
-
Toegankelijk gebruikend AEM GraphQL API .
Inhoudsfragmenten zijn inhoudsstructuren die:
- Geen lay-out of ontwerp hebben (enige tekstopmaak is mogelijk in de modus RTF).
- Bevat één of meerdere samenstellende delen .
- bevat, of kan met, beelden worden verbonden.
- Wordt gebruikt als in-tussen inhoud wanneer van verwijzingen voorzien op een pagina.
- Zijn onafhankelijk van het leveringsmechanisme (namelijk pagina, kanaal).
Fragmenten met Visual Assets fragments-with-visual-assets
Om auteurs meer controle over hun inhoud te geven, kunnen afbeeldingen worden toegevoegd aan en/of geïntegreerd met een inhoudsfragment.
Assets kan op verschillende manieren worden gebruikt met een inhoudsfragment. Elk van deze mogelijkheden heeft zijn eigen voordelen:
-
Activa van het Tussenvoegsel in een fragment (gemengd-media fragmenten)
- Zij zijn een deel van het fragment (zie Vormende Delen van een Inhoudsfragment ).
- De positie van het element definiëren.
- Zie Invoegend Assets in uw Fragment in de Redacteur van het Fragment voor meer informatie.
note note NOTE Visuele elementen die in het inhoudsfragment zelf worden ingevoegd, worden aan de voorafgaande alinea gekoppeld. Wanneer het fragment aan een pagina wordt toegevoegd, worden deze elementen ten opzichte van die alinea verplaatst wanneer tussenliggende inhoud wordt toegevoegd. -
Verwante Inhoud
- Verbonden met een fragment; maar geen vast deel van het fragment (zie Vormt Delen van een Inhoudsfragment ).
- Heeft enige flexibiliteit voor positionering.
- Eenvoudig beschikbaar voor gebruik (als tussenliggende inhoud) bij gebruik van het fragment op een pagina.
Zie Geassocieerde Inhoud voor meer informatie.
-
Assets die beschikbaar zijn in de assetbrowser van de pagina-editor
- Volledige flexibiliteit toestaan voor de selectie van een element.
- Heeft enige flexibiliteit voor positionering.
- Bevat niet het concept dat voor een specifiek fragment wordt goedgekeurd.
Zie {Browser van 0} Assets voor meer informatie.
Delen van een inhoudsfragment maken constituent-parts-of-a-content-fragment
De elementen van het inhoudsfragment bestaan uit de volgende onderdelen (direct of indirect):
-
Elementen van het Fragment
- Elementen correleren met de gegevensvelden die inhoud bevatten.
- U gebruikt een inhoudsmodel om het inhoudsfragment te maken. De elementen (velden) die in het model zijn opgegeven, definiëren de structuur van het fragment. Deze elementen (velden) kunnen van verschillende gegevenstypen zijn.
-
Fragmentalinea's
-
Tekstblokken, vaak meerdere regels die zijn gescheiden als afzonderlijke entiteiten.
-
In de modi Tekst met opmaak en Markdown kan een alinea worden opgemaakt als een koptekst. In dat geval horen die alinea en de volgende alinea bij elkaar als één eenheid.
-
Inhoudsbeheer tijdens het ontwerpen van pagina's inschakelen.
-
-
Assets die in een Fragment (Gemengd-Media Fragments) wordt opgenomen
-
Assets (afbeeldingen) ingevoegd in het feitelijke fragment en gebruikt als de interne inhoud van een fragment.
-
Ingesloten in het alineasysteem van het fragment.
-
Kan worden geformatteerd wanneer het fragment wordt gebruikt/op een pagina van verwijzingen wordt voorzien.
-
Kan alleen met de fragmenteditor worden toegevoegd aan, verwijderd uit of verplaatst binnen een fragment. Deze handelingen kunnen niet worden uitgevoerd in de paginaeditor.
-
Kan slechts aan, worden toegevoegd geschrapt van, of binnen, een fragment gebruikend het Rich formaat van de Tekst in de fragmentredacteur worden bewogen.
-
Kan alleen worden toegevoegd aan tekstelementen met meerdere regels (elk fragmenttype).
-
Aan de voorgaande tekst (alinea) worden toegevoegd.
note caution CAUTION Assets kan (per ongeluk) uit een fragment worden verwijderd door over te schakelen op de indeling Onbewerkte tekst. note note NOTE Assets kan ook als extra (in-tussen) inhoud worden toegevoegd wanneer het gebruiken van een fragment op een pagina; het gebruiken van of Geassocieerde Inhoud of activa van browser van Assets.
-
-
Verwante Inhoud
-
Dit is inhoud die zich buiten een fragment bevindt, maar die van redactionele betekenis is. Afbeeldingen, video's of andere fragmenten worden meestal weergegeven.
-
De afzonderlijke elementen in de verzameling zijn beschikbaar voor gebruik met het fragment in de pagina-editor wanneer het aan een pagina wordt toegevoegd. Dit betekent dat ze optioneel zijn, afhankelijk van de vereisten van het specifieke kanaal.
-
De activa worden geassocieerd aan fragmenten als inzamelingen ; de bijbehorende inzamelingen staan de auteur toe om te beslissen welke activa te gebruiken wanneer zij de pagina ontwerpen.
- Verzamelingen kunnen tijdens het ontwerpen van fragmenten als standaardinhoud worden gekoppeld.
- Assets (DAM) Inzamelingen zijn de basis voor de bijbehorende inhoud van fragmenten.
-
Desgewenst kunt u het fragment zelf ook aan een verzameling toevoegen om het bijhouden van het fragment te vergemakkelijken.
-
-
Metagegevens van het Fragment
-
Gebruik de schema's van de meta-gegevens van Assets .
-
Tags kunnen worden gemaakt wanneer u:
-
Het fragment maken en ontwerpen
-
of hoger:
- Door het fragment Eigenschappen van de console te bekijken/uit te geven
- Door Meta-gegevens te uitgeven wanneer in de fragmentredacteur
-
note caution CAUTION Metagegevensverwerkingsprofielen zijn niet van toepassing op inhoudsfragmenten. -
-
Meester
-
Een deel van het fragment
- Elk inhoudsfragment heeft één instantie van Master.
- Stramien kan niet worden verwijderd.
-
Het hoofd is toegankelijk in de fragmentredacteur onder Variaties.
-
Stramien is geen variatie als zodanig, maar is de basis van alle variaties.
-
-
Variaties
- Uitvoeringen van fragmenttekst die specifiek zijn voor een redactioneel doel; kan worden gekoppeld aan een kanaal, maar dit is niet verplicht; kan ook worden gebruikt voor lokale ad-hocwijzigingen.
- Wordt gecreeerd als exemplaren van Hoofd, maar kan dan zoals vereist worden uitgegeven. Er is inhoudsoverlap tussen de variaties zelf.
- Kan worden gedefinieerd tijdens het ontwerpen van fragmenten.
- Opgeslagen in het fragment, om spreiding van inhoudskopieën te voorkomen.
- De variaties kunnen met Hoofd worden gesynchroniseerd als de Hoofdinhoud is bijgewerkt.
- Kan worden samengevat om de tekst aan een vooraf bepaalde lengte snel te beknotten.
- Beschikbaar onder het lusje van Variaties van de fragmentredacteur.
Tussen inhoud wanneer pagina's worden gemaakt met inhoudsfragmenten in-between-content-when-page-authoring-with-content-fragments
Tussenliggende inhoud:
- Beschikbaar voor gebruik in de Pagina-editor bij het werken met inhoudsfragmenten.
- extra inhoud die binnen de stroom van een fragment wordt toegevoegd nadat het wordt gebruikt of op een pagina van verwijzingen wordt voorzien.
- Beschikbaar voor gebruik in de Redacteur van de Pagina wanneer het werken met de Fragmenten van de Inhoud .
- Tussen-inhoud kan aan elk fragment worden toegevoegd, waarbij slechts één element zichtbaar is.
- De bijbehorende inhoud kan worden gebruikt, evenals activa en/of componenten van aangewezen browser.
Vereist door fragmenten required-by-fragments
Als u een inhoudsfragment wilt maken, hebt u het volgende nodig:
-
a Model van het Fragment van de Inhoud
- Is toegelaten gebruikend Browser van de Configuratie .
- Wordt gecreeerd gebruikend Hulpmiddelen .
- Vereist om tot een fragment te leiden.
- Definieert de structuur van een fragment (titel, inhoudselementen, tagdefinities).
- De modeldefinitie vereist een titel en één gegevenselement; alle andere is facultatief.
- Het model kan, indien van toepassing, de standaardinhoud bepalen.
- Auteurs kunnen de gedefinieerde structuur niet wijzigen tijdens het ontwerpen van fragmentinhoud, maar ze kunnen de modeleditor wel openen vanuit de fragmenteditor.
- Wijzigingen die worden aangebracht in een model nadat afhankelijke inhoudsfragmenten zijn gemaakt, kunnen van invloed zijn op die inhoudsfragmenten.
Als u de Content Fragments wilt gebruiken voor het ontwerpen van pagina's, hebt u ook het volgende nodig:
-
de Component van het Fragment van de Inhoud
- Instrumentaal voor het leveren van het fragment in HTML-indeling, JSON-indeling of beide.
- Vereist om het fragment op een pagina van verwijzingen te voorzien.
- Verantwoordelijk voor de lay-out en levering van een fragment, dat wil zeggen, kanalen.
- Fragmenten hebben een of meer specifieke componenten nodig om de lay-out te definiëren en om enkele of alle elementen/variaties en bijbehorende inhoud te leveren.
- Wanneer u een fragment naar een pagina sleept in de ontwerpfase, wordt de vereiste component automatisch gekoppeld.
Inhoudsfragmenten opnieuw gebruiken met MSM reusing-content-fragments-with-msm
Wanneer betreden door de Assets console, kunt u MSM gebruiken en Levende Exemplaren voor uw fragmenten creëren.
Zie voor meer informatie:
Deze laten overerving voor zowel variaties als individuele gebieden van uw fragmenten toe.
Voorbeeldengebruik example-usage
Een fragment met de elementen en variaties kan worden gebruikt om coherente inhoud voor meerdere kanalen te maken. Bedenk bij het ontwerpen van het fragment wat wordt gebruikt en waar het wordt gebruikt.
WKND-voorbeeld wknd-sample
De steekproeven van de Plaats WKND worden verstrekt om u over AEM as a Cloud Service te helpen leren.
Het WKND-project omvat:
-
Modellen voor inhoudsfragmenten zijn beschikbaar onder:
http://<hostname>:<port>/libs/dam/cfm/models/console/content/models.html/conf/wknd -
Inhoudsfragmenten (en andere inhoud) beschikbaar onder:
http://<hostname>:<port>/assets.html/content/dam/wknd/en
Aanbevolen procedures best-practices
Inhoudsfragmenten kunnen worden gebruikt om complexe structuren te vormen. Adobe biedt aanbevelingen voor aanbevolen methoden bij het definiëren en gebruiken van zowel modellen als fragmenten.
Eenvoudig houden keep-it-simple
Bij het modelleren van gestructureerde inhoud in AEM, houd inhoudsstructuren zo eenvoudig mogelijk om sterke systeemprestaties en gestroomlijnd bestuur te verzekeren.
Aantal modellen number-of-models
Maak zoveel inhoudsmodellen als u nodig hebt, maar niet meer.
Te veel modellen bemoeilijken het bestuur en kunnen GraphQL-query's vertragen. Een kleine set modellen, maximaal een lage tiental, is meestal voldoende. Als u de hoge tientallen of meer nadert, heroverweegt u uw modelleringsstrategie.
Modellen en fragmenten nesten (zeer belangrijk) nesting-models-and-fragments
Vermijd diep of bovenmatig nesten van inhoudsfragmenten met verwijzingen naar inhoudsfragmenten, waardoor fragmenten kunnen verwijzen naar andere fragmenten, soms op meerdere niveaus.
Het zware gebruik van verwijzingen naar inhoudsfragmenten kan de systeemprestaties, de reactiesnelheid van de gebruikersinterface en de uitvoering van GraphQL-query's aanzienlijk beïnvloeden. Doel om het nesten tot maximaal tien niveaus te beperken.
Aantal gegevensvelden en gegevenstypen per model number-of-data-fields-and-types-per-model
Neem alleen de gegevensvelden op en typ een model dat u echt nodig hebt.
Te complexe modellen leiden tot te complexe fragmenten die het ontwerpen bemoeilijken en de prestaties van de editor verminderen.
RTF-velden rich-text-fields
De gebieden van de Tekst van het gebruik Rich (de Meerdere lijntekst Type van Gegevens) met overweging:
-
Velden
Beperk het aantal RTF-velden per model. Vanwege de prestaties is het niet raadzaam meer dan tien RTF-velden in één model op te nemen. Indien nodig, wordt het geadviseerd dat u genestelde Fragments van de Inhoud gebruikt.
-
Inhoud
U moet ook de hoeveelheid tekst beperken die in elk fragment is opgeslagen, en de hoeveelheid HTML-opmaak. Zeer grote RTF-inhoud kan de systeemprestaties negatief beïnvloeden.
Aantal variaties number-of-variations
Maak zoveel fragmentvariaties als u nodig hebt, maar niet meer.
Variaties voegen verwerkingstijd toe aan een inhoudsfragment, aan de auteursomgeving en ook bij levering.
U wordt aangeraden:
- het aantal variaties tot een beheerbaar minimum beperken
- niet groter zijn dan tien variaties per inhoudsfragment
Testen vóór productie test-before-production
In twijfel, prototype uw voorgenomen inhoudsstructuren alvorens hen uit te rollen aan productie. Vroege proefnemingen en adequate tests, zowel technisch als acceptatie door de gebruiker, kunnen later problemen voorkomen wanneer de productietermijnen worden overschreden.