Capitolo 4 - Definizione dei modelli di Content Services

Il capitolo 4 del tutorial AEM Headless tratta il ruolo dei modelli AEM modificabili nel contesto di AEM Content Services. I modelli modificabili vengono utilizzati per definire la struttura del contenuto JSON che AEM Content Services espone ai clienti tramite la composizione dei componenti AEM abilitati per Content Services.

Informazioni sul ruolo dei modelli in AEM Content Services

I modelli modificabili dell’AEM vengono utilizzati per definire gli endpoint HTTP a cui si accede per esporre il contenuto dell’evento come JSON.

In genere i modelli modificabili dell’AEM vengono utilizzati per definire le pagine web, ma questo utilizzo è semplicemente una convenzione. I modelli modificabili possono essere utilizzati per comporre qualsiasi set di contenuti; la modalità di accesso a tali contenuti: come HTML in un browser, come JSON utilizzato da JavaScript (AEM SPA Editor) o da un'app mobile è una funzione del modo in cui viene richiesta la pagina.

In AEM Content Services, i modelli modificabili vengono utilizzati per definire la modalità di esposizione dei dati JSON.

Per l'app WKND Mobile verrà creato un unico modello modificabile utilizzato per gestire un singolo endpoint API. Anche se questo esempio è semplice per illustrare i concetti di headless AEM, puoi creare più pagine (o endpoint) ciascuna delle quali esporre diversi set di contenuti per creare un’API più complessa e meglio organizzata.

Informazioni sull’endpoint API

Per capire come comporre il nostro endpoint API e capire quali contenuti dovrebbero essere esposti alla nostra app WKND Mobile, rivediamo la progettazione.

Decomposizione pagina API eventi

Come possiamo vedere, abbiamo tre set logici di contenuti da fornire all’app mobile.

  1. Il Logo
  2. Linea tag
  3. Elenco di eventi

A tal fine, possiamo mappare questi requisiti sui Componenti AEM (e, nel nostro caso, sui Componenti core WCM dell’AEM) per esporre il contenuto richiesto come JSON.

  1. Il Logo viene visualizzato tramite un componente immagine
  2. La linea tag è stata rilevata tramite un componente testo
  3. L'elenco di Eventi viene visualizzato tramite un componente Elenco frammenti di contenuto che a sua volta fa riferimento a un set di frammenti di contenuto evento.
NOTE
Per supportare l'esportazione JSON di pagine e componenti da parte del servizio di contenuti AEM, le pagine e i componenti devono derivare dai componenti core WCM dell'AEM.
I componenti core WCM dell'AEM dispongono di funzionalità incorporate per supportare uno schema JSON normalizzato di pagine e componenti esportati. Tutti i componenti mobili WKND utilizzati in questa esercitazione (Pagina, Immagine, Testo e Elenco frammenti di contenuto) sono derivati dai componenti core WCM dell’AEM.

Definizione del modello API per gli eventi

  1. Passa a Strumenti > Generale > Modelli >WKND Mobile.

  2. Crea il modello Events API:

    1. Tocca Crea nella barra delle azioni superiore
    2. Seleziona il modello WKND Mobile - Empty Page
    3. Tocca Avanti nella barra delle azioni superiore
    4. Immetti Events API nel campo Titolo modello
    5. Tocca Crea nella barra delle azioni superiore
    6. Tocca Apri per aprire il nuovo modello da modificare
  3. Innanzitutto, consentiamo ai tre componenti AEM identificati di modellare il contenuto modificando il criterio del contenitore layout principale. Verificare che la modalità Struttura sia attiva, selezionare Layout Container [Root] e toccare il pulsante Criteri.

  4. In Proprietà > Componenti consentiti cercare WKND Mobile. Consentire ai seguenti componenti del gruppo di componenti WKND Mobile di utilizzarli nella pagina API Events.

    • WKND Mobile > Image

      • Logo per l’app
    • WKND Mobile > Text

      • Testo introduttivo dell’app
    • WKND Mobile > Content Fragment List

      • Elenco delle categorie di eventi disponibili per la visualizzazione nell’app
  5. Al termine, tocca il segno di spunta Fine nell'angolo superiore destro.

  6. Aggiorna la finestra del browser per visualizzare il nuovo elenco di Componenti consentiti nella barra a sinistra.

  7. Dal Finder Componenti nella barra a sinistra, trascina i seguenti Componenti AEM:

    1. Image per il logo
    2. Text per la linea di tag
    3. Content Fragment List per gli eventi
  8. Per ciascuno dei componenti precedenti, selezionarli e premere il pulsante sblocca.

  9. Verificare tuttavia che il contenitore layout sia bloccato per impedire l'aggiunta di altri componenti o la rimozione di questi tre componenti.

  10. Tocca Informazioni pagina > Visualizza in Amministratore per tornare all'elenco dei modelli WKND Mobile. Seleziona il modello Events API appena creato e tocca Abilita nella barra delle azioni superiore.

NOTE
I componenti utilizzati per far emergere il contenuto vengono aggiunti al modello e bloccati. Questo consente agli autori di modificare i componenti predefiniti, ma non di aggiungere o rimuovere arbitrariamente i componenti, in quanto la modifica dell’API stessa potrebbe interrompere i presupposti sulla struttura JSON e interrompere il consumo delle app. Tutte le API devono essere stabili.

Passaggi successivi

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

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