Cache für adaptive Formulare konfigurieren

Cachen ist ein Mechanismus zum Verkürzen von Datenzugriffszeiten, zur Reduktion von Wartezeiten und zur Steigerung der Geschwindigkeit der Eingabe/Ausgabe (I/A). Cache für adaptive Formulare speichert nur HTML-Inhalte und JSON-Strukturen eines adaptiven Formulars, ohne die vorausgefüllten Daten zu speichern. Dies hilft bei der Verkürzung der zum Rendern eines adaptiven Formulars auf dem Client erforderlichen Zeit. Sie wurde speziell für adaptive Formulare entwickelt.

Konfigurieren des Cache für adaptive Formulare in Autoren- und Veröffentlichungsinstanzen

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

2. Klicken Sie auf Konfiguration für adaptive Formulare und interaktiven Kommunikations-Web-Kanal, um die Konfigurationswerte zu bearbeiten.

3. Geben Sie im Dialogfeld Bearbeiten der Konfigurationswerte die maximale Anzahl von Formularen oder Dokumenten an, die eine Instanz des AEM Forms-Servers im Feld Anzahl adaptiver Formulare 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.

   

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

Ihre Umgebung ist für die Verwendung von Cache-adaptiven Formularen und zugehörigen Assets konfiguriert.

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

Sie können auch das Zwischenspeichern adaptiver Formulare im Dispatcher konfigurieren, um die Leistung zu verbessern.

Voraussetzungen

• Aktivieren Sie die Option Zusammenführen oder Vorbefüllen von Daten auf Client. Dadurch können eindeutige Daten für jede Instanz eines vorbefüllten Formulars zusammengeführt werden.

Überlegungen zum Zwischenspeichern adaptiver Formulare auf einem Dispatcher

• Verwenden Sie bei Verwendung des Cache für adaptive Formulare die AEM Dispatcher, um Client-Bibliotheken (CSS und JavaScript) eines adaptiven Formulars zwischenzuspeichern.
• 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: URLs mit dem Muster /content/forms/[folder-structure]/[form-name].html werden im Cache abgelegt, während URLs mit dem Muster /content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content von der Caching-Funktion ignoriert werden. Verwenden Sie daher URLs mit Erweiterungen, um die Caching-Vorteile 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 dem Format http://host:port/content/forms/af/<adaptivefName>.html.
  • Wenn Sie das URL-Format http://host:port/content/forms/af/<adaptivefName>.html verwenden und Browsergebietsschema im Konfigurationsmanager deaktiviert ist, 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 eine nicht lokalisierte Version des adaptiven Formulars wird bereitgestellt.
  • Wenn Sie das URL-Format http://host:port/content/forms/af/<adaptivefName>.html und Use Browser Locale im Configuration Manager verwenden, wird eine lokalisierte Version des adaptiven Formulars bereitgestellt, sofern verfügbar. Die Sprache des lokalisierten adaptiven Formulars basiert auf dem Gebietsschema, das für Ihren Browser konfiguriert ist (Browsergebietsschema). Dies kann dazu führen, dass [nur die erste Instanz eines adaptiven Formulars] zwischengespeichert wird. Um zu erfahren, wie Sie diesem Problem vorbeugen können, lesen Sie unter Fehlerbehebung nach.

Aktivieren des Dispatcher-Cache

Führen Sie die folgenden Schritte aus, um das Zwischenspeichern adaptiver Formulare in Dispatcher zu aktivieren und zu konfigurieren:

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

2. Fügen Sie folgende Zeilen in Ihre Datei dispatcher.any ein:

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

   Das Hinzufügen des Obenstehenden bewirkt Folgendes:

   • 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 invalidiert. Beim automatischen Verfall referenzierter Ressourcen bestehen jedoch einige Ausnahmen. Um zu erfahren, wie Sie diese Ausnahmen vermeiden können, lesen Sie den Abschnitt Fehlerbehebung.

3. Fügen Sie die folgenden Regeln dispatcher.any oder einer benutzerdefinierten Regeldatei hinzu. Die URLs ohne Cache-Unterstützung werden ausgeschlossen. So zum Beispiel URLs für 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. Fügen Sie folgende Parameter der Liste „URL-Parameter ignorieren“ hinzu:

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

Ihre AEM-Umgebung ist so konfiguriert, dass sie adaptive Formulare zwischenspeichert. Es werden alle Arten adaptiver Formulare zwischengespeichert. Falls Sie vor Bereitstellung einer zwischengespeicherten Seite die Zugriffsberechtigungen für diese Seite überprüfen müssen, lesen Sie Caching von geschütztem Content.

Fehlerbehebung

Einige adaptive Formulare, die Bilder oder Videos enthalten, werden nicht automatisch aus dem Dispatcher-Cache invalidiert

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 aus dem Dispatcher-Cache invalidiert.

Lösung

Machen Sie nach dem Veröffentlichen der Bilder und Videos die Veröffentlichung der adaptiven Formulare, die auf diese Assets verweisen, explizit rückgängig und veröffentlichen Sie sie.

Nur die erste Instanz eines adaptiven Formulars wird zwischengespeichert

Problem

Wenn die URL des adaptiven Formulars keine Lokalisierungsinformationen enthält und Use Browser Locale im Configuration Manager 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 für das Laden zur Laufzeit konfiguriert ist.

2. Fügen Sie Ihrer Datei folgenden Code hinzu und speichern Sie die Änderung. Es handelt sich dabei um Beispiel-Code, den Sie 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>