Utilizzo di frammenti di contenuto working-with-content-fragments
Con Adobe Experience Manager (AEM) as a Cloud Service, i frammenti di contenuto ti consentono di progettare, creare, curare e pubblicare contenuti indipendenti dalla pagina. Consentono di preparare contenuti pronti per l'uso in più posizioni e su più canali, ideali per la distribuzione headless. Possono inoltre essere utilizzati insieme a Gestione multisito per consentire di riutilizzare il contenuto.
I frammenti di contenuto contengono contenuti strutturati:
-
Sono basati su un Modello per frammenti di contenuto, che definisce la struttura del frammento risultante.
-
La struttura può essere di tre tipi:
-
Base
- Ad esempio, un singolo campo di testo su più righe.
- Può essere utilizzato per preparare contenuti semplici da utilizzare nell’authoring delle pagine.
-
Complessa
- Combinazione di molti campi di tipi di dati diversi, tra cui testo, numeri, dati booleani, dati e ora.
- Può essere utilizzato per preparare contenuti più strutturati per l’authoring delle pagine o per la distribuzione all’applicazione.
-
Nidificata
- I tipi di dati di riferimento disponibili consentono di nidificare il contenuto.
- Questa struttura è spesso utilizzata per la consegna a un’applicazione.
-
I frammenti di contenuto possono essere consegnati anche in formato JSON, utilizzando le funzionalità di esportazione Sling Model (JSON) dei componenti core di AEM. Questo tipo di consegna:
- consente di utilizzare il componente per gestire gli elementi di un frammento da consegnare;
- consente la consegna in massa, aggiungendo più componenti core per frammenti di contenuto nella pagina utilizzata per la consegna API
Questa pagina e quelle seguenti descrivono le attività di creazione, configurazione, manutenzione e utilizzo dei frammenti di contenuto:
- Abilita funzionalità frammento di contenuto per la tua istanza
- Modelli per frammenti di contenuto - abilitazione, creazione e definizione dei modelli
- Gestione dei frammenti di contenuto: crea i frammenti di contenuto, quindi modifica, pubblica e fai riferimento a essi
- Varianti: authoring dei contenuti di frammenti: come creare il contenuto di un frammento e quindi varianti del contenuto principale
- Markdown: come utilizzare la sintassi markdown per il frammento
- Utilizzo di contenuti associati: come aggiungere contenuti associati
- Metadati: proprietà dei frammenti: come visualizzare e modificare le proprietà dei frammenti
- Utilizzare Frammenti di contenuto insieme a GraphQL per distribuire il contenuto da utilizzare nelle applicazioni. Per facilitare questa fase, puoi visualizzare in anteprima l'output JSON.
- Riutilizzare frammenti di contenuto con MSM
- Authoring delle pagine con frammenti di contenuto.
- Personalizzazione ed estensione dei frammenti di contenuto
- Componenti di configurazione dei frammenti di contenuto per il rendering
- Supporto dei frammenti di contenuto nell’API HTTP di AEM Assets
- API GraphQL di AEM per l’utilizzo con Frammenti di contenuto
- OpenAPI per il modello Frammento di contenuto e Frammento di contenuto
Il numero di canali di comunicazione aumenta ogni anno. In genere i canali si distinguono in base al meccanismo di consegna, come segue:
- Canale fisico; ad esempio, desktop, dispositivi mobili.
- Forma di consegna in un canale fisico, ad esempio “pagina dei dettagli di un prodotto”, “pagina della categoria del prodotto” per desktop oppure “web mobile”, “app mobile” per dispositivi mobili.
Tuttavia, probabilmente non vorrai utilizzare lo stesso contenuto per tutti i canali, ma dovrai ottimizzarlo in base al canale specifico.
I frammenti di contenuto consentono di:
- valutare come raggiungere in modo efficiente il pubblico target su ciascun canale;
- creare e gestire contenuti editoriali indipendenti dal canale;
- creare pool di contenuti per una serie di canali;
- progettare varianti di contenuto per canali specifici;
- aggiungere immagini al testo inserendo delle risorse (frammenti con elementi multimediali diversi);
- Crea contenuti nidificati in modo da riflettere la complessità dei dati.
Questi frammenti di contenuto possono quindi essere assemblati per fornire esperienze su vari canali.
- I frammenti di contenuto sono contenuti editoriali, con definizione e struttura, ma senza elementi visivi aggiuntivi di design e/o layout. Possono essere utilizzati per accedere a dati strutturati, tra cui testi, numeri e date.
- I frammenti di esperienza sono contenuti completi di layout, frammenti di una pagina web.
Frammenti di contenuto e Content Services content-fragments-and-content-services
AEM Content Services è progettato per generalizzare la descrizione e la consegna dei contenuti in/da AEM, non limitandosi alle pagine web.
Fornisce contenuti a canali diversi dalle tradizionali pagine web di AEM, utilizzando metodi standardizzati utilizzabili da qualsiasi cliente. Questi canali possono includere:
- Applicazioni a pagina singola
- Applicazioni mobile native
- altri canali e punti di contatto esterni ad AEM
La consegna viene effettuata in formato JSON utilizzando il modulo di esportazione JSON.
I frammenti di contenuto di AEM possono essere utilizzati per descrivere e gestire contenuti strutturati. Il contenuto strutturato è definito in modelli che possono contenere vari tipi di contenuto, tra cui testo, dati numerici, dati booleani, data e ora e altro ancora.
Insieme alle funzionalità di esportazione JSON dei componenti core di AEM, tali contenuti strutturati possono quindi essere utilizzati per consegnare contenuti AEM a canali diversi dalle pagine AEM.
Tipo di contenuto content-type
I frammenti di contenuto sono:
-
Memorizzati come Risorse:
- I frammenti di contenuto (e le relative varianti) possono essere creati e gestiti dalla console Assets.
- Vengono creati e modificati nell’Editor frammenti di contenuto.
-
Utilizzato nell'editor pagina dal componente Frammento di contenuto (componente di riferimento):
- Il componente Frammento di contenuto è disponibile per gli autori delle pagine. Consente loro di fare riferimento e distribuire il frammento di contenuto richiesto in formato HTML o JSON.
-
Accessibili tramite l’API GraphQL di AEM.
I frammenti di contenuto sono strutture di contenuto che:
- Non disporre di layout o progettazione (in modalità Testo formattato è possibile formattare del testo).
- Contiene una o più parti costitutive.
- Contengono immagini o possono essere connesse a esse.
- Sono utilizzati come contenuto intermedio quando vi si fa riferimento in una pagina.
- è indipendente dal meccanismo di consegna (ad esempio, pagina, canale).
Frammenti con risorse visive fragments-with-visual-assets
Per dare agli autori un maggiore controllo sui contenuti, le immagini possono essere aggiunte a e/o integrate con un frammento di contenuto.
Assets può essere utilizzato con un frammento di contenuto in diversi modi, ciascuno con i propri vantaggi:
-
Tramite Inserisci risorsa per inserire una risorsa in un frammento (frammenti con elementi multimediali diversi)
- Fanno parte del frammento (vedi Parti costitutive di un frammento di contenuto).
- Viene definita la posizione della risorsa.
- Per ulteriori informazioni consulta Inserimento di risorse nel frammento nell’editor di frammenti.
note note NOTE Le risorse visive inserite nel frammento di contenuto stesso sono associate al paragrafo precedente. Quando il frammento viene aggiunto a una pagina, queste risorse vengono spostate in relazione a tale paragrafo quando viene aggiunto contenuto intermedio. -
Contenuto associato
- Connesso a un frammento, ma non parte fissa del frammento (vedi Parti costitutive di un frammento di contenuto).
- Ha una certa flessibilità per il posizionamento.
- Facilmente disponibile per l’uso (come contenuto intermedio) quando si utilizza il frammento su una pagina.
Per ulteriori informazioni vedi Contenuto associato.
-
Risorse disponibili nel browser Risorse dell’editor pagina
- Offrono massima flessibilità nella selezione di una risorsa.
- Ha una certa flessibilità per il posizionamento.
- Non supportano il concetto di approvazione per un frammento specifico.
Per ulteriori informazioni vedi Browser risorse.
Parti costitutive di un frammento di contenuto constituent-parts-of-a-content-fragment
Le risorse dei frammenti di contenuto sono composte dalle seguenti parti (direttamente o indirettamente):
-
Elementi del frammento
- Gli elementi sono correlati ai campi di dati che contengono il contenuto.
- Per creare il frammento di contenuto, puoi utilizzare un modello di contenuto. Gli elementi (campi) specificati nel modello definiscono la struttura del frammento. Questi elementi (campi) possono essere di vari tipi di dati.
-
Paragrafi del frammento
-
Blocchi di testo, spesso con più righe delimitate come singole entità.
-
Nelle modalità Testo formattato e Markdown, un paragrafo può essere formattato come intestazione, in tal caso appartiene a un’unica unità insieme al paragrafo seguente.
-
Consentono di controllare i contenuti durante l’authoring delle pagine.
-
-
Risorse inserite in un frammento (frammenti con elementi multimediali diversi)
-
Risorse (immagini) inserite nel frammento effettivo e utilizzate come contenuto interno di un frammento.
-
Incorporato nel sistema paragrafo del frammento.
-
Possono essere formattate quando il frammento viene utilizzato o inserito come riferimento in una pagina.
-
Possono solo essere aggiunte, eliminate o spostate all’interno di un frammento utilizzando l’editor di frammenti. Queste azioni non possono essere eseguite nell’editor pagina.
-
Possono essere aggiunte, eliminate o spostate all'interno di un frammento solo utilizzando il formato Rich Text nell'editor frammenti.
-
Possono essere aggiunte solo a elementi di testo su più righe (qualsiasi tipo di frammento).
-
Sono associate al testo che precede (paragrafo).
note caution CAUTION Le risorse possono essere rimosse (inavvertitamente) da un frammento se si passa al formato Testo normale. note note NOTE È inoltre possibile aggiungere Assets come contenuto aggiuntivo (intermedio) quando si utilizza un frammento su una pagina, utilizzando Contenuto associato o risorse dal browser Assets.
-
-
Contenuto associato
-
Contenuti esterni a un frammento, ma con rilevanza editoriale per esso. In genere si tratta di immagini, video o altri frammenti.
-
Le singole risorse all’interno di una raccolta sono disponibili per essere utilizzate con il frammento nell’editor pagina quando questo viene aggiunto a una pagina. Sono quindi elementi opzionali, a seconda dei requisiti del canale specifico.
-
Le risorse sono associate a frammenti tramite raccolte; le raccolte associate consentono all'autore di decidere quali risorse utilizzare durante l'authoring della pagina.
- Le raccolte possono essere associate ai frammenti come contenuto predefinito, oppure possono essere associate dagli autori durante la creazione dei frammenti.
- Le raccolte di risorse (DAM) sono la base del contenuto associato dei frammenti.
-
Volendo, puoi anche aggiungere il frammento stesso a una raccolta per facilitare il tracciamento.
-
-
Metadati del frammento
-
Utilizzano gli schemi di metadati delle risorse.
-
È possibile creare i tag quando:
-
si crea e si effettua l’authoring del frammento;
-
oppure in un secondo tempo:
- visualizzando e modificando le Proprietà del frammento dalla console;
- modificando i Metadati nell’editor di frammenti
-
note caution CAUTION I profili di elaborazione dei metadati non sono applicabili ai frammenti di contenuto. -
-
Principale
-
Parte del frammento
- Ogni frammento di contenuto dispone di un’istanza Principale.
- L’elemento Principale non può essere eliminato.
-
L’elemento Principale è accessibile nella sezione Varianti dell’editor di frammenti.
-
l’elemento Principale non è una variante in sé, ma è la base di tutte le varianti.
-
-
Varianti
- Rappresentazioni di testo di un frammento specifiche a scopo editoriale; possono essere relative a un canale, ma questo non è obbligatorio; possono anche essere utilizzate per modifiche locali ad hoc.
- Vengono create come copie di Master, ma possono essere modificate in base alle esigenze. Esiste una sovrapposizione di contenuti tra le varianti stesse.
- Possono essere definite durante l’authoring del frammento.
- Sono memorizzate nel frammento, per evitare la dispersione delle copie del contenuto.
- Le varianti possono essere sincronizzate con l’elemento principale se il suo contenuto viene aggiornato.
- Il testo può essere riepilogato per ridurlo rapidamente a una lunghezza predefinita.
- Sono disponibili nella scheda Varianti dell’editor di frammenti.
Contenuto intermedio nell’authoring di pagine con frammenti di contenuto in-between-content-when-page-authoring-with-content-fragments
Contenuto intermedio:
- Può essere utilizzato nell’Editor pagina quando si lavora con frammenti di contenuto.
- Contenuto aggiuntivo aggiunto all'interno del flusso di un frammento dopo che è stato utilizzato o inserito come riferimento in una pagina.
- Disponibile per l'utilizzo nell'Editor pagina quando si lavora con frammenti di contenuto.
- Il contenuto intermedio può essere aggiunto a qualsiasi frammento, in cui è visibile un solo elemento.
- È possibile utilizzare il contenuto associato, così come le risorse e/o i componenti dal browser appropriato.
Elementi necessari per i frammenti required-by-fragments
Per creare un frammento di contenuto, è necessario:
-
un Modello per frammenti di contenuto
- È abilitato per tramite il browser configurazioni.
- È creato utilizzando gli strumenti.
- È necessario per creare un frammento.
- Definisce la struttura di un frammento (titolo, elementi di contenuto, definizioni tag).
- La definizione del modello richiede un titolo e un elemento dati; tutto il resto è facoltativo.
- Il modello può definire il contenuto predefinito, se applicabile.
- Gli autori non possono modificare la struttura definita durante l’authoring del contenuto di un frammento, anche se possono aprire l’editor modelli dall’editor frammenti.
- Le modifiche apportate a un modello dopo la creazione dei frammenti di contenuto dipendenti possono influire su tali frammenti di contenuto.
Per utilizzare i frammenti di contenuto per l’authoring delle pagine, è inoltre necessario:
-
il componente Frammento di contenuto
- Essenziale per la distribuzione del frammento in formato HTML, JSON o entrambi.
- Obbligatorio per fare riferimento al frammento in una pagina.
- Responsabile del layout e della distribuzione di un frammento, ovvero i canali.
- I frammenti devono disporre di uno o più componenti dedicati per definire il layout e fornire alcuni o tutti gli elementi/varianti e i contenuti associati.
- Quando si trascina un frammento su una pagina durante l’authoring, il componente richiesto viene associato automaticamente.
Riutilizzo dei frammenti di contenuto con MSM reusing-content-fragments-with-msm
Se si accede tramite la console Assets, è possibile utilizzare MSM e creare Live Copy per i frammenti.
Per ulteriori dettagli, consulta:
Questi abilitano l'ereditarietà sia per le varianti che per i singoli campi dei frammenti.
Esempio di utilizzo example-usage
Un frammento, con i relativi elementi e varianti, può essere utilizzato per creare contenuti coerenti per più canali. Durante la progettazione del frammento, considera cosa viene utilizzato e dove viene utilizzato.
Esempio WKND wknd-sample
Per apprendere a utilizzare AEM as a Cloud Service, viene fornito il sito WKND di esempio.
Il progetto WKND include:
-
Modelli di Frammento di contenuto disponibili in:
http://<hostname>:<port>/libs/dam/cfm/models/console/content/models.html/conf/wknd -
Frammenti di contenuto (e altro contenuto) disponibili in:
http://<hostname>:<port>/assets.html/content/dam/wknd/en
Best practice best-practices
I frammenti di contenuto possono essere utilizzati per formare strutture complesse. Adobe offre consigli sulle best practice da seguire per la definizione e l’utilizzo di modelli e frammenti.
Semplifica keep-it-simple
Durante la modellazione di contenuti strutturati in AEM, utilizza strutture di contenuto quanto più semplici possibile per garantire prestazioni di sistema elevate e governance semplificata.
Numero di modelli number-of-models
Crea tutti i modelli di contenuto necessari, ma non più.
Troppi modelli complicano la governance e possono rallentare le query GraphQL. Di solito è sufficiente un piccolo insieme di modelli, massimo di decine basse. Se ti avvicini alle dieci o più alte, riconsidera la tua strategia di modellazione.
Nidificazione di modelli e frammenti (molto importante) nesting-models-and-fragments
Evita la nidificazione profonda o eccessiva dei frammenti di contenuto utilizzando i Riferimenti ai frammenti di contenuto, che consentono ai frammenti di fare riferimento ad altri frammenti, a volte su più livelli.
L’utilizzo intensivo dei riferimenti ai frammenti di contenuto può influire in modo significativo sulle prestazioni del sistema, sulla reattività dell’interfaccia utente e sull’esecuzione delle query GraphQL. Mirare a mantenere la nidificazione a non più di dieci livelli.
Numero di campi e tipi di dati per modello number-of-data-fields-and-types-per-model
Includi solo i campi di dati e i tipi di dati necessari per un modello.
Modelli eccessivamente complessi portano a frammenti eccessivamente complessi che possono rendere difficile l’authoring e ridurre le prestazioni dell’editor.
Campi Rich Text rich-text-fields
Utilizza i campi Rich Text (il tipo di dati Testo su più righe) tenendo presente:
-
Campi
Limita il numero di campi Rich Text per modello. Per motivi di prestazioni, si consiglia di non disporre di più di dieci campi Rich Text in un modello. Se necessario, è consigliabile utilizzare frammenti di contenuto nidificati.
-
Contenuto
È inoltre necessario limitare la quantità di testo memorizzata in ciascun frammento e la quantità di formattazione di HTML. Contenuti Rich Text di grandi dimensioni possono influire negativamente sulle prestazioni del sistema.
Numero di varianti number-of-variations
Crea tutte le varianti di frammento necessarie, ma non più.
Le varianti aggiungono tempo di elaborazione a un frammento di contenuto, nell’ambiente di authoring e alla consegna.
Si consiglia di:
- mantenere il numero di varianti al minimo gestibile
- non superare dieci varianti per frammento di contenuto
Test prima della produzione test-before-production
In caso di dubbi, crea un prototipo delle strutture di contenuto previste prima di implementarle in produzione. Una verifica precoce dei concetti, unita a test adeguati, sia tecnici che di accettazione da parte dell’utente, può aiutare a evitare problemi in un secondo momento, quando si dovranno affrontare le scadenze di produzione.