Creare modelli di frammenti di contenuto create-content-fragment-models
Questo capitolo illustra i passaggi necessari per creare cinque modelli per frammenti di contenuto:
- Informazioni contatto
- Indirizzo
- Persona
- Dove si trova
- Team
I modelli per frammenti di contenuto consentono di definire relazioni tra i tipi di contenuto e di mantenere tali relazioni, ad esempio gli schemi. Utilizza riferimenti a frammenti nidificati, vari tipi di dati sul contenuto e il tipo di scheda per l’organizzazione del contenuto visivo. Tipi di dati più avanzati, ad esempio segnaposto per schede, riferimenti a frammenti, oggetti JSON e il tipo di dati data e ora.
Questo capitolo illustra anche come migliorare le regole di convalida per i riferimenti ai contenuti, come le immagini.
Prerequisiti prerequisites
Questo è un tutorial avanzato. Prima di procedere con questo capitolo, assicurati di aver completato la configurazione rapida. Assicurati anche di aver letto il precedente capitolo overview per ulteriori informazioni sulla configurazione dell'esercitazione avanzata.
Obiettivi objectives
- Creare modelli per frammenti di contenuto.
- Aggiungi segnaposto per schede, data e ora, oggetti JSON, riferimenti a frammenti e riferimenti a contenuti per i modelli.
- Aggiungi la convalida ai riferimenti di contenuto.
Panoramica del modello per frammenti di contenuto content-fragment-model-overview
Il video seguente fornisce una breve introduzione ai modelli per frammenti di contenuto e spiega come vengono utilizzati in questa esercitazione.
Creare modelli di frammenti di contenuto create-models
Creiamo alcuni modelli per frammenti di contenuto per l’app WKND. Se hai bisogno di un'introduzione di base alla creazione di modelli per frammenti di contenuto, consulta il capitolo appropriato nell'esercitazione di base.
-
Passa a Strumenti > Generale > Modelli per frammenti di contenuto.
-
Selezionare Condiviso WKND per visualizzare l'elenco dei modelli per frammenti di contenuto esistenti per il sito.
Modello informazioni contatto contact-info-model
Quindi, crea un modello contenente le informazioni di contatto per una persona o una posizione.
-
Seleziona Crea nell'angolo superiore destro.
-
Assegna al modello il titolo "Informazioni di contatto", quindi seleziona Crea. Nella finestra modale di completamento visualizzata, seleziona Apri per modificare il modello appena creato.
-
Per iniziare, trascina un campo Testo su riga singola nel modello. Assegnagli un Etichetta campo di "Telefono" nella scheda Proprietà. Il nome della proprietà viene compilato automaticamente come
phone. Selezionare la casella di controllo per rendere il campo Obbligatorio. -
Passa alla scheda Tipi di dati, quindi aggiungi un altro campo Testo a riga singola sotto il campo "Telefono". Assegnagli un Etichetta campo di "E-mail" e impostala su Obbligatorio.
Adobe Experience Manager viene fornito con alcuni metodi di convalida incorporati. Questi metodi di convalida ti consentono di aggiungere regole di governance a campi specifici nei modelli per frammenti di contenuto. In questo caso, aggiungiamo una regola di convalida per garantire che gli utenti possano immettere indirizzi e-mail validi solo durante la compilazione di questo campo. Nel menu a discesa Tipo di convalida, selezionare Posta elettronica.
Il modello per frammenti di contenuto completato deve essere simile al seguente:
Al termine, seleziona Salva per confermare le modifiche e chiudere l'Editor modello per frammenti di contenuto.
Modello di indirizzo address-model
Quindi, crea un modello per un indirizzo.
-
Da Condiviso WKND, seleziona Crea dall'angolo in alto a destra.
-
Immettere il titolo "Indirizzo" e selezionare Crea. Nella finestra modale di completamento visualizzata, seleziona Apri per modificare il modello appena creato.
-
Trascina e rilascia un campo Testo su riga singola sul modello e assegnagli un Etichetta campo di "Indirizzo". Il nome della proprietà viene quindi compilato come
streetAddress. Selezionare la casella di controllo Obbligatorio. -
Ripetete i passaggi precedenti e aggiungete altri quattro campi "Testo a riga singola" al modello. Utilizza le seguenti etichette:
- Città
- Stato
- Codice postale
- Paese
-
Seleziona Salva per salvare le modifiche al modello di indirizzo.
Il modello di frammento "Address" completato deve essere simile al seguente:
Modello della persona person-model
Quindi, crea un modello che contenga informazioni su una persona.
-
Nell'angolo in alto a destra, seleziona Crea.
-
Assegna al modello il titolo "Persona", quindi seleziona Crea. Nella finestra modale di completamento visualizzata, seleziona Apri per modificare il modello appena creato.
-
Per iniziare, trascina un campo Testo su riga singola nel modello. Assegnagli un Etichetta campo con "Nome completo". Il nome della proprietà viene compilato automaticamente come
fullName. Selezionare la casella di controllo per rendere il campo Obbligatorio.
-
È possibile fare riferimento ai modelli per frammenti di contenuto in altri modelli. Passa alla scheda Tipi di dati, quindi trascina e rilascia il campo Riferimento frammento e assegnagli l'etichetta "Informazioni di contatto".
-
Nella scheda Proprietà, seleziona il campo Modelli per frammenti di contenuto consentiti e fai clic sull'icona della cartella, quindi scegli il modello per frammenti Informazioni di contatto creato in precedenza.
-
Aggiungi un campo Riferimento contenuto e assegnagli un'etichetta Campo di "Immagine profilo". Seleziona l'icona della cartella in Percorso principale per aprire la finestra modale di selezione del percorso. Selezionare un percorso radice selezionando contenuto > Assets, quindi selezionando la casella di controllo per Condiviso WKND. Utilizza il pulsante Seleziona in alto a destra per salvare il percorso. Il percorso del testo finale deve contenere
/content/dam/wknd-shared.
-
In Accetta solo i tipi di contenuto specificati, selezionare "Immagine".
-
Per limitare le dimensioni e le dimensioni del file di immagine, esaminiamo alcune opzioni di convalida per il campo Riferimento contenuto.
In Accetta solo le dimensioni file specificate, selezionare "Minore o uguale a" e di seguito vengono visualizzati campi aggiuntivi.
-
Per Max, immettere "5" e per Seleziona unità, selezionare "Megabyte (MB)". Questa convalida consente di scegliere solo le immagini delle dimensioni specificate.
-
In Accetta solo la larghezza immagine specificata, selezionare "Larghezza massima". Nel campo Max (pixel) visualizzato, immettere "10000". Selezionare le stesse opzioni per Accetta solo un'altezza immagine specificata.
Queste convalide garantiscono che le immagini aggiunte non superino i valori specificati. Le regole di convalida ora dovrebbero essere simili al seguente:
-
Aggiungi un campo Testo su più righe e assegnagli un'etichetta Campo di "Biografia". Lascia l'elenco a discesa Tipo predefinito come opzione predefinita "Testo formattato".
-
Passa alla scheda Tipi di dati, quindi trascina un campo Enumerazione sotto "Biografia". Invece dell'opzione predefinita Rendering come, seleziona Elenco a discesa e assegnagli un Etichetta campo con "Livello esperienza istruttore". Immettere una selezione di opzioni a livello di esperienza istruttore come Expert, Advanced, Intermediate.
-
Trascinare quindi un altro campo Enumerazione in "Livello esperienza istruttore" e scegliere "caselle di controllo" nell'opzione Rendering come. Assegnagli un Etichetta campo di "Abilità". Acquisisci diverse abilità come arrampicata su roccia, surf, ciclismo, sci e zaino. L’etichetta dell’opzione e il valore dell’opzione devono corrispondere come segue:
-
Infine, crea un'etichetta di campo "Dettagli amministratore" utilizzando un campo Testo su più righe.
Seleziona Salva per confermare le modifiche e chiudere l'Editor modello per frammenti di contenuto.
Modello di posizione location-model
Il successivo modello per frammenti di contenuto descrive una posizione fisica. Questo modello utilizza segnaposto per tabulazioni. I segnaposto per schede consentono di organizzare i tipi di dati nell’editor modelli e il contenuto nell’editor frammenti, rispettivamente, suddividendo il contenuto in categorie. Ogni segnaposto crea una scheda, simile a una scheda in un browser Internet, nell’editor dei frammenti di contenuto. Il modello Posizione deve avere due schede: Dettagli posizione e Indirizzo posizione.
-
Come in precedenza, seleziona Crea per creare un altro modello per frammenti di contenuto. Per Titolo modello, immettete "Posizione". Seleziona Crea seguito da Apri nella finestra modale di successo visualizzata.
-
Aggiungi un campo Segnaposto scheda al modello ed etichettalo come "Dettagli posizione".
-
Trascina e rilascia un Testo su riga singola e assegnagli l'etichetta "Nome". Sotto questa etichetta di campo, aggiungi un campo testo su più righe e impostalo su "Descrizione".
-
Quindi, aggiungi un campo Riferimento frammento ed etichettalo come "Informazioni di contatto". Nella scheda delle proprietà, in Modelli per frammenti di contenuto consentiti, seleziona l'Icona cartella e scegli il modello per frammenti "Informazioni di contatto" creato in precedenza.
-
Aggiungi un campo Riferimento contenuto in "Informazioni di contatto". Etichettalo come "Immagine posizione". Il percorso principale deve essere
/content/dam/wknd-shared.In Accetta solo i tipi di contenuto specificati, selezionare "Immagine". -
Aggiungiamo anche un campo Oggetto JSON sotto "Immagine posizione". Poiché questo tipo di dati è flessibile, può essere utilizzato per visualizzare qualsiasi dato da includere nel contenuto. In questo caso, l’oggetto JSON viene utilizzato per visualizzare informazioni sul meteo. Etichetta l’oggetto JSON "Meteo per stagione". Nella scheda Proprietà, aggiungi una Descrizione in modo che sia chiaro per l'utente quali dati devono essere immessi qui: "Dati JSON relativi alla posizione dell'evento meteo per stagione (Primavera, Estate, Autunno, Inverno)."
-
Per creare la scheda Indirizzo posizione, aggiungi un campo Segnaposto scheda al modello e assegnagli l'etichetta "Indirizzo posizione".
-
Trascina e rilascia un campo Riferimento frammento e, dalla scheda delle proprietà, etichettalo come "Indirizzo" e in Modelli per frammenti di contenuto consentiti, seleziona il modello Indirizzo.
-
Seleziona Salva per confermare le modifiche e chiudere l'Editor modello per frammenti di contenuto. Il modello di percorso completato dovrebbe essere visualizzato come segue:
Modello team team-model
Infine, crea un modello che descriva un team di persone.
-
Dalla pagina Condiviso WKND, seleziona Crea per creare un altro modello per frammenti di contenuto. Per Titolo modello, immetti "Team". Come in precedenza, seleziona Crea seguito da Apri nella finestra modale di successo visualizzata.
-
Aggiungi al modulo un campo Testo su più righe. In Etichetta campo, immettere "Description".
-
Aggiungi un campo Data e ora al modello ed etichettalo come "Data di fondazione del team". In questo caso, mantenere il Tipo predefinito impostato su "Data", ma si noti che è anche possibile utilizzare "Data e ora" o "Ora".
-
Passare alla scheda Tipi di dati. Sotto la "Data di fondazione team", aggiungi un Riferimento frammento. Nel menu a discesa Rendering come, seleziona "Multifield". Per Etichetta campo, immettere "Membri team". Questo campo è collegato al modello Persona creato in precedenza. Poiché il tipo di dati è multicampo, è possibile aggiungere più frammenti di persona per creare un team di persone.
-
In Modelli per frammenti di contenuto consentiti, utilizza l'icona della cartella per aprire il modale Seleziona percorso, quindi seleziona il modello Persona. Usa il pulsante Seleziona per salvare il percorso.
-
Seleziona Salva per confermare le modifiche e chiudere l'Editor modello per frammenti di contenuto.
Aggiungere riferimenti frammento al modello di avventura fragment-references
Similmente a come il modello Team ha un riferimento frammento al modello Persona, per visualizzare questi nuovi modelli nell’app WKND è necessario fare riferimento ai modelli Team e Posizione dal modello Adventure.
-
Dalla pagina Condiviso WKND, seleziona il modello Avventura, quindi seleziona Modifica dalla navigazione superiore.
-
Nella parte inferiore del modulo, sotto "Cosa portare", aggiungi un campo Riferimento frammento. Immetti un Etichetta campo di "Posizione". In Modelli per frammenti di contenuto consentiti, selezionare il modello Posizione.
-
Aggiungi un altro campo Riferimento frammento ed etichettalo come "Team istruttore". In Modelli per frammenti di contenuto consentiti, selezionare il modello Team.
-
Aggiungi un altro campo Riferimento frammento ed etichettalo come "Amministratore".
-
Seleziona Salva per confermare le modifiche e chiudere l'Editor modello per frammenti di contenuto.
Best practice best-practices
Esistono alcune best practice relative alla creazione di modelli per frammenti di contenuto:
-
Creare modelli mappati a componenti UX. Ad esempio, l’app WKND dispone di modelli di frammenti di contenuto per avventure, articoli e posizione. Puoi anche aggiungere intestazioni, promozioni o liberatorie. Ciascuno di questi esempi costituisce un componente UX specifico.
-
Crea il minor numero di modelli possibile. Limitare il numero di modelli consente di massimizzare il riutilizzo e semplificare la gestione dei contenuti.
-
Nidifica i modelli per frammenti di contenuto con la profondità necessaria, ma solo con la necessità. Ricorda che la nidificazione viene eseguita con riferimenti a frammenti o a contenuti. Considerare un massimo di cinque livelli di nidificazione.
Congratulazioni. congratulations
Congratulazioni Ora hai aggiunto le schede, hai utilizzato i tipi di dati di oggetti data e ora e JSON e hai ulteriori informazioni sui riferimenti a frammenti e contenuti. Sono state inoltre aggiunte le regole di convalida dei riferimenti ai contenuti.
Passaggi successivi next-steps
Il prossimo capitolo di questa serie tratta la creazione di frammenti di contenuto dai modelli creati in questo capitolo. Scopri come utilizzare i tipi di dati introdotti in questo capitolo e creare criteri per cartelle per limitare quali modelli per frammenti di contenuto possono essere creati in una cartella di risorse.
Anche se è opzionale per questo tutorial, assicurati di pubblicare tutti i contenuti in situazioni di produzione reali. Per una panoramica degli ambienti di authoring e pubblicazione in AEM, consulta
Serie video AEM Headless e GraphQL.