Capitolo 5 - Authoring delle pagine di Content Services
Il capitolo 5 del tutorial AEM headless tratta la creazione della pagina dai modelli definiti nel capitolo 4. La pagina creata in questo capitolo fungerà da endpoint HTTP JSON per l’app mobile.
/content/wknd-mobile/en/api è stata predefinita. Le pagine di base di en e api hanno uno scopo architettonico e organizzativo, ma non sono strettamente necessarie. Se il contenuto API può essere localizzato, è consigliabile seguire le usuali best practice di organizzazione delle pagine Copia in lingua e Gestore multisito, in quanto la pagina API può essere localizzata come qualsiasi pagina di AEM Sites.Creazione della pagina API dell’evento
-
Passa a AEM > Siti > WKND Mobile > English >API.
-
Tocca l'etichetta della pagina API, quindi tocca il pulsante Crea nella barra delle azioni superiore e crea una nuova pagina API degli eventi nella pagina API.
- Tocca Crea nella barra delle azioni superiore
- Seleziona modello Eventi API
- Nel campo Nome immetti eventi
- Nel campo Titolo immetti API eventi
- Tocca Crea nella barra delle azioni superiore per creare la pagina
- Tocca Fine per tornare all'amministratore AEM Sites
Creazione della pagina API degli eventi
-
Modificare la pagina Events API passando a AEM > Sites > WKND Mobile > English > API, selezionando la pagina Events API e toccando Edit nella barra delle azioni superiore.
-
Aggiungi un'immagine logo da visualizzare nell'app trascinandola da Asset Finder al segnaposto del componente Immagine.
- Utilizza il logo fornito trovato in
/content/dam/wknd-mobile/images/wknd-logo.png.
- Utilizza il logo fornito trovato in
-
Aggiungi riga di tag da visualizzare sopra gli eventi.
- Modifica il componente Testo
- Immettere il testo:
The WKND is here.
-
Seleziona eventi da visualizzare:
-
Imposta la seguente configurazione nella scheda Proprietà:
- Modello: Evento
- Percorso principale: /content/dam/wknd-mobile/en/events
- Tag: <Lascia vuoto>
-
Imposta la seguente configurazione nella scheda Elementi:
- Rimuovi eventuali elementi elencati per garantire che SIANO ESPOSTI TUTTI gli elementi dei Frammenti di contenuto dell’evento.
-
Rivedi l’output JSON della pagina API
L'output JSON e il relativo formato possono essere rivisti richiedendo la pagina con il selettore .model.json.
Questa struttura JSON (o schema) deve essere ben compresa dai consumatori di questa API. È fondamentale che i consumatori di API comprendano quali aspetti della struttura siano fissi (ossia. il logo (immagine) e il tag live (testo) dell’API degli eventi e che sono fluidi (ad esempio gli eventi elencati in Componente Elenco frammenti di contenuto).
L’interruzione di questo contratto su un’API pubblicata può causare un comportamento errato nell’utilizzo delle app.
-
Nelle nuove schede del browser, richiedi le pagine API degli eventi utilizzando il selettore
.model.json, che richiama l’esportazione JSON di AEM Content Services e serializza la pagina e i componenti in una struttura JSON normalizzata e ben definita.La struttura JSON prodotta da queste pagine è quella a cui le app che utilizzano la struttura devono allinearsi.
-
Richiedi la pagina Events API come JSON.
Il risultato dovrebbe essere simile al seguente:
.tidy:Passaggio successivo
Se necessario, installa il pacchetto di contenuti com.adobe.aem.guides.wknd-mobile.content.chapter-5.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.