Best practice per la configurazione e l’utilizzo di AEM GraphQL con frammenti di contenuto best-practices-setup-use-aem-graphql-content-fragments

Queste linee guida riepilogano le best practice consigliate per l’impostazione, la configurazione e l’utilizzo di AEM con GraphQL e Frammenti di contenuto.

Guida introduttiva getting-started

Per aiutarti a imparare a usare al meglio:

Configurazione setup

Per configurare in modo sicuro il GraphQL per l’AEM da utilizzare con i frammenti di contenuto e le app, è necessario configurare vari componenti.

Creazione di endpoint GraphQL (inclusa la sicurezza) graphql-endpoint-creation

L’endpoint è il percorso utilizzato per accedere a GraphQL per AEM. Questi endpoint devono essere creati e pubblicati in modo da essere accessibili in modo sicuro.

Dettagli details-graphql-endpoint-creation

Gestire gli endpoint GraphQL in AEM

Ambienti environments-graphql-endpoint-creation

Gli endpoint devono essere configurati in:

Per:

Memorizzazione in cache di Dispatcher AEM dispatcher-caching

La memorizzazione nella cache delle query persistenti non è abilitata per impostazione predefinita in Dispatcher. L’abilitazione predefinita non è possibile perché i clienti che utilizzano CORS (Cross-Origin Resource Sharing) con più origini devono rivedere, e possibilmente aggiornare, la configurazione di Dispatcher.

Dettagli details-dispatcher-caching

Query persistenti GraphQL: abilitazione della memorizzazione in cache in Dispatcher

Ambienti environments-dispatcher-caching

Dispatcher è in genere configurato per:

Configurazione CORS cors-setup

Per accedere all’endpoint GraphQL, è necessario configurare un criterio CORS e aggiungerlo a un progetto AEM distribuito all’AEM tramite Cloud Manager. A questo scopo, aggiungi un file di configurazione OSGi CORS appropriato per gli endpoint desiderati.

Dettagli details-cors-setup

Configurazione di Cross-Origin Resource Sharing (CORS)

Ambienti environments-cors-setup

CORS è in genere configurato per:

Autenticazione authentication

Un caso d’uso principale per l’API GraphQL di Adobe Experience Manager as a Cloud Service (AEM) per la distribuzione di frammenti di contenuto accetta query remote da applicazioni o servizi di terze parti. Queste query remote possono richiedere l’accesso a API autenticate, per garantire la distribuzione di contenuti headless.

Dettagli details-authentication

Autenticazione per query GraphQL AEM remote su frammenti di contenuto

Ambienti environments-authentication

L’autenticazione è in genere configurata per:

Per:

Autorizzazioni permissions

Con un’implementazione headless, è necessario affrontare diverse aree di sicurezza e autorizzazioni. Le autorizzazioni e gli utenti tipo possono essere considerati in generale in base all’ambiente AEM Autore o Pubblica. Ogni ambiente contiene utenti tipo diversi e con esigenze diverse.

Dettagli details-permissions

Considerazioni sulle autorizzazioni per contenuti headless

Ambienti environments-permissions

Le autorizzazioni sono generalmente configurate per:

Per:

Utilizzare una rete per la distribuzione dei contenuti (CDN) cdn

Le query GraphQL e le relative risposte JSON possono essere memorizzate nella cache se impostate come GET richieste quando si utilizza una rete CDN. Al contrario, le richieste non memorizzate nella cache possono essere molto (risorse) costose e lente da elaborare, con il potenziale di ulteriori effetti negativi sulle risorse dell’origine.

Dettagli details-cdn

CDN in AEM as a Cloud Service

Ambienti environments-cdn

Una rete CDN è in genere configurata per:

Configurare e creare frammenti di contenuto cconfigure-create-content-fragments

AEM GraphQL viene utilizzato per recuperare informazioni dai frammenti di contenuto. Prima di poter creare il contenuto, è necessario configurarlo, quindi definire una struttura e una posizione.

Dettagli details-content-fragments

Ambienti eenvironments-content-fragments

I frammenti di contenuto sono definiti, creati, testati, pubblicati e accessibili su:

Per:

Utilizzo di AEM GraphQL use-aem-graphql

Ottimizzare le query GraphQL optimize-graphql-queries

Queste linee guida servono a prevenire problemi di prestazioni con le query GraphQL.

Dettagli details-optimize-graphql-queries

Ottimizzazione delle query GraphQL

Accedere a GraphQL dalle app access-graphql-from-your-apps

I CMS headless AEM offrono agli sviluppatori la libertà di creare e distribuire esperienze eccezionali utilizzando i linguaggi, i framework e gli strumenti che già conoscono.

Dettagli details-your-apps

Ambienti environments-your-apps

Le app vengono generalmente sviluppate, testate e utilizzate per:

Per:

Risorse aggiuntive

Per ulteriori dettagli sul GraphQL dell’AEM e sui frammenti di contenuto, vedi: