Gestione dei modelli per frammenti di contenuto managing-content-fragment-models
Dalla console Frammenti di contenuto puoi gestire i tuoi modelli di frammenti di contenuto, quindi apri l'editor per definire la struttura.
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 come base per i contenuti headless o per l’authoring delle pagine.
Come utilizzare i modelli per frammenti di contenuto how-to-work-with-content-fragment-models
Come panoramica molto rapida, per lavorare con i modelli per frammenti di contenuto:
- Abilita la funzionalità modello Frammento di contenuto per un’istanza
- Crea il tuo modello per frammenti di contenuto.
- A questo punto puoi anche abilitare il modello (da utilizzare per la creazione di frammenti di contenuto).
- Definisci la struttura del modello.
- Abilita il modello per frammenti di contenuto, se non lo hai già fatto.
- Consenti modelli di frammento di contenuto nelle cartelle Risorse richieste configurando i Criteri.
Struttura e gestione di base dei modelli per frammenti di contenuto nella console basic-structure-handling-content-fragment-models-console
Puoi utilizzare il pannello all'estrema sinistra della console Frammenti di contenuto per selezionare Modelli per frammenti di contenuto come tipo di risorsa per visualizzare, sfogliare e gestire:
Verrà aperta la visualizzazione per i modelli per frammenti di contenuto:
Nella console puoi osservare tre aree principali:
-
Barra degli strumenti superiore
- Fornisce le funzionalità standard di AEM
- Mostra anche la tua organizzazione IMS
- Fornisce varie azioni
-
Pannello a sinistra
- Mostra i percorsi per tutte le configurazioni elencate come cartelle
- Qui puoi nascondere o visualizzare la struttura delle cartelle
- Puoi selezionare una cartella specifica della struttura
- Può essere ridimensionata per mostrare cartelle nidificate (configurazioni secondarie)
- Oltre ai modelli per frammenti di contenuto, puoi visualizzare Frammenti di contenuto o Assets; puoi anche comprimere o espandere i collegamenti ai pannelli
-
Pannello principale/destro; da qui puoi:
-
Visualizza l’elenco di tutti i modelli per frammenti di contenuto presenti nella cartella selezionata:
-
Verranno visualizzati i modelli per frammenti di contenuto della cartella selezionata e tutte le sottocartelle:
- La posizione è indicata dalle breadcrumb; queste possono essere utilizzate anche per modificare la posizione:
-
Vari campi di informazioni su un modello per frammenti di contenuto forniscono collegamenti che, a seconda del campo, possono:
- Apri il modello appropriato nell’editor
- Mostra informazioni sul percorso della configurazione
- Mostra informazioni sullo stato del modello
-
Alcuni altri campi di informazioni su un modello per frammenti di contenuto possono essere utilizzati per Filtro rapido:
- Seleziona un valore nella colonna e viene immediatamente applicato come filtro
- Il filtro rapido è supportato per le colonne Modificato da, Pubblicato da e Stato.
-
Se utilizzi il passaggio del mouse sulle intestazioni della colonna, verranno visualizzati un selettore di azioni a discesa e cursori di larghezza che ti consentono di:
- Ordinare: selezionando l’azione appropriata per ordine crescente o decrescente.
In questo modo l’intera tabella viene ordinata in base a tale colonna. L’ordinamento è disponibile solo nelle colonne appropriate. - Ridimensiona la colonna: utilizzando i cursori di azione o di larghezza
- Ordinare: selezionando l’azione appropriata per ordine crescente o decrescente.
-
Seleziona uno o più modelli per ulteriori azioni
-
-
Apri il pannello dei filtri
-
Una selezione di scelte rapide da tastiera è disponibile per questa console
-
Informazioni fornite sui modelli per frammenti di contenuto information-content-fragment-models
Il pannello principale (vista tabella) della console, a destra, fornisce una serie di informazioni sui modelli per frammenti di contenuto. Alcuni elementi forniscono anche collegamenti diretti a ulteriori azioni e/o informazioni:
-
Nome
- Fornisce un collegamento per aprire il modello nell’editor.
-
Bloccato (icona lucchetto)
- Quando il modello è bloccato, questo viene indicato da un'icona lucchetto.
-
Percorso
- Fornisce il percorso come collegamento per aprire la configurazione nella console.
Passando il puntatore del mouse sul nome della cartella verrà visualizzato il percorso JCR.
- Fornisce il percorso come collegamento per aprire la configurazione nella console.
-
Stato
- Solo informativo.
- Può essere utilizzato per Filtro rapido
-
Modificato
- Solo informativo.
-
Modificato da
- Solo informativo.
- Può essere utilizzato per Filtro rapido.
-
Tag
- Solo informativo.
- Mostra tutti i tag correlati al modello.
- Può essere utilizzato per Filtro rapido.
-
Pubblicazione
- Solo informativo.
-
Pubblicato da
- Solo informativo.
- Può essere utilizzato per Filtro rapido.
Proprietà modello model-properties
Quando selezioni un modello specifico, vengono visualizzate le proprietà del modello (come definito durante la creazione del modello). Se il modello non è Bloccato, è possibile aggiornare alcuni elementi. Per aprire e chiudere il pannello informazioni, è inoltre possibile utilizzare l'icona delle informazioni (accanto al modello Titolo).
-
Titolo
-
Tag
-
Descrizione
-
Schema URL anteprima
I modelli per frammenti di contenuto consentono 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}
Azioni actions
Dopo aver selezionato una cartella (nel pannello a sinistra) puoi utilizzare una serie di azioni, direttamente o dopo aver selezionato un modello specifico:
Azioni (non selezionate) actions-unselected
Alcune azioni sono disponibili dalla console: dopo aver selezionato una cartella, ma senza selezionare un modello per frammenti di contenuto specifico:
- Crea un nuovo modello (vuoto)
Azioni per un modello per frammenti di contenuto nella console Frammenti di contenuto actions-selected-content-fragment-models
Selezionando un modello specifico si apre una barra degli strumenti incentrata sulle azioni disponibili per tale modello. Puoi anche selezionare più modelli: le azioni disponibili verranno regolate di conseguenza.
- Modifica per definire il modello per frammenti di contenuto.
- Pubblica nei livelli Pubblica o Anteprima.
- Blocca/Sblocca per controllare se un utente è autorizzato a modificare il modello.
- Abilita/Disabilita per controllare se a un utente è consentito creare frammenti di contenuto basati su questo modello.
La selezione di un singolo modello mostra anche le proprietà modello nel pannello di destra.
Seleziona le colonne visualizzate nella console select-columns-console
Come per altre console, puoi configurare le colonne visibili e disponibili da utilizzare:
Presenta un elenco di colonne che puoi nascondere o mostrare:
Filtrare modelli per frammenti di contenuto filter-content-fragment-models
Il pannello Filtro offre:
-
una selezione di predicati;
- tra cui campi di stato, tag, utenti
- è possibile selezionare e combinare uno o più predicati per creare il filtro
Una volta selezionata, vengono visualizzate le opzioni Filtro in base a (nella parte superiore del pannello principale). Possono essere deselezionati da lì. Ad esempio:
Filtro rapido fast-filtering
Puoi anche selezionare un predicato facendo clic su un valore di colonna specifico nell’elenco. Puoi selezionare uno o più valori per combinare i predicati.
Selezionare ad esempio Abilitato nella colonna Stato. Una volta selezionato, questo verrà visualizzato come predicato di filtro e l’elenco verrà filtrato di conseguenza.
Creazione di un modello di frammento di contenuto creating-a-content-fragment-model
-
Passa alla cartella appropriata per la configurazione o la configurazione secondaria.
-
Utilizza Crea per aprire la finestra di dialogo.
note caution CAUTION L'opzione Crea sarà disponibile solo: - Se l'utilizzo dei modelli per frammenti di contenuto è stato abilitato
- dopo aver selezionato la cartella in cui desideri creare il modello.
-
Seleziona il Percorso per la configurazione e specifica il Nome.
note note NOTE La configurazione verrà compilata automaticamente con la configurazione corrente (la cartella in cui ti trovi attualmente). Puoi anche modificare la configurazione facendo clic sull’icona della cartella. Puoi anche definire varie proprietà:
- Titolo
Se immetti prima il Titolo, Nome verrà generato da questo. - una Descrizione
- Abilita modello per abilitare il modello
note note NOTE Per informazioni dettagliate, consulta Modello per frammenti di contenuto - Proprietà. 
- Titolo
-
Utilizza Crea per salvare il modello vuoto oppure Crea e apri.
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
Puoi abilitare un modello:
- Durante la creazione di un nuovo modello
- Nella finestra di dialogo viene visualizzata un’opzione.
- Quando un modello è stato specificamente Disabilitato
- Quando il modello richiesto è selezionato, l'azione Abilita è disponibile nella barra degli strumenti superiore.
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.
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.
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 e seleziona il modello per frammenti di contenuto. È possibile selezionare più modelli.
-
Seleziona Pubblica nella barra degli strumenti.
-
Nella finestra di dialogo Pubblica seleziona la Destinazione:
- Servizio di pubblicazione
- Servizio di anteprima
-
Verrà avviato il flusso di lavoro per la pubblicazione dei modelli selezionati e dei relativi riferimenti. Lo stato di pubblicazione viene quindi visualizzato nella console.
Modelli per frammenti di contenuto bloccati locked-content-fragment-models
Questa funzione consente di controllare se un modello può essere aggiornato, ma offre anche funzioni di governance per i 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 puoi 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, riceverai un avviso e verranno 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.
-