DocumentazioneAEMTutorial su AEMTutorial di AEM Headless

Capitolo 2 - Utilizzo dei modelli per frammenti di contenuto

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Principiante
  • Sviluppatore

I modelli per frammenti di contenuto dell’AEM definiscono schemi di contenuto che possono essere utilizzati per modellare la creazione di contenuti non elaborati da parte di autori AEM. Questo approccio è simile allo scaffolding o all’authoring basato su moduli. Il concetto chiave dei frammenti di contenuto è che il contenuto creato non dipende dalla presentazione, ovvero è destinato all’uso multicanale laddove l’applicazione utente, che sia AEM, un’applicazione a pagina singola o un’app mobile, controlla il modo in cui il contenuto viene visualizzato all’utente.

La preoccupazione principale del frammento di contenuto è garantire:

  1. Il contenuto corretto viene raccolto dall’autore
  2. Il contenuto può essere esposto in un formato strutturato e ben conosciuto alle applicazioni che consumano.

Questo capitolo tratta come abilitare e definire i modelli per frammenti di contenuto utilizzati per definire una struttura di dati normalizzata e un’interfaccia di authoring per la modellazione e la creazione di "Eventi".

Abilita modelli per frammenti di contenuto

I modelli per frammenti di contenuto devono essere abilitati tramite AEM con Browser configurazioni.

Se i modelli per frammenti di contenuto sono non abilitati per una configurazione, il pulsante Crea > Frammento di contenuto non verrà visualizzato per la configurazione AEM pertinente.

