Modelli per frammenti di contenuto content-fragment-models
I modelli per frammenti di contenuto in Adobe Experience Manager (AEM as a Cloud Service) definiscono la struttura per il contenuto dei frammenti di contenuto. Questi frammenti possono quindi essere utilizzati per l’authoring delle pagine o come base per i contenuti headless.
Per utilizzare i modelli di frammento di contenuto:
- Abilita la funzionalità modello Frammento di contenuto per un’istanza
- Crea e configura i modelli per frammenti di contenuto
- Abilitare i modelli di frammenti di contenuto da utilizzare per la creazione di frammenti di contenuto
- Consenti modelli di frammento di contenuto nelle cartelle Risorse richieste configurando i Criteri.
Creazione di un modello di frammento di contenuto creating-a-content-fragment-model
-
Passa a Strumenti, Generale, quindi apri Modelli per frammenti di contenuto.
-
Passa alla cartella appropriata per la configurazione o la configurazione secondaria.
-
Utilizza Crea per aprire la procedura guidata.
note caution CAUTION Se l'utilizzo di modelli per frammenti di contenuto non è stato abilitato, l'opzione Crea non sarà disponibile. -
Specifica il titolo modello.
Puoi anche definire varie proprietà; ad esempio, aggiungi Tag, Descrizione, seleziona Abilita modello per abilitare il modello se necessario e definisci
Pattern URL anteprima predefinito.note note NOTE Per informazioni dettagliate, consulta Modello per frammenti di contenuto - Proprietà. -
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.
Modello per frammenti di contenuto - Proprietà content-fragment-model-properties
Queste proprietà vengono definite al momento della creazione di un modello e possono essere modificate in un secondo momento con l'opzione Proprietà per il modello per frammenti di contenuto:
-
Base
-
Titolo modello
-
Tag
-
Descrizione
-
Abilita modello
-
Pattern URL anteprima predefinito
L'editor frammento di contenuto consente agli autori di visualizzare in anteprima il contenuto in un'applicazione front-end esterna. Una volta configurato il servizio Anteprima, aggiungere l'URL per l'applicazione front-end.L’URL di anteprima deve seguire questo pattern:
https://<preview_url>?param=${expression}
Le espressioni disponibili sono:
${contentFragment.path}
${contentFragment.model.path}
${contentFragment.model.name}
${contentFragment.variation}
${contentFragment.id}
-
Carica immagine
-
Definizione del modello per frammenti di contenuto defining-your-content-fragment-model
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:
-
Passa a Strumenti, Generale, quindi apri Modelli per frammenti di contenuto.
-
Passa alla cartella contenente il modello Frammento 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:
- a sinistra: campi già definiti
- a destra: Tipi di dati disponibili per la creazione di campi, oltre alle Proprietà da utilizzare dopo la creazione
note note NOTE Quando un campo è definito come Obbligatorio, l'Etichetta indicata nel riquadro di sinistra è contrassegnata con 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 le Proprietà che possono essere definite 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à.
-
La digitazione di un Etichetta campo completa automaticamente il Nome proprietà - se vuoto, e può essere aggiornato manualmente in seguito.
note caution CAUTION Quando si aggiorna 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.
Ad esempio:
-
-
-
Per rimuovere un campo
Seleziona il campo richiesto, quindi seleziona l’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.
Tipi di dati data-types
Per definire il modello è disponibile una selezione di tipi di dati:
-
Testo su riga singola
- Aggiungi un campo per una singola riga di testo; è possibile definire la lunghezza massima
- Il campo può essere configurato per consentire agli autori di frammenti di creare nuove istanze del campo
-
Testo su più righe
- Area di testo che può essere RTF, Testo normale o Markdown
- Il campo può essere configurato per consentire agli autori di frammenti di creare nuove istanze del campo
note note NOTE Se l'area di testo è RTF, Testo normale o Markdown, è definito nel modello dalla proprietà Tipo predefinito. Questo formato non può essere modificato dall'Editor frammento di contenuto, ma solo dal modello. -
Numero
- Aggiungere un campo numerico
- Il campo può essere configurato per consentire agli autori di frammenti di creare nuove istanze del campo
-
Booleano
- Aggiungi una casella di controllo booleana
-
Data e ora
- Aggiungere un campo data e/o ora
-
Enumerazione
- Aggiungere un set di campi Casella di controllo, Pulsante di scelta o A discesa
- Puoi specificare le opzioni disponibili per l’autore del frammento
- Aggiungere un set di campi Casella di controllo, Pulsante di scelta o A discesa
-
Tag
- Consente agli autori di frammenti di accedere alle aree dei tag e di selezionarle
-
Riferimento contenuto
- I riferimenti ad altri contenuti di qualsiasi tipo possono essere utilizzati per creare contenuto nidificato
- Se si fa riferimento a un’immagine, è possibile scegliere di mostrare una miniatura
- Il campo può essere configurato per consentire agli autori di frammenti di creare nuove istanze del campo
-
Riferimento frammento
-
I riferimenti ad altri frammenti di contenuto possono essere utilizzati per creare contenuto nidificato
-
Il campo può essere configurato per consentire agli autori di frammenti di:
- Modificare direttamente il frammento a cui si fa riferimento
- Creare un nuovo frammento di contenuto basato sul modello appropriato
- Crea nuove istanze del campo
-
-
Oggetto JSON
-
Consente all’autore del frammento di contenuto di immettere la sintassi JSON negli elementi corrispondenti di un frammento.
- Questo fa sì che AEM possa memorizzare direttamente JSON con copia e incolla da un altro servizio.
- Il codice JSON viene trasmesso e riprodotto come codice JSON in GraphQL.
- Include le funzioni di evidenziazione della sintassi JSON, completamento automatico ed evidenziazione degli errori nell’editor dei frammenti di contenuto.
-
-
Segnaposto scheda
-
Consente l’introduzione di schede da utilizzare per la modifica del contenuto di Frammenti di contenuto.
- Vengono visualizzati come divisori 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.
note note NOTE Questo tipo di dati viene utilizzato esclusivamente per la formattazione e viene ignorato dallo schema GraphQL AEM.
-
Proprietà properties
Molte proprietà sono auto-esplicative, qui sotto ulteriori dettagli per alcune proprietà:
-
Nome proprietà
Quando aggiorni manualmente questa proprietà per un tipo di dati, i nomi must contengono only A-Z, a-z, 0-9 e il carattere speciale di sottolineatura "_".
note caution CAUTION 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 visualizzerà una singola istanza del campo o se potrà creare più istanze. Quando si utilizza Campo multiplo è possibile definire il numero minimo e massimo di elementi. Per ulteriori dettagli, vedere Convalida.
-
Etichetta campo
L'immissione di un'etichetta Campo genera automaticamente un Nome proprietà, che può essere aggiornato 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:
- Formato RTF
- Markdown
- Testo normale
Se non viene specificato diversamente, 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, dopo che il frammento è stato aperto nell'editor e 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 valoreJapan
in due frammenti di contenuto dipendenti. Viene visualizzato un avviso quando si tenta di eseguire la seconda istanza.note note NOTE L’unicità è assicurata da directory principale lingua. note note NOTE 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à.
-
Traducibile
Selezionando la casella di controllo Traducibile in un campo dell’editor modelli di frammenti di contenuto:
- Fa sì che il nome della proprietà del campo sia aggiunto alla configurazione di traduzione, al contesto
/content/dam/<sites-configuration>
, se non già presente. - Per GraphQL: impostare una proprietà
<translatable>
nel campo Frammento di contenuto suyes
, per consentire al filtro query GraphQL di restituire output JSON con solo contenuto traducibile.
- Fa sì che il nome della proprietà del campo sia aggiunto alla configurazione di traduzione, al contesto
Convalida validation
Diversi tipi di dati includono ora la possibilità di definire requisiti di convalida per l’immissione di contenuto nel frammento risultante:
-
Testo su riga singola
- Confronta con un regex predefinito.
-
Numero
- Verifica la presenza di valori specifici.
-
Riferimento contenuto
- Controlla tipi specifici di contenuto.
- È possibile fare riferimento solo alle risorse di dimensioni file specificate o inferiori.
- È possibile fare riferimento solo alle immagini entro un intervallo di larghezza e/o altezza predefinito (in pixel).
-
Riferimento frammento
- Verifica un modello per frammenti di contenuto specifico.
-
Numero minimo di elementi / Numero massimo di elementi
I campi definiti come Campo multiplo (impostati con Rendering come) dispongono delle opzioni seguenti:
- Numero minimo di elementi
- Numero massimo di elementi
Convalidati nell'Editor frammento di contenuto.
Utilizzo di riferimenti per creare contenuti nidificati using-references-to-form-nested-content
I frammenti di contenuto possono formare contenuto nidificato utilizzando uno dei seguenti tipi di dati:
-
- Fornisce un semplice riferimento ad altri contenuti; di qualsiasi tipo.
- Può essere configurato per uno o più riferimenti (nel frammento risultante).
-
Riferimento frammento (frammenti nidificati)
-
Fa riferimento ad altri frammenti, a seconda dei modelli specifici indicati.
-
Consente di includere/recuperare dati strutturati.
note note NOTE Questo metodo è particolarmente interessante quando si utilizza Distribuzione di contenuti headless tramite frammenti di contenuto con GraphQL. * Può essere configurato per uno o più riferimenti (nel frammento risultante).
-
-
Riferimenti contenuto
In questo modo si impedisce all’utente di aggiungere un riferimento al frammento corrente e si potrebbe creare una finestra di dialogo di selezione Riferimento frammento 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.
Riferimento contenuto content-reference
Il Riferimento contenuto consente di eseguire il rendering del contenuto da un’altra origine, ad esempio un’immagine, una pagina o un frammento di esperienza.
Oltre alle proprietà standard puoi specificare:
-
Il percorso principale, che specifica dove memorizzare qualsiasi contenuto a cui si fa riferimento
note note NOTE Questo è obbligatorio se desideri caricare e fare riferimento direttamente alle immagini in questo campo quando utilizzi l’editor di frammenti di contenuto. Per ulteriori dettagli, vedi Immagini di riferimento. -
I tipi di contenuto a cui è possibile fare riferimento
note note NOTE Devono includere Immagine se desideri caricare e fare riferimento direttamente alle immagini in questo campo quando utilizzi l'editor di frammenti di contenuto. Per ulteriori dettagli, vedi Immagini di riferimento. -
Le limitazioni per le dimensioni dei file
-
Se si fa riferimento a un’immagine:
- Mostra miniatura
- Limiti di altezza e larghezza dell’immagine
Riferimento frammento (frammenti nidificati) fragment-reference-nested-fragments
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.
Ad esempio:
- Un modello che definisce i dettagli di un dipendente, tra cui:
- Un riferimento al modello che definisce il datore di lavoro (azienda)
type EmployeeModel {
name: String
firstName: String
company: CompanyModel
}
type CompanyModel {
name: String
street: String
city: String
}
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. Quando si aggiungono riferimenti a un 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.
- fragmentreferencecomposite: consente all’autore del frammento di creare un elemento composito selezionando più frammenti
Abilitazione o disabilitazione di un modello per frammenti di contenuto enabling-disabling-a-content-fragment-model
Puoi Abilitare o Disabilitare i modelli per frammenti di contenuto per il controllo completo sul loro utilizzo.
Abilitazione di un modello per frammenti di contenuto enabling-a-content-fragment-model
Una volta creato, il modello deve essere abilitato in modo che:
- Può essere selezionato quando si crea un frammento di contenuto.
- Possibilità di utilizzarlo come riferimento all’interno di un modello per frammento di contenuto
- Possibilità di utilizzarlo in GraphQL, affinché venga generato lo schema
Per abilitare un modello contrassegnato come:
- Bozza: nuova (mai abilitata).
- Disabilitato: che è stato specificamente disabilitato
puoi utilizzare l’opzione Abilita dalle seguenti aree:
- Dalla barra degli strumenti superiore, quando è selezionato il modello richiesto.
- Con l’azione rapida corrispondente (passando il mouse sul modello richiesto).
Disabilitazione di un modello per frammenti di contenuto disabling-a-content-fragment-model
Un modello può anche essere disabilitato, con i seguenti risultati:
-
Il modello non sarà più disponibile come base per la creazione di nuovi frammenti di contenuto.
-
Tuttavia:
- Lo schema GraphQL continua a essere generato ed è ancora interrogabile (per evitare di influenzare l’API JSON).
- È comunque possibile eseguire query su qualsiasi frammento di contenuto basato sul modello e restituirlo dall’endpoint GraphQL.
-
Non è più possibile fare riferimento al modello, ma i riferimenti esistenti vengono mantenuti intatti e possono ancora essere interrogati e restituiti dall’endpoint GraphQL.
Per disabilitare un modello contrassegnato come Abilitato, utilizzare l'opzione Disabilita da:
- Dalla barra degli strumenti superiore, quando è selezionato il modello richiesto.
- Con l’azione rapida corrispondente (passando il mouse sul modello richiesto).
Consentire modelli per frammenti di contenuto nella cartella delle risorse allowing-content-fragment-models-assets-folder
Per implementare la governance dei contenuti, puoi configurare dei Criteri nella cartella Risorse per controllare quali modelli per frammenti di contenuto sono consentiti per la creazione di frammenti in tale cartella.
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 nuove 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:
- I Criteri dei Modelli per frammenti di contenuto consentiti.
- Se vuoto, prova a determinare il criterio utilizzando le regole di ereditarietà.
- Se la catena di ereditarietà non fornisce un risultato, consulta la sezione Configurazione di Servizi cloud per quella cartella (anche prima direttamente e poi tramite ereditarietà).
- Se nessuno dei risultati di cui sopra fornisce risultati, allora non ci sono modelli consentiti per quella cartella.
Eliminazione di un modello per frammenti di contenuto deleting-a-content-fragment-model
Per eliminare un modello per frammenti di contenuto:
-
Passa a Strumenti, Generale, quindi apri Modelli per frammenti di contenuto.
-
Passa alla cartella contenente il modello Frammento di contenuto.
-
Seleziona il modello e poi Elimina dalla barra degli strumenti.
note note NOTE Se al modello viene fatto riferimento, viene visualizzato un avviso che consente di eseguire le azioni appropriate.
Pubblicazione di un modello per frammenti di contenuto publishing-a-content-fragment-model
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:
-
Passa a Strumenti, Generale, quindi apri Modelli per frammenti di contenuto.
-
Passa alla cartella contenente il modello Frammento di contenuto.
-
Seleziona il modello e poi Pubblica dalla barra degli strumenti.
Lo stato di pubblicazione viene visualizzato nella console.note note NOTE 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.
Annullamento della pubblicazione di un modello per frammenti di contenuto unpublishing-a-content-fragment-model
È possibile annullare la pubblicazione dei modelli per frammenti di contenuto se nessun frammento vi fa riferimento.
Per annullare la pubblicazione di un modello per frammenti di contenuto:
-
Passa a Strumenti, Generale, 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.
Se tenti di annullare la pubblicazione di un modello attualmente utilizzato da uno o più frammenti, viene visualizzato un avviso di errore. Ad esempio:
Il messaggio suggerisce di controllare il pannello Riferimenti per approfondire l'analisi:
Modelli per frammenti di contenuto bloccati (pubblicati) locked-published-content-fragment-models
Questa funzione garantisce la governance dei modelli per frammenti di contenuto pubblicati.
La sfida the-challenge
-
I modelli per frammenti di contenuto determinano lo schema per le query GraphQL in AEM.
-
Gli schemi GraphQL AEM vengono creati non appena viene creato un modello per frammenti di contenuto e possono esistere sia nell’ambiente di creazione che in quello di pubblicazione.
-
Gli schemi in fase di pubblicazione sono i più critici in quanto forniscono le basi per la consegna live di contenuti di frammenti di contenuto in formato JSON.
-
-
Possono verificarsi problemi quando i modelli per frammenti di contenuto vengono modificati o in altre parole modificate. Ciò significa che lo schema cambia, e questo può di conseguenza influenzare le query GraphQL esistenti.
-
L’aggiunta di nuovi campi a un modello per frammenti di contenuto non dovrebbe avere effetti negativi, in genere. Tuttavia, la modifica dei campi dati esistenti (ad esempio il nome) o l’eliminazione delle definizioni dei campi interromperà le query GraphQL esistenti quando richiedono questi campi.
Requisiti the-requirements
-
Per sensibilizzare gli utenti sui rischi derivanti dalla modifica di modelli già utilizzati per la distribuzione di contenuti live, in altre parole, di modelli pubblicati.
-
Inoltre, per evitare modifiche non desiderate.
Uno di questi criteri potrebbe interrompere le query se i modelli modificati vengono ripubblicati.
Soluzione the-solution
Per risolvere questi problemi, i modelli di frammento di contenuto sono bloccati in modalità di SOLA LETTURA su autore, non appena sono stati pubblicati. Questo stato è indicato da Bloccato:
Quando il modello è Bloccato (in modalità di SOLA LETTURA), è possibile visualizzare il contenuto e la struttura dei modelli, ma non è possibile modificarli.
Puoi gestire i modelli Bloccati dalla console o dall’editor modelli:
-
Console
Dalla console, è possibile gestire la modalità SOLA LETTURA con le azioni Sblocca e Blocca nella barra degli strumenti:
-
È possibile Sbloccare un modello per abilitare le modifiche.
Se selezioni Sblocca viene visualizzato un avviso ed è necessario confermare l'azione Sblocca:
Puoi quindi aprire il modello per la modifica.
-
Puoi anche Bloccare successivamente il modello.
-
La ripubblicazione del modello lo riporta immediatamente in modalità Bloccato (SOLA LETTURA).
-
-
Editor modelli
-
Quando apri un modello bloccato, viene visualizzato un avviso e vengono presentate tre azioni: Annulla, Visualizza sola lettura, Modifica:
-
Se si seleziona Visualizza sola lettura, è possibile visualizzare il contenuto e la struttura del modello:
-
Se selezioni Modifica, puoi modificare e salvare gli aggiornamenti:
note note NOTE Potrebbe ancora essere presente un avviso nella parte superiore, ma si verifica quando il modello è già utilizzato da frammenti di contenuto esistenti. -
Annulla ti riporta alla console.
-