DocumentaciónAEM 6.5Guía del usuario

Configurar la caché de los formularios adaptables configure-adaptive-forms-cache

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Administrador
  • Usuario

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 memoria caché de los formularios adaptables almacena únicamente el contenido del 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 configure-adaptive-forms-caching-at-author-and-publish-instances

  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. AEM 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 Forms de la puede almacenar en caché en el campo Número de Forms adaptables. El valor predeterminado es 100.

    note note
    NOTE
    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 configure-the-cache

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

Requisitos previos pre-requisites

Consideraciones para almacenar en caché formularios adaptables en Dispatcher considerations

  • 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 la caché, y el almacenamiento en la caché ignora las URL con el patrón /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content. Para esto, utilice una 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 exploradorpara 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 tendrá en cuenta la configuración regional configurada para el explorador (configuración regional del explorador) y se proporcionará 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.

Habilitación del almacenamiento en caché en Dispatcher

Para habilitar y configurar el almacenamiento en caché de los formularios adaptables en Dispatcher, realice los siguientes pasos:

  1. Abra la siguiente URL en 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:

    code language-json 
       /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 caché hasta que no se publique una versión actualizada.

    • Cuando se publica una versión más reciente de un recurso al que se hace referencia en un formulario adaptable, el formulario adaptable afectado se invalida 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.

    code language-json 
       /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"
   }

  4. Añada los siguientes parámetros a la lista de los parámetros de URL ignorados:

    code language-json 
       /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 necesita comprobar los permisos de acceso de los usuarios de una página antes de enviar la página almacenada en caché, vea almacenar en caché el contenido protegido.

Resolución de problemas troubleshooting

Algunos formularios adaptables que contienen imágenes o vídeos no se invalidan automáticamente en la caché de Dispatcher videos-or-images-not-auto-invalidated

Problema issue1

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

Solución Solution1

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 only-first-instance-of-adaptive-forms-is-cached

Problema issue3

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

Solución Solution3

Resuelva el problema realizando los siguientes pasos:

  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>
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2