Configurare la cache dei moduli adattivi

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

  1. Vai a Gestione configurazione console web AEM all’indirizzo https://[server]:[port]/system/console/configMgr.

  2. Clic Configurazione di un modulo adattivo e di un canale web di comunicazione interattiva per modificarne i valori di configurazione.

  3. In modificare i valori di configurazione specifica il numero massimo di moduli, o documenti, un’istanza dell’AEM Forms il server può memorizzare in cache Numero di Forms adattivi campo. 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.

    Finestra di dialogo di configurazione per la cache HTML dei moduli adattivi

  4. Clic 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

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, 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:
    • Usa formato URL http://host:port/content/forms/af/<afName>.<locale>.html per richiedere una versione localizzata di un modulo adattivo anziché http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
    • Disattiva utilizzando le impostazioni locali del browser per 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 internazionali del browser in configuration manager è disattivato, 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 Usa impostazioni internazionali del browser in configuration manager è abilitato, 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ò portare a [memorizzare in cache solo la prima istanza di un modulo adattivo]. Per evitare che il problema si verifichi nell’istanza, consulta risoluzione dei problemi.

Abilita il caching in Dispatcher

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

  1. Apri il seguente URL per ogni istanza di pubblicazione dell’ambiente e abilitare l’agente di svuotamento per le istanze di pubblicazione dell’ambiente:
    http://[server]:[port]]/etc/replication/agents.publish/flush.html

  2. 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 una soluzione alternativa alle eccezioni, vedere risoluzione dei problemi sezione.

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

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

  4. Aggiungi i seguenti parametri all’elenco dei parametri degli 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 hai bisogno di controllare le autorizzazioni di accesso utente per una pagina prima di distribuire la pagina memorizzata in cache, consulta caching di 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 queste immagini e video vengono modificati nell’editor di risorse, 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 contiene informazioni sulla localizzazione, e Usa impostazioni internazionali del browser quando configuration manager è 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:

  1. Apri il file conf.d/httpd-dispatcher.conf o qualsiasi altro file di configurazione configurato per il caricamento in fase di esecuzione.

  2. 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>

In questa pagina