Configurare la cache dei moduli adattivi

Ultimo aggiornamento: 5 maggio 2025

Si applica a:
Experience Manager 6.5

Argomenti:

Creato per:

Amministratore
Utente

La cache è un meccanismo che consente di ridurre i tempi di accesso ai dati, ridurre la latenza e migliorare le velocità di input/output (I/O). La cache dei moduli adattivi memorizza solo il contenuto HTML e la struttura JSON di un modulo adattivo senza salvare dati precompilati. Consente di ridurre il tempo necessario per il rendering di un modulo adattivo sul client. È progettato appositamente per i moduli adattivi.

Configurare la cache dei moduli adattivi nelle istanze di authoring e pubblicazione

Passare a Gestione configurazione console Web AEM in https://[server]:[port]/system/console/configMgr.
Fai clic su Configurazione modulo adattivo e canale web di comunicazione interattiva per modificarne i valori di configurazione.
Nella finestra di dialogo modifica valori configurazione, specifica il numero massimo di moduli o documenti, un'istanza del server AEM Forms può memorizzare nella cache nel campo Numero di Forms adattivi. Il valore predefinito è 100.

NOTA
Per disabilitare la cache, imposta il valore nel campo Numero di Forms adattivi su 0. La cache viene reimpostata e tutti i moduli e i documenti vengono rimossi dalla cache quando si disattiva o si modifica la configurazione della cache.
Fai clic su Salva per salvare la configurazione.

L’ambiente è configurato per l’utilizzo di moduli adattivi della cache e delle relative risorse.

(Facoltativo) Configurazione della cache dei moduli adattivi in Dispatcher

Puoi anche configurare il caching dei moduli adattivi in Dispatcher per un ulteriore miglioramento delle prestazioni.

Prerequisiti

Abilita l'opzione unione o precompilazione dei dati nel client. Consente di unire dati univoci per ogni istanza di un modulo precompilato.

Considerazioni per la memorizzazione nella cache dei moduli adattivi su un Dispatcher

Quando utilizzi la cache dei moduli adattivi, utilizza l’AEM Dispatcher per memorizzare nella cache le librerie client (CSS e JavaScript) di un modulo adattivo.
Durante lo sviluppo di componenti personalizzati, nel server utilizzato per lo sviluppo, mantieni disabilitata la cache dei moduli adattivi.
Gli URL senza estensione non vengono memorizzati in cache. Ad esempio, gli URL con pattern /content/forms/[folder-structure]/[form-name].html vengono memorizzati nella cache e la memorizzazione nella cache ignora gli URL con pattern /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content. Pertanto, utilizza gli URL con estensioni per sfruttare i vantaggi del caching.
Considerazioni per i moduli adattivi localizzati:
- Utilizza il formato URL http://host:port/content/forms/af/<afName>.<locale>.html per richiedere una versione localizzata di un modulo adattivo invece di http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
- Disattivare utilizzando le impostazioni locali del browser per gli URL con formato http://host:port/content/forms/af/<adaptivefName>.html.
- Quando si utilizza il formato URL http://host:port/content/forms/af/<adaptivefName>.html e Usa impostazioni locali del browser in Gestione configurazione è disabilitato, viene distribuita la versione non localizzata del modulo adattivo. La lingua non localizzata è la lingua utilizzata durante lo sviluppo del modulo adattivo. Le impostazioni locali configurate per il browser (impostazioni locali del browser) non vengono considerate e viene distribuita una versione non localizzata del modulo adattivo.
- Quando si utilizza il formato URL http://host:port/content/forms/af/<adaptivefName>.html e si attiva Usa impostazioni locali browser in Gestione configurazione, viene distribuita una versione localizzata del modulo adattivo, se disponibile. La lingua del modulo adattivo localizzato si basa sulla lingua configurata per il browser (lingua del browser). Può causare il caching di [solo della prima istanza di un modulo adattivo]. Per evitare che il problema si verifichi nell'istanza, vedere risoluzione dei problemi.

Abilita caching in Dispatcher

Per abilitare e configurare la memorizzazione in cache dei moduli adattivi su Dispatcher, effettua le seguenti operazioni:

