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; modalità di accesso al contenuto: come HTML in un browser, come JSON utilizzato da JavaScript (AEM SPA Editor) o 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 WKND Mobile app, creeremo un singolo modello modificabile che viene utilizzato per guidare 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 al nostro WKND Mobile App, rivediamo il design.

Scomposizione pagina API eventi

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

  1. Il Logo
  2. Il Linea tag
  3. L’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 riprodotto tramite una Componente immagine
  2. Il Linea tag viene riprodotto tramite una Componente testo
  3. L’elenco di Eventi viene riprodotto tramite una Componente Elenco frammenti di contenuto che a sua volta fa riferimento a un insieme di Frammenti di contenuto evento.
NOTA

Per supportare l’esportazione JSON delle pagine e dei componenti da parte del servizio di contenuti AEM, le pagine e i componenti devono: derivare dai componenti core WCM dell’AEM.

Componenti core WCM AEM dispongono di funzionalità integrate 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. Accedi a Strumenti > Generale > Modelli >WKND Mobile.

  2. Creare Events API modello:

    1. Tocca Crea nella barra delle azioni superiore
    2. Seleziona la WKND Mobile - Empty Page modello
    3. Tocca Successivo nella barra delle azioni superiore
    4. Invio Events API nel Titolo modello campo
    5. Tocca Crea nella barra delle azioni superiore
    6. Tocca Apri apri il nuovo modello per la modifica

  3. Innanzitutto, permettiamo ai tre Componenti AEM identificati di modellare il contenuto modificando il Policy della radice Contenitore di layout. Assicurati che Struttura è attiva, seleziona la Layout Container [Root], e tocca il Policy pulsante.

  4. Sotto Proprietà > Componenti consentiti cerca WKND Mobile. Consenti i seguenti componenti da WKND Mobile in modo che possano essere utilizzati sulla scheda Events pagina API.

    • 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. Tocca il Fine al termine, nell’angolo in alto a destra.

  6. Aggiorna finestra del browser per visualizzare 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 di cui sopra, selezionarli e premere il tasto sblocca pulsante.

  9. Tuttavia, assicurarsi che contenitore layout è bloccato per impedire l'aggiunta di altri componenti o la rimozione di questi tre componenti.

  10. Tocca Informazioni pagina > Visualizza in Amministrazione per tornare al WKND Mobile elenco di modelli. Seleziona la nuova Events API modello e tocco Abilita nella barra delle azioni superiore.

NOTA

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 com.adobe.aem.guides.wknd-mobile.content.chapter-4.zip pacchetto di contenuti su AEM Author tramite Gestione pacchetti AEM. Questo pacchetto contiene le configurazioni e il contenuto descritti in questo e nei capitoli precedenti dell’esercitazione.

In questa pagina