Configurar la caché de formularios adaptables

Una caché es un mecanismo para reducir los tiempos de acceso a los datos, reducir la latencia y mejorar las velocidades de entrada y salida (E/S). La caché de formularios adaptables almacena solo el contenido HTML y la estructura JSON de un formulario adaptable sin guardar datos precargados. Ayuda a reducir el tiempo necesario para procesar un formulario adaptable en el cliente. Está diseñado específicamente para formularios adaptables.

Configurar la caché de formularios adaptables en instancias de creación y publicación

  1. Vaya a AEM administrador de configuración de consola web en https://[server]:[port]/system/console/configMgr.

  2. Haga clic en Configuración del Canal Web de comunicación interactiva y formulario adaptable para editar sus valores de configuración.

  3. En el cuadro de diálogo editar valores de configuración, especifique el número máximo de formularios o documentos que una instancia del servidor AEM Forms puede almacenar en caché en el campo Número de Forms adaptable. El valor predeterminado es 100.

    NOTA

    Para deshabilitar la caché, establezca el valor en el campo Número de Forms adaptable en 0. La caché se restablece y todos los formularios y documentos se eliminan de la caché cuando se deshabilita o cambia la configuración de la caché.

    Cuadro de diálogo de configuración para la caché HTML de formularios adaptables

  4. Haga clic en Guardar para guardar la configuración.

El entorno está configurado para utilizar formularios adaptables de caché y recursos relacionados.

(Opcional) Configure la caché de formularios adaptables en el despachante

También puede configurar el procesamiento en caché de formularios adaptables en el despachante para un aumento adicional del rendimiento.

Requisitos previos

Consideraciones para almacenar en caché formularios adaptables en un despachante

  • Cuando utilice la caché de formularios adaptables, utilice la AEM Dispatcher para almacenar en caché las bibliotecas de cliente (CSS y JavaScript) de un formulario adaptable.
  • Al desarrollar componentes personalizados, en el servidor utilizado para el desarrollo, mantenga deshabilitada la caché de formularios adaptables.
  • Las direcciones URL sin extensión no se almacenan en caché. Por ejemplo, la dirección URL con patrón/content/forms/[folder-structure]/[form-name].html se almacena en caché y el almacenamiento en caché omite las direcciones URL con patrón /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content. Por lo tanto, utilice direcciones URL con extensiones para aprovechar las ventajas del almacenamiento en caché.
  • Consideraciones para formularios adaptables localizados:
    • Utilice el formato de URL http://host:port/content/forms/af/<afName>.<locale>.html para solicitar una versión localizada de un formulario adaptable en lugar de http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
    • Deshabilite el uso de localizaciones de explorador para direcciones URL con formato http://host:port/content/forms/af/<adaptivefName>.html.
    • Cuando se utiliza Formato de URL http://host:port/content/forms/af/<adaptivefName>.html y Usar configuración regional del explorador en el administrador de configuración, se muestra la versión no localizada del formulario adaptable. El idioma no localizado es el idioma utilizado al desarrollar el formulario adaptable. La configuración regional configurada para el explorador (configuración regional del explorador) no se tiene en cuenta y se proporciona una versión no localizada del formulario adaptable.
    • Cuando se utiliza Formato de URL http://host:port/content/forms/af/<adaptivefName>.html y Usar configuración regional del explorador en el administrador de configuración está habilitado, se muestra una versión localizada del formulario adaptable, si está disponible. El idioma del formulario adaptable localizado se basa en la configuración regional configurada para el explorador (configuración regional del explorador). Puede llevar a [almacenar en caché sólo la primera instancia de un formulario adaptable]. Para evitar que el problema se produzca en su instancia, consulte solución de problemas.

Habilitar la caché en el despachante

Siga los pasos que se indican a continuación para habilitar y configurar la caché de formularios adaptables en el despachante:

  1. Abra la siguiente URL para cada instancia de publicación de su entorno y configure el agente de replicación:
    http://[server]:[port]]/etc/replication/agents.publish/flush.html

  2. Añada lo siguiente en el archivo 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"
   }

    Al agregar lo anterior:

    • Un formulario adaptable permanece en la caché hasta que no se publica una versión actualizada del formulario.

    • Cuando se publica una versión más reciente del recurso al que se hace referencia en un formulario adaptable, los formularios adaptables afectados se invalidan automáticamente. Existen algunas excepciones a la invalidación automática de los recursos a los que se hace referencia. Para ver la solución alternativa a las excepciones, consulte la sección solución de problemas.

  3. Añada el siguiente archivo de reglas dispatcher.any o custom rules. Excluye las direcciones URL que no admiten el almacenamiento en caché. Por ejemplo, Comunicación interactiva.

       /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. Añada los siguientes parámetros en la lista de parámetros de URL omitidos:

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

El entorno de AEM está configurado para almacenar en caché formularios adaptables. Almacena en caché todos los tipos de formularios adaptables. Si necesita comprobar los permisos de acceso de los usuarios para una página antes de entregar la página en caché, consulte almacenamiento en caché de contenido seguro.

Solución de problemas

Algunos formularios adaptables que contienen imágenes o vídeos no se invalidan automáticamente desde la caché del despachante

Problema

Al seleccionar y agregar imágenes o vídeos mediante el navegador de recursos a un formulario adaptable y estas imágenes y vídeos se editan en el editor de recursos, los formularios adaptables que contengan dichas imágenes no se invalidan automáticamente desde la caché del despachante.

Solución

Después de publicar las imágenes y el vídeo, anule explícitamente la publicación y publique los formularios adaptables que hacen referencia a estos recursos.

Algunos formularios adaptables que contienen fragmentos de contenido o de experiencia no se invalidan automáticamente desde la caché del despachante

Problema

Cuando se agrega un fragmento de contenido o de experiencia a un formulario adaptable y estos recursos se editan y publican de forma independiente, los formularios adaptables que contengan dichos recursos no se invalidan automáticamente desde la caché del despachante.

Solución

Después de publicar fragmentos de contenido o fragmentos de experiencia actualizados, anule explícitamente la publicación y publique los formularios adaptables que utilizan estos recursos.

Solo se almacena en caché la primera instancia de un formulario adaptable

Problema

Cuando la dirección URL del formulario adaptable no tiene información de localización y Usar configuración regional del explorador en el administrador de configuración está activada, se proporciona una versión localizada del formulario adaptable y solo se almacena en caché la primera instancia del formulario adaptable y se entrega a todos los usuarios subsiguientes.

Solución

Siga los pasos siguientes para resolver el problema:

  1. Abra conf.d/httpd-dispatcher.conf o cualquier otro archivo de configuración configurado para cargarse durante la ejecución.

  2. Añada el siguiente código en el archivo y guárdelo. Es un código de muestra modificarlo para adaptarlo a su entorno.

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

En esta página