建立HTML5表單的自訂描述檔

描述檔是Apache Sling中的資源節點。 它代表HTML5表單轉譯服務的自訂版本。 您可以使用HTML5表單轉譯服務來自訂HTML5表單的外觀、行為和互動。 JCR儲存庫的/content資料夾中存在配置式節點。 您可以將節點直接放在/content資料夾或/content資料夾的任何子資料夾下。

描述檔節點具有​sling:resourceSuperType​屬性，預設值為​xfaforms/profile。 節點的演算指令碼位於/libs/xfaforms/profile。

Sling指令碼是JSP指令碼。 這些JSP指令碼可當成容器，用來將要求表單的HTML和必要的JS / CSS工件組合在一起。 這些Sling指令碼也稱為​Profile Renderer指令碼。 描述檔轉譯器會呼叫FormsOSGi服務，以轉譯所要求的表單。

描述檔指令碼位於html.jsp和html.POST.jsp中，以處理GET和POST請求。 您可以複製並修改一或多個檔案，以覆寫並新增自訂設定。 不要進行任何就地更改，修補程式更新將覆蓋此類更改。

配置檔案包含各種模組。 這些模組包括formRuntime.jsp、config.jsp、toolbar.jsp、formBody.jsp、nav_footer.jsp和footer.jsp。

formRuntime.jsp

formRuntime.jsp模組包含客戶端庫的引用。 它還描述了從請求中提取地區資訊並將本地化消息包含在請求中的方法。 您可以在formRuntime.jsp中加入自己的customJavaScript Libs或樣式。

config.jsp

config.jsp模組包含各種配置，如日誌、代理服務和行為版本。 您可以將自己的配置和Widget自定義添加到config.jsp模組中。 您也可以將自訂介面工具集註冊等組態新增至config.jsp模組。

toolbar.jsp

toolbar.jsp包含用於建立彩色工具欄的代碼。 若要移除工具列，請從HTML.jsp移除toolbar.jsp

formBody.jsp

formBody.jsp模組用於XFA表單的HTML表示。

nav_footer.jsp

一開始，HTML5表格只會轉譯表格的第一頁。 當使用者捲動表格時，會載入其餘的表格。 它讓載入體驗更快速。 nav_footer.jsp元件包含所有樣式和所需元素，以便在捲動時載入頁面。

footer.jsp

footer.jsp模組為空。 它允許您添加僅用於用戶交互的指令碼。

建立自定義配置檔案

要建立自定義配置檔案，請執行以下步驟：

建立配置檔案節點

1. 導覽至URL上的CRX DE介面：https://'[server]:[port]'/crx/de並使用管理員憑據登錄到介面。

2. 在左窗格中，導覽至​/content/xfaforms/profiles​位置。

3. 複製節點預設值，並將節點貼上到名稱為​hrform​的不同資料夾(/content/profiles)中。

4. 選擇新節點​hrform，然後添加字串屬性：sling:resourceType with value:hrform/demo。

5. 按一下工具列選單中的「全部儲存」以儲存變更。

建立配置檔案渲染器指令碼

在建立自訂描述檔後，將演算資訊新增至此描述檔。 在收到對新配置檔案的請求時，CRX將驗證是否存在要呈現的JSP頁的/apps資料夾。 在/apps資料夾中建立JSP頁。

1. 在左窗格中，導覽至/apps資料夾。

2. 按一下右鍵/apps資料夾，然後選擇建立名為​hrform​的資料夾。

3. 在​hrform​資料夾內，建立名為​demo​的資料夾。

4. 按一下​全部保存​按鈕。

5. 導覽至/libs/xfaforms/profile/html.jsp並複製節點​html.jsp。

6. 將​html.jsp​節點貼入上面以相同名稱​html.jsp​建立的/apps/hrform/demo資料夾，然後按一下「儲存​a6/>」。

7. 如果您有任何其他描述檔指令碼元件，請依照步驟1-6複製/apps/hrform/demo檔案夾中的元件。

8. 若要確認已建立描述檔，請開啟URL https://'[server]:[port]'/content/xfaforms/profiles/hrform.html

若要驗證表單，請從本機檔案系統將表單匯入至AEM Forms，並在伺服器作者例項上預覽表AEM單🔗。