Modelli per frammenti di contenuto

NOTA

I modelli per frammenti di contenuto in AEM definiscono la struttura del contenuto per i frammenti di contenuto, che fungono da base per i contenuti headless.

Per utilizzare i modelli di frammento di contenuto:

  1. Abilita la funzionalità del modello di frammento di contenuto per la tua istanza
  2. Creare e configurare i modelli per frammenti di contenuto
  3. Abilitare i modelli di frammenti di contenuto per l’uso durante la creazione di frammenti di contenuto per la creazione di frammenti di contenuto
  4. Consenti modelli di frammenti di contenuto nelle cartelle Risorse richieste configurando Criteri.

Creazione di un modello di frammento di contenuto

  1. Passa a Strumenti, Risorse, quindi apri Modelli di frammento di contenuto.

  2. Passa alla cartella appropriata per la configurazione.

  3. Utilizza Crea per aprire la procedura guidata.

    ATTENZIONE

    Se l'utilizzo dei modelli di frammento di contenuto non è stato abilitato, l'opzione Crea non sarà disponibile.

  4. Specifica il Titolo modello. Puoi anche aggiungere Tag, una Descrizione e selezionare Abilita modello per abilitare il modello se necessario.

    titolo e descrizione

  5. 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.

Definizione del modello per frammenti di contenuto

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:

ATTENZIONE

La modifica di un modello di frammento di contenuto esistente può avere un impatto sui frammenti dipendenti.

  1. Passa a Strumenti, Risorse, quindi apri Modelli di frammento di contenuto.

  2. Passa alla cartella contenente il modello di frammento di contenuto.

  3. 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:

    • sinistra: campi già definiti
    • A destra: Tipi di dati disponibili per la creazione di campi, oltre alle Proprietà da utilizzare dopo la creazione.
    NOTA

    Quando un campo è obbligatorio, l’Etichetta indicata nel riquadro a sinistra sarà contrassegnata con un asterisco (*).

proprietà

  1. Aggiunta di un campo

    • Trascina un tipo di dati obbligatorio nella posizione desiderata per un campo:

      tipo di dati a 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 autoesplicative. Per ulteriori informazioni, consulta Proprietà.

      • Digitando un Etichetta campo si completa automaticamente il Nome proprietà, se vuoto, e può essere aggiornato manualmente in seguito.

        ATTENZIONE

        Quando aggiorni manualmente la proprietà Nome proprietà per un tipo di dati, tieni presente che i nomi devono contenere solo caratteri latini, cifre numeriche 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.

      Esempio:

      proprietà del campo

  2. Rimozione di un campo

    Seleziona il campo richiesto, quindi tocca o fai clic sull’icona del cestino. Viene richiesto di confermare l’operazione.

    rimuovere

  3. Add all required fields, and define the related properties, as required. Esempio:

    save

  4. Selezionare Salva per mantenere la definizione.

Tipi di dati

Per definire il modello è disponibile una selezione di tipi di dati:

  • Testo su riga singola
    • aggiungere uno o più campi di una singola riga di testo; la lunghezza massima può essere definita
  • Testo su più righe
    • Area di testo che può essere RTF, testo normale o Markdown
  • Numero
    • Aggiungi uno o più campi numerici
  • Booleano
    • Aggiungi una casella di controllo booleana
  • Data e ora
    • Aggiungere una data e/o un’ora
  • Enumerazione
    • Aggiungere un set di caselle di controllo, pulsanti di scelta o campi a discesa
  • Tag
    • Consente agli autori di frammenti di accedere alle aree dei tag e di selezionarle
  • Riferimento contenuto
    • riferimenti ad altri contenuti di qualsiasi tipo; può essere utilizzato per creare contenuto nidificato
    • Se si fa riferimento a un'immagine, è possibile scegliere di mostrare una miniatura
  • Riferimento frammento
    • fa riferimento ad altri frammenti di contenuto; può essere utilizzato per creare contenuto nidificato
    • Il tipo di dati può essere configurato in modo da consentire agli autori di frammenti di:
      • Modificare direttamente il frammento a cui si fa riferimento.
      • Crea un nuovo frammento di contenuto basato sul modello appropriato
  • Oggetto JSON
    • Consente all’autore del frammento di contenuto di immettere la sintassi JSON negli elementi corrispondenti di un frammento.
      • Per consentire AEM memorizzare JSON diretto che hai copiato/incollato da un altro servizio.
      • Il JSON verrà trasmesso e trasmesso come JSON in GraphQL.
      • Include l’evidenziazione della sintassi JSON, il completamento automatico e l’evidenziazione degli errori nell’editor dei frammenti di contenuto.
  • Segnaposto scheda
    • 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 .

      NOTA

      Questo tipo di dati viene utilizzato esclusivamente per la formattazione e viene ignorato dallo schema GraphQL AEM.

