HTML5表單的架構 architecture-of-html-forms
架構 architecture
HTML5表單功能會部署為內嵌AEM執行個體中的套件，並使用RESTful Apache Sling架構透過HTTP/S公開為REST端點。
使用Sling架構 using-sling-framework
Apache Sling是以資源為中心。 它會使用請求URL來先解析資源。 每個資源都有 sling：resourceType （或 sling：resourceSuperType）屬性。 接著，會根據此屬性、要求方法和要求URL的屬性，選取sling指令碼來處理要求。 此Sling指令碼可以是JSP或servlet。 對於HTML5表單，設定檔 節點會當作Sling資源，設定檔轉譯器 會當作Sling指令碼，處理使用特定設定檔轉譯行動表單的請求。 設定檔轉譯器 是從請求讀取引數並呼叫Forms OSGi服務的JSP。
如需REST端點和支援的要求引數的詳細資訊，請參閱轉譯表單範本。
當使用者從使用者端裝置(例如iOS或Android™瀏覽器)提出請求時，Sling會先根據請求URL解析設定檔節點。 此設定檔節點會讀取 sling：resourceSuperType 和 sling：resourceType，以決定可處理此表單轉譯器請求的所有可用指令碼。 接著，它會使用Sling要求選取器搭配request方法，以識別最適合處理此要求的指令碼。 請求到達設定檔轉譯器JSP後，JSP會呼叫Forms OSGi服務。
如需Sling指令碼解析的詳細資訊，請參閱AEM Sling速查表或Apache Sling Url分解。
典型的表單處理呼叫流程 typical-form-processing-call-flow
HTML5表單會快取處理（轉譯或提交）第一個請求中的表單所需的所有中間物件。 它不會快取相依於資料的物件，因為這類物件可能會變更。
Mobile Form會維護兩種不同的快取層級：PreRender快取和轉譯器快取。 preRender快取包含已解析範本的所有片段和影像，而轉譯器快取包含HTML等轉譯內容。
HTML5 forms workflow
HTML5表單不會快取遺失片段和影像參考的範本。 如果HTML5表單超過正常所需時間，請檢查伺服器記錄檔中是否有遺漏的參考和警告。 同時請確定未達到物件大小上限。
Forms OSGi服務會以兩個步驟處理請求：
- 產生佈局和初始表單狀態： Forms OSGi轉譯服務會呼叫Forms快取元件，以判斷表單是否已快取且尚未失效。 如果表單已快取且有效，則會從快取中提供產生的HTML。 如果表單失效，Forms OSGi轉譯服務會產生XML格式的初始表單版面和表單狀態。 此XML會由Forms OSGi服務轉換為HTML版面配置和初始JSON表單狀態，然後針對後續請求進行快取。
- 預先填入的Forms：在轉譯時，如果使用者請求具有預先填入資料的表單，則Forms OSGi轉譯服務會呼叫Forms服務容器，並產生具有合併資料的新表單狀態。 不過，由於版面配置已在上述步驟中產生，因此此呼叫的速度會比第一次呼叫快。 此呼叫只會執行資料合併，並對資料執行指令碼，
如果表單中有任何更新，或表單內使用任何資產，表單快取元件會偵測更新，且特定表單的快取會失效。 Forms OSGi服務完成處理後，設定檔轉譯器jsp會新增JavaScript程式庫參考和樣式至此表單，並將回應傳回給使用者端。 一般Web伺服器（例如Apache）可以在此使用，並開啟HTML壓縮。 網頁伺服器可大幅減少回應大小、網路流量，以及伺服器與使用者端電腦之間資料串流所需的時間。
當使用者提交表單時，瀏覽器會將JSON格式的表單狀態傳送至提交服務Proxy；然後提交服務Proxy會使用JSON資料產生資料XML，並將該資料XML提交至提交端點。
元件 components
您需要AEM Forms附加元件套件才能啟用HTML5表單。 如需有關安裝AEM Forms附加元件套件的資訊，請參閱安裝和設定AEM Forms。
OSGi元件(adobe-lc-forms-core.jar) osgi-components-adobe-lc-forms-core-jar
AdobeXFA Forms轉譯器(com.adobe.livecycle.adobe-lc-forms-core) 是從Felix Admin Console (https://[host]：[連線埠]/system/console/bundles)的套件檢視中檢視時，HTML5 forms OSGi套件的顯示名稱。
此元件包含用於轉譯、快取管理和組態設定的OSGi元件。
Forms OSGi服務 forms-osgi-service
此OSGi服務包含將XDP轉譯為HTML的邏輯，並處理表單提交以產生資料XML。 此服務使用Forms服務容器。 Forms服務容器會在內部呼叫執行處理的原生元件XMLFormService.exe。
如果收到轉譯要求，此元件會呼叫Forms服務容器以產生版面和狀態資訊，系統會進一步處理這些資訊以產生HTML和JSON表單DOM狀態。
此元件也負責從提交的表單狀態JSON產生資料XML。
快取元件 cache-component
HTML5 forms使用快取來最佳化輸送量和回應時間。 您可以設定快取服務的層級，以微調效能與空間使用率之間的平衡。
HTML5表單使用LRU策略執行記憶體中的快取。 如果快取策略設為「無」，將不會建立快取，並將清除現有的快取資料（如果有的話）。 除了快取策略之外，您也可以設定記憶體中的快取大小總計，這有助於設定快取大小的最大限制，如果超過此限制，將使用LRU模式來釋放快取資源。
設定服務 configuration-service
「組態服務」可讓您調整HTML5表單的組態引數和快取設定。
若要更新這些設定，請前往CQ FelixAdmin Console(位於https://<'[server]：[連線埠]'/system/console/configMgr)，搜尋並選取「行動Forms設定」。
您可以使用設定服務來設定快取大小或停用快取。 您也可以使用「偵錯選項」引數來啟用偵錯。 您可以在偵錯HTML5表單找到更多有關偵錯表單的資訊。
執行階段元件(adobe-lc-forms-runtime-pkg.zip) runtime-components-adobe-lc-forms-runtime-pkg-zip
執行階段套件包含用於轉譯HTML表單的使用者端程式庫。
執行階段套件中可用的重要元件：
指令碼引擎 scripting-engine
Adobe XFA實作支援兩種指令碼語言，以在表單中啟用使用者定義的邏輯執行：JavaScript和FormCalc。
HTML Forms的指令碼引擎是以JavaScript撰寫的，以支援這兩種語言的XFA指令碼API。
在轉譯時，FormCalc指令碼會轉譯（並快取）至伺服器上的JavaScript，對使用者或設計人員而言是透明的。
此指令碼引擎使用ECMAScript5的某些功能，例如Object.defineProperty。 引擎/程式庫會以CQ使用者端程式庫形式傳送，類別名稱為 xfaforms.profile。 它也提供 FormBridge API 來啟用外部入口網站或應用程式與表單互動。 使用FormBridge，外部應用程式便能以程式設計方式隱藏特定元素、取得或設定其值，或變更其屬性。
如需詳細資訊，請參閱表單Bridge文章。
版面引擎 layout-engine
HTML5表單的版面和視覺方面是根據SVG1.1、jQuery、BackBone和CSS3功能。 表單的初始外觀會在伺服器產生並快取。 使用者端會管理該初始版面的調整，以及表單版面的任何進一步增量變更。 為此，Runtime套件包含以JavaScript撰寫並以jQuery/Backbone為基礎的版面引擎。 此引擎會處理所有動態行為，例如新增/移除可重複例項、可成長物件配置。 此版面引擎一次轉譯一頁的表單。 起初，使用者只檢視一個頁面，而水準卷軸只代表第一個頁面。 但是，當使用者向下捲動時，下一頁開始呈現。 此逐頁轉譯可減少在瀏覽器中轉譯第一頁所需的時間，並增強表單的感知效能。 此引擎/程式庫是類別名稱為 xfaforms.profile 的CQ Client Lib的一部分。
版面引擎也包含一組用於從使用者擷取表單欄位值的Widget。 這些Widget模型化為jQuery UI Widget，可實作特定的額外合約，以順暢地與版面引擎搭配運作。
如需有關Widget與對應合約的詳細資訊，請參閱HTML5表單的自訂Widget。
樣式 styling
與HTML元素相關聯的樣式會內嵌或根據內嵌CSS區塊新增。 有些常見樣式與表單無關，但這些樣式屬於具有類別名稱xfaforms.profile的CQ Client Lib。
除了預設的樣式屬性外，每個表單元素也包含某些以元素型別、名稱和其他屬性為基礎的CSS類別。 使用這些類別，使用者可以透過指定他們自己的CSS來重新設定元素的樣式。
如需預設樣式和類別的詳細資訊，請參閱樣式簡介。
伺服器端指令碼和Web服務 server-side-script-and-web-services
任何標示為在伺服器上執行或標示為呼叫Web服務的指令碼（無論標示為執行的位置為何）一律會在伺服器上執行。
使用者端指令碼引擎：
- 對伺服器發出同步呼叫，以JSON形式傳遞目前的表單狀態
- 在伺服器上執行指令碼或Web服務
- 產生新的JSON狀態
- 當傳回回應時，合併使用者端上的新JSON狀態。
本地化資源組合 localization-resource-bundles
HTML5表單支援義大利文(it)、西班牙文(es)、巴西葡萄牙文(pt_BR)、簡體中文(zh_CN)、繁體中文（僅有限支援） (zh_TW)、韓文(ko_KR)、英文(en_US)、法文(fr_FR)、德文(de_DE)和日文(ja)語言。 根據在請求標頭中接收的地區設定，相應的資源包被傳送到使用者端。 此資源套件已新增到設定檔JSP中，成為類別名稱為 xfaforms.I18N 的CQ使用者端程式庫。 您可以覆寫在設定檔中擷取地區設定套件的邏輯。
Sling元件(adobe-lc-forms-content-pkg.zip) sling-components-adobe-lc-forms-content-pkg-zip
Sling套件包含與設定檔和設定檔轉譯器相關的內容。
設定檔 profiles
設定檔是Sling中的資源節點，代表表單或Forms系列。 在CQ層級，這些設定檔是JCR節點。 節點位於JCR存放庫中的 /content 資料夾下，並且可以位於 /content 資料夾下的任何子資料夾內。
設定檔轉譯器 profile-renderers
設定檔節點具有屬性 sling：resourceSuperType，值為 xfaforms/profile。 此屬性會在內部將要求轉寄給 /libs/xfaforms/profile 資料夾中設定檔節點的sling指令碼。 這些指令碼是JSP頁面，是用來組合HTML表單和必要JS/CSS成品的容器。 這些頁面包含對下列專案的參照：
- xfaforms.I18N。<locale>：此程式庫包含當地語系化的資料。
- xfaforms.profile：此程式庫包含XFA指令碼和配置引擎的實作。
這些程式庫被模型化為CQ使用者端程式庫，這些程式庫會利用CQ架構JavaScript程式庫的自動串連、縮制和壓縮功能。
如需CQ使用者端程式庫的詳細資訊，請參閱CQ Clientlib檔案。
如上所述，設定檔轉譯器JSP透過sling include呼叫Forms服務。 此JSP也會根據管理員設定或請求引數設定各種偵錯選項。
HTML5表單可讓開發人員建立設定檔和設定檔轉譯器，以自訂表單的外觀。 例如，HTML表單可讓開發人員整合現有HTML入口網站面板或<div>區段中的表單。
如需建立自訂設定檔的詳細資訊，請參閱建立自訂設定檔。