NOTE
Le configurazioni AEM rappresentano un set di configurazioni tenant in base al contesto memorizzate in /conf. In genere le configurazioni AEM sono correlate a un particolare sito Web gestito in AEM Sites o a una business unit responsabile di un sottoinsieme di contenuti (risorse, pagine, ecc.) nell'AEM.
Affinché una configurazione influisca su una gerarchia di contenuti, è necessario fare riferimento alla configurazione tramite la proprietà cq:conf di tale gerarchia di contenuti. Questa operazione viene eseguita per la configurazione WKND Mobile in Passaggio 5 di seguito.
Quando si utilizza la configurazione global, questa si applica a tutto il contenuto e non è necessario impostare cq:conf.
Per ulteriori informazioni, vedere la documentazione del browser di configurazione.

  1. Accedi a AEM Author come utente con le autorizzazioni appropriate per modificare la configurazione pertinente.

    • Per questa esercitazione, è possibile utilizzare l'utente admin.

  2. Passa a Strumento > Generale > Browser configurazioni

  3. Tocca l'icona cartella accanto a WKND Mobile per selezionarla, quindi tocca il pulsante Modifica in alto a sinistra.

  4. Seleziona Modelli per frammenti di contenuto e tocca Salva e chiudi in alto a destra.

    Ciò consente l’utilizzo di modelli per frammenti di contenuto nelle strutture del contenuto della cartella risorse a cui è applicata la configurazione WKND Mobile.

    note note
    NOTE
    Questa modifica alla configurazione non è reversibile dall'interfaccia utente Web Configurazione AEM. Per annullare questa configurazione:
    code language-none 
    1. Apri [CRXDE Liti](http://localhost:4502/crx/de)
1. Passa a `/conf/wknd-mobile/settings/dam/cfm`
1. Elimina il nodo `models`
    Tutti i modelli per frammenti di contenuto esistenti creati con questa configurazione vengono eliminati e le relative definizioni memorizzate in /conf/wknd-mobile/settings/dam/cfm/models.

  5. Applica la configurazione WKND Mobile alla cartella WKND Mobiledi Assets per consentire la creazione di frammenti di contenuto da modelli per frammenti di contenuto all'interno della gerarchia di cartelle di Assets:

    1. Passa a AEM > Assets > File
    2. Seleziona la cartella WKND Mobile
    3. Tocca il pulsante Proprietà nella barra delle azioni superiore per aprire Proprietà cartella
    4. In Proprietà cartella, toccare la scheda Cloud Service
    5. Verificare che il campo Configurazione cloud sia impostato su /conf/wknd-mobile
    6. Tocca Salva e chiudi in alto a destra per mantenere le modifiche

https://video.tv.adobe.com/v/28336?quality=12&learn=on

WARNING
I modelli per frammenti di contenuto sono stati spostati da Strumenti > Assets a Strumenti > Generale.

Informazioni sul modello per frammenti di contenuto da creare

Prima di definire il modello per frammenti di contenuto, esaminiamo l’esperienza che utilizzeremo per assicurarci di acquisire tutti i punti di dati necessari. A questo scopo, esamineremo la progettazione delle applicazioni mobili e mapperemo gli elementi di progettazione in base al contenuto da raccogliere.

Possiamo suddividere i punti di dati che definiscono un Evento come segue:

Creazione del modello per frammenti di contenuto

Grazie alla mappatura è possibile definire i frammenti di contenuto utilizzati per raccogliere e infine esporre i dati dell’evento.

Creazione del modello per frammenti di contenuto

  1. Passa a Strumenti > Generale > Modelli per frammenti di contenuto.
  2. Toccare la cartella WKND Mobile per aprirla.
  3. Tocca Crea per aprire la procedura guidata per la creazione del modello per frammenti di contenuto.
  4. Immetti Event come Titolo modello (la descrizione è facoltativa) e tocca Crea per salvare.

https://video.tv.adobe.com/v/28337?quality=12&learn=on

Definizione della struttura del modello per frammenti di contenuto

  1. Passa a Strumenti > Generale > Modelli per frammenti di contenuto >WKND.

  2. Seleziona il modello per frammenti di contenuto Event e tocca Modifica nella barra delle azioni superiore.

  3. Dalla scheda Tipi di dati a destra, trascina L'input di testo a riga singola nella zona di rilascio a sinistra per definire il campo Question.

  4. Verificare che il nuovo input testo a riga singola sia selezionato a sinistra e che la scheda Proprietà sia selezionata a destra. Compila i campi Proprietà come segue:

    • Rendering come: textfield
    • Etichetta campo: Event Title
    • Nome proprietà: eventTitle
    • Lunghezza massima : 25
    • Obbligatorio: Yes

Ripeti questi passaggi utilizzando le definizioni di input definite di seguito per creare il resto del modello per frammenti di contenuto dell’evento.

NOTE
I campi Nome proprietà DEVONO corrispondere esattamente, in quanto l'applicazione Android è programmata per escludere questi nomi.

Descrizione evento

  • Tipo di dati: Multi-line text
  • Etichetta campo: Event Description
  • Nome proprietà: eventDescription
  • Tipo predefinito: Rich text

Data e ora evento

  • Tipo di dati: Date and time
  • Etichetta campo: Event Date and Time
  • Nome proprietà: eventDateAndTime
  • Obbligatorio: Yes

Tipo evento

  • Tipo di dati: Enumeration
  • Etichetta campo: Event Type
  • Nome proprietà: eventType
  • Opzioni : Art,Music,Performance,Photography

Prezzo del biglietto

  • Tipo di dati: Number
  • Rendering come: numberfield
  • Etichetta campo: Ticket Price
  • Nome proprietà: eventPrice
  • Tipo: Integer
  • Obbligatorio: Yes

Immagine evento

  • Tipo di dati: Content Reference
  • Rendering come: contentreference
  • Etichetta campo: Event Image
  • Nome proprietà: eventImage
  • Percorso principale: /content/dam/wknd-mobile/images
  • Obbligatorio: Yes

Nome sede

  • Tipo di dati: Single-line text
  • Rendering come: textfield
  • Etichetta campo: Venue Name
  • Nome proprietà: venueName
  • Lunghezza massima : 20
  • Obbligatorio: Yes

Città del luogo

  • Tipo di dati: Enumeration
  • Etichetta campo: Venue City
  • Nome proprietà: venueCity
  • Opzioni : Basel,London,Los Angeles,Paris,New York,Tokyo

https://video.tv.adobe.com/v/28335?quality=12&learn=on

NOTE
Nome proprietà indica entrambi il nome della proprietà JCR in cui è memorizzato il valore e la chiave nel file JSON. Deve essere un nome semantico che non cambierà durante il ciclo di vita del modello per frammenti di contenuto.

Dopo aver completato la creazione del modello per frammenti di contenuto, devi ottenere una definizione simile alla seguente:

Modello per frammenti di contenuto evento

Passaggio successivo

Se necessario, installa il pacchetto di contenuti com.adobe.aem.guides.wknd-mobile.content.chapter-2.zip su AEM Author tramite Gestione pacchetti AEM. Questo pacchetto contiene le configurazioni e il contenuto descritti in questa parte dell’esercitazione.

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