Werken met contentfragmenten - Concepten en aanbevolen procedures working-with-content-fragments-concepts-and-best-practices
Met Adobe Experience Manager (AEM) as a Cloud Service kunt u met inhoudsfragmenten paginaonafhankelijke inhoud ontwerpen, maken, beheren en publiceren. Zij staan u toe om inhoud klaar voor gebruik in veelvoudige plaatsen, en over veelvoudige kanalen voor te bereiden, ideaal voor hoofdloze levering , en pagina authoring .
- gebruik van de Assets console voor het beheren van de Fragmenten van de Inhoud
- gebruik van de originele redacteur van het Fragment van de Inhoud ,
- het gebruiken van Fragmenten van de Inhoud voor pagina-creatie .
Inhoudsfragmenten bevatten gestructureerde inhoud:
-
Elk fragment is gebaseerd op het Model van het Fragment van de a Inhoud .
- Het Model van het Fragment van de Inhoud bepaalt de structuur van het resulterende fragment.
-
Elk fragment bestaat uit:
-
De structuur kan liggen tussen:
-
Basis
- Bijvoorbeeld een tekstveld met één regel tekst.
- Kan worden gebruikt voor het voorbereiden van eenvoudige inhoud voor gebruik in paginaontwerp.
- Kan ook worden gebruikt voor koploze levering aan uw toepassing.
-
Complex
- Een combinatie van een groot aantal velden met verschillende gegevenstypen, zoals tekst, getal, boolean en datum en tijd.
- Kan worden gebruikt voor het voorbereiden van meer gestructureerde inhoud voor het ontwerpen van pagina's of voor levering zonder kop aan uw toepassing.
-
Genest
- Met de beschikbare gegevenstypen waarnaar wordt verwezen, kunt u de inhoud nesten.
- De neiging om voor hoofdloze levering aan uw toepassing te worden gebruikt.
-
Inhoudsfragmenten kunnen ook in JSON-indeling worden geleverd, 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 de veelvoudige Componenten van de Kern van het Fragment van de Inhoud op de pagina toe te voegen die voor API levering wordt gebruikt
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.
Nochtans, wilt u (waarschijnlijk) niet nauwkeurige zelfde inhoud voor alle kanalen gebruiken - u moet uw inhoud volgens het specifieke kanaal optimaliseren.
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 uw tekst toe door elementen in te voegen.
- Maak geneste inhoud om de complexiteit van uw gegevens te weerspiegelen.
Deze inhoudsfragmenten kunnen vervolgens worden samengesteld om ervaringen via verschillende kanalen te bieden.
- 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.
Deze pagina's en de volgende pagina's bevatten de taken voor het maken, configureren, onderhouden en gebruiken van de inhoudsfragmenten:
- Functionaliteit van inhoudsfragment inschakelen voor uw instantie
- Modellen van het Fragment van de Inhoud - toelatend, creërend, en bepalend uw modellen
- creeer uw Fragmenten van de Inhoud (gebruikend de Console van het Fragment van de Inhoud)
Nadat de fragmenten zijn gemaakt, kunt u:
-
gebruik de console van de Fragmenten van de Inhoud - aan:
- toegang krijgen, publiceren (om een voorvertoning of productie weer te geven) en verwijzen naar uw fragmenten
-
gebruik de redacteur van de Fragmenten van de Inhoud - aan:
- bewerken, publiceren (voor voorvertoning of productie) en verwijzen naar uw fragmenten
- samenwerken met andere auteurs die opmerkingen gebruiken
-
analyseer de structuur van uw Fragment van de Inhoud, gebruikend de redacteur
-
heb toegang tot uw fragmenten met GraphQL, voor hoofdloze levering aan uw toepassingen .
-
integreer en gebruik uw Fragmenten van de Inhoud in Adobe Journey Optimizer
-
Creeer, en beheer, Lanceringen voor 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 Authoring van de Pagina met de Fragmenten van de Inhoud .
- Het Fragment van de Inhoud en ModelAPIs van het Fragment van de Inhoud zijn ook beschikbaar.
Hoofd en Variaties main-and-variations
Variaties zijn een belangrijk kenmerk van AEM Content Fragments. Zij staan u toe om exemplaren van de Belangrijkste inhoud voor gebruik op specifieke kanalen, en scenario's tot stand te brengen en uit te geven, makend koploze inhoudslevering en pagina het schrijven nog flexibeler.
-
Hoofd
-
Hoofd is geen variatie als dusdanig, maar is de basis van alle variaties.
-
Een integraal onderdeel van het fragment
- Elk fragment van de Inhoud heeft één geval van Hoofd.
- Hoofd kan niet worden geschrapt.
-
Hoofd is toegankelijk in de fragmentredacteur onder Variaties.
note note NOTE In de redacteur beschikbaar bij de Assets console, Hoofd wordt geëtiketteerd als Meester. -
-
Variaties
- Uitvoeringen van fragmenttekst die specifiek zijn voor redactionele doeleinden; kan gerelateerd zijn aan het kanaal maar is niet verplicht, maar kan ook voor lokale ad-hocwijzigingen worden gebruikt.
- Wordt gecreeerd als exemplaren van Hoofd, maar kan dan worden uitgegeven zoals vereist; er is vaak inhoudsoverlap tussen de variaties zelf.
- Kan tijdens het ontwerpen van fragmenten worden gedefinieerd; vanuit het linkerdeelvenster.
- Opgeslagen in het fragment, om spreiding van inhoudskopieën te voorkomen.
- De variaties kunnen worden vergeleken en worden gesynchroniseerd met Hoofd.
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:
-
De eigenschap van A Plaatsen.
-
Opgeslagen als Assets:
- De fragmenten van de inhoud (en hun variaties) kunnen van de console van de Fragmenten van de Inhoud worden gecreeerd en worden gehandhaafd .
- Geautoriseerd en bewerkt in de Redacteur van het Fragment van de Inhoud .
-
Toegankelijk voor inhoudslevering die AEM GraphQL API gebruiken.
-
Beschikbaar in de paginaredacteur door de component van het Fragment van de Inhoud te gebruiken (van verwijzingen voorzien component):
- De Component van de Kern van het Fragment van de Inhoud is beschikbaar aan paginaauteurs. Hiermee kunnen ze naar het vereiste inhoudsfragment in HTML- of JSON-indeling verwijzen en dit leveren.
Inhoudsfragmenten zijn een inhoudsstructuur die:
- Deze variabelen zijn niet opgemaakt of ontworpen (tekstopmaak is mogelijk voor tekstvelden).
- Deze zijn onafhankelijk van het leveringsmechanisme (zoals de pagina of het kanaal).
- Bevat één, of meer, constituerende delen .
- Kan bevatten, of met, beelden worden verbonden.
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:
- als Verwijzing van de a Inhoud
- binnen a Meerdere lijntekst gebied
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 het Model van het Fragment van de a Inhoud om het fragment van de Inhoud tot stand te brengen. De elementen (gebieden) die in het model worden gespecificeerd bepalen 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.
-
Inhoudsbeheer tijdens het ontwerpen van pagina's inschakelen.
-
-
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 later, wanneer u bekijkt of de eigenschappen uitgeeft wanneer in de fragmentredacteur
note caution CAUTION Metagegevensverwerkingsprofielen zijn niet van toepassing op inhoudsfragmenten. note caution CAUTION Een model van het Fragment van de Inhoud kan gegevensgebieden vaak bepalen genoemd Titel en Beschrijving. Als deze twee gebieden bestaan, zijn zij user-defined gebieden en kunnen op het inhoudsgebied van de redacteur worden bijgewerkt. Het tevreden Fragment, en zijn variaties, heeft ook meta-gegevens (bezit) gebieden genoemd Titel en Beschrijving. Deze twee metagegevensvelden maken integraal deel uit van een inhoudsfragment en variatie. Deze velden worden in eerste instantie gedefinieerd wanneer het fragment wordt gemaakt. Deze eigenschappen kunnen worden bijgewerkt in het gebied met eigenschappen/metagegevens van de editor. -
Vereist door fragmenten required-by-fragments
Voor het maken van Content Fragments hebt u nodig:
-
Model van de Inhoud
- Zijn toegelaten gebruikend Browser van de Configuratie .
- Wordt gecreeerd gebruikend de Console van het Fragment van de Inhoud .
- Vereist om tot een fragment te leiden.
- Definieert de structuur van een fragment (titel, inhoudselementen, tagdefinities).
- Definities van inhoudsfragmentmodel vereisen een titel en één gegevenselement. Alle overige elementen zijn optioneel.
- Het model kan de standaardinhoud definiëren, indien van toepassing.
- 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 de levering van inhoud zonder kop, hebt u ook het volgende nodig:
-
a vraag van GraphQL om de vereiste inhoud te verzoeken
-
deze inhoud kan dan voor de ontwikkeling van uw eigen SPAs voor AEM worden gebruikt; voor meer informatie, herzie de volgende documenten:
Als u de Content Fragments wilt gebruiken voor het ontwerpen van pagina's, hebt u ook het volgende nodig:
-
A Component van het Fragment van de Inhoud
- Instrumentaal voor het leveren van het fragment in HTML- en/of JSON-indeling.
- Vereist om het fragment op een pagina van verwijzingen te voorzien.
- Verantwoordelijk voor de lay-out en levering van een fragment, bijvoorbeeld 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.
- Zie de Component van de Kern van het Fragment van de Inhoud .
De console met inhoudsfragmenten content-fragments-console
De console van de Fragmenten van de Inhoud wordt gewijd aan het beheren van, het zoeken naar, en het creëren van Fragmenten van de Inhoud , Modellen van het Fragment van de Inhoud en Assets . Deze functie is geoptimaliseerd voor gebruik in een context zonder koptekst, maar wordt ook gebruikt bij het maken van Content Fragments en Content Fragment Models voor gebruik in het ontwerpen van pagina's.
De console kan direct van het hoogste niveau van de Globale Navigatie worden betreden.
U kunt het meest linkse deelvenster gebruiken om het brontype te selecteren dat u wilt weergeven, bekijken en beheren:
Zie voor meer informatie:
-
Een selectie van toetsenbordkortere weg is beschikbaar voor gebruik in deze console
Voorbeeldengebruik example-usage
Een fragment met de elementen en variaties kan worden gebruikt om coherente inhoud voor meerdere kanalen te maken. Bij het ontwerpen van het fragment moet u rekening houden met wat er wordt gebruikt en waar.
WKND-voorbeeld wknd-sample
De Gedeelde Plaats WKND en WKND steekproeven worden verstrekt om u over AEM as a Cloud Service te helpen leren.
Het WKND-project omvat:
-
Modellen voor inhoudsfragmenten zijn beschikbaar onder:
-
.../libs/dam/cfm/models/console/content/models.html/conf/wknd -
.../ui#/aem/libs/dam/cfm/models/console/content/models.html/conf/wknd-shared
-
-
Inhoudsfragmenten (en andere inhoud) beschikbaar onder:
.../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. Aanbevolen wordt het aantal variaties tot een beheerbaar minimum te beperken.
De beste manier is om tien variaties per inhoudsfragment niet te overschrijden.
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.