Proprietà

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 devono contenere solo caratteri latini, cifre numeriche e trattino basso "_" come carattere speciale.

    ATTENZIONE

    Se i modelli creati in versioni precedenti di AEM contengono caratteri non validi, rimuovi o aggiorna tali caratteri.

  • Rendering
    comeLe 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 campoInserimento di un campo

L’ etichetta del campo genera automaticamente un Nome proprietà, che può 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, consulta Convalida .

  • Per il tipo di dati Testo su più righe è possibile definire il Tipo predefinito come:

    • Formato RTF
    • Markdown
    • Testo normale

    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 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 frammento 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.

    NOTA

    L'unicità è assicurata per radice linguistica.

    NOTA

    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.

  • Per ulteriori informazioni su quel tipo di dati specifico e sulle relative proprietà, consulta Riferimento contenuto .

  • Per ulteriori informazioni sul tipo di dati specifico e sulle relative proprietà, consulta Riferimento frammento (frammenti nidificati) .

Convalida

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
    • Test for specific types of content.
    • È 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
    • Test di un modello di frammento di contenuto specifico.

Utilizzo di riferimenti per creare contenuti nidificati

I frammenti di contenuto possono formare contenuto nidificato utilizzando uno dei seguenti tipi di dati:

NOTA

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.

Riferimento contenuto

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 percorso principale per qualsiasi contenuto di riferimento
  • Tipi di contenuto a cui è possibile fare riferimento
  • Limitazioni per le dimensioni dei file
  • Se si fa riferimento a un'immagine:
    • Mostra miniatura
    • Restrizioni dell'altezza e della larghezza dell'immagine

Riferimento contenuto

Riferimento frammento (frammenti nidificati)

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:

  • 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
}
NOTA

Questo è di particolare interesse in combinazione con 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 singoli

    • fragmentreference - allows the fragment author to select a single reference to a fragment

  • Model Type
    Multiple models can be selected. When authoring the Content Fragment any referenced fragments must have been created using these models.

  • Root
    PathSpecifica un percorso principale per tutti i frammenti a cui viene fatto riferimento.

  • Consenti creazione di frammenti

    This will allow the fragment author to create a new fragment based on the appropriate model.

    • fragmentreferencecomposite : consente all’autore del frammento di creare un composito selezionando più frammenti

    Riferimento frammento

NOTA

A recurrence protection mechanism is in place. 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.

Modello frammento di contenuto - Proprietà

Puoi modificare le Proprietà di un modello di frammento di contenuto:

  • Base
    • Titolo modello
    • Tag
    • Descrizione
    • Carica immagine

Abilitazione o disabilitazione di un modello di frammento di contenuto

Per un controllo completo sull’utilizzo dei modelli di frammenti di contenuto, è possibile impostare uno stato .

Abilitazione di un modello per frammenti di contenuto

Una volta creato un modello, questo deve essere abilitato in modo che:

  • È disponibile per la selezione durante la creazione di un nuovo frammento di contenuto.
  • Can be referenced from within a Content Fragment Model.
  • Is available to GraphQL; so the schema is generated.

Per abilitare un modello contrassegnato come:

  • Bozza : mew (mai attivato).
  • Disabilitato : è stato specificamente disabilitato.

Puoi utilizzare l'opzione Abilita da:

  • La barra degli strumenti superiore, quando è selezionato il modello richiesto.
  • Azione rapida corrispondente (passa il mouse sul modello richiesto).

Abilita bozza o modello disabilitato

Disabilitazione di un modello di frammento di contenuto

Un modello può anche essere disabilitato in modo che:

  • Il modello non è più disponibile come base per la creazione di nuovi frammenti di contenuto.
  • However:
    • 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 si utilizza l'opzione Disabilita da:

  • La barra degli strumenti superiore, quando è selezionato il modello richiesto.
  • Azione rapida corrispondente (passa il mouse sul modello richiesto).

Disattiva un modello abilitato

Consentire modelli di frammenti di contenuto nella cartella delle risorse

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 dei frammenti in tale cartella.

NOTA

Il meccanismo è simile a consentire i modelli di pagina per una pagina e i relativi elementi secondari, nelle proprietà avanzate di una pagina.

Per configurare Criteri per Modelli di frammento di contenuto consentiti:

  1. Naviga e apri Proprietà per la cartella Risorse richiesta.

  2. Apri la scheda Criteri , dove puoi configurare:

    • Ereditato da<folder>

      Policies are automatically inherited when creating new child folders; the policy can be reconfigured (and the inheritance broken) if sub-folders need to allow models different to the parent folder.

    • Modelli per frammenti di contenuto consentiti per percorso

      Possono essere consentiti più modelli.

    • Modelli di frammenti di contenuto consentiti per tag

      Multiple models can be allowed.
      Criterio modello frammento di contenuto

  3. Save any changes.

