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.

  1. Scarica Advanced-GraphQL-Tutorial-Starter-Package-1.1.zip

  2. In AEM, passa a Strumenti > Distribuzione > Pacchetti per accedere a Gestione pacchetti.

  3. Carica e installa il pacchetto (file zip) scaricato nel passaggio precedente.

    Pacchetto caricato tramite Gestione pacchetti

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.

  1. Dalla pagina Avventure, seleziona Crea > Cartella nell'angolo in alto a destra.

    Crea cartella

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

    Crea cartella modale

    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:

  1. Seleziona la cartella Istruttori creata, quindi seleziona Proprietà dalla barra di navigazione superiore.

    Proprietà

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

    Icona della cartella

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

  4. Seleziona Salva e chiudi e seleziona OK nella finestra di dialogo visualizzata.

  5. È 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.

    Criteri cartella

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.

  1. 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:

    Frammento di contenuto persona

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

  1. Seleziona Nuovo frammento di contenuto sotto il campo Informazioni contatto.

    Nuovo frammento di contenuto

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

    Finestra modale Nuovo frammento di contenuto

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

    Scheda Proprietà

    Vengono visualizzati nuovi campi che consentono di modificare il frammento di contenuto Informazioni contatto.

    Frammento di contenuto Info contatto

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

  5. Per tornare al frammento di contenuto Istruttore, seleziona Jacob Wester nell'angolo in alto a sinistra dell'editor.

    Torna al frammento di contenuto originale

    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ì:

    Frammento di contenuto Jacob Wester

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

Campi
Valori
Titolo frammento di contenuto
Stacey Roswells
Nome e cognome
Stacey Roswells
Informazioni di contatto
/content/dam/wknd-shared/en/adventures/istrors/contact-info/stacey-roswells-contact-info
Immagine profilo
/content/dam/wknd-shared/en/contributors/stacey-roswells.jpg
Biografia
Stacey Roswells è un esperto arrampicatore e avventuriero alpino. Nato a Baltimora, nel Maryland, Stacey è il più giovane di sei figli. Il padre di Stacey era un tenente colonnello della US Navy e la madre era un'istruttrice di danza moderna. La famiglia di Stacey si spostò frequentemente con gli incarichi di lavoro del padre, e scattò le prime foto quando il padre era di stanza in Thailandia. Qui Stacey imparò a scalare la roccia.
Livello di esperienza istruttore
Avanzate
Competenze
Arrampicata

Kumar Selvaraj

Campi
Valori
Titolo frammento di contenuto
Kumar Selvaraj
Nome e cognome
Kumar Selvaraj
Informazioni di contatto
/content/dam/wknd-shared/en/adventures/istrors/contact-info/kumar-selvaraj-contact-info
Immagine profilo
/content/dam/wknd-shared/en/contributors/kumar-selvaraj.jpg
Biografia
Kumar Selvaraj è un istruttore professionista certificato AMGA il cui obiettivo principale è quello di aiutare gli studenti a migliorare le loro abilità di arrampicata e trekking.
Livello di esperienza istruttore
Avanzate
Competenze
Arrampicata

Ayo Ogunseinde

Campi
Valori
Titolo frammento di contenuto
Ayo Ogunseinde
Nome e cognome
Ayo Ogunseinde
Informazioni di contatto
/content/dam/wknd-shared/en/adventures/istrors/contact-info/ayo-ogunseinde-contact-info
Immagine profilo
/content/dam/wknd-shared/en/contributors/ayo-ogunseinde-237739.jpg
Biografia
Ayo Ogunseinde è un alpinista professionista e istruttore di zaino che vive a Fresno, California centrale. L'obiettivo di Ayo è quello di guidare gli escursionisti nelle loro avventure nel parco nazionale più epico.
Livello di esperienza istruttore
Avanzate
Competenze
Arrampicata

Lascia vuoto il campo Informazioni aggiuntive.

Aggiungi le seguenti informazioni nei frammenti Informazioni contatto:

Titolo frammento di contenuto
Telefono
E-mail
Informazioni di contatto Stacey Roswells
209-888-0011
sroswells@wknd.com
Kumar Selvaraj Informazioni di contatto
209-888-0002
kselvaraj@wknd.com
Informazioni di contatto Ayo Ogunseinde
209-888-0304
aogunseinde@wknd.com

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.

Cartella posizioni

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.

Segnaposto scheda

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.

Icona informazioni oggetto JSON

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:

Oggetto JSON

Aggiungi contenuto

Aggiungiamo il resto del contenuto al frammento di contenuto Posizione per eseguire una query sulle informazioni con GraphQL nel capitolo successivo.

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

  4. Con tutte le informazioni aggiunte, la scheda Dettagli località ora si presenta così:

    Scheda Dettagli località completata

  5. 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
  6. La scheda Indirizzo località completata del frammento di Parco nazionale Yosemite ha l'aspetto seguente:

    Scheda Indirizzo località completata

  7. Seleziona Salva e chiudi.

Crea un altro frammento

  1. Accedi alla cartella Yosemite Valley Lodge. Crea un frammento di contenuto utilizzando il modello di frammento di contenuto Posizione e chiamalo "Yosemite Valley Lodge".

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

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

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

    Cartella Yosemite Valley Lodge

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.

Cartella team Yosemite

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.

  1. 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."

  2. Per aggiungere un riferimento a un contenuto, seleziona l'icona Inserisci risorsa nella barra degli strumenti dell'editor di testo su più righe.

    Inserisci icona risorsa

  3. Nel modale visualizzato, seleziona team-yosemite-logo.png e premi Seleziona.

    Seleziona immagine

    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.

  1. Seleziona l'icona Inserisci frammento di contenuto nella barra degli strumenti dell'editor di testo su più righe.

    Icona Inserisci frammento di contenuto

  2. Passa a WKND Shared > Inglese > Avventure > Posizioni > Yosemite Valley Lodge > Yosemite Valley Lodge. Premi Seleziona per inserire il frammento di contenuto.

    Inserisci frammento di contenuto modale

    Il campo Descrizione è ora simile al seguente:

    Campo descrizione

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.

Visualizzazione calendario data

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.

  1. Selezionare Aggiungi nel campo Membri team.

    Pulsante Aggiungi

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

    Percorso riferimento frammento

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

    Campo membri team

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

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

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

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

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

  5. Sono stati aggiunti tre riferimenti a frammenti per un frammento di contenuto Avventura. I campi hanno un aspetto simile al seguente:

    Riferimenti a frammenti adventure

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

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4