DokumentationAEM 6.5Användarhandbok

Konfigurera cacheminne för adaptiva formulär configure-adaptive-forms-cache

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Administratör
  • Användare

Ett cacheminne är en mekanism som förkortar dataåtkomsttider, minskar latensen och förbättrar I/O-hastigheter (input/output). Cacheminnet för adaptiva formulär lagrar endast HTML-innehåll och JSON-struktur i ett adaptivt formulär utan att några förfyllda data sparas. Det minskar tiden som krävs för att återge ett anpassat formulär på klienten. Det är särskilt utformat för anpassningsbara formulär.

Konfigurera cacheminne för anpassade formulär vid författare och publiceringsinstanser configure-adaptive-forms-caching-at-author-and-publish-instances

  1. Gå AEM webbkonsolens konfigurationshanterare på https://[server]:[port]/system/console/configMgr.

  2. Klicka på Adaptive Form and Interactive Communication Web Channel Configuration om du vill redigera dess konfigurationsvärden.

  3. I dialogrutan edit configuration values anger du det maximala antalet formulär, eller dokument, som en instans av AEM Forms-servern kan cachelagra i fältet Number of Adaptive Forms. Standardvärdet är 100.

    note note
    NOTE
    Om du vill inaktivera cachen anger du värdet 0 i fältet Antal adaptiva Forms. Cacheminnet återställs och alla formulär och dokument tas bort från cacheminnet när du inaktiverar eller ändrar cachekonfigurationen.

    Konfigurationsdialogruta för cacheminne för adaptiva formulär i HTML

  4. Klicka på Save för att spara konfigurationen.

Miljön är konfigurerad att använda cacheadaptiva formulär och relaterade resurser.

(Valfritt) Konfigurera cacheminne för anpassningsbara formulär på Dispatcher configure-the-cache

Du kan också konfigurera cachning av adaptiva formulär på Dispatcher för ytterligare prestandaförbättringar.

Krav pre-requisites

Att tänka på när du cachelagrar adaptiva formulär på en Dispatcher considerations

  • När du använder cacheminnet för adaptiva formulär använder du AEM Dispatcher för att cachelagra klientbibliotek (CSS och JavaScript) för ett adaptivt formulär.

  • När du utvecklar anpassade komponenter på servern som används för utveckling ska du inaktivera cachen för anpassade formulär.

  • URL:er utan tillägg cachelagras inte. URL:er med mönstret /content/forms/[folder-structure]/[form-name].html cachelagras till exempel, och cachelagring ignorerar URL:er med mönstret /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content. Använd URL:er med tillägg för att utnyttja fördelarna med cachning.

  • Att tänka på när det gäller lokaliserade adaptiva formulär:

    • Använd URL-formatet http://host:port/content/forms/af/<afName>.<locale>.html för att begära en lokaliserad version av ett adaptivt formulär i stället för http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
    • Inaktivera användning av webbläsarens språkområde för URL-adresser med formatet http://host:port/content/forms/af/<adaptivefName>.html.
    • När du använder URL-formatet http://host:port/content/forms/af/<adaptivefName>.html, och Use Browser Locale i konfigurationshanteraren är inaktiverat, används den icke-lokaliserade versionen av det adaptiva formuläret. Det icke-lokaliserade språket är det språk som används vid utvecklingen av det adaptiva formuläret. Det språk som är konfigurerat för webbläsaren (webbläsarens språkområde) beaktas inte och en icke-lokaliserad version av det anpassade formuläret används.
    • När du använder URL-formatet http://host:port/content/forms/af/<adaptivefName>.html, och Use Browser Locale i konfigurationshanteraren är aktiverat, visas en lokaliserad version av det adaptiva formuläret, om en sådan finns. Språket i det lokaliserade adaptiva formuläret baseras på det språk som är konfigurerat för webbläsaren (webbläsarens språkområde). Det kan leda till [cachelagring av endast den första instansen av ett adaptivt formulär]. Information om hur du förhindrar att problemet inträffar på din instans finns i felsökning.

Aktivera cachelagring på Dispatcher

Så här aktiverar och konfigurerar du cachelagring av adaptiva formulär på Dispatcher:

  1. Öppna följande URL för varje publiceringsinstans av miljön och aktivera rensningsagenten för publiceringsinstanser av miljön:
    http://[server]:[port]]/etc/replication/agents.publish/flush.html

  2. Lägg till följande i din dispatcher.vilken fil som helst:

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

    När du lägger till ovanstående:

    • Ett anpassat formulär finns kvar i cacheminnet tills en uppdaterad version av formuläret inte publiceras.

    • När en nyare version av en resurs som refereras till i ett adaptivt formulär publiceras blir de adaptiva formulären automatiskt ogiltiga. Det finns några undantag för automatisk ogiltigförklaring av refererade resurser. Du hittar mer information om undantag i avsnittet felsökning.

  3. Lägg till nedanstående regeldispatcher.vilken eller vilken anpassad regelfil som helst. URL:er som inte stöder cachelagring utesluts. Interaktiv kommunikation.

    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. Lägg till följande parametrar i listan över ignorerade URL-parametrar:

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

Din AEM är konfigurerad att cachelagra adaptiva formulär. Den cache-lagrar alla typer av anpassningsbara formulär. Om du behöver kontrollera användaråtkomstbehörighet för en sida innan du levererar den cachelagrade sidan läser du cachelagra skyddat innehåll.

Felsökning troubleshooting

Vissa anpassningsbara formulär som innehåller bilder eller videoklipp ogiltigförklaras inte automatiskt från Dispatcher cache videos-or-images-not-auto-invalidated

Problem issue1

När du markerar och lägger till bilder eller videoklipp via en filläsare i ett anpassat formulär och dessa bilder och videoklipp redigeras i Assets Editor blir adaptiva formulär som innehåller sådana bilder inte automatiskt ogiltiga från Dispatcher cache.

Lösning Solution1

När du har publicerat bilder och video avpublicerar och publicerar du de adaptiva formulären som refererar till dessa resurser.

Endast den första instansen av ett adaptivt formulär cachelagras only-first-instance-of-adaptive-forms-is-cached

Problem issue3

När URL:en för det adaptiva formuläret inte har någon lokaliseringsinformation och Use Browser Locale i konfigurationshanteraren är aktiverad, skickas en lokaliserad version av det adaptiva formuläret. Endast den första instansen av det adaptiva formuläret cachelagras och skickas till alla efterföljande användare.

Lösning Solution3

Lös problemet genom att utföra följande steg:

  1. Öppna conf.d/httpd-dispatcher.conf eller någon annan konfigurationsfil som är konfigurerad att läsas in under körning.

  2. Lägg till följande kod i filen och spara den. Det är en exempelkod som ändrar den så att den passar din miljö.

   <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