Panoramica sull’utilizzo dei frammenti di contenuto overview-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 distribuzione headless e creazione pagine.
- utilizzo della console Assets per gestione dei frammenti di contenuto
- utilizzo dell'editor frammento di contenuto originale,
- utilizzo di Frammenti di contenuto per l'authoring delle pagine.
I frammenti di contenuto contengono contenuto strutturato:
-
Ogni frammento è basato su un Modello per frammenti di contenuto.
- Il modello per frammenti di contenuto definisce la struttura del frammento risultante.
-
Ogni frammento è costituito da:
- Principale: parte integrante del frammento che contiene il contenuto principale. Esiste sempre e non può essere eliminata
- Varianti - Una o più permutazioni del contenuto, create dall'autore
-
La struttura può essere di tre tipi:
-
Base
- Ad esempio, un singolo campo di testo su più righe.
- Può essere utilizzata per preparare contenuti semplici da utilizzare nell’authoring delle pagine.
- Può essere utilizzato anche per la consegna headless all’applicazione.
-
Complessa
- Combinazione di molti campi di tipi di dati diversi, tra cui testo, numeri, dati booleani e data e ora.
- Può essere utilizzato per preparare contenuti più strutturati per l’authoring delle pagine o per la distribuzione headless all’applicazione.
-
Nidificata
- I tipi di dati di riferimento disponibili consentono di nidificare il contenuto.
- Tende a essere utilizzato per la consegna headless all’applicazione.
-
I frammenti di contenuto possono essere consegnati anche in formato JSON, utilizzando le funzionalità di esportazione Sling Model (JSON) dei componenti core dell’AEM. Questo tipo di consegna:
- consente di utilizzare il componente per gestire gli elementi di un frammento da consegnare;
- consente la distribuzione in blocco; aggiungendo più componenti core Frammento di contenuto nella pagina utilizzata per la distribuzione API
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 desideri utilizzare esatto stesso contenuto per tutti i canali. È necessario ottimizzare il contenuto 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;
- Per aggiungere immagini al testo, inserisci le risorse.
- creare contenuti nidificati in base alla complessità dei dati.
Questi frammenti di contenuto possono quindi essere assemblati per fornire esperienze su diversi 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.
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
- Crea i tuoi frammenti di contenuto (utilizzando la console Frammenti di contenuto)
Dopo la creazione dei frammenti, puoi:
- Utilizza la console Frammenti di contenuto per accedere ai frammenti, pubblicarli (per visualizzarli in anteprima o produrli) e farvi riferimento
- Utilizza l'editor frammenti di contenuto per modificare, pubblicare (per l'anteprima o la produzione) e fare riferimento ai frammenti
- Analizza la struttura del frammento di contenuto, utilizzando l'editor
- Accedi ai tuoi frammenti con GraphQL per la consegna headless nelle tue applicazioni.
- Oppure utilizza i tuoi frammenti per creare le pagine
- 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
- Authoring delle pagine con frammenti di contenuto.
- Sono disponibili anche OpenAPI per frammenti di contenuto e modelli di frammenti di contenuto.
Principale e varianti main-and-variations
Le varianti sono una caratteristica significativa dei frammenti di contenuto dell’AEM. Consentono di creare e modificare copie del contenuto Principale da utilizzare su canali e scenari specifici, rendendo ancora più flessibile la distribuzione di contenuti headless e l'authoring delle pagine.
-
Principale
-
Principale non è una variante in quanto tale, ma è la base di tutte le varianti.
-
Parte integrante del frammento
- Ogni frammento di contenuto ha un'istanza di Main.
- Impossibile eliminare Main.
-
Principale è accessibile nell'editor frammenti in Varianti.
note note NOTE Nell'editor disponibile nella console Assets, Main è etichettato come Master. -
-
Varianti
- Sono rappresentazioni di testo dei frammenti a scopo editoriale; possono essere relative a un canale ma non necessariamente, e possono anche essere utilizzate per modifiche locali ad hoc.
- Sono create come copie di Principale, ma possono essere modificate in base alle esigenze. Spesso vi è una sovrapposizione di contenuto tra le varianti stesse.
- Può essere definito durante la creazione del frammento, dal pannello a sinistra.
- Sono memorizzate nel frammento, per evitare la dispersione delle copie del contenuto.
- Le varianti possono essere confrontate e sincronizzate con Principale.
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 diversi tipi di contenuto, compresi 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:
-
Una funzionalità di Sites.
-
Memorizzati come Risorse:
- I frammenti di contenuto (e le relative varianti) possono essere creati e gestiti dalla console Frammenti di contenuto.
- Creato e modificato nell'Editor frammento di contenuto.
-
Accessibile per la distribuzione dei contenuti tramite l'API GraphQL per AEM.
-
Disponibile nell'editor di pagine tramite il componente Frammento di contenuto (componente di riferimento):
- Il componente core Frammento di contenuto è disponibile per gli autori di pagine. Consente loro di fare riferimento e distribuire il frammento di contenuto richiesto in formato HTML o JSON.
I frammenti di contenuto sono una struttura di contenuto che:
- Sono privi di layout o progettazione (la formattazione del testo è possibile per i campi di testo).
- È indipendente dal meccanismo di consegna (ad esempio la pagina o il canale).
- contiene una o più parti costituenti;
- può contenere immagini o essere connessa ad esse;
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:
- as a Riferimento contenuto
- in un campo Testo su più righe
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 si utilizza un modello per frammenti di contenuto. Gli elementi (campi) specificati nel modello definiscono la struttura del frammento. Questi elementi (campi) possono essere di diversi tipi di dati.
-
Paragrafi del frammento
-
Blocchi di testo, spesso con più righe, delimitati come singole entità.
-
Consentono di controllare i contenuti durante l’authoring delle pagine.
-
-
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 momento, quando visualizzi o modifichi le proprietà nell'editor frammenti
note caution CAUTION I profili di elaborazione dei metadati non sono applicabili ai frammenti di contenuto. note caution CAUTION Un modello per frammenti di contenuto può spesso definire campi di dati denominati Titolo e Descrizione. Se questi due campi esistono, sono campi definiti dall’utente e possono essere aggiornati nell’area del contenuto dell’editor. Il frammento di contenuto e le relative varianti dispongono anche di campi di metadati (proprietà) denominati Titolo e Descrizione. Questi due campi di metadati sono parte integrante di qualsiasi frammento di contenuto e variante e sono inizialmente definiti al momento della creazione del frammento. Possono essere aggiornati nell’area proprietà/metadati dell’editor. -
Elementi necessari per i frammenti required-by-fragments
Per creare frammenti di contenuto sono necessari i seguenti elementi:
-
Modello di contenuto
- Viene abilitato tramite il Browser configurazioni.
- Viene creato utilizzando gli strumenti.
- È necessario per creare un frammento.
- Definisce la struttura di un frammento (titolo, elementi di contenuto, definizioni tag).
- Le definizioni del modello per frammenti di contenuto richiedono un titolo e un elemento dati; tutto il resto è facoltativo.
- Il modello può definire eventuale contenuto predefinito.
- 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 la distribuzione di contenuti headless è inoltre necessario:
-
una query GraphQL per richiedere il contenuto richiesto
-
questo contenuto può quindi essere utilizzato per sviluppare il proprio SPA per l’AEM; per ulteriori informazioni, consulta i seguenti documenti:
Per utilizzare i frammenti di contenuto nell’authoring delle pagine è inoltre necessario:
-
Un componente Frammento di contenuto
- Essenziale per la distribuzione del frammento in formato HTML e/o JSON.
- Obbligatorio per fare riferimento al frammento in una pagina.
- Responsabile del layout e della distribuzione di un frammento, ad esempio 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.
- Consulta il componente core Frammento di contenuto.
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 è necessario considerare cosa verrà utilizzato e dove.
Esempio WKND wknd-sample
Per apprendere a utilizzare AEM as a Cloud Service, vengono forniti gli esempi Sito WKND e Condiviso WKND.
Il progetto WKND include:
-
Modelli di Frammento di contenuto disponibili in:
-
.../libs/dam/cfm/models/console/content/models.html/conf/wknd -
.../ui#/aem/libs/dam/cfm/models/console/content/models.html/conf/wknd-shared
-
-
Frammenti di contenuto (e altro contenuto) disponibili in:
.../assets.html/content/dam/wknd/en