Capitolo 4 - Definizione dei modelli di Content Services

Il capitolo 4 dell’esercitazione AEM headless descrive il ruolo dei modelli modificabili AEM contesto di Content Services AEM. I modelli modificabili vengono utilizzati per definire la struttura del contenuto JSON AEM Content Services espone ai clienti tramite la composizione di Content Services abilitato AEM Componenti.

Ruolo dei modelli in AEM Content Services

AEM Modelli modificabili vengono utilizzati per definire i punti finali HTTP a cui si accede per esporre il contenuto dell’evento come JSON.

Tradizionalmente, i modelli modificabili vengono utilizzati per definire le pagine web, ma questo utilizzo è semplicemente una convenzione. I modelli modificabili possono essere utilizzati per la composizione qualsiasi insieme del contenuto; modalità di accesso a tale contenuto: come HTML in un browser, in quanto JSON utilizzato da JavaScript (AEM editor di SPA) o da un’app mobile è una funzione del modo in cui viene richiesta tale pagina.

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

Per WKND Mobile L’app creerà un singolo modello modificabile utilizzato per indirizzare un singolo endpoint API. Anche se questo esempio è semplice per illustrare i concetti di AEM headless, puoi creare più pagine (o endpoint) ciascuna con diversi set di contenuti da esporre per creare un’API più complessa e meglio organizzata.

Informazioni sul punto finale dell’API

Per comprendere come comporre il nostro endpoint API e capire quale contenuto deve essere esposto al nostro WKND Mobile App, rivediamo la progettazione.

Decomposizione della pagina API degli eventi

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

  1. La Logo
  2. La Riga tag
  3. L'elenco di Eventi

A questo scopo, possiamo mappare questi requisiti sui componenti AEM (e, nel nostro caso, sui componenti core AEM WCM) per esporre il contenuto richiesto come JSON.

  1. La Logo viene visualizzata tramite un Componente immagine
  2. La Riga tag viene visualizzata tramite un Componente testo
  3. L'elenco di Eventi viene visualizzata tramite un Componente Elenco frammenti di contenuto che a sua volta fa riferimento a un set di frammenti di contenuto evento.
NOTA

Per supportare AEM’esportazione JSON di pagine e componenti da parte di Content Service, le pagine e i componenti devono derivano AEM componenti core WCM.

AEM componenti core WCM dispongono di funzionalità incorporate per supportare uno schema JSON normalizzato di pagine e componenti esportati. Tutti i componenti WKND Mobile utilizzati in questa esercitazione (Pagina, Immagine, Testo ed Elenco frammenti di contenuto) sono derivati AEM componenti core WCM.

Definizione del modello API per gli eventi

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

  2. Crea il Events API modello:

    1. Tocca Crea nella barra delle azioni superiore
    2. Seleziona la WKND Mobile - Empty Page template
    3. Tocca Successivo nella barra delle azioni superiore
    4. Invio Events API in Titolo modello field
    5. Tocca Crea nella barra delle azioni superiore
    6. Tocca Apri apri il nuovo modello per la modifica
  3. In primo luogo, consentiamo ai tre componenti AEM identificati di modellare il contenuto modificando il Criterio della radice Contenitore di layout. Assicurati che Struttura modalità attiva, seleziona la Layout Container [Root] e tocca Criterio pulsante .

  4. Sotto Proprietà > Componenti consentiti cercare WKND Mobile. Consenti i seguenti componenti dalla WKND Mobile gruppo di componenti in modo che possano essere utilizzati Events Pagina API.

    • WKND Mobile > Image

      • Logo dell’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 Fine segno di spunta nell'angolo superiore destro al termine.

  6. Aggiorna la finestra del browser per visualizzare la nuova Componenti consentiti nella barra a sinistra.

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

    1. Image per il logo
    2. Text per la riga tag
    3. Content Fragment List per gli eventi
  8. Per ciascuno dei componenti di cui sopra, selezionali e premi il pulsante sbloccare pulsante .

  9. Tuttavia, assicurati che Contenitore di layout è bloccato per evitare l’aggiunta di altri componenti o la rimozione di questi tre componenti.

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

NOTA

I componenti utilizzati per la visualizzazione del contenuto vengono aggiunti al modello stesso e bloccati. Questo consente agli autori di modificare i componenti predefiniti, ma non di aggiungere o rimuovere in modo arbitrario i componenti, in quanto la modifica dell’API stessa potrebbe interrompere i presupposti intorno alla struttura JSON e interrompere le app consumiste. Tutte le API devono essere stabili.

Passaggi successivi

Facoltativamente, installa il com.adobe.aem.guides.wknd-mobile.content.capitolo-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 precedenti capitoli dell'esercitazione.

In questa pagina