建立HTML5表單的自訂設定檔 creating-a-custom-profile-for-html-forms

CAUTION
AEM 6.4已結束延伸支援,本檔案不再更新。 如需詳細資訊,請參閱 技術支援期. 尋找支援的版本 此處.

配置檔案是 Apache Sling. 它代表自訂版本的HTML5 forms轉譯服務。 您可以使用HTML5表單轉譯服務來自訂HTML5表單的外觀、行為和互動。 設定檔節點存在於 /content 資料夾。 您可以將節點直接放置在 /content 資料夾或 /content 檔案夾。

設定檔節點具有 sling:resourceSuperType 屬性,預設值為 xfaforms/設定檔. 節點的呈現指令碼位於/libs/xfaforms/profile。

Sling指令碼是JSP指令碼。 這些JSP指令碼用作容器,用於將請求的表單的HTML和所需的JS/CSS對象放在一起。 這些Sling指令碼也稱為 描述檔轉譯器指令碼。 描述檔轉譯器會呼叫Forms OSGi服務,以轉譯請求的表單。

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

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

formRuntime.jsp formruntime-jsp-br

formRuntime.jsp模組包含客戶端庫的引用。 它也描述了從請求中擷取地區設定資訊的方法,以及在請求中包含本地化的訊息。 您可以在formRuntime.jsp中包含自己的自訂javascript lib或樣式。

config.jsp config-jsp

config.jsp模組包含各種配置,如日誌記錄、代理服務和行為版本。 您可以將自己的配置和Widget自定義添加到config.jsp模組中。 您也可以將設定(如自訂Widget註冊)新增至config.jsp模組。

toolbar.jsp toolbar-jsp

toolbar.jsp包含用於建立彩色工具欄的代碼。 要刪除工具欄,請從HTML.jsp中刪除toolbar.jsp

formBody.jsp formbody-jsp

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

起初,HTML5表單僅呈現表單的第一頁。 當使用者捲動表單時,其餘的表單即會載入。 這可讓載入體驗更快。 nav_footer.jsp元件包含所有樣式和所需元素,以便在捲動時載入頁面。

footer.jsp footer-jsp

footer.jsp模組為空。 它可讓您新增僅用於使用者互動的指令碼。

建立自訂設定檔 creating-custom-profiles

若要建立自訂設定檔,請執行下列步驟:

建立設定檔節點 create-profile-node

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

  2. 在左窗格中,導覽至該位置 /content/xfaforms/profiles.

  3. 複製節點預設值,然後將節點貼到不同的資料夾(/content/profiles) hrform.

  4. 選擇新節點, hrform,並新增字串屬性: sling:resourceType 具有值: hrform/demo.

  5. 按一下工具列功能表中的「全部儲存」 ,以儲存變更。

建立設定檔轉譯器指令碼 create-the-profile-renderer-script

建立自訂設定檔後,將轉譯資訊新增至此設定檔。 CRX在接收到對新配置檔案的請求時,將驗證要呈現的JSP頁是否存在/apps資料夾。 在/apps資料夾中建立JSP頁。

  1. 在左窗格中,導覽至 /apps 檔案夾。

  2. 以滑鼠右鍵按一下 /apps 資料夾,並選擇建立具有名稱的資料夾 hrform.

  3. 了解 hrform 資料夾建立名為 示範.

  4. 按一下 全部儲存 按鈕。

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

  6. 貼上 html.jsp 節點 /apps/hrform/demo 在上面建立的資料夾 html.jsp 按一下 儲存.

  7. 如果您有設定檔指令碼的任何其他元件,請依照步驟1至6複製/apps/hrform/demo資料夾中的元件。

  8. 若要確認已建立設定檔,請開啟URL https://[server]:[port]/content/xfaforms/profiles/hrform.html

要驗證表單, 匯入表單 從您的本機檔案系統,到AEM Forms和 預覽表單 在AEM伺服器製作例項上。

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da