Configurar la caché de los formularios adaptables

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

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

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

  2. Haga clic en Configuración del canal Web de comunicaciones interactivas y formularios adaptables 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 de AEM Forms puede almacenar en caché en el campo Número de formularios adaptables. El valor predeterminado es 100.

    NOTA

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

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

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

Su entorno está configurado para utilizar la memoria caché de los formularios adaptables y los recursos relacionados.

(Opcional) Configurar la memoria caché de un formulario adaptable en Dispatcher

También puede configurar el almacenamiento en la memoria caché de un formulario adaptable en Dispatcher para mejorar el rendimiento.

Requisitos previos

Consideraciones para almacenar en la memoria caché formularios adaptables en Dispatcher

  • Cuando utilice la memoria caché de los formularios adaptables, utilice el Dispatcher de AEM para almacenar en caché las bibliotecas de cliente (CSS y JavaScript) de un formulario adaptable.
  • Cuando desarrolle componentes personalizados, mantenga deshabilitada la memoria caché de los formularios adaptables en el servidor utilizado para el desarrollo.
  • Las URL sin extensión no se almacenan en caché. Por ejemplo, las URL con el patrón /content/forms/[folder-structure]/[form-name].html se almacenan en caché, y el almacenamiento en caché ignora las URL con el patrón /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content. Por lo tanto, utilice URL con extensiones para aprovechar las ventajas del almacenamiento en caché.
  • Consideraciones para los formularios adaptables localizados:
    • Utilice el formato 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 la configuración regional del explorador para URL con el formato http://host:port/content/forms/af/<adaptivefName>.html.
    • Cuando utiliza el formato de URL http://host:port/content/forms/af/<adaptivefName>.html y Usar explorador local está deshabilitado en el administrador de configuración, se proporcionará la versión no localizada del formulario adaptable. El idioma no localizado es el utilizado al desarrollar el formulario adaptable. No se tiene en cuenta la configuración regional configurada para el explorador (configuración regional del explorador) y se proporciona una versión no localizada del formulario adaptable.
    • Cuando utiliza el formato de URL http://host:port/content/forms/af/<adaptivefName>.html y Usar explorador local está habilitado en el administrador de configuración, se proporcionará la versión no localizada del formulario adaptable. El idioma del formulario adaptable localizado se basará en la configuración local del explorador (explorador local). Puede llevar a [almacenar en caché solo la primera instancia de un formulario adaptable]. Para evitar que este problema se produzca en la instancia, consulte Solución de problemas.

Habilitar el almacenamiento en caché en Dispatcher

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

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

  2. Agregue lo siguiente al 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"
       }
    

    Cuando haya agregado lo anterior:

    • El formulario adaptable permanecerá en la memoria caché hasta que no se publique una versión actualizada.

    • Cuando se publique una versión más reciente del recurso al que se hace referencia en un formulario adaptable, el formulario adaptable afectado se invalidará automáticamente. Existen algunas excepciones a la hora de invalidar automáticamente los recursos a los que se hace referencia. Para obtener más información sobre las excepciones, consulte la sección Solución de problemas.

  3. Añada las siguientes reglas: dispatcher.any o un archivo de reglas personalizadas. Esto excluirá las URL que no admitan el almacenamiento en caché; por ejemplo, comunicaciones interactivas.

       /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 a la lista de los parámetros de URL ignorados:

       /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 la memoria caché los formularios adaptables. Almacena en la memoria caché todo tipo de formularios adaptables. Si tiene que comprobar los permisos de acceso de los usuarios de una página antes de enviar la página almacenada en caché, consulte Almacenar contenido protegido en caché.

Solución de problemas

Algunos formularios adaptables que contienen imágenes o vídeos no se invalidan automáticamente en la memoria caché de Dispatcher

Problema

Cuando selecciona y agrega imágenes o vídeos a un formulario adaptable a través del explorador de recursos y estas imágenes y vídeos se editan en el editor de recursos, el formulario adaptable que las contiene no se invalida automáticamente en la caché de Dispatcher.

Solución

Después de publicar las imágenes y el vídeo, cancele la publicación y publique de forma explícita el formulario adaptable que hace referencia a estos recursos.

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

Problema

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

Solución

Siga estos pasos 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. Agregue el siguiente código al archivo y guárdelo. Es un código de ejemplo, puede 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