Apri il seguente URL per ogni istanza di pubblicazione dell'ambiente e abilita l'agente di svuotamento per le istanze di pubblicazione dell'ambiente:
http://[server]:[port]]/etc/replication/agents.publish/flush.html
Aggiungi quanto segue al file dispatcher.any:
/invalidate { /0000 { /glob "*" /type "deny" } /0001 { # Consider all HTML files stale after an activation. /glob "*.html" /type "allow" } /0002 { # Exclude htmls present in AF directories /glob "/content/forms/**/*.html" /type "deny" }
Quando aggiungi quanto sopra:
- Un modulo adattivo rimane nella cache fino a quando non viene pubblicata una versione aggiornata del modulo.
- Quando viene pubblicata una versione più recente di una risorsa a cui si fa riferimento in un modulo adattivo, i moduli adattivi interessati vengono automaticamente invalidati. Esistono alcune eccezioni all’annullamento automatico della validità delle risorse di riferimento. Per informazioni sulle eccezioni, vedere la sezione risoluzione dei problemi.

Aggiungi il seguente file di regole dispatcher.any o personalizzato. Sono esclusi gli URL che non supportano il caching. Ad esempio, la comunicazione interattiva.

   /0000 {
         /glob "*"
         /type "allow"
   }
   ## Do not cache csrf login tokens
   /0001 {
         /glob "/libs/granite/csrf/token.json"
         /type "deny"
   }
   ## Do not cache IC - print channel
   /0002 {
         /glob "/content/forms/**/channels/print.html"
         /type "deny"
   }
   ## Do not cache IC - web channel
   /0003 {
         /glob "/content/forms/**/channels/web.html"
         /type "deny"
   }

Aggiungere i seguenti parametri all'elenco dei parametri URL da ignorare:

   /ignoreUrlParams {
   /0001 { /glob "*" /type "deny" }
   # added for AEM forms specific use cases.
   /0003 { /glob "dataRef" /type "allow" }
   }

L’ambiente AEM è configurato per memorizzare nella cache i moduli adattivi. Memorizza nella cache tutti i tipi di moduli adattivi. Se prima di distribuire la pagina memorizzata in cache è necessario verificare le autorizzazioni di accesso utente per una pagina, vedere memorizzazione in cache del contenuto protetto.

Risoluzione dei problemi

Alcuni moduli adattivi contenenti immagini o video non vengono invalidati automaticamente dalla cache di Dispatcher

Problema

Quando selezioni e aggiungi immagini o video tramite il browser di risorse a un modulo adattivo e tali immagini e video vengono modificati nell’editor di Assets, i moduli adattivi contenenti tali immagini non vengono invalidati automaticamente dalla cache di Dispatcher.

Soluzione

Dopo aver pubblicato le immagini e il video, annulla esplicitamente la pubblicazione e pubblica i moduli adattivi che fanno riferimento a tali risorse.

Solo la prima istanza di un modulo adattivo è memorizzata in cache

Problema

Se l'URL del modulo adattivo non dispone di informazioni sulla localizzazione e Usa impostazioni locali browser nella gestione della configurazione è abilitato, viene distribuita una versione localizzata del modulo adattivo. Solo la prima istanza del modulo adattivo viene memorizzata in cache e distribuita a ogni utente successivo.

Soluzione

Per risolvere il problema, effettuare le seguenti operazioni:

Apri il file conf.d/httpd-dispatcher.conf o qualsiasi altro file di configurazione configurato per il caricamento in fase di esecuzione.
Aggiungi il seguente codice al file e salvalo. Si tratta di un codice di esempio per modificarlo in base all’ambiente in uso.

   <VirtualHost *:80>
        # Set log level high during development / debugging and then turn it down to whatever is appropriate
    LogLevel rewrite:trace6
        # Start Rewrite Engine
    RewriteEngine On
        # Handle actual URL convention (just pass through)
        RewriteRule "^/content/forms/af/(.*)[.](.*).html$" "/content/forms/af/$1.$2.html" [PT]

        # Handle selector based redirection basded on browser language
        # The Rewrite Cond(ition) is looking for the Accept-Lanague header and if found takes the first two character which most likely will be the desired language selector.
        RewriteCond %{HTTP:Accept-Language} ^(..).*$ [NC]
        RewriteRule "^/content/forms/af/(.*).html$" "/content/forms/af/$1.%1.html" [R]
   </VirtualHost>

recommendation-more-help