設定最適化表單快取 configure-adaptive-forms-cache
快取是一種可縮短資料存取時間、減少延遲以及改善輸入/輸出(I/O)速度的機制。 調適型表單快取只會儲存調適型表單的HTML內容和JSON結構,不會儲存任何預先填入的資料。 它有助於減少在使用者端上轉譯最適化表單所需的時間。 專為適用性表單而設計。
在製作和發佈執行個體設定調適型表單快取 configure-adaptive-forms-caching-at-author-and-publish-instances
-
請前往AEM網頁主控台設定管理員,位於
https://[server]:[port]/system/console/configMgr
. -
按一下 最適化表單和互動式通訊Web頻道設定 以編輯其設定值。
-
在 編輯設定值 對話方塊,指定AEM例項的最大表單數或檔案數 Forms 伺服器可以在以下位置快取: 最適化Forms的數量 欄位。 預設值為 100。
note note NOTE 若要停用快取,請將「最適化Forms數目」欄位中的值設為 0. 當您停用或變更快取設定時,快取會重設,所有表單和檔案都會從快取中移除。 -
按一下 儲存 以儲存組態。
您的環境已設定為使用快取最適化表單和相關資產。
(可選)在Dispatcher設定最適化表單快取 configure-the-cache
您也可以在Dispatcher設定最適化表單快取,以獲得額外的效能提升。
先決條件 pre-requisites
- 啟用 在使用者端合併或預填資料 選項。 它有助於合併預填表單的每個例項的唯一資料。
在Dispatcher上快取自適應表單的考量事項 considerations
-
使用自適應表單快取時,請使用AEM Dispatcher 快取最適化表單的使用者端資料庫(CSS和JavaScript)。
-
開發自訂元件時,在用於開發的伺服器上,停用最適化表單快取。
-
不會快取沒有副檔名的URL。 例如,具有模式的URL
/content/forms/[folder-structure]/[form-name].html
快取,且快取會忽略具有模式的URL/content/dam/formsanddocument/[folder-name]/<form-name>/jcr:content
. 因此,請使用具有擴充功能的URL,以獲得快取的優點。 -
本地化適用性表單的考量事項:
- 使用URL格式
http://host:port/content/forms/af/<afName>.<locale>.html
請求最適化表單的本地化版本,而非http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
- 停用使用瀏覽器地區設定 格式為URL的
http://host:port/content/forms/af/<adaptivefName>.html
. - 當您使用URL格式時
http://host:port/content/forms/af/<adaptivefName>.html
、和 使用瀏覽器地區設定 在configuration manager中停用時,會提供非當地語系化版本的調適型表單。 非當地語系化語言是開發最適化表單時使用的語言。 系統不會考量為瀏覽器設定的地區設定(瀏覽器地區設定),而是提供最適化表單的非當地語系化版本。 - 當您使用URL格式時
http://host:port/content/forms/af/<adaptivefName>.html
、和 使用瀏覽器地區設定 在configuration manager中,會啟用最適化表單的當地語系化版本(如果有的話)。 當地語系化最適化表單的語言取決於瀏覽器設定的地區設定(瀏覽器地區設定)。 這可能導致 [僅快取最適化表單的第一個例項]. 若要防止執行個體發生問題,請參閱 疑難排解.
- 使用URL格式
在Dispatcher上啟用快取
若要在Dispatcher上啟用和設定快取調適型表單,請執行以下步驟:
-
為環境的每個發佈執行個體開啟以下URL,並 為您的環境的發佈執行個體啟用排清代理程式:
http://[server]:[port]]/etc/replication/agents.publish/flush.html
-
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" }
當您新增上述專案時:
-
最適化表單會保留在快取中,直到表單的更新版本未發佈為止。
-
當最適化表單中參考的資源的較新版本發佈時,受影響的最適化表單會自動失效。 參考資源的自動失效有一些例外。 如需例外的因應措施,請參閱 疑難排解 區段。
-
-
新增以下rules 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" }
-
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沒有任何本地化資訊,並且 使用瀏覽器地區設定 在configuration manager已啟用時,會提供最適化表單的本地化版本。 系統只會快取最適化表單的第一個例項,並傳送給每個後續使用者。
解決方案 Solution3
請執行以下步驟來解決問題:
-
開啟「conf.d/httpd-dispatcher.conf」或任何其他設定為在執行階段載入的組態檔。
-
將下列程式碼新增至您的檔案並儲存。 此範常式式碼會加以修改以符合您的環境。
<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>