Modelli per frammenti di contenuto

Ultimo aggiornamento: 2023-09-16
  • Creato per:
  • User

I modelli per frammenti di contenuto nell’AEM definiscono la struttura del contenuto per il frammenti di contenuto, fungere da base per i contenuti headless.

Per utilizzare i modelli per frammenti di contenuto, puoi:

  1. Abilita la funzionalità modello Frammento di contenuto per un’istanza.
  2. Crea e configura i modelli per frammenti di contenuto.
  3. Abilitare i modelli di frammenti di contenuto da utilizzare per la creazione di frammenti di contenuto.
  4. Consenti modelli di frammento di contenuto nelle cartelle Risorse richieste configurando i Criteri.

Creazione di un modello di frammento di contenuto

  1. Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.

  2. Passa alla cartella appropriata per configurazione.

  3. Utilizza Crea per aprire la procedura guidata.

  4. Specifica il Titolo modello. Puoi anche aggiungere Tag, a Descrizione, e seleziona Abilita modello a abilita 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 per frammento di contenuto esistente può avere un impatto sui frammenti dipendenti.

  1. Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.

  2. Passa alla cartella contenente il modello per frammenti di contenuto.

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

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

    proprietà

  4. Per aggiungere un campo

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

      tipo di dati per il campo

    • Una volta aggiunto un campo al modello, il pannello di destra mostra Proprietà che possono essere definiti 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 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, 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.

      Esempio:

      proprietà del campo

  5. Per rimuovere un campo

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

    rimuovere

  6. Aggiungi tutti i campi obbligatori e definisci le relative proprietà in base alle esigenze. Esempio:

    salva

  7. Seleziona Salva per mantenere la definizione.

Tipi di dati

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

  • Testo su riga singola
    • Aggiungi 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
    • Aggiungi 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
    • 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
  • Riferimento frammento
    • I riferimenti ad altri frammenti di contenuto possono essere utilizzati 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.
      • Creare un frammento di contenuto in base al modello appropriato
  • Oggetto JSON
    • Consente all’autore del frammento di contenuto di immettere la sintassi JSON negli elementi corrispondenti di un frammento.
      • Per consentire all’AEM di memorizzare JSON diretto che hai copiato e incollato 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 dei frammenti di contenuto.
      Nell’editor modelli viene mostrato come divisore che separa le sezioni dell’elenco dei tipi di dati di contenuto. Ogni sua istanza rappresenta l’inizio di una nuova scheda.
      Nell’editor di 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, qui sotto ulteriori dettagli per alcune proprietà:

  • Nome proprietà

    Quando si aggiorna manualmente questa proprietà per un tipo di dati, i nomi deve contain solo A-Z, a-z, 0-9 e il carattere speciale di sottolineatura "_".

    ATTENZIONE

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

  • Rendering come
    Sono disponibili varie opzioni per realizzare o riprodurre il campo in un frammento. Spesso questo consente di definire se l’autore può vedere una singola istanza del campo o se può crearne più istanze.

  • Etichetta campo
    Inserimento di un Etichetta campo genera automaticamente un Nome proprietà, che possono quindi essere aggiornati 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.

    Modifica del Tipo predefinito in un modello per frammenti di contenuto ha 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 campo Testo a riga singola denominato Country nel modello per frammenti 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 da directory principale lingua.

    NOTA

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

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
    • 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 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 periodica per:

  • Riferimenti contenuto
    Questo impedisce all’utente di aggiungere un riferimento al frammento corrente. Inoltre la finestra di dialogo selettore del riferimento frammento può risultare 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

Il Riferimento contenuto consente di eseguire il rendering del contenuto da un’altra origine, ad esempio un’immagine o un frammento di contenuto.

Oltre alle proprietà standard puoi specificare:

  • Il Percorso directory principale per qualsiasi contenuto a cui si fa riferimento
  • I tipi di contenuto a cui è possibile fare 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 contenuto

Riferimento frammento (frammenti nidificati)

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.

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. Durante l’authoring del 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

    Riferimento frammento

NOTA

È presente un meccanismo di protezione per evitare le ricorrenze. Non consente all’utente di selezionare il frammento di contenuto corrente nel riferimento frammento. Inoltre la finestra di dialogo selettore del riferimento frammento può risultare vuota.

In GraphQL è inoltre disponibile una protezione di ricorrenza per i riferimenti di frammenti. Se crei una query approfondita tra due frammenti di contenuto che si riferiscono l’uno all’altro, restituisce null.

Abilitazione o disabilitazione di un modello per frammenti di contenuto

I modelli per frammenti di contenuto dispongono di uno stato che puoi impostare per avere il controllo completo del loro utilizzo.

Abilitazione di un modello per frammenti di contenuto

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

  • Può essere selezionato quando si crea un frammento di contenuto.
  • È possibile farvi riferimento dall’interno di un modello per frammenti di contenuto.
  • È disponibile per GraphQL, pertanto viene generato lo schema.

Per abilitare un modello contrassegnato come:

  • Bozza: nuovo (mai abilitato)
  • Disabilitato : disabilitato.

È possibile utilizzare Abilita opzione da:

  • Dalla barra degli strumenti superiore, quando è selezionato il modello richiesto.
  • Con l’azione rapida corrispondente (passando il mouse sul modello richiesto).

Abilitare un modello in stato Bozza o Disabilitato

Disabilitazione di un modello per frammenti di contenuto

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 influire sull’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 disattivare un modello contrassegnato come Abilitato, utilizza Disattiva opzione da:

  • Dalla barra degli strumenti superiore, quando è selezionato il modello richiesto.
  • Con l’azione rapida corrispondente (passando il mouse sul modello richiesto).

Disattivare un modello abilitato

Consentire modelli per frammenti di contenuto nella cartella delle risorse

Per implementare la governance dei contenuti, puoi configurare Criteri in una cartella Assets per controllare quali modelli per frammenti di contenuto sono consentiti per la creazione di frammenti in tale cartella.

NOTA

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

Per configurare i Criteri dei Modelli per frammenti di contenuto consentiti:

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

  2. Apri la scheda Criteri, dove puoi configurare:

    • Ereditato da<folder>

      I criteri vengono ereditati automaticamente durante la creazione di 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.

    Criterio del modello per frammento di contenuto

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

ATTENZIONE

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

Per eliminare un modello per frammenti di contenuto:

  1. Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.

  2. Passa alla cartella contenente il modello per frammenti di contenuto.

  3. Seleziona il modello e poi Elimina dalla barra degli strumenti.

    NOTA

    Se ci sono riferimenti al modello, viene visualizzata un’avvertenza. Prendi le misure appropriate.

Pubblicazione di un modello per frammenti di contenuto

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:

  1. Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.

  2. Passa alla cartella contenente il modello per frammenti di contenuto.

  3. Seleziona il modello e poi Pubblica dalla barra degli strumenti.
    Lo stato di pubblicazione viene indicato nella console.

    NOTA

    Se pubblichi un frammento di contenuto per il quale il modello non è ancora stato pubblicato, questo viene segnalato in un elenco di selezione e il modello viene pubblicato con il frammento.

Annullamento della pubblicazione di un modello per frammenti di contenuto

Si può annullare la pubblicazione di modelli per frammenti di contenuto che non sono referenziati da alcun frammento.

Per annullare la pubblicazione di un modello per frammenti di contenuto:

  1. Accedi a Strumenti, Risorse, quindi apri Modelli per frammenti di contenuto.

  2. Passa alla cartella contenente il modello per frammenti di contenuto.

  3. Seleziona il modello e poi Annulla pubblicazione dalla barra degli strumenti.
    Lo stato di pubblicazione viene indicato nella console.

Modello per frammenti di contenuto - Proprietà

Puoi modificare le Proprietà di un modello per frammenti di contenuto:

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

In questa pagina