The Content Fragment Models allowed for a folder are resolved as follows:

  • I Criteri per Modelli di frammento di contenuto consentiti.
  • Se vuoto, prova a determinare il criterio utilizzando le regole di ereditarietà.
  • Se la catena di ereditarietà non fornisce un risultato, controlla la configurazione Cloud Services per quella cartella (anche prima direttamente e poi tramite ereditarietà).
  • If none of the above deliver any results, then there are no allowed models for that folder.

Eliminazione di un modello di frammento di contenuto

ATTENZIONE

L’eliminazione di un modello di frammento di contenuto può avere un impatto sui frammenti dipendenti.

Per eliminare un modello di frammento di contenuto:

  1. Passa a Strumenti, Risorse, quindi apri Modelli di frammento di contenuto.

  2. Passa alla cartella contenente il modello di frammento di contenuto.

  3. Select your model, followed by Delete from the toolbar.

    NOTA

    If the model is referenced a warning will be given. Agisci in modo appropriato.

Pubblicazione di un modello di frammento di contenuto

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:

  1. Passa a Strumenti, Risorse, quindi apri Modelli di frammento di contenuto.

  2. Passa alla cartella contenente il modello di frammento di contenuto.

  3. Seleziona il modello, seguito da Pubblica dalla barra degli strumenti.
    Lo stato di pubblicazione sarà indicato nella console.

    NOTA

    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 di frammento di contenuto

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:

  1. Passa a Strumenti, Risorse, quindi apri Modelli di frammento di contenuto.

  2. Passa alla cartella contenente il modello di frammento di contenuto.

  3. Select your model, followed by Unpublish from the toolbar.
    Lo stato di pubblicazione sarà indicato nella console.

Se tenti di annullare la pubblicazione di un modello attualmente utilizzato da uno o più frammenti, un avviso di errore segnala quanto segue:

Content Fragment Model error message when unpublishing a model that is in use

Il messaggio ti consiglierà di controllare il pannello Riferimenti per ulteriori informazioni:

Modello per frammento di contenuto nei riferimenti

Modelli per frammenti di contenuto bloccati (pubblicati)

NOTA

La funzione Modelli per frammenti di contenuto bloccati (pubblicati) è in versione beta.

Questa funzione fornisce la governance dei modelli di frammenti di contenuto pubblicati.

La sfida

  • I modelli per frammenti di contenuto determinano lo schema per le query GraphQL in AEM.

    • AEM gli schemi GraphQL 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 distribuzione live di contenuti di frammenti di contenuto in formato JSON.

  • Possono verificarsi problemi quando i modelli di frammento di contenuto vengono modificati o in altre parole modificati. Ciò significa che lo schema cambia, che a sua volta può influenzare le query GraphQL esistenti.

  • L’aggiunta di nuovi campi a un modello di frammento di contenuto non dovrebbe avere effetti negativi, in genere. Tuttavia, la modifica dei campi dati esistenti (ad esempio il loro nome) o l’eliminazione delle definizioni dei campi interromperà le query GraphQL esistenti quando richiedono questi campi.

Requisiti

  • 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.

Una di queste potrebbe interrompere le query se i modelli modificati vengono ripubblicati.

La soluzione

Per risolvere questi problemi, i modelli di frammenti di contenuto sono bloccati in modalità DI SOLA LETTURA sull'autore, non appena pubblicati. Questo è indicato da Bloccato:

Scheda del modello frammento di contenuto 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à DI SOLA LETTURA con le azioni Sblocca e Blocca nella barra degli strumenti:

    Barra degli strumenti del modello frammento di contenuto bloccato

    • È possibile Sbloccare un modello per abilitare le modifiche.

      Se selezioni Sblocca verrà visualizzato un avviso e devi confermare l'azione Sblocca:
      Messaggio durante lo sblocco del modello di frammento di contenuto

      You can then open the model for editing.

    • You can also Lock the model afterwards.

    • Re-publishing the model will immediately put it back into Locked (READ-ONLY) mode.

  • Editor modelli

    • Quando apri un modello bloccato, viene visualizzato un avviso e vengono presentate tre azioni: Annulla, Visualizza solo lettura, Modifica:

      Message when viewing a locked Content Fragment Model

    • Se selezioni Visualizza solo lettura puoi vedere il contenuto e la struttura del modello:

      Visualizza solo lettura - Modello frammento di contenuto bloccato

    • If you select Edit you can edit and save your updates:

      Modifica - Modello frammento di contenuto bloccato

      NOTA

      There may still a warning at the top, but that is when the model is already in use by existing Content Fragments.

    • ​L’opzione Annulla consente di tornare alla console.

In questa pagina