文件AEM 6.5使用手冊

設定最適化表單快取 configure-adaptive-forms-cache

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

建立對象：

  • 管理員
  • 使用者

快取是一種可縮短資料存取時間、減少延遲以及改善輸入/輸出(I/O)速度的機制。 調適型表單快取只會儲存調適型表單的HTML內容和JSON結構，不會儲存任何預先填入的資料。 它有助於減少在使用者端上轉譯最適化表單所需的時間。 專為適用性表單而設計。

在製作和發佈執行個體設定調適型表單快取 configure-adaptive-forms-caching-at-author-and-publish-instances

  1. 前往https://[server]:[port]/system/console/configMgr的AEM Web主控台組態管理員。

  2. 按一下​ 最適化表單和互動式通訊Web Channel設定 ​以編輯其設定值。

  3. 在編輯設定值對話方塊中，指定AEM Forms伺服器執行個體可以在​ Number of Adaptive Forms ​欄位中快取的表單或檔案數目上限。 預設值為 100。

    note note
    NOTE
    若要停用快取，請將[最適化Forms數目]欄位中的值設定為​ 0。 當您停用或變更快取設定時，快取會重設，所有表單和檔案都會從快取中移除。

    最適化表單HTML快取的 設定對話方塊

  4. 按一下[儲存]儲存組態。​

您的環境已設定為使用快取最適化表單和相關資產。

（可選）在Dispatcher設定最適化表單快取 configure-the-cache

您也可以在Dispatcher設定最適化表單快取，以獲得額外的效能提升。

必要條件 pre-requisites

  • 啟用在使用者端合併或預填資料。 它有助於合併預填表單的每個例項的唯一資料。

在Dispatcher上快取最適化表單的考量事項 considerations

  • 使用最適化表單快取時，請使用AEM Dispatcher來快取最適化表單的使用者端資料庫(CSS和JavaScript)。

  • 開發自訂元件時，在用於開發的伺服器上，停用最適化表單快取。

  • 不會快取沒有副檔名的URL。 例如，快取模式為/content/forms/[folder-structure]/[form-name].html的URL，而快取會忽略模式為/content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content的URL。 因此，請使用具有擴充功能的URL，以獲得快取的優點。

  • 本地化適用性表單的考量事項：

    • 使用URL格式http://host:port/content/forms/af/<afName>.<locale>.html來要求最適化表單的本地化版本，而非http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
    • 針對格式為http://host:port/content/forms/af/<adaptivefName>.html的URL停用使用瀏覽器地區設定。
    • 當您使用URL格式http://host:port/content/forms/af/<adaptivefName>.html，且組態管理員中的​ 使用瀏覽器地區設定 ​已停用時，會提供非當地語系化版本的調適型表單。 非當地語系化語言是開發最適化表單時使用的語言。 系統不會考量為瀏覽器設定的地區設定（瀏覽器地區設定），而是提供最適化表單的非當地語系化版本。
    • 當您使用URL格式http://host:port/content/forms/af/<adaptivefName>.html，並且啟用Configuration Manager中的​ 使用瀏覽器地區設定 ​時，會提供當地語系化的最適化表單版本（如果有的話）。 當地語系化最適化表單的語言取決於瀏覽器設定的地區設定（瀏覽器地區設定）。 這會導致只快取[最適化表單]的第一個執行個體。 若要防止執行個體發生問題，請參閱疑難排解。

在Dispatcher啟用快取

若要在Dispatcher上啟用並設定快取調適型表單，請執行以下步驟：

  1. 為環境的每個發佈執行個體開啟下列URL，並為環境的發佈執行個體啟用排清代理程式：
    http://[server]:[port]]/etc/replication/agents.publish/flush.html

  2. 將以下專案新增到您的dispatcher.any檔案：

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

    當您新增上述專案時：

    • 最適化表單會保留在快取中，直到表單的更新版本未發佈為止。

    • 當最適化表單中參考的資源的較新版本發佈時，受影響的最適化表單會自動失效。 參考資源的自動失效有一些例外。 如需例外狀況的因應措施，請參閱疑難排解區段。

  3. 新增以下規則dispatcher.any或自訂規則檔案。 它會排除不支援快取的URL。 例如，互動式通訊。

    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. 將下列引數新增至忽略URL引數清單：

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

您的AEM環境已設定為快取最適化表單。 它會快取所有型別的調適型表單。 如果您需要在傳遞快取頁面之前檢查頁面的使用者存取許可權，請參閱快取安全內容。

疑難排解 troubleshooting

某些包含影像或影片的最適化表單不會從Dispatcher快取中自動失效 videos-or-images-not-auto-invalidated

問題 issue1

當您透過資產瀏覽器選取影像或視訊並新增至最適化表單，且在Assets編輯器中編輯這些影像和視訊時，包含這類影像的最適化表單不會自動從Dispatcher快取中失效。

解決方案 Solution1

發佈影像和影片後，請明確取消發佈並發佈參照這些資產的最適化表單。

僅快取最適化表單的第一個例項 only-first-instance-of-adaptive-forms-is-cached

問題 issue3

當最適化表單URL沒有任何本地化資訊，且組態管理員中的​ 使用瀏覽器地區設定 ​已啟用時，會提供最適化表單的本地化版本。 系統只會快取最適化表單的第一個例項，並傳送給每個後續使用者。

解決方案 Solution3

請執行以下步驟來解決問題：

  1. 開啟「conf.d/httpd-dispatcher.conf」或任何其他設定為在執行階段載入的組態檔。

  2. 將下列程式碼新增至您的檔案並儲存。 此範常式式碼會加以修改以符合您的環境。

   <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