Creare frammenti di contenuto
Nel capitolo precedente hai creato cinque modelli per frammenti di contenuto: Persona, Team, Posizione, Indirizzo e Informazioni di contatto. Questo capitolo illustra i passaggi necessari per creare frammenti di contenuto basati su tali modelli. Inoltre, illustra come creare criteri per cartelle per limitare quali modelli per frammenti di contenuto possono essere utilizzati nella cartella.
Prerequisiti prerequisites
Questo documento fa parte di un'esercitazione in più parti. Prima di procedere con questo capitolo, assicurati che il capitolo precedente sia stato completato.
Obiettivi objectives
In questo capitolo, scopri come:
- Creare cartelle e impostare limiti utilizzando i criteri delle cartelle
- Creare riferimenti ai frammenti direttamente dall’editor frammenti di contenuto
- Utilizzare i tipi di dati Tab, Date e JSON Object
- Inserire riferimenti a contenuti e frammenti nell’editor di testo su più righe
- Aggiungere più riferimenti a frammenti
- Nidificare frammenti di contenuto
Installare il contenuto di esempio sample-content
Installa un pacchetto AEM contenente diverse cartelle e immagini di esempio utilizzate per accelerare l’esercitazione.
-
In AEM, passa a Strumenti > Distribuzione > Pacchetti per accedere a Gestione pacchetti.
-
Carica e installa il pacchetto (file zip) scaricato nel passaggio precedente.
Creare cartelle e impostare limiti utilizzando i criteri delle cartelle
Dalla home page dell'AEM, selezionare Assets > File > WKND Shared > English. Qui puoi vedere le varie categorie di Frammenti di contenuto, tra cui Avventure e Collaboratori.
Creare cartelle create-folders
Passa alla cartella Avventure. È possibile notare che sono già state create cartelle per Team e Percorsi per memorizzare i frammenti di contenuto Team e Percorsi.
Crea una cartella per i frammenti di contenuto degli istruttori basati sul modello di frammento di contenuto della persona.
-
Dalla pagina Avventure, seleziona Crea > Cartella nell'angolo in alto a destra.
-
Nella finestra modale Crea cartella visualizzata, immetti "Istruttori" nel campo Titolo. Prendi nota della "s" alla fine. I titoli delle cartelle che contengono molti frammenti devono essere plurali. Seleziona Crea.
Ora hai creato una cartella in cui archiviare Adventure Instructors.
Impostare i limiti utilizzando i criteri delle cartelle
AEM consente di definire autorizzazioni e criteri per le cartelle dei frammenti di contenuto. Utilizzando le autorizzazioni, è possibile concedere a determinati utenti (autori) o gruppi di autori l'accesso a determinate cartelle. Utilizzando i criteri per cartelle, puoi limitare ciò che gli autori di modelli per frammenti di contenuto possono utilizzare in tali cartelle. In questo esempio, limiteremo una cartella ai modelli Info persona e Info contatto. Per configurare un criterio di cartella:
-
Seleziona la cartella Istruttori creata, quindi seleziona Proprietà dalla barra di navigazione superiore.
-
Seleziona la scheda Criteri, quindi deseleziona Ereditato da /content/dam/wknd-shared. Nel campo Modelli per frammenti di contenuto consentiti per percorso, seleziona l'icona della cartella.
-
Nella finestra di dialogo Seleziona percorso visualizzata, segui il percorso conf > WKND Shared. Il modello per frammenti di contenuto persona, creato nel capitolo precedente, contiene un riferimento al modello per frammenti di contenuto Informazioni contatto. Per creare un frammento di contenuto Istruttore, nella cartella Istruttori devono essere consentiti sia i modelli di informazioni persona che quelli di informazioni contatto. Seleziona Persona e Informazioni di contatto, quindi premi Seleziona per chiudere la finestra di dialogo.
-
Seleziona Salva e chiudi e seleziona OK nella finestra di dialogo visualizzata.
-
È stato configurato un criterio di cartella per la cartella Istruttori. Passa alla cartella Istruttori e seleziona Crea > Frammento di contenuto. Gli unici modelli che è possibile selezionare sono Persona e Informazioni di contatto.
Creazione di frammenti di contenuto per istruttori
Accedi alla cartella Istruttori. Da qui, creiamo una cartella nidificata per memorizzare le informazioni di contatto degli istruttori.
Segui i passaggi descritti nella sezione relativa alla creazione di cartelle per creare una cartella denominata "Informazioni di contatto". La cartella nidificata eredita i criteri di cartella della cartella principale. Puoi configurare criteri più specifici in modo che la cartella appena creata consenta l’utilizzo solo del modello Informazioni di contatto.
Creare un frammento di contenuto Istruttore
Creiamo quattro persone che possono essere aggiunte a un team di Istruttori di Avventura.
-
Dalla cartella Istruttori, crea un frammento di contenuto basato sul modello di frammento di contenuto Persona e assegnagli il titolo "Jacob Wester".
Il nuovo frammento di contenuto creato si presenta come segue:
-
Immetti il seguente contenuto nei campi:
- Nome Completo: Jacob Wester
- Biografia: Jacob Wester è stato un istruttore di trekking per dieci anni e ne ha apprezzato ogni minuto! Jacob è un cercatore di avventura con un talento per l'arrampicata su roccia e zaino. Jacob è il vincitore delle gare di arrampicata, inclusa la gara di boulder della battaglia della baia. Jacob attualmente vive in California.
- Livello esperienza istruttore: esperto
- Abilità: arrampicata su roccia, surf, zaino
- Dettagli amministratore: Jacob Wester coordina le attività di backpacking da tre anni.
-
Nel campo Immagine profilo, aggiungi un riferimento a un'immagine. Passa a Condiviso WKND > Inglese > Collaboratori > jacob_wester.jpg per creare un percorso per l'immagine.
Creare un riferimento a un frammento dall’editor frammento di contenuto fragment-reference-from-editor
AEM consente di creare un riferimento a un frammento direttamente dall’editor di frammenti di contenuto. Creiamo un riferimento alle informazioni di contatto di Jacob.
-
Seleziona Nuovo frammento di contenuto sotto il campo Informazioni contatto.
-
Viene visualizzata la finestra modale Nuovo frammento di contenuto. Nella scheda Seleziona destinazione, segui il percorso Avventure > Istruttori e seleziona la casella di controllo accanto alla cartella Informazioni contatto. Seleziona Avanti per passare alla scheda Proprietà.
-
Nella scheda Proprietà, immetti "Jacob Wester Contact Info" nel campo Title. Seleziona Crea, quindi premi Apri nella finestra di dialogo di successo che viene visualizzata.
Vengono visualizzati nuovi campi che consentono di modificare il frammento di contenuto Informazioni contatto.
-
Immetti il seguente contenuto nei campi:
- Telefono: 209-888-0000
- E-mail: jwester@wknd.com
Al termine, selezionare Salva. È stato creato un frammento di contenuto Informazioni contatto.
-
Per tornare al frammento di contenuto Istruttore, seleziona Jacob Wester nell'angolo in alto a sinistra dell'editor.
Il campo Informazioni contatto contiene ora il percorso del frammento di informazioni di contatto di riferimento. Questo è un riferimento a un frammento nidificato. Il frammento di contenuto dell’istruttore finito si presenta così:
-
Seleziona Salva e chiudi per salvare il frammento di contenuto. Ora disponi di un nuovo Frammento di contenuto Istruttore.
Creare frammenti aggiuntivi
Segui lo stesso processo descritto nella sezione precedente per creare altri tre frammenti di contenuto Istruttori e tre frammenti di contenuto Informazioni contatto per questi Istruttori. Aggiungi il seguente contenuto nei frammenti Istruttori:
Stacey Roswells
Kumar Selvaraj
Ayo Ogunseinde
Lascia vuoto il campo Informazioni aggiuntive.
Aggiungi le seguenti informazioni nei frammenti Informazioni contatto:
Ora puoi creare un team.
Creare frammenti di contenuto per le posizioni
Passa alla cartella Percorsi. Qui puoi vedere due cartelle nidificate che sono già state create: Yosemite National Park e Yosemite Valley Lodge.
Ignora la cartella Yosemite Valley Lodge per il momento. Ritorniamo più avanti in questa sezione quando creiamo una posizione che funge da base per il nostro team di istruttori.
Accedi alla cartella Parco nazionale Yosemite. Attualmente, contiene solo un'immagine del Parco Nazionale dello Yosemite. Creiamo un frammento di contenuto utilizzando il modello di frammento di contenuto Posizione e denominalo "Parco nazionale Yosemite".
Segnaposto scheda
AEM consente di utilizzare i segnaposto per schede per raggruppare diversi tipi di contenuto e semplificare la lettura e la gestione dei frammenti di contenuto. Nel capitolo precedente, hai aggiunto segnaposto per schede al modello Posizione. Di conseguenza, il frammento di contenuto della posizione ora dispone di due sezioni di scheda: Dettagli posizione e Indirizzo posizione.
La scheda Dettagli località contiene i campi Nome, Descrizione, Informazioni contatto, Immagine località e Meteo per stagione, mentre la scheda Indirizzo località contiene un riferimento a un frammento di contenuto indirizzo. Le schede specificano chiaramente quali tipi di contenuto devono essere compilati, in modo che l’authoring dei contenuti sia più semplice da gestire.
Tipo di dati oggetto JSON
Il campo Meteo per stagione è un tipo di dati Oggetto JSON, il che significa che accetta dati in formato JSON. Questo tipo di dati è flessibile e può essere utilizzato per tutti i dati da includere nel contenuto.
Per visualizzare la descrizione del campo creata nel capitolo precedente, passa il cursore sull’icona delle informazioni a destra del campo.
In questo caso, dobbiamo fornire il tempo medio per la posizione. Immetti i dati seguenti:
{
"summer": "81 / 89°F",
"fall": "56 / 83°F",
"winter": "46 / 51°F",
"spring": "57 / 71°F"
}
Il campo Meteo per stagione ora dovrebbe essere simile al seguente:
Aggiungi contenuto
Aggiungiamo il resto del contenuto al frammento di contenuto Posizione per eseguire una query sulle informazioni con GraphQL nel capitolo successivo.
-
Nella scheda Dettagli località, immetti le seguenti informazioni nei campi:
- Nome: Parco Nazionale Yosemite
- Descrizione: Yosemite National Park si trova nelle montagne della Sierra Nevada in California. È famosa per le sue splendide cascate, gli alberi giganti di sequoia e le viste iconiche delle scogliere di El Capitan e Half Dome. Trekking e campeggio sono i modi migliori per vivere Yosemite. Numerosi percorsi offrono infinite opportunità per l'avventura e l'esplorazione.
-
Dal campo Informazioni contatto, crea un frammento di contenuto basato sul modello Informazioni contatto e assegnagli il titolo "Informazioni di contatto Parco nazionale Yosemite". Segui lo stesso processo descritto nella sezione precedente su creazione di un riferimento a un frammento dall'editor e immetti i seguenti dati nei campi:
- Telefono: 209-999-0000
- E-mail: yosemite@wknd.com
-
Dal campo Immagine posizione, passa a Avventure > Posizioni > Parco nazionale Yosemite > Parco nazionale yosemite.jpeg per creare un percorso per l'immagine.
Ricorda che nel capitolo precedente hai configurato la convalida dell’immagine, pertanto le dimensioni dell’immagine Posizione devono essere inferiori a 2560 x 1800 e le dimensioni del file devono essere inferiori a 3 MB.
-
Con tutte le informazioni aggiunte, la scheda Dettagli località ora si presenta così:
-
Passa alla scheda Indirizzo. Dal campo Indirizzo, crea un frammento di contenuto denominato "Indirizzo del parco nazionale Yosemite" utilizzando il modello per frammenti di contenuto dell'indirizzo creato nel capitolo precedente. Segui lo stesso processo descritto nella sezione relativa alla creazione di un riferimento a un frammento dall'editor e immetti i seguenti dati nei campi:
- Indirizzo: 9010 Curry Village Drive
- Città: Yosemite Valley
- Stato: CA
- Codice postale: 95389
- Paese: Stati Uniti
-
La scheda Indirizzo località completata del frammento di Parco nazionale Yosemite ha l'aspetto seguente:
-
Seleziona Salva e chiudi.
Crea un altro frammento
-
Accedi alla cartella Yosemite Valley Lodge. Crea un frammento di contenuto utilizzando il modello di frammento di contenuto Posizione e chiamalo "Yosemite Valley Lodge".
-
Nella scheda Dettagli località, immetti le seguenti informazioni nei campi:
- Nome: Yosemite Valley Lodge
- Descrizione: Yosemite Valley Lodge è un hub per le riunioni di gruppo e tutti i tipi di attività, come lo shopping, la ristorazione, la pesca, l'escursionismo e molto altro.
-
Dal campo Informazioni contatto, crea un frammento di contenuto basato sul modello Informazioni contatto e assegnagli il titolo "Informazioni di contatto di Yosemite Valley Lodge". Segui lo stesso processo descritto nella sezione relativa alla creazione di un riferimento a un frammento dall'editor e immetti i seguenti dati nei campi del nuovo frammento di contenuto:
- Telefono: 209-992-0000
- E-mail: yosemitelodge@wknd.com
Salva il frammento di contenuto appena creato.
-
Torna a Yosemite Valley Lodge e passa alla scheda Indirizzo località. Dal campo Indirizzo, crea un frammento di contenuto denominato "Indirizzo del luogo di residenza della valle di Yosemite" utilizzando il modello per frammenti di contenuto degli indirizzi creato nel capitolo precedente. Segui lo stesso processo descritto nella sezione relativa alla creazione di un riferimento a un frammento dall'editor e immetti i seguenti dati nei campi:
- Indirizzo: 9006 Yosemite Lodge Drive
- Città: Parco Nazionale Yosemite
- Stato: CA
- Codice postale: 95389
- Paese: Stati Uniti
Salva il frammento di contenuto appena creato.
-
Torna a Yosemite Valley Lodge, quindi seleziona Salva e chiudi. La cartella Yosemite Valley Lodge contiene ora tre frammenti di contenuto: Yosemite Valley Lodge, Yosemite Valley Lodge Contact Info e Yosemite Valley Lodge Address.
Creare un frammento di contenuto team
Sfoglia le cartelle in Team > Team Yosemite. È possibile vedere che la cartella Team di Yosemite contiene attualmente solo il logo del team.
Creiamo un frammento di contenuto utilizzando il modello di frammento di contenuto del team e chiamiamolo "Team Yosemite".
Riferimenti a contenuti e frammenti nell’editor di testo su più righe
AEM consente di aggiungere contenuti e riferimenti a frammenti direttamente nell’editor di testo su più righe e di recuperarli in un secondo momento utilizzando le query GraphQL. Aggiungiamo sia il contenuto che i riferimenti ai frammenti nel campo Descrizione.
-
In primo luogo, aggiungere il testo seguente nel campo Descrizione: "Il team di avventurieri professionisti e istruttori di trekking che lavorano nel Parco Nazionale Yosemite."
-
Per aggiungere un riferimento a un contenuto, seleziona l'icona Inserisci risorsa nella barra degli strumenti dell'editor di testo su più righe.
-
Nel modale visualizzato, seleziona team-yosemite-logo.png e premi Seleziona.
Il riferimento al contenuto è ora aggiunto al campo Descrizione.
Ricorda che nel capitolo precedente hai consentito l'aggiunta di riferimenti ai frammenti al campo Descrizione. Aggiungiamone uno qui.
-
Seleziona l'icona Inserisci frammento di contenuto nella barra degli strumenti dell'editor di testo su più righe.
-
Passa a WKND Shared > Inglese > Avventure > Posizioni > Yosemite Valley Lodge > Yosemite Valley Lodge. Premi Seleziona per inserire il frammento di contenuto.
Il campo Descrizione è ora simile al seguente:
Ora hai aggiunto i riferimenti a contenuto e frammento direttamente nell’editor di testo su più righe.
Tipo di dati Data e ora
Esaminiamo il tipo di dati Data e ora. Seleziona l'icona Calendario sul lato destro del campo Data di fondazione team per aprire la visualizzazione del calendario.
Le date passate o future possono essere impostate utilizzando le frecce avanti e indietro su entrambi i lati del mese. Supponiamo che il team di Yosemite sia stato fondato il 24 maggio 2016, quindi fisseremo la data per allora.
Aggiungere più riferimenti a frammenti
Aggiungiamo gli Istruttori al riferimento del frammento Membri del team.
-
Selezionare Aggiungi nel campo Membri team.
-
Nel nuovo campo visualizzato, seleziona l’icona della cartella per aprire il modale Seleziona percorso. Cerca tra le cartelle Condiviso WKND > Inglese > Avventure > Istruttori, quindi seleziona la casella di controllo accanto a jacob-wester. Premi Seleziona per salvare il percorso.
-
Selezionare il pulsante Aggiungi altre tre volte. Utilizza i nuovi campi per aggiungere i tre Istruttori rimanenti al team. Il campo Membri team è ora simile al seguente:
-
Seleziona Salva e chiudi per salvare il frammento di contenuto del team.
Aggiungere riferimenti di frammenti a un frammento di contenuto Avventura
Infine, aggiungiamo i nuovi frammenti di contenuto creati in un’avventura.
-
Passa a Avventure > Backpacking Yosemite e apri il frammento di contenuto Backpacking Yosemite. Nella parte inferiore del modulo è possibile visualizzare i tre campi creati nel capitolo precedente: Posizione, Team istruttore e Amministratore.
-
Aggiungi il riferimento al frammento nel campo Posizione. Il percorso deve fare riferimento al frammento di contenuto del parco nazionale Yosemite creato:
/content/dam/wknd-shared/en/adventures/locations/yosemite-national-park/yosemite-national-park. -
Aggiungi il riferimento al frammento nel campo Team istruttore. Il percorso del team deve fare riferimento al frammento di contenuto del team Yosemite creato:
/content/dam/wknd-shared/en/adventures/teams/yosemite-team/yosemite-team. Questo è un riferimento a un frammento nidificato. Il frammento di contenuto del team contiene un riferimento al modello Persona che fa riferimento ai modelli Informazioni di contatto e Indirizzo. Pertanto, i frammenti di contenuto nidificati si trovano a tre livelli di profondità. -
Aggiungi il riferimento al frammento nel campo Amministratore. Supponiamo che Jacob Wester sia un amministratore della Yosemite Backpacking Adventure. Il percorso deve portare al frammento di contenuto di Jacob Wester e deve essere visualizzato come segue:
/content/dam/wknd-shared/en/adventures/instructors/jacob-wester. -
Sono stati aggiunti tre riferimenti a frammenti per un frammento di contenuto Avventura. I campi hanno un aspetto simile al seguente:
-
Seleziona Salva e chiudi per salvare il contenuto.
Congratulazioni.
Congratulazioni Ora hai creato Frammenti di contenuto basati sui modelli di Frammenti di contenuto avanzati creati nel capitolo precedente. Hai anche creato un criterio di cartella per limitare quali modelli per frammenti di contenuto possono essere selezionati all’interno di una cartella.
Passaggi successivi
Nel prossimo capitolo, scopri come inviare query GraphQL avanzate utilizzando l’ambiente di sviluppo integrato (IDE) GraphiQL. Queste query ci consentono di visualizzare i dati creati in questo capitolo e, infine, di aggiungere queste query all’app WKND.