Avancerade begrepp för AEM Headless
Den här kompletta självstudiekursen fortsätter med den grundläggande självstudiekursen som täckte grunderna i Adobe Experience Manager (AEM) Headless och GraphQL. Den avancerade självstudiekursen visar ingående aspekter av att arbeta med modeller för innehållsfragment, innehållsfragment och beständiga frågor för AEM GraphQL, inklusive hur du använder beständiga frågor från GraphQL i ett klientprogram.
Förutsättningar
Slutför snabbinstallationen för AEM as a Cloud Service för att konfigurera din AEM as a Cloud Service-miljö.
Vi rekommenderar att du slutför de tidigare grundläggande självstudiekurserna och videoserierna innan du fortsätter med den här avancerade självstudiekursen. Även om du kan slutföra självstudiekursen i en lokal AEM-miljö, omfattar den här självstudiekursen bara arbetsflödet för AEM as a Cloud Service.
Mål
Den här självstudiekursen handlar om följande ämnen:
- Skapa modeller för innehållsfragment med valideringsregler och mer avancerade datatyper som platshållare för flikar, kapslade fragmentreferenser, JSON-objekt och datatyperna Datum och tid.
- Skapa innehållsfragment när du arbetar med kapslat innehåll och fragmentreferenser och konfigurera mappprinciper för styrning av innehållsfragmentutveckling.
- Utforska AEM GraphQL API-funktioner med GraphQL queries med variabler och direktiv.
- Behåll GraphQL-frågor med parametrar i AEM och lär dig hur du använder cachekontrollparametrar med beständiga frågor.
- Integrera begäran om beständiga frågor i exempelappen WKND GraphQL React med AEM Headless JavaScript SDK.
Avancerade koncept för AEM Headless - översikt
I följande video visas en översikt på hög nivå över de koncept som beskrivs i den här självstudiekursen. Självstudiekursen innehåller definition av modeller för innehållsfragment med mer avancerade datatyper, kapsling av innehållsfragment och beständiga GraphQL-frågor i AEM.
Projektinställningar
WKND-webbplatsprojektet har alla nödvändiga konfigurationer, så du kan starta självstudiekursen direkt när du har slutfört snabbinstallationen. I det här avsnittet beskrivs endast några viktiga steg som du kan använda när du skapar ett eget AEM Headless-projekt.
Granska befintlig konfiguration
Det första steget till att starta ett nytt projekt i AEM är att skapa konfigurationen, som en arbetsyta och skapa GraphQL API-slutpunkter. Om du vill granska eller skapa en konfiguration går du till Verktyg > Allmänt > Konfigurationsläsaren.
Observera att webbplatskonfigurationen WKND Shared redan har skapats för självstudiekursen. Om du vill skapa en konfiguration för ditt eget projekt väljer du Skapa i det övre högra hörnet och fyller i formuläret i Create Configuration modal som visas.
Granska GraphQL API-slutpunkter
Sedan måste du konfigurera API-slutpunkter att skicka GraphQL-frågor till. Om du vill granska befintliga slutpunkter eller skapa en går du till Verktyg > Allmänt > GraphQL.
Observera att WKND Shared Endpoint redan har skapats. Om du vill skapa en slutpunkt för projektet väljer du Skapa i det övre högra hörnet och följer arbetsflödet.
Granska WKND-innehållets struktur och språkets rotmapp
En väldefinierad innehållsstruktur är avgörande för att AEM headless-implementering ska lyckas. Det är användbart för skalbarhet, användbarhet och behörighetshantering av ditt innehåll.
En språkrotmapp är en mapp med en ISO-språkkod som namn, till exempel EN eller FR. I AEM översättningshanteringssystem används dessa mappar för att definiera det primära språket för ditt innehåll och dina språk för översättning av innehåll.
Gå till Navigering > Assets > Filer.
Gå till mappen WKND Shared. Lägg märke till mappen med titeln "English" och namnet "EN". Den här mappen är språkrotmappen för WKND-platsprojektet.
Skapa en språkrotmapp i konfigurationen för ditt eget projekt. Mer information finns i avsnittet Skapa mappar.
Tilldela en konfiguration till den kapslade mappen
Slutligen måste du tilldela projektets konfiguration till rotmappen för språket. Med det här uppdraget kan du skapa innehållsfragment baserat på de modeller för innehållsfragment som definieras i projektets konfiguration.
Om du vill tilldela språkets rotmapp till konfigurationen markerar du mappen och väljer Egenskaper i det övre navigeringsfältet.
Gå sedan till fliken Cloud-tjänster och välj mappikonen i fältet Cloud-konfiguration.
I den modal som visas väljer du den tidigare skapade konfigurationen för att tilldela språkrotmappen till den.
God praxis
Här följer några tips om hur du skapar egna projekt i AEM:
- Mapphierarkin bör utformas med lokalisering och översättning i åtanke. Språkmappar ska med andra ord kapslas i konfigurationsmappar, vilket gör det enkelt att översätta innehåll i dessa konfigurationsmappar.
- Mapphierarkin bör hållas platt och okomplicerad. Undvik att flytta eller byta namn på mappar och fragment senare, särskilt efter publicering för direktanvändning, eftersom sökvägar ändras som kan påverka fragmentreferenser och GraphQL-frågor.
Starter- och lösningspaket
Två AEM paket är tillgängliga och kan installeras via Package Manager
- Advanced-GraphQL-Tutorial-Starter-Package-1.1.zip används senare i självstudien och innehåller exempelbilder och mappar.
- Advanced-GraphQL-Tutorial-Solution-Package-1.2.zip innehåller den färdiga lösningen för kapitel 1-4 inklusive nya modeller för innehållsfragment, innehållsfragment och beständiga GraphQL-frågor. Användbar för dem som vill hoppa direkt in i kapitlet Integrering av klientprogram.
Projektet React App - Advanced Tutorial - WKND Adventures är tillgängligt för att granska och utforska exempelprogrammet. Det här exempelprogrammet hämtar innehållet från AEM genom att anropa de beständiga GraphQL-frågorna och återger det i en engagerande upplevelse.
Komma igång
Så här kommer du igång med den här avancerade självstudiekursen:
- Konfigurera en utvecklingsmiljö med AEM as a Cloud Service.
- Starta självstudiekursens kapitel i Skapa modeller för innehållsfragment.