Definizione dei modelli per frammenti di contenuto

Ultimo aggiornamento: 5 maggio 2025
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Principiante
  • Sviluppatore

In questo capitolo, scopri come modellare il contenuto e creare uno schema con Modelli per frammenti di contenuto. Scopri i diversi tipi di dati che possono essere utilizzati per definire uno schema come parte del modello.

Vengono creati due modelli semplici: Team e Persona. Il modello dati Team contiene nome, nome breve e descrizione e fa riferimento al modello dati Person, che contiene nome completo, dettagli bio, immagine profilo e elenco occupazioni.

Puoi anche creare un modello personalizzato seguendo i passaggi di base e regolare i rispettivi passaggi, come le query GraphQL e il codice dell’app React, oppure semplicemente seguire i passaggi descritti in questi capitoli.

Prerequisiti

Questo è un tutorial in più parti e si presume che sia disponibile un ambiente di authoring AEM.

Obiettivi

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

Creare una configurazione di progetto

Una configurazione di progetto contiene tutti i modelli di Frammento di contenuto associati a un particolare progetto e fornisce un mezzo per organizzare i modelli. È necessario creare almeno un progetto prima di creare il modello per frammenti di contenuto.

  1. Accedi all'ambiente AEM Author (es. https://author-pYYYY-eXXXX.adobeaemcloud.com/)

  2. Dalla schermata iniziale di AEM, passa a Strumenti > Generale > Browser configurazioni.

    Passa a Browser configurazioni

  3. Fai clic su Crea, nell'angolo in alto a destra

  4. Nella finestra di dialogo risultante, immetti:

    • Titolo*: Progetto personale
    • Nome*: progetto personale (preferisci utilizzare lettere minuscole utilizzando i trattini per separare le parole. Questa stringa influenza l'endpoint GraphQL univoco per il quale le applicazioni client eseguono le richieste.)
    • Controlla Modelli per frammenti di contenuto
    • Controlla Query persistenti GraphQL

    Configurazione progetto personale

Creare modelli di frammenti di contenuto

Quindi, crea due modelli per un Team e una Persona.

Creare il modello della persona

Crea un modello per una Persona, che è il modello dati che rappresenta una persona che fa parte di un team.

  1. Dalla schermata iniziale di AEM, passa a Strumenti > Generale > Modelli per frammenti di contenuto.

    Passa a modelli per frammenti di contenuto

  2. Passare alla cartella Progetto personale.

  3. Tocca Crea nell'angolo superiore destro per visualizzare la procedura guidata Crea modello.

  4. Nel campo Titolo modello, immetti Persona e tocca Crea. Nella finestra di dialogo risultante, tocca Apri per generare il modello.

  5. Trascina e rilascia un elemento Testo su riga singola nel pannello principale. Immetti le seguenti proprietà nella scheda Proprietà:

    • Etichetta Campo: Nome Completo
    • Nome proprietà: fullName
    • Seleziona Obbligatorio

    Campo proprietà Nome completo

    Il Nome proprietà definisce il nome della proprietà che viene mantenuto in AEM. Il nome proprietà definisce anche il nome chiave per questa proprietà come parte dello schema dei dati. Questa chiave viene utilizzata quando i dati dei frammenti di contenuto sono esposti tramite API GraphQL.

  6. Tocca la scheda Tipi di dati e trascina un campo Testo su più righe sotto il campo Nome completo. Immetti le seguenti proprietà:

    • Etichetta Campo: Biografia
    • Nome proprietà: biographyText
    • Tipo predefinito: Testo formattato

  7. Fai clic sulla scheda Tipi di dati e trascina un campo Riferimento contenuto. Immetti le seguenti proprietà:

    • Etichetta Campo: Immagine Profilo
    • Nome proprietà: profilePicture
    • Percorso principale: /content/dam

    Durante la configurazione del percorso principale, puoi fare clic sull'icona cartella per visualizzare un modale per selezionare il percorso. Questo limita le cartelle che gli autori possono utilizzare per compilare il percorso. /content/dam è la directory principale in cui sono archiviati tutti i file AEM Assets (immagini, video e altri frammenti di contenuto).

  8. Aggiungi una convalida al Riferimento immagine in modo che solo i tipi di contenuto di Immagini possano essere utilizzati per compilare il campo.

    Limita alle immagini

  9. Fai clic sulla scheda Tipi di dati e trascina un tipo di dati Enumerazione sotto il campo Riferimento immagine. Immetti le seguenti proprietà:

    • Rendering come: Caselle di controllo
    • Etichetta Campo: Occupazione
    • Nome proprietà: occupation

  10. Aggiungi diverse opzioni utilizzando il pulsante Aggiungi un'opzione. Usa lo stesso valore per Etichetta opzione e Valore opzione:

    Artista, Influencer, Fotografo, Viaggiatore, Autore, YouTuber

  11. Il modello finale di Persona deve essere simile al seguente:

    Modello persona finale

  12. Fai clic su Salva per salvare le modifiche.

Creare il modello di team

Crea un modello per un Team, che è il modello dati per un team di persone. Il modello Team fa riferimento al modello Persona per rappresentare i membri del team.

  1. Nella cartella Progetto, tocca Crea nell'angolo superiore destro per visualizzare la procedura guidata Crea modello.

  2. Nel campo Titolo modello, immetti Team e tocca Crea.

    Tocca Apri nella finestra di dialogo risultante per aprire il modello appena creato.

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

    • Etichetta Campo: Titolo
    • Nome proprietà: title
    • Seleziona Obbligatorio

  4. Tocca la scheda Tipi di dati e trascina un elemento Testo su riga singola nel pannello principale. Immetti le seguenti proprietà nella scheda Proprietà:

    • Etichetta Campo: Nome Breve
    • Nome proprietà: shortName
    • Seleziona Obbligatorio
    • Seleziona Univoco
    • In Tipo di convalida > scegli Personalizzato
    • In Regex convalida personalizzata > immetti ^[a-z0-9\-_]{5,40}$. In questo modo è possibile immettere solo valori alfanumerici minuscoli e trattini da 5 a 40 caratteri.

    La proprietà shortName consente di eseguire query su un singolo team in base a un percorso abbreviato. L'impostazione Unique assicura che il valore sia sempre univoco per ogni frammento di contenuto di questo modello.

  5. Tocca la scheda Tipi di dati e trascina un campo Testo su più righe sotto il campo Nome breve. Immetti le seguenti proprietà:

    • Etichetta Campo: Descrizione
    • Nome proprietà: description
    • Tipo predefinito: Testo formattato

  6. Fai clic sulla scheda Tipi di dati e trascina un campo Riferimento frammento. Immetti le seguenti proprietà:

    • Rendering come: Campo multiplo
    • Etichetta Campo: Membri Team
    • Nome proprietà: teamMembers
    • Modelli per frammenti di contenuto consentiti: utilizza l'icona della cartella per selezionare il modello Person.

  7. Il modello Team finale deve essere simile al seguente:

    Modello team finale

  8. Fai clic su Salva per salvare le modifiche.

  9. Ora è necessario disporre di due modelli da utilizzare:

    Due modelli