Bästa tillvägagångssätt för installation och användning av AEM GraphQL med innehållsfragment best-practices-setup-use-aem-graphql-content-fragments

I dessa riktlinjer sammanfattas de rekommenderade bästa sätten att konfigurera, konfigurera och använda AEM med GraphQL- och Content Fragments.

Komma igång getting-started

Så här kommer du igång:

Inställningar setup

Om du vill konfigurera AEM GraphQL för användning med innehållsfragment och dina appar måste du konfigurera olika komponenter.

Skapa GraphQL-slutpunkter (inklusive säkerhet) graphql-endpoint-creation

Slutpunkten är den sökväg som används för att komma åt GraphQL för AEM. Dessa slutpunkter måste skapas och publiceras så att de kan nås på ett säkert sätt.

Information details-graphql-endpoint-creation

Hantera GraphQL-slutpunkter i AEM

Miljö environments-graphql-endpoint-creation

Slutpunkter måste konfigureras i:

För:

AEM Dispatcher-cachning dispatcher-caching

Cachelagring av beständiga frågor är inte aktiverat som standard i Dispatcher. Standardaktivering är inte möjlig eftersom kunder som använder CORS (Cross-Origin Resource Sharing) med flera ursprung måste granska och eventuellt uppdatera sin Dispatcher-konfiguration.

Information details-dispatcher-caching

GraphQL Persisted Queries - aktivera cachelagring i Dispatcher

Miljö environments-dispatcher-caching

Dispatcher är vanligtvis konfigurerat för:

CORS-inställningar cors-setup

För att komma åt GraphQL-slutpunkten måste en CORS-princip konfigureras och läggas till i ett AEM som distribueras till AEM via Cloud Manager. Detta görs genom att en lämplig OSGi CORS-konfigurationsfil läggs till för de önskade slutpunkterna.

Information details-cors-setup

CORS-konfiguration (Cross-Origin Resource Sharing)

Miljö environments-cors-setup

CORS är vanligtvis konfigurerad för:

Autentisering authentication

Ett primärt användningsexempel för Adobe Experience Manager as a Cloud Service (AEM) GraphQL API for Content Fragment Delivery är att ta emot fjärrfrågor från tredjepartsprogram eller -tjänster. Dessa fjärrfrågor kan kräva autentiserad API-åtkomst för säker leverans av headless-innehåll.

Information details-authentication

Autentisering för fjärrfrågor AEM GraphQL-frågor om innehållsfragment

Miljö environments-authentication

Autentisering är vanligtvis konfigurerad för:

För:

Behörigheter permissions

Med en headless-implementering finns det flera säkerhets- och behörighetsområden som bör hanteras. Behörigheter och profiler kan övervägas baserat på den AEM miljön Författare eller Publish. Varje miljö innehåller olika personligheter och med olika behov.

Information details-permissions

Behörighetsaspekter för headless-innehåll

Miljö environments-permissions

Behörigheter är vanligtvis konfigurerade för:

För:

Använd ett CDN (Content Delivery Network) cdn

GraphQL-frågor och deras JSON-svar kan cachelagras om de är riktade som GET-begäranden när ett CDN används. Icke cachelagrade begäranden kan däremot vara mycket (resurskrävande) och långsamma att behandla, vilket kan få ytterligare negativa effekter på ursprungsmaterialets resurser.

Information details-cdn

CDN i AEM AS A CLOUD SERVICE

Miljö environments-cdn

Ett CDN är vanligtvis konfigurerat för:

Konfigurera och skapa innehållsfragment cconfigure-create-content-fragments

AEM GraphQL används för att hämta information från dina innehållsfragment. Dessa måste konfigureras, sedan en struktur och en plats definierad, innan du kan skapa innehållet.

Information details-content-fragments

Miljö eenvironments-content-fragments

Innehållsfragment definieras, skapas, testas, publiceras och öppnas på:

För:

Använda AEM GraphQL use-aem-graphql

Optimera dina GraphQL-frågor optimize-graphql-queries

Riktlinjerna är till för att förhindra prestandaproblem i dina GraphQL-frågor.

Information details-optimize-graphql-queries

Optimera GraphQL-frågor

Få tillgång till GraphQL från dina appar access-graphql-from-your-apps

AEM headless CMS ger utvecklare frihet att skapa och leverera exceptionella upplevelser med de språk, ramverk och verktyg de redan är bekanta med.

Information details-your-apps

Miljö environments-your-apps

Appar utvecklas, testas och används vanligtvis på:

För:

Ytterligare resurser

Mer information om AEM GraphQL och innehållsfragment finns i: