I modelli per frammenti di contenuto nell’AEM definiscono la struttura del contenuto per il frammenti di contenuto, fungere da base per i contenuti headless.
Per utilizzare i modelli per frammenti di contenuto, puoi:
Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella appropriata per configurazione.
Utilizza Crea per aprire la procedura guidata.
Se il l’utilizzo di modelli per frammenti di contenuto non è stato abilitato, il Crea non è disponibile.
Specifica il Titolo modello. Puoi anche aggiungere Tag, a Descrizione, e seleziona Abilita modello a abilita il modello se necessario.
Utilizza Crea per salvare il modello vuoto. Un messaggio indica il successo dell’azione, puoi selezionare Apri per modificare immediatamente il modello, oppure Fine per tornare alla console.
Il modello per frammenti di contenuto definisce efficacemente la struttura dei frammenti di contenuto risultanti utilizzando una selezione di Tipi di dati. Utilizzando l’editor modelli è possibile aggiungere istanze dei tipi di dati, quindi configurarle per creare i campi richiesti:
La modifica di un modello per frammento di contenuto esistente può avere un impatto sui frammenti dipendenti.
Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella contenente il modello per frammenti di contenuto.
Apri il modello che desideri modificare utilizzando l’azione rapida oppure selezionando il modello e quindi l’azione dalla barra degli strumenti.
Una volta aperto, l’editor modelli mostra:
Quando un campo è obbligatorio, l’Etichetta indicata nel riquadro a sinistra è contrassegnata da un asterisco (*).
Per aggiungere un campo
Trascina un tipo di dati obbligatorio nella posizione desiderata per un campo:
Una volta aggiunto un campo al modello, il pannello di destra mostra Proprietà che possono essere definiti per quel particolare tipo di dati. Qui puoi definire ciò che è necessario per quel campo.
Molte proprietà sono auto-esplicative, per ulteriori dettagli vedi Proprietà.
Digitazione di un Etichetta campo completa automaticamente il Nome proprietà - se vuoto, e può essere aggiornato manualmente in seguito.
Quando aggiorni manualmente la proprietà Nome proprietà per un tipo di dati, i nomi devono contenere solo caratteri A-Z, a-z, 0-9 e il carattere speciale di sottolineatura "_".
Se i modelli creati in versioni precedenti di AEM contengono caratteri non validi, rimuovi o aggiorna tali caratteri.
Esempio:
Per rimuovere un campo
Seleziona il campo richiesto, quindi tocca o fai clic sull’icona del cestino. Viene richiesto di confermare l’azione.
Aggiungi tutti i campi obbligatori e definisci le relative proprietà in base alle esigenze. Esempio:
Seleziona Salva per mantenere la definizione.
Per definire il modello è disponibile una selezione di tipi di dati:
Consente l’introduzione di schede da utilizzare per la modifica del contenuto dei frammenti di contenuto.
Nell’editor modelli viene mostrato come divisore che separa le sezioni dell’elenco dei tipi di dati di contenuto. Ogni sua istanza rappresenta l’inizio di una nuova scheda.
Nell’editor di frammenti, ogni istanza viene visualizzata come una scheda.
Questo tipo di dati viene utilizzato esclusivamente per la formattazione e viene ignorato dallo schema GraphQL AEM.
Molte proprietà sono auto-esplicative, qui sotto ulteriori dettagli per alcune proprietà:
Nome proprietà
Quando si aggiorna manualmente questa proprietà per un tipo di dati, i nomi deve contain solo A-Z, a-z, 0-9 e il carattere speciale di sottolineatura "_".
Se i modelli creati in versioni precedenti di AEM contengono caratteri non validi, rimuovi o aggiorna tali caratteri.
Rendering come
Sono disponibili varie opzioni per realizzare o riprodurre il campo in un frammento. Spesso questo consente di definire se l’autore può vedere una singola istanza del campo o se può crearne più istanze.
Etichetta campo
Inserimento di un Etichetta campo genera automaticamente un Nome proprietà, che possono quindi essere aggiornati manualmente, se necessario.
Convalida
La convalida di base è disponibile tramite meccanismi quali la proprietà Obbligatorio. Alcuni tipi di dati dispongono di campi di convalida aggiuntivi. Vedi Convalida per ulteriori dettagli.
Per il tipo di dati Testo su più righe è possibile definire il Tipo predefinito come:
Se non viene specificato diversamente, per questo campo viene utilizzato il valore predefinito Rich Text.
Modifica del Tipo predefinito in un modello per frammenti di contenuto ha effetto solo su un frammento esistente correlato, una volta che il frammento è stato aperto nell’editor e successivamente salvato.
Univoco
Il contenuto (per il campo specifico) deve essere univoco in tutti i frammenti di contenuto creati dal modello corrente.
Questo viene utilizzato per impedire agli autori di contenuti di ripetere contenuti già aggiunti in un altro frammento dello stesso modello.
Ad esempio, un campo Testo a riga singola denominato Country
nel modello per frammenti di contenuto non può avere il valore Japan
in due frammenti di contenuto dipendenti. Viene visualizzato un avviso quando si tenta di eseguire la seconda istanza.
L’unicità è assicurata da directory principale lingua.
Le varianti possono avere lo stesso valore unico come varianti dello stesso frammento, ma non lo stesso valore utilizzato in qualsiasi variante di altri frammenti.
Vedi Riferimento contenuto per ulteriori dettagli su quel tipo di dati specifico e sulle relative proprietà.
Vedi Riferimento frammento (frammenti nidificati) per ulteriori dettagli su quel tipo di dati specifico e sulle relative proprietà.
Diversi tipi di dati includono ora la possibilità di definire requisiti di convalida per l’immissione di contenuto nel frammento risultante:
I frammenti di contenuto possono formare contenuto nidificato utilizzando uno dei seguenti tipi di dati:
Riferimento frammento (frammenti nidificati)
Fa riferimento ad altri frammenti, a seconda dei modelli specifici indicati.
Consente di includere/recuperare dati strutturati.
Questo metodo è di particolare interesse per Distribuzione di contenuti headless tramite frammenti di contenuto con GraphQL.
AEM ha una protezione periodica per:
Riferimenti contenuto
Questo impedisce all’utente di aggiungere un riferimento al frammento corrente. Inoltre la finestra di dialogo selettore del riferimento frammento può risultare vuota.
Riferimenti frammento in GraphQL
Se crei una query approfondita che restituisce più frammenti di contenuto a cui si fa riferimento l’un l’altro, alla prima occorrenza restituisce null.
Il Riferimento contenuto consente di eseguire il rendering del contenuto da un’altra origine, ad esempio un’immagine o un frammento di contenuto.
Oltre alle proprietà standard puoi specificare:
Il Riferimento frammento fa riferimento a uno o più frammenti di contenuto. Questa funzione è particolarmente interessante per il recupero dei contenuti da utilizzare nell’app, in quanto consente di recuperare dati strutturati con più livelli.
Esempio:
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
Ciò è di particolare interesse per Distribuzione di contenuti headless tramite frammenti di contenuto con GraphQL.
Oltre alle proprietà standard puoi definire:
Rendering come:
multifield: l’autore del frammento può creare più riferimenti individuali
fragmentreference: consente all’autore del frammento di selezionare un singolo riferimento a un frammento
Tipo di modello
È possibile selezionare più modelli. Durante l’authoring del frammento di contenuto, tutti i frammenti a cui si fa riferimento devono essere stati creati utilizzando questi modelli.
Percorso radice
Specifica un percorso radice per tutti i frammenti a cui si fa riferimento.
Consenti creazione di frammenti
Questo consente all’autore del frammento di creare un frammento basato sul modello appropriato.
È presente un meccanismo di protezione per evitare le ricorrenze. Non consente all’utente di selezionare il frammento di contenuto corrente nel riferimento frammento. Inoltre la finestra di dialogo selettore del riferimento frammento può risultare vuota.
In GraphQL è inoltre disponibile una protezione di ricorrenza per i riferimenti di frammenti. Se crei una query approfondita tra due frammenti di contenuto che si riferiscono l’uno all’altro, restituisce null.
I modelli per frammenti di contenuto dispongono di uno stato che puoi impostare per avere il controllo completo del loro utilizzo.
Una volta creato, il modello deve essere abilitato in modo che:
Per abilitare un modello contrassegnato come:
È possibile utilizzare Abilita opzione da:
Un modello può anche essere disabilitato, con i seguenti risultati:
Per disattivare un modello contrassegnato come Abilitato, utilizza Disattiva opzione da:
Per implementare la governance dei contenuti, puoi configurare Criteri in una cartella Assets per controllare quali modelli per frammenti di contenuto sono consentiti per la creazione di frammenti in tale cartella.
Il meccanismo è simile a consentire modelli di pagina per una pagina e i relativi elementi secondari, nelle proprietà avanzate di una pagina.
Per configurare i Criteri dei Modelli per frammenti di contenuto consentiti:
Naviga e apri Proprietà per la cartella Risorse desiderata.
Apri la scheda Criteri, dove puoi configurare:
Ereditato da<folder>
I criteri vengono ereditati automaticamente durante la creazione di cartelle secondarie; il criterio può essere riconfigurato (interrompendo l’ereditarietà) se le sottocartelle devono consentire modelli diversi dalla cartella principale.
Modelli per frammenti di contenuto consentiti per percorso
Possono essere consentiti più modelli.
Modelli per frammenti di contenuto consentiti per tag
Possono essere consentiti più modelli.
Salva eventuali modifiche.
I modelli per frammenti di contenuto consentiti per una cartella vengono risolti come segue:
L’eliminazione di un modello per frammenti di contenuto può avere un impatto sui frammenti dipendenti.
Per eliminare un modello per frammenti di contenuto:
Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella contenente il modello per frammenti di contenuto.
Seleziona il modello e poi Elimina dalla barra degli strumenti.
Se ci sono riferimenti al modello, viene visualizzata un’avvertenza. Prendi le misure appropriate.
I modelli per frammenti di contenuto devono essere pubblicati quando/prima della pubblicazione di qualsiasi frammento di contenuto dipendente.
Per pubblicare un modello per frammenti di contenuto:
Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella contenente il modello per frammenti di contenuto.
Seleziona il modello e poi Pubblica dalla barra degli strumenti.
Lo stato di pubblicazione viene indicato nella console.
Se pubblichi un frammento di contenuto per il quale il modello non è ancora stato pubblicato, questo viene segnalato in un elenco di selezione e il modello viene pubblicato con il frammento.
Si può annullare la pubblicazione di modelli per frammenti di contenuto che non sono referenziati da alcun frammento.
Per annullare la pubblicazione di un modello per frammenti di contenuto:
Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella contenente il modello per frammenti di contenuto.
Seleziona il modello e poi Annulla pubblicazione dalla barra degli strumenti.
Lo stato di pubblicazione viene indicato nella console.
Puoi modificare le Proprietà di un modello per frammenti di contenuto: