I modelli di frammenti di contenuto definiscono la struttura del contenuto per i frammenti di contenuto.
Per utilizzare i modelli di frammenti di contenuto, effettuare le seguenti operazioni:
Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.
Andate alla cartella appropriata per la configurazione.
Utilizzare Create per aprire la procedura guidata.
Se l'utilizzo di modelli di frammento di contenuto non è stato abilitato, l'opzione Crea non sarà disponibile.
Specifica il Titolo modello. È inoltre possibile aggiungere Tag, una Descrizione, quindi selezionare Abilita modello per abilitare il modello, se necessario.
Utilizzare Create per salvare il modello vuoto. Un messaggio indica l'esito positivo dell'azione, è possibile selezionare Apri per modificare immediatamente il modello, oppure Fine per tornare alla console.
Il modello di frammento di contenuto definisce in modo efficace 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.
Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.
Individuate la cartella che contiene il modello di frammento di contenuto.
Aprire il modello richiesto per Edit; utilizzare l'azione rapida oppure selezionare 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
Trascinare un tipo di dati richiesto nella posizione desiderata per un campo:
Una volta aggiunto un campo al modello, il pannello a destra mostrerà le Proprietà che possono essere definite per quel particolare tipo di dati. Qui è possibile definire i requisiti necessari per tale campo.
Esempio:
Rimozione di un campo
Selezionate il campo desiderato, quindi toccate o fate clic sull'icona del cestino. Viene richiesto di confermare l’operazione.
Aggiungete tutti i campi obbligatori e definite le relative proprietà, a seconda delle necessità. Esempio:
Selezionare Save per mantenere la definizione.
È disponibile una selezione di tipi di dati per definire il modello:
Molte proprietà sono auto-esplicative, per alcune proprietà ulteriori dettagli sono di seguito:
Rendering
con nome: varie opzioni per realizzare/eseguire il rendering del campo in un frammento. Spesso questo consente di definire se l’autore visualizzerà una singola istanza del campo o se potrà creare più istanze.
Etichetta
campoImmissione di un
L' etichetta campo genererà automaticamente un nome proprietà, che potrà quindi essere aggiornato manualmente, se necessario.
La convalida
ValidationBasic è disponibile tramite meccanismi quali la proprietà Requiredproperty. Alcuni tipi di dati dispongono di campi di convalida aggiuntivi. Per ulteriori informazioni, vedere Convalida.
Per il tipo di dati Testo su più righe è possibile definire il Tipo predefinito come:
Se non viene specificato, per questo campo viene utilizzato il valore predefinito Rich Text.
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.
UniqueContent (per il campo specifico) deve essere univoco in tutti i frammenti di contenuto creati dal modello corrente.
Questo consente di impedire agli autori di contenuti di ripetere il contenuto già aggiunto in un altro frammento dello stesso modello.
Ad esempio, un campo Testo su riga singola denominato Country
nel modello di frammento di contenuto non può avere il valore Japan
in due frammenti di contenuto dipendenti. Viene emesso un avviso quando si tenta di eseguire la seconda istanza.
Uniquità garantita per radice lingua.
Le varianti possono avere lo stesso valore univoco delle varianti dello stesso frammento, ma non lo stesso valore utilizzato in qualsiasi variante di altri frammenti.
TranslatableSelezionando la casella di controllo "Translatable" su un campo nell'editor modelli CF
/content/dam/<tenant>
, se non è già presente.<translatable>
nel campo Frammento di contenuto su yes
, per consentire il filtro query GraphQL per l'output JSON con solo contenuto convertibile.Per ulteriori informazioni su tale tipo di dati specifico e sulle relative proprietà, vedere Riferimento frammento (frammenti nidificati).
Diversi tipi di dati ora includono la possibilità di definire i 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 è di particolare interesse in combinazione con Distribuzione di contenuti headless con frammenti di contenuto con GraphQL.
Può essere configurato per uno o più riferimenti (nel frammento risultante).
AEM dispone di una protezione di ricorrenza per:
Content Reference (Riferimento contenuto) consente di eseguire il rendering del contenuto da un’altra origine; ad esempio, un 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 di contenuti da usare 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
}
Questo è di particolare interesse in combinazione con Distribuzione di contenuti headless con frammenti di contenuto con GraphQL.
Oltre alle proprietà standard è possibile definire:
Rendering come:
multicampo : l’autore del frammento può creare più riferimenti, singoli o singoli
riferimento a frammento : consente all'autore del frammento di selezionare un singolo riferimento a un frammento
Model
TypeÈ possibile selezionare più modelli. Durante la creazione del frammento di contenuto, qualsiasi frammento a cui si fa riferimento deve essere stato creato utilizzando questi modelli.
Percorso
radice: specifica un percorso principale per tutti i frammenti a cui viene fatto riferimento.
Consenti creazione di frammenti
Questo consente all'autore del frammento di creare un nuovo frammento basato sul modello appropriato.
Esiste un meccanismo di protezione contro la ricorrenza. Non consente all'utente di selezionare il frammento di contenuto corrente in Riferimento frammento. Questo potrebbe causare la visualizzazione di una finestra di dialogo vuota del selettore Riferimento frammento.
Esiste anche una protezione di ricorrenza per i riferimenti ai frammenti in GraphQL. Se si crea una query approfondita tra due frammenti di contenuto che si fanno riferimento l'uno all'altro, viene restituito null.
Per il controllo completo sull’utilizzo dei modelli di frammenti di contenuto, è possibile impostare uno stato.
Una volta creato, il modello deve essere abilitato in modo che:
Per abilitare un modello contrassegnato come:
È possibile utilizzare l'opzione Abilita da:
È inoltre possibile disattivare un modello in modo che:
Per disabilitare un modello contrassegnato come Abilitato, utilizzare l'opzione Disattiva da:
Per implementare la gestione dei contenuti, puoi configurare Criteri nella cartella Risorse per controllare quali modelli di frammenti di contenuto possono essere creati in tale cartella.
Il meccanismo è simile a consentendo modelli di pagina per una pagina e i relativi elementi secondari, nelle proprietà avanzate di una pagina.
Per configurare i criteri per modelli di frammenti di contenuto consentiti:
Spostatevi e aprite Proprietà per la cartella Risorse richiesta.
Aprite la scheda Criteri in cui potete configurare:
Ereditato da<folder>
I criteri vengono ereditati automaticamente quando si creano nuove cartelle figlie. 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.
Salvare le modifiche.
I modelli di frammento di contenuto consentiti per una cartella sono 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:
Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.
Individuate la cartella che contiene il modello di frammento di contenuto.
Selezionare il modello, seguito da Elimina dalla barra degli strumenti.
Se al modello viene fatto riferimento, verrà visualizzato un avviso. Adottare le misure appropriate.
I modelli di frammenti di contenuto devono essere pubblicati quando/prima che vengano pubblicati eventuali frammenti di contenuto dipendenti.
Per pubblicare un modello di frammento di contenuto:
Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.
Individuate la cartella che contiene il modello di frammento di contenuto.
Selezionate il modello, seguito da Pubblica dalla barra degli strumenti.
Lo stato di pubblicazione verrà indicato nella console.
Se si pubblica un frammento di contenuto per il quale il modello non è ancora stato pubblicato, verrà visualizzato un elenco di selezione e il modello verrà pubblicato insieme al frammento.
È possibile annullare la pubblicazione dei modelli di frammento di contenuto se non vi fanno riferimento alcun frammento.
Per annullare la pubblicazione di un modello di frammento di contenuto:
Andate a Strumenti, Risorse, quindi aprite Modelli di frammenti di contenuto.
Individuate la cartella che contiene il modello di frammento di contenuto.
Selezionate il modello, seguito da Annulla pubblicazione dalla barra degli strumenti.
Lo stato di pubblicazione verrà indicato nella console.