Come modellare il contenuto model-your-content
In questa parte del Percorso per sviluppatori di AEM headless, puoi imparare a modellare la struttura del contenuto. Poi scopri che la struttura per Adobe Experience Manager (AEM) utilizza modelli per frammenti di contenuto e frammenti di contenuto per il riutilizzo su più canali.
Percorso affrontato finora story-so-far
All'inizio, Informazioni sullo sviluppo headless di CMS riguardava la distribuzione di contenuti headless e il motivo per cui dovrebbe essere utilizzata. Quindi Guida introduttiva di AEM Headless ha descritto AEM Headless nel contesto del tuo progetto.
Nel documento precedente del percorso di AEM headless, Percorso della tua prima esperienza con AEM headless, hai quindi appreso i passaggi necessari per implementare il primo progetto. Dopo averlo letto, dovresti:
- comprendere importanti considerazioni sulla pianificazione per la progettazione dei contenuti
- comprendere i passaggi per implementare headless in base ai requisiti del livello di integrazione.
- impostare gli strumenti e le configurazioni AEM necessarie.
- Conoscere le best practice per semplificare il tuo percorso headless, garantire la distribuzione rapida dei contenuti e l’efficienza nella loro generazione.
Questo articolo si basa su questi fondamentali in modo da capire come preparare il tuo progetto AEM headless.
Obiettivo objective
-
Pubblico: principiante
-
Obiettivo: scopri come modellare la struttura del contenuto, quindi realizzare tale struttura utilizzando i Modelli per frammenti di contenuto di AEM e i Frammenti di contenuto:
- Introduzione dei concetti e della terminologia relativi alla modellazione di dati/contenuti.
- Scopri perché è necessaria la modellazione dei contenuti per la distribuzione di contenuti headless.
- Scopri come realizzare questa struttura utilizzando Modelli di frammenti di contenuto di AEM (e creare contenuti con Frammenti di contenuto).
- Scopri come modellare il contenuto; principi con campioni di base.
Modellazione dei contenuti content-modeling
Il mondo là fuori è grande e brutto.
Forse sì, forse no. Si tratta certamente di un mondo in gran parte complicato là fuori. La modellazione dei dati viene utilizzata per definire una rappresentazione semplificata di una sottosezione molto piccola, utilizzando le informazioni specifiche necessarie per un determinato scopo.
Esempio:
Ci sono molte scuole, ma tutte hanno varie cose in comune:
- Una posizione
- Un dirigente scolastico
- Molti insegnanti
- Molti membri del personale non docente
- Molti studenti
- Molti ex-insegnanti
- Molti ex allievi
- Molte classi
- Molti (molti) libri
- Molti (molti) pezzi di attrezzatura
- Molte attività extra curriculari
- e così via…
L’elenco può sembrare infinito anche per un esempio così piccolo. Tuttavia, se si desidera semplicemente che l'applicazione esegua un'operazione semplice, è possibile limitare le informazioni alle attività essenziali.
Ad esempio, pubblicità di eventi speciali per tutte le scuole della zona:
- Nome della scuola
- Posizione della scuola
- Dirigente scolastico
- Tipo di evento
- Data dell’evento
- Insegnante che organizza l’evento
Concetti concepts
Ciò che desideri descrivere sono denominate Entità, ovvero le "cose" di cui vuoi archiviare le informazioni.
Le informazioni su tali entità che vuoi memorizzare sono gli Attributi (proprietà), ad esempio il nome e le qualifiche per gli insegnanti.
Poi ci sono varie Relazioni tra le entità. Per esempio, di solito una scuola ha un solo preside e molti insegnanti (e di solito il preside è anche un insegnante).
Il processo di analisi e definizione di queste informazioni, insieme alle relazioni tra di esse, è chiamato Modellazione dei contenuti.
Funzioni di base basics
Spesso è possibile iniziare creando uno Schema concettuale che descrive le entità e le relative relazioni. Di solito questo schema è di alto livello (concettuale).
Dopo aver fissato lo schema concettuale è possibile tradurre i modelli in uno Schema logico che descrive le entità, gli attributi e le relazioni. A questo livello, esamina attentamente le definizioni per eliminare la duplicazione e ottimizzare la progettazione.
Ad esempio, sono necessarie entità separate per Head Teacher e Teacher o è sufficiente un attributo aggiuntivo sul modello Teacher?
Garantire l’integrità dei dati data-integrity
L’integrità dei dati è necessaria per garantire l’accuratezza e la coerenza dei contenuti durante l’intero ciclo di vita. Ciò include la garanzia che gli autori dei contenuti possano capire facilmente cosa archiviare e dove, per cui sono fondamentali i seguenti elementi:
- una struttura chiara
- una struttura il più concisa possibile (senza sacrificare la precisione)
- la convalida dei singoli campi
- all’occorrenza, limitare il contenuto di campi specifici a ciò che è significativo
Eliminazione della ridondanza dei dati data-redundancy
La ridondanza dei dati si verifica quando le stesse informazioni vengono memorizzate due volte nella struttura del contenuto. Questo dovrebbe essere evitato in quanto può generare confusione durante la creazione del contenuto ed errori durante l’esecuzione di query; per non parlare dell’uso improprio dello spazio di archiviazione.
Ottimizzazione e prestazioni optimization-and-performance
Ottimizzando la struttura è possibile migliorare le prestazioni, sia per la creazione di contenuti che per l’esecuzione di query.
È tutta una questione di equilibrio, ma la creazione di una struttura troppo complessa o con troppi livelli può:
-
creare confusione per gli autori che generano i contenuti.
-
penalizzare notevolmente le prestazioni se la query deve accedere a più frammenti di contenuto nidificati (a cui si fa riferimento) per recuperare il contenuto richiesto.
Modellazione dei contenuti per AEM Headless content-modeling-for-aem-headless
La Modellazione dati è un insieme di tecniche consolidate, spesso utilizzate quando si sviluppano database relazionali, quindi cosa significa Modellazione dei contenuti per AEM Headless?
Perché? why
Per garantire che l’applicazione possa richiedere e ricevere in modo coerente ed efficiente il contenuto richiesto da AEM, questo contenuto deve essere strutturato.
Ciò significa che l’applicazione conosce in anticipo la forma della risposta e quindi come elaborarla. Questo è molto più semplice della ricezione di contenuti in formato libero, che devono essere analizzati per determinare cosa contengono e come possono essere utilizzati.
Introduzione a Come? how
AEM utilizza Frammenti di contenuto per fornire le strutture necessarie per la distribuzione headless dei contenuti alle applicazioni.
La struttura del modello di contenuto è:
- realizzata secondo la definizione del modello per frammenti di contenuto,
- utilizzata come base dei frammenti di contenuto impiegati per la generazione dei contenuti.
Le richieste di contenuti vengono effettuate utilizzando l’API GraphQL di AEM, un’implementazione personalizzata dell’API GraphQL standard. L’API GraphQL di AEM consente di eseguire query (complesse) sui frammenti di contenuto; con ciascuna query basata su un tipo di modello specifico.
Il contenuto restituito può quindi essere utilizzato dalle applicazioni.
Creazione della struttura con modelli per frammenti di contenuto create-structure-content-fragment-models
I modelli per frammenti di contenuto forniscono vari meccanismi che consentono di definire la struttura del contenuto.
Un modello per frammento di contenuto descrive un’entità.
All’interno di un modello:
- Tipi di dati ti consente di definire i singoli attributi.
Ad esempio, definisci il campo contenente il nome di un insegnante come Testo e i relativi anni di servizio come Numero. - I tipi di dati Riferimento contenuto e Riferimento frammento consentono di creare relazioni con altri contenuti in AEM.
- Il tipo di dati Riferimento frammento consente di realizzare più livelli di struttura nidificando i frammenti di contenuto (in base al tipo di modello). Questo è fondamentale per la modellazione dei contenuti.
Ad esempio:
Tipi di dati data-types
AEM fornisce i seguenti tipi di dati per modellare il contenuto:
- Testo su riga singola
- Testo su più righe
- Numero
- Booleano
- Data e ora
- Enumerazione
- Tag
- Riferimento contenuto
- Riferimento frammento
- Oggetto JSON
Riferimenti e contenuto nidificato references-nested-content
Due tipi di dati forniscono riferimenti a contenuti esterni a uno specifico frammento:
-
Riferimento contenuto
Fornisce un semplice riferimento ad altri contenuti di qualsiasi tipo.
Ad esempio, è possibile fare riferimento a un’immagine in una posizione specifica. -
Riferimento frammento
Fornisce riferimenti ad altri frammenti di contenuto.
Questo tipo di riferimento viene utilizzato per creare contenuti nidificati, introducendo le relazioni necessarie per modellare il contenuto.
Il tipo di dati può essere configurato in modo da consentire agli autori di frammenti di:- Modificare direttamente il frammento a cui si fa riferimento.
- Crea un frammento di contenuto in base al modello appropriato.
Creazione di modelli per frammenti di contenuto creating-content-fragment-models
All’inizio, devi abilitare i modelli per frammenti di contenuto per il sito. Questa abilitazione viene eseguita nel Browser configurazioni; in Strumenti > Generale > Browser configurazioni. Puoi scegliere di configurare la voce globale oppure creare una nuova configurazione. Esempio:
È quindi possibile creare modelli per frammenti di contenuto e definire la struttura. Questa operazione può essere eseguita in Strumenti > Assets > Modelli per frammenti di contenuto. Esempio:
Uso del modello per creare contenuti con frammenti di contenuto use-content-to-author-content
I frammenti di contenuto vengono creati in base a un modello per frammenti di contenuto. Il modello fornisce la struttura, il frammento ospita il contenuto.
Selezione del modello appropriato select-model
Il primo passaggio per creare effettivamente il contenuto è la creazione di un frammento di contenuto. Questa operazione viene eseguita utilizzando Crea > Frammento di contenuto, nella cartella desiderata in Risorse > File. La procedura guidata ti conduce attraverso i diversi passaggi.
Un frammento di contenuto si basa su un modello per frammento di contenuto specifico, selezionato come primo passaggio del processo di creazione.
Creazione e modifica di contenuti strutturati create-edit-structured-content
Una volta creato il frammento, puoi aprirlo nell’Editor frammento di contenuto. Qui puoi effettuare le seguenti operazioni:
- Modificare il contenuto in modalità normale o a schermo intero.
- Formattare il contenuto come Testo completo, Testo normale o Markdown.
- Creare e gestire le varianti dei contenuti.
- Associare contenuto.
- Modificare i metadati.
- Mostrare la struttura ad albero.
- Visualizzare un’anteprima della rappresentazione JSON.
Creare frammenti di contenuto creating-content-fragments
Dopo aver selezionato il modello appropriato, nell’Editor frammento di contenuto viene aperto un frammento di contenuto per la modifica:
Guida introduttiva con alcuni esempi getting-started-examples
Per una struttura di base come esempio, vedere Struttura dei frammenti di contenuto di esempio.
Passaggio successivo whats-next
Ora che hai imparato a modellare la tua struttura e a creare contenuti basandoti su di essa, il passaggio successivo è: Scoprire come utilizzare le query GraphQL per accedere e recuperare il contenuto dei frammenti di contenuto. Questo introduce e illustra GraphQL, quindi esamina alcune query di esempio per vedere come funzionano le cose in pratica.
Risorse aggiuntive additional-resources
-
Utilizzo dei frammenti di contenuto: pagina di apertura dei frammenti di contenuto.
- Frammenti di contenuto nel browser configurazioni - Abilitare la funzionalità Frammenti di contenuto nel browser configurazioni.
- Modelli per frammenti di contenuto - Creazione e modifica di modelli per frammenti di contenuto.
- Gestione dei frammenti di contenuto - Creazione e creazione di frammenti di contenuto. In questa pagina vengono visualizzate altre sezioni dettagliate.
-
Schemi GraphQL AEM - Modalità di realizzazione dei modelli in GraphQL.
-
Guida introduttiva ad AEM Headless - Una breve serie di video tutorial che offre una panoramica dell’utilizzo di funzioni headless di AEM, tra cui modellazione dei contenuti e GraphQL.
- Nozioni di base sulla modellazione di GraphQL: scopri come definire e inserire i frammenti di contenuto in Adobe Experience Manager (AEM) per l’utilizzo con GraphQL.