I modelli per frammenti di contenuto in AEM definiscono la struttura del contenuto per il frammenti di contenuto, funge da base per i contenuti headless.
Per utilizzare i modelli di frammento di contenuto:
Passa a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella appropriata configurazione.
Utilizzo Crea per aprire la procedura guidata.
Se l’utilizzo di modelli per frammenti di contenuto non è stato abilitato, l’opzione Crea non sarà disponibile.
Specifica il Titolo modello. È inoltre possibile aggiungere Tag, Descrizione, quindi seleziona Abilita modello a abilita il modello se necessario.
Utilizzo 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 a frammento 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 di frammento di contenuto esistente può avere un impatto sui frammenti dipendenti.
Passa a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella contenente il modello di frammento di contenuto.
Apri il modello richiesto per Modifica; utilizza l’azione rapida oppure seleziona 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 sarà contrassegnata con un asterisco (*).
Aggiunta di 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 visualizza Proprietà che può essere definito 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 completerà automaticamente il Nome proprietà - se vuoto, e può essere aggiornato manualmente in seguito.
Quando si aggiorna manualmente la proprietà Nome proprietà per un tipo di dati, tenere presente che i nomi devono contenere solo i caratteri A-Z, a-z, 0-9 e il carattere di sottolineatura "_" come carattere speciale.
Se i modelli creati in versioni precedenti di AEM contengono caratteri non validi, rimuovi o aggiorna tali caratteri.
Esempio:
Rimozione di un campo
Seleziona il campo richiesto, quindi tocca o fai clic sull’icona del cestino. Viene richiesto di confermare l’operazione.
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.
Questo verrà mostrato come divisore nell'editor modelli, separando le sezioni dell'elenco dei tipi di dati di contenuto. Ogni istanza rappresenta l’inizio di una nuova scheda.
Nell’editor 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, per alcune proprietà ulteriori dettagli sono qui sotto:
Nome proprietà
Quando aggiorni manualmente questa proprietà per un tipo di dati, tieni presente che i nomi deve contain only A-Z, a-z, 0-9 e carattere di sottolineatura "_" come carattere speciale.
Se i modelli creati in versioni precedenti di AEM contengono caratteri non validi, rimuovi o aggiorna tali caratteri.
Rendering come
Le varie opzioni per la realizzazione/il rendering del campo in un frammento. Spesso questo consente di definire se l’autore visualizza una singola istanza del campo o se può creare più istanze.
Etichetta campo
Inserimento di un
Etichetta campo genererà automaticamente un Nome proprietà, che può quindi essere aggiornato manualmente se necessario.
Convalida
La convalida di base è disponibile tramite meccanismi quali Obbligatorio proprietà. 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, il valore predefinito Rich Text viene utilizzato per questo campo.
La modifica del Tipo predefinito in un modello per frammenti di contenuto avrà 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 Testo a riga singola campo denominato Country
nel modello frammento di contenuto non può essere presente il valore Japan
in due frammenti di contenuto dipendenti. Viene visualizzato un avviso quando si tenta di eseguire la seconda istanza.
L'unicità è assicurata per radice linguistica.
Le varianti possono avere lo stesso 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 specificati.
Consente di includere/recuperare dati strutturati.
Questo metodo ha un interesse particolare in relazione Distribuzione di contenuti headless tramite frammenti di contenuto con GraphQL.
AEM ha una protezione di ricorrenza per:
Riferimenti contenuto
Questo impedisce all’utente di aggiungere un riferimento al frammento corrente. Questo può causare una finestra di dialogo vuota del selettore dei riferimenti ai frammenti.
Riferimenti a frammenti in GraphQL
Se crei una query profonda che restituisce più frammenti di contenuto a cui fanno riferimento l’uno dall’altro, alla prima occorrenza restituirà null.
La funzione Riferimento contenuto consente di eseguire il rendering del contenuto da un’altra origine; ad esempio, frammento di immagine o di contenuto.
Oltre alle proprietà standard è possibile specificare:
Il riferimento al 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:
multicampo - l’autore del frammento può creare più riferimenti singoli o multipli
fragmentreference : consente all’autore del frammento di selezionare un singolo riferimento a un frammento
Tipo di modello
È possibile selezionare più modelli. Durante la creazione del frammento di contenuto, tutti i frammenti a cui si fa riferimento devono essere stati creati utilizzando questi modelli.
Percorso radice
Specifica un percorso principale per tutti i frammenti a cui viene fatto riferimento.
Consenti creazione di frammenti
In questo modo l’autore del frammento potrà creare un nuovo frammento basato sul modello appropriato.
È in vigore un meccanismo di protezione contro la recidiva. Non consente all’utente di selezionare il frammento di contenuto corrente nel riferimento al frammento. Questo può causare una finestra di dialogo vuota del selettore dei riferimenti ai frammenti.
In GraphQL è inoltre disponibile una protezione di ricorrenza per i riferimenti ai frammenti. Se crei una query approfondita tra due frammenti di contenuto che si riferiscono l’uno all’altro, restituirà null.
Per un controllo completo sull’utilizzo dei modelli di frammenti di contenuto, è possibile impostare uno stato .
Una volta creato un modello, questo deve essere abilitato in modo che:
Per abilitare un modello contrassegnato come:
Utilizzi le Abilita da:
Un modello può anche essere disabilitato in modo che:
Per disattivare un modello contrassegnato come Abilitato si utilizza Disattiva da:
Per implementare la governance dei contenuti, puoi configurare Criteri nella cartella Risorse per controllare quali modelli di 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 le Criteri per Modelli di frammenti di contenuto consentiti:
Naviga e apri Proprietà per la cartella Risorse richiesta.
Apri Criteri , dove puoi configurare:
Ereditato da<folder>
I criteri vengono ereditati automaticamente durante la creazione di nuove cartelle secondarie; il criterio può essere riconfigurato (e l’ereditarietà è interrotta) se le sottocartelle devono consentire modelli diversi dalla cartella principale.
Modelli per frammenti di contenuto consentiti per percorso
Possono essere consentiti più modelli.
Modelli di frammenti di contenuto consentiti per tag
Possono essere consentiti più modelli.
Salva eventuali modifiche.
I modelli di frammento di contenuto consentiti per una cartella vengono risolti come segue:
L’eliminazione di un modello di frammento di contenuto può avere un impatto sui frammenti dipendenti.
Per eliminare un modello di frammento di contenuto:
Passa a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella contenente il modello di frammento di contenuto.
Seleziona il modello, seguito da Elimina dalla barra degli strumenti.
Se si fa riferimento al modello, viene visualizzato un avviso. Agisci in modo appropriato.
I modelli di frammento di contenuto devono essere pubblicati quando/prima che vengano pubblicati eventuali frammenti di contenuto dipendenti.
Per pubblicare un modello di frammento di contenuto:
Passa a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella contenente il modello di frammento di contenuto.
Seleziona il modello, seguito da Pubblica dalla barra degli strumenti.
Lo stato di pubblicazione sarà indicato nella console.
Se pubblichi un frammento di contenuto per il quale il modello non è ancora stato pubblicato, un elenco di selezione lo indicherà e il modello verrà pubblicato con il frammento.
I modelli di frammento di contenuto possono essere inediti se non sono indicati da alcun frammento.
Per annullare la pubblicazione di un modello di frammento di contenuto:
Passa a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.
Passa alla cartella contenente il modello di frammento di contenuto.
Seleziona il modello, seguito da Annulla pubblicazione dalla barra degli strumenti.
Lo stato di pubblicazione sarà indicato nella console.
È possibile modificare le Proprietà di un modello di frammento di contenuto: