Cache für adaptive Formulare konfigurieren

Eine Cache ist ein Vorgang, um Datenzugriffzeiten zu verkürzen, die Wartezeit zu reduzieren, und die Geschwindigkeit von Eingabe/Ausgabe (I/A) zu verbessern. Cache für adaptive Formulare speichert nur HTML-Inhalte und JSON-Strukturen eines adaptiven Formulars, ohne die vorausgefüllten Daten zu speichern. Dies hilft, die für die Wiedergabe eines adaptiven Formulars auf dem Client erforderliche Zeit zu verkürzen. Es wurde speziell für adaptive Formulare entwickelt.

Cache für adaptive Formulare bei Autoren- und Veröffentlichungsinstanzenkonfigurieren

  1. Gehen Sie zu AEM Web Console Configuration Manager unter https://[server]:[port]/system/console/configMgr.

  2. Klicken Sie auf Konfiguration für adaptive Formulare und interaktiver Kommunikationswebkanal, um die Konfigurationswerte zu bearbeiten.

  3. Geben Sie im Dialogfeld Konfigurationswerte bearbeiten die maximale Anzahl von Formularen oder Dokumenten an, die eine Instanz des AEM Forms-Servers im Feld Anzahl der adaptiven Forms zwischenspeichern kann. Der Standardwert ist 100.

    HINWEIS

    Um den Cache zu deaktivieren, legen Sie den Wert für die Anzahl adaptiver Formulare auf 0 fest. Der Cache wird zurückgesetzt und alle Formulare und Dokumente werden aus dem Cache entfernt, wenn Sie die Cachekonfiguration deaktivieren oder ändern.

    Dialogfeld für HTML-Cache für adaptive Formulare konfigurieren

  4. Klicken Sie auf Speichern, um die Konfiguration zu speichern.

Ihre Umgebung ist so konfiguriert, dass sie adaptive Formulare und zugehörige Elemente im Cache verwendet.

(Optional) Konfigurieren Sie den Cache für adaptive Formulare beim Dispatcher

Sie können auch die Zwischenspeicherung adaptiver Formulare beim Dispatcher konfigurieren, um die Leistung zu erhöhen.

Voraussetzungen

Überlegungen zum Zwischenspeichern adaptiver Formulare auf einem Dispatcher

  • Verwenden Sie bei Verwendung des Cache für adaptive Formulare die AEM Dispatcher, um Clientbibliotheken (CSS und JavaScript) eines adaptiven Formulars zu zwischenspeichern.
  • Beim Entwickeln der benutzerdefinierten Komponenten muss auf dem für die Entwicklung verwendeten Server der Cache für adaptive Formulare deaktiviert bleiben.
  • URLs ohne Erweiterung werden nicht zwischengespeichert. Beispiel: URL mit Mustermuster/content/forms/[folder-structure]/[form-name].html werden zwischengespeichert, und die Zwischenspeicherung ignoriert URLs mit Muster /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content. Verwenden Sie daher URLs mit Erweiterungen, um die Vorteile der Zwischenspeicherung zu nutzen.
  • Überlegungen zu lokalisierten adaptiven Formularen:
    • Verwenden Sie das URL-Format http://host:port/content/forms/af/<afName>.<locale>.html, um anstelle von http://host:port/content/forms/af/afName.html?afAcceptLang=<locale> eine lokalisierte Version eines adaptiven Formulars anzufordern.
    • Deaktivieren Sie die Verwendung des Browser- Gebietsschemas für URLs mit Format http://host:port/content/forms/af/<adaptivefName>.html.
    • Wenn Sie das URL-Format http://host:port/content/forms/af/<adaptivefName>.html und Browser-Gebietsschema im Configuration Manager verwenden deaktiviert haben, wird die nicht lokalisierte Version des adaptiven Formulars bereitgestellt. Die nicht lokalisierte Sprache ist die Sprache, die bei der Entwicklung des adaptiven Formulars verwendet wird. Das für Ihren Browser konfigurierte Gebietsschema (Browser-Gebietsschema) wird nicht berücksichtigt und es wird eine nicht lokalisierte Version des adaptiven Formulars bereitgestellt.
    • Wenn Sie das URL-Format http://host:port/content/forms/af/<adaptivefName>.html und Browser-Gebietsschema im Konfigurationsmanager verwenden aktiviert haben, wird eine lokalisierte Version des adaptiven Formulars bereitgestellt, sofern verfügbar. Die Sprache des lokalisierten adaptiven Formulars basiert auf dem für Ihren Browser konfigurierten Gebietsschema (Browser-Gebietsschema). Dies kann dazu führen, dass nur die erste Instanz eines adaptiven Formulars [zwischengespeichert wird. ] Um zu verhindern, dass das Problem auf Ihrer Instanz auftritt, lesen Sie Fehlerbehebung.

Zwischenspeicherung beim Dispatcher aktivieren

Führen Sie die folgenden Schritte aus, um die Zwischenspeicherung adaptiver Formulare beim Dispatcher zu aktivieren und zu konfigurieren:

  1. Öffnen Sie die folgende URL für jede Instanz im Veröffentlichungsmodus Ihrer Umgebung und aktivieren Sie den Flush-Agent für Instanzen im Veröffentlichungsmodus Ihrer Umgebung:
    http://[server]:[port]]/etc/replication/agents.publish/flush.html

  2. hinzufügen Sie Folgendes zu Ihrer Datei 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"
       }
    

    Wenn Sie Folgendes hinzufügen:

    • Ein adaptives Formular bleibt im Cache, bis eine aktualisierte Version des Formulars nicht veröffentlicht wird.

    • Wenn eine neuere Version der Ressource veröffentlicht wird, auf die in einem adaptiven Formular verwiesen wird, werden die betroffenen adaptiven Formulare automatisch ungültig. Es gibt einige Ausnahmen von der automatischen Ungültigmachung referenzierter Ressourcen. Eine Problemumgehung zu Ausnahmen finden Sie im Abschnitt Fehlerbehebung.

  3. hinzufügen Sie die folgende Regeldatei dispatcher.any oder benutzerdefinierte Regeldatei. Die URLs, die keine Zwischenspeicherung unterstützen, werden ausgeschlossen. Zum Beispiel Interaktive Kommunikation.

       /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. hinzufügen Sie die folgenden Parameter an die Liste "URL-Parameter ignorieren":

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

Ihre AEM Umgebung ist so konfiguriert, dass adaptive Formulare zwischengespeichert werden. Es speichert alle Arten adaptiver Formulare zwischen. Wenn Sie vor der Bereitstellung der zwischengespeicherten Seite die Benutzerzugriffsberechtigungen für eine Seite überprüfen müssen, lesen Sie Zwischenspeichern geschützter Inhalte.

Fehlerbehebung

Einige adaptive Formulare, die Bilder oder Videos enthalten, werden nicht automatisch aus dem Dispatcher-Cacheungültig gemacht

Problem

Wenn Sie Bilder oder Videos über den Asset-Browser auswählen und zu einem adaptiven Formular hinzufügen und diese Bilder und Videos im Assets-Editor bearbeitet werden, werden adaptive Formulare, die solche Bilder enthalten, nicht automatisch vom Dispatcher-Cache ungültig gemacht.

Lösung

Nach dem Veröffentlichen der Bilder und Videos müssen Sie die Veröffentlichung der adaptiven Formulare, die auf diese Assets verweisen, explizit rückgängig machen und veröffentlichen.

Es wird nur die erste Instanz eines adaptiven Formulars zwischengespeichert

Problem

Wenn die URL des adaptiven Formulars keine Informationen zur lokale Anpassung enthält und Browsergebietsschema verwenden im Konfigurationsmanager aktiviert ist, wird eine lokalisierte Version des adaptiven Formulars bereitgestellt und nur die erste Instanz des adaptiven Formulars wird zwischengespeichert und an jeden nachfolgenden Benutzer gesendet.

Lösung

Führen Sie zur Behebung dieses Problems folgende Schritte durch:

  1. Öffnen Sie die Datei "conf.d/httpd-dispatcher.conf"oder eine andere Konfigurationsdatei, die zur Laufzeit geladen werden soll.

  2. hinzufügen Sie den folgenden Code in Ihrer Datei und speichern Sie ihn. Es handelt sich dabei um einen Beispielcode, mit dem Sie ihn an Ihre Umgebung anpassen können.

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

Auf dieser Seite