Definizione dei modelli di frammenti di contenuto

In questo capitolo scopri come modellare il contenuto e creare uno schema con Modelli di frammento di contenuto. Esaminerete i modelli esistenti e creerete un nuovo modello. Inoltre, verranno illustrati i diversi tipi di dati che possono essere utilizzati per definire uno schema come parte del modello.

In questo capitolo verrà creato un nuovo modello per un Collaboratore, che è il modello dati per gli utenti che creano contenuti per la rivista e l’avventura come parte del marchio WKND.

Prerequisiti

Si tratta di un tutorial in più parti e si presume che i passaggi descritti in Configurazione rapida siano stati completati.

Obiettivi

  • Crea un nuovo modello di frammento di contenuto.
  • Identifica i tipi di dati disponibili e le opzioni di convalida per la creazione di modelli.
  • Comprendere in che modo il modello per frammenti di contenuto definisce sia lo schema dei dati che il modello di creazione per un frammento di contenuto.

Panoramica modello frammento di contenuto

Il video precedente offre una panoramica di alto livello sull’utilizzo dei modelli di frammenti di contenuto.

ATTENZIONE

Il video precedente mostra la creazione del modello Collaboratore con il nome Contributors. Quando esegui i passaggi nel tuo ambiente, accertati che il titolo utilizzi il singolo modulo: Contributor senza s. La denominazione del modello per frammenti di contenuto determina le chiamate API GraphQL che verranno eseguite in seguito nell’esercitazione.

Inspect, il modello di frammento di contenuto avventuroso

Nel capitolo precedente sono stati modificati e visualizzati su un’applicazione esterna diversi frammenti di contenuto Avventures. Esaminiamo il modello per frammenti di contenuto di avventura per comprendere lo schema dei dati sottostanti di questi frammenti.

  1. Dal menu AEM Avvio vai a Strumenti > Risorse > Modelli di frammento di contenuto.

    Passa a Modelli di frammenti di contenuto

  2. Passa la cartella Sito WKND e passa il puntatore del mouse sul modello Avventura Frammento di contenuto e fai clic sull'icona Modifica (matita) per aprire il modello.

    Apri il modello di frammento di contenuto di avventura

  3. Viene aperto l’ Editor modello frammento di contenuto. Osserva che i campi che definiscono il modello Avventura includono diversi Tipi di dati come Testo a riga singola, Testo a riga multipla, Enumerazione e Riferimento contenuto.

  4. La colonna a destra dell’editor elenca i Tipi di dati disponibili, che definiscono i campi del modulo utilizzati per la creazione di frammenti di contenuto.

  5. Seleziona il campo Titolo nel pannello principale. Nella colonna di destra fai clic sulla scheda Proprietà :

    Proprietà titolo avventura

    Osserva il campo Nome proprietà impostato su adventureTitle. Definisce il nome della proprietà persistente da AEM. Il Nome proprietà definisce anche il nome chiave per questa proprietà come parte dello schema dati. Questa chiave verrà utilizzata quando i dati dei frammenti di contenuto vengono esposti tramite API GraphQL.

    ATTENZIONE

    La modifica del Nome proprietà di un campo dopo che i frammenti di contenuto sono derivati dal modello ha effetti a valle. I valori dei campi nei frammenti esistenti non saranno più referenziati e lo schema dei dati esposto da GraphQL cambierà, influendo sulle applicazioni esistenti.

  6. Scorri verso il basso nella scheda Proprietà e visualizza il menu a discesa Tipo di convalida.

    Opzioni di convalida disponibili

    Le convalide predefinite del modulo sono disponibili per E-mail e URL. È inoltre possibile definire una convalida Personalizzata utilizzando un'espressione regolare.

  7. Fai clic su Annulla per chiudere l’Editor modello frammento di contenuto.

Creare un modello per collaboratori

Quindi, crea un nuovo modello per un Collaboratore, che è il modello di dati per gli utenti che creano contenuti per la rivista e l’avventura come parte del marchio WKND.

  1. Fai clic su Crea nell'angolo superiore destro per visualizzare la procedura guidata Crea modello.

  2. Per Titolo modello immetti: Collaboratore e fai clic su Crea

    Procedura guidata del modello a frammento di contenuto

    Fai clic su Apri per aprire il modello appena creato.

  3. Trascina un elemento Testo a riga singola nel pannello principale. Immetti le seguenti proprietà nella scheda Proprietà :

    • Etichetta campo: Nome completo
    • Nome proprietà: fullName
    • Controlla Obbligatorio

    Campo proprietà Nome completo

  4. Fai clic sulla scheda Tipi di dati e trascina e rilascia un campo Testo su più righe sotto il campo Nome completo . Immetti le seguenti proprietà:

    • Etichetta campo: Biografia
    • Nome proprietà: biographyText
    • Tipo predefinito: Rich Text
  5. Fai clic sulla scheda Tipi di dati e trascina e rilascia un campo Riferimento contenuto . Immetti le seguenti proprietà:

    • Etichetta campo: Riferimento immagine
    • Nome proprietà: pictureReference
    • Percorso directory principale: /content/dam/wknd

    Durante la configurazione del Percorso principale è possibile fare clic sull'icona cartella per visualizzare un modale per selezionare il percorso. Questo limiterà le cartelle che gli autori possono utilizzare per compilare il percorso.

    Percorso radice configurato

  6. Aggiungi una convalida al Picture Reference in modo che possano essere utilizzati solo i tipi di contenuto di Images per compilare il campo.

    Limita alle immagini

  7. Fai clic sulla scheda Tipi di dati e trascina e rilascia un tipo di dati Enumerazione sotto il campo Picture Reference . Immetti le seguenti proprietà:

    • Etichetta campo: Occupazione
    • Nome proprietà: occupation
  8. Aggiungi diversi Opzioni utilizzando il pulsante Aggiungi un'opzione . Utilizza lo stesso valore per Etichetta opzione e Valore opzione:

    Artista, Influencer, Fotografo, Viaggiatore, Scrittore, YouTuber

    Valori delle opzioni di occupazione

  9. Il modello finale Collaboratore deve essere simile al seguente:

    Modello collaboratore finale

  10. Fai clic su Salva per salvare le modifiche.

Attiva il modello per collaboratori

I modelli di frammento di contenuto devono essere abilitati prima che gli autori di contenuti possano utilizzarli. È possibile Disattivare un modello di frammento di contenuto, vietando così agli autori di utilizzarlo. Ricorda che la modifica di Nome proprietà di un campo nel modello modifica lo schema dei dati sottostanti e può avere effetti significativi a valle sui frammenti esistenti e sulle applicazioni esterne. È consigliabile pianificare con attenzione la convenzione di denominazione utilizzata per i campi Nome proprietà prima di abilitare il modello di frammento di contenuto per gli utenti.

  1. Assicurati che il modello Collaboratore sia attualmente in uno stato Abilitato.

    Modello collaboratore abilitato

    È possibile attivare o disattivare lo stato di un modello di frammento di contenuto passando con il mouse sulla scheda e facendo clic sull'icona Disattiva / Abilita .

Congratulazioni!

Congratulazioni, hai appena creato il tuo primo modello di frammento di contenuto!

Passaggi successivi

Nel capitolo successivo, Creazione di modelli di frammento di contenuto, verrà creato e modificato un nuovo frammento di contenuto basato su un modello di frammento di contenuto. Inoltre, verrà illustrato come creare varianti di frammenti di contenuto.

In questa pagina