Configurar cache de formulários adaptáveis

Um cache é um mecanismo para reduzir os tempos de acesso aos dados, reduzir a latência e melhorar as velocidades de entrada/saída (E/S). O cache de formulários adaptáveis armazena somente o conteúdo em HTML e a estrutura JSON de um formulário adaptável sem salvar os dados pré-preenchidos. Ajuda a reduzir o tempo necessário para renderizar um formulário adaptável no cliente. Ele foi projetado especificamente para formulários adaptáveis.

Configurar o cache de formulários adaptáveis nas instâncias de criação e publicação

  1. Vá para o gerenciador de configuração do console da Web do AEM em https://[server]:[port]/system/console/configMgr.

  2. Clique em Configuração do canal da Web do formulário adaptável e da comunicação interativa para editar os valores de configuração.

  3. No editar valores de configuração especificar o número máximo de formulários ou documentos que uma instância do AEM Forms o servidor pode armazenar em cache no Número de Forms adaptáveis campo. O valor padrão é 100.

    OBSERVAÇÃO

    Para desativar o cache, defina o valor no campo Número de Forms adaptáveis como 0. O cache é redefinido e todos os formulários e documentos são removidos do cache quando você desativa ou altera a configuração do cache.

    Caixa de diálogo de configuração para cache de HTML de formulários adaptáveis

  4. Clique em Salvar para salvar a configuração.

Seu ambiente está configurado para usar formulários adaptáveis em cache e ativos relacionados.

(Opcional) Configurar o cache de formulários adaptáveis no dispatcher

Você também pode configurar o armazenamento em cache de formulários adaptáveis no Dispatcher para aumentar ainda mais o desempenho.

Pré-requisitos

Considerações para armazenamento em cache de formulários adaptáveis em um dispatcher

  • Ao usar o cache de formulários adaptáveis, use o AEM Dispatcher para armazenar em cache bibliotecas de clientes (CSS e JavaScript) de um formulário adaptável.
  • Ao desenvolver componentes personalizados, no servidor usado para desenvolvimento, mantenha o cache de formulários adaptáveis desativado.
  • Os URLs sem extensão não são armazenados em cache. Por exemplo, URL com padrão/content/forms/[folder-structure]/[form-name].html são armazenados em cache e o armazenamento em cache ignora URLs com padrão /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content. Portanto, use URLs com extensões para aproveitar os benefícios do armazenamento em cache.
  • Considerações para formulários adaptáveis localizados:
    • Usar formato de URL http://host:port/content/forms/af/<afName>.<locale>.html para solicitar uma versão localizada de um formulário adaptável em vez de http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
    • Desativar usando localidade do navegador para URLs com formato http://host:port/content/forms/af/<adaptivefName>.html.
    • Quando você usa o formato de URL http://host:port/content/forms/af/<adaptivefName>.html, e Usar localidade do navegador no gerenciador de configurações estiver desativado, a versão não localizada do formulário adaptável será fornecida. O idioma não localizado é o idioma usado no desenvolvimento do formulário adaptável. A localidade configurada para seu navegador (localidade do navegador) não é levada em consideração e uma versão não localizada do formulário adaptável é fornecida.
    • Quando você usa o formato de URL http://host:port/content/forms/af/<adaptivefName>.html, e Usar localidade do navegador no gerenciador de configurações ativado, uma versão localizada do formulário adaptável é fornecida, se disponível. O idioma do formulário adaptável localizado se baseia no local configurado para seu navegador (local do navegador). Pode levar a [armazenamento em cache somente da primeira instância de um formulário adaptável]. Para evitar que o problema ocorra na sua instância, consulte solução de problemas.

Ativar o armazenamento em cache no dispatcher

Execute as etapas listadas abaixo para ativar e configurar o armazenamento em cache de formulários adaptáveis no dispatcher:

  1. Abra o seguinte URL para cada instância de publicação de seu ambiente e ativar agente de limpeza para instâncias de publicação do seu ambiente:
    http://[server]:[port]]/etc/replication/agents.publish/flush.html

  2. Adicione o seguinte ao arquivo 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"
   }

    Ao adicionar o acima:

    • Um formulário adaptável permanece no cache até que uma versão atualizada do formulário não seja publicada.

    • Quando uma versão mais recente do recurso referenciado em um formulário adaptável é publicada, os formulários adaptáveis afetados são invalidados automaticamente. Há algumas exceções à invalidação automática de recursos referenciados. Para obter uma solução alternativa para exceções, consulte solução de problemas seção.

  3. Adicione o arquivo de regras dispatcher.any abaixo ou um arquivo de regras personalizado. Ela exclui os URLs que não oferecem suporte ao armazenamento em cache. Por exemplo, Comunicação interativa.

       /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. Adicionar os seguintes parâmetros à lista para ignorar parâmetros de URL:

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

Seu ambiente AEM está configurado para armazenar formulários adaptáveis em cache. Armazena em cache todos os tipos de formulários adaptáveis. Se você tiver um requisito para verificar as permissões de acesso do usuário para uma página antes de entregar a página em cache, consulte armazenamento em cache de conteúdo protegido.

Resolução de problemas

Alguns formulários adaptáveis contendo imagens ou vídeos não são invalidados automaticamente do cache do dispatcher

Problema

Quando você seleciona e adiciona imagens ou vídeos por meio do navegador de ativos a um formulário adaptável e essas imagens e vídeos são editados no editor de ativos, os formulários adaptáveis que contêm essas imagens não são invalidados do cache do dispatcher automaticamente.

Solução

Após a publicação das imagens e do vídeo, cancele explicitamente a publicação e publique os formulários adaptáveis que fazem referência a esses ativos.

Somente a primeira instância de um formulário adaptável é armazenada em cache

Problema

Quando a URL do formulário adaptável não tiver informações de localização e Usar localidade do navegador no gerenciador de configurações estiver ativado, uma versão localizada do formulário adaptável será fornecida e somente a primeira instância do formulário adaptável será armazenada em cache e entregue a cada usuário subsequente.

Solução

Execute as seguintes etapas para resolver o problema:

  1. Abra o arquivo conf.d/httpd-dispatcher.conf ou qualquer outro arquivo de configuração configurado para ser carregado no tempo de execução.

  2. Adicione o código a seguir ao arquivo e salve-o. É uma amostra de código, modifique-a para atender ao seu ambiente.

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

Nesta página