DocumentatieAEM 6.5Handboek

Cache voor adaptieve formulieren configureren configure-adaptive-forms-cache

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Beheerder
  • Gebruiker

Een cache is een mechanisme om de toegangstijd voor gegevens te verkorten, de latentie te verminderen en de invoer-/uitvoersnelheid (I/O) te verbeteren. In de cache van adaptieve formulieren worden alleen de HTML-inhoud en de JSON-structuur van een adaptief formulier opgeslagen zonder dat vooraf ingevulde gegevens worden opgeslagen. Hierdoor wordt de tijd die nodig is om een adaptief formulier op de client te genereren, verkort. Het is specifiek ontworpen voor adaptieve formulieren.

Cache voor adaptieve formulieren configureren bij auteur- en publicatieinstanties configure-adaptive-forms-caching-at-author-and-publish-instances

  1. Ga naar AEM webconsoleconfiguratiebeheer op https://[server]:[port]/system/console/configMgr .

  2. Klik op Adaptive Form and Interactive Communication Web Channel Configuration om de configuratiewaarden ervan te bewerken.

  3. Geef in het dialoogvenster edit configuration values het maximumaantal formulieren of documenten op dat een instantie van de AEM Forms server in het veld Number of Adaptive Forms in cache kan plaatsen. De standaardwaarde is 100.

    note note
    NOTE
    Om het geheime voorgeheugen onbruikbaar te maken, plaats de waarde op het Aantal van het AanpassingsForms gebied aan 0. De cache wordt opnieuw ingesteld en alle formulieren en documenten worden uit de cache verwijderd wanneer u de cachemonfiguratie uitschakelt of wijzigt.

    de dialoog van de Configuratie voor het adaptieve geheime voorgeheugen van de HTML van vormen

  4. Klik op Save om de configuratie op te slaan.

Uw omgeving is geconfigureerd voor het gebruik van cacheadaptieve formulieren en gerelateerde elementen.

(Optioneel) Aangepast formuliercache configureren in Dispatcher configure-the-cache

U kunt ook adaptieve formulieren in cache plaatsen bij Dispatcher voor een extra prestatieverhoging.

Voorwaarden pre-requisites

Overwegingen bij het in cache plaatsen van adaptieve formulieren op een Dispatcher considerations

  • Wanneer u de cache voor adaptieve formulieren gebruikt, gebruikt u de AEM Dispatcher om clientbibliotheken (CSS en JavaScript) van een adaptief formulier in cache te plaatsen.

  • Zorg tijdens het ontwikkelen van aangepaste componenten op de server die wordt gebruikt voor ontwikkeling dat de cache van adaptieve formulieren uitgeschakeld blijft.

  • URL's zonder extensie worden niet in de cache opgeslagen. URL met patroon /content/forms/[folder-structure]/[form-name].html wordt bijvoorbeeld in de cache opgeslagen en URL's met patroon /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content worden genegeerd in de cache. Gebruik dus URL's met extensies om de voordelen van caching te benutten.

  • Overwegingen voor gelokaliseerde adaptieve formulieren:

    • Gebruik de URL-indeling http://host:port/content/forms/af/<afName>.<locale>.html om een gelokaliseerde versie van een adaptief formulier aan te vragen in plaats van http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
    • maak onbruikbaar gebruikend browser scènevoor URLs met formaat http://host:port/content/forms/af/<adaptivefName>.html.
    • Wanneer u URL-indeling http://host:port/content/forms/af/<adaptivefName>.html gebruikt en Use Browser Locale in configuratiebeheer is uitgeschakeld, wordt de niet-gelokaliseerde versie van het adaptieve formulier weergegeven. De niet-gelokaliseerde taal is de taal die wordt gebruikt bij het ontwikkelen van het adaptieve formulier. De landinstelling die is geconfigureerd voor uw browser (landinstelling browser) wordt niet in overweging genomen en er wordt een niet-gelokaliseerde versie van het adaptieve formulier weergegeven.
    • Wanneer u URL-indeling http://host:port/content/forms/af/<adaptivefName>.html gebruikt en Use Browser Locale in configuratiebeheer is ingeschakeld, wordt een gelokaliseerde versie van het aangepaste formulier weergegeven, indien beschikbaar. De taal van het gelokaliseerde adaptieve formulier is gebaseerd op de landinstelling die is geconfigureerd voor uw browser (landinstelling browser). Het kan tot [ caching slechts de eerste instantie van een adaptieve vorm ] leiden. Om de kwestie te verhinderen op uw instantie te gebeuren, zie het oplossen van problemen.

Het in cache plaatsen van Dispatcher inschakelen

Voer de volgende stappen uit om adaptieve formulieren in cache in te schakelen en te configureren op Dispatcher:

  1. Open volgende URL voor elk publiceer geval van uw milieu en laat flush agent voor toe publiceer instanties van uw milieu:
    http://[server]:[port]]/etc/replication/agents.publish/flush.html

  2. voeg het volgende aan uw dispatcher.any- dossiertoe:

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

    Wanneer u het bovenstaande toevoegt:

    • Een adaptief formulier blijft in de cache totdat een bijgewerkte versie van het formulier niet wordt gepubliceerd.

    • Wanneer een nieuwere versie van een bron waarnaar in een adaptief formulier wordt verwezen, wordt gepubliceerd, worden de beïnvloede adaptieve formulieren automatisch ongeldig gemaakt. Er zijn enkele uitzonderingen op de automatische ongeldigmaking van bronnen waarnaar wordt verwezen. Voor alternerende actie aan uitzonderingen, zie de het oplossen van problemen sectie.

  3. voeg hieronder regels dispatcher.any of het dossier van douaneregelstoe. De URL's die caching niet ondersteunen, worden uitgesloten. Bijvoorbeeld interactieve communicatie.

    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. voeg de volgende parameters aan de negeer URL parameterlijsttoe:

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

Uw AEM-omgeving is geconfigureerd om adaptieve formulieren in de cache op te slaan. Alle typen adaptieve formulieren worden in het cachegeheugen opgeslagen. Als u een controle van de toestemmingen van de gebruikerstoegang voor een pagina vereist alvorens de caching pagina te leveren, zie caching beveiligde inhoud.

Problemen oplossen troubleshooting

Sommige adaptieve formulieren met afbeeldingen of video's worden niet automatisch ongeldig gemaakt in de Dispatcher-cache videos-or-images-not-auto-invalidated

Probleem issue1

Wanneer u afbeeldingen of video's selecteert en toevoegt via de middelenbrowser aan een adaptief formulier en deze afbeeldingen en video's worden bewerkt in de Assets-editor, worden adaptieve formulieren met dergelijke afbeeldingen niet automatisch ongeldig gemaakt in de Dispatcher-cache.

Oplossing Solution1

Nadat u de afbeeldingen en video hebt gepubliceerd, publiceert u de adaptieve formulieren die naar deze elementen verwijzen, expliciet en niet meer.

Alleen de eerste instantie van een adaptief formulier wordt in de cache opgeslagen only-first-instance-of-adaptive-forms-is-cached

Probleem issue3

Wanneer de URL van het aangepaste formulier geen lokalisatiegegevens bevat en Use Browser Locale in configuratiebeheer is ingeschakeld, wordt een gelokaliseerde versie van het adaptieve formulier weergegeven. Alleen het eerste exemplaar van het adaptieve formulier wordt in de cache opgeslagen en aan elke volgende gebruiker bezorgd.

Oplossing Solution3

Los het probleem op door de volgende stappen uit te voeren:

  1. Open conf.d/httpd-dispatcher.conf of een ander configuratiebestand dat is geconfigureerd om te laden tijdens runtime.

  2. Voeg de volgende code toe aan het bestand en sla deze op. Dit is een voorbeeldcode die u kunt aanpassen aan uw omgeving.

   <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