建立自訂最適化表單範本 creating-a-custom-adaptive-form-template

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

必備條件 prerequisites

最適化表單範本 adaptive-form-template

適用性表單範本是專用的AEM頁面範本,具有用於建立適用性表單的特定屬性和內容結構。 範本有預先設定的配置、樣式和基本初始內容結構。

建立表單後,對原始範本內容結構所做的任何變更都不會反映在表單中。

預設最適化表單範本 default-adaptive-form-templates

AEM快速入門提供下列最適化表單範本:

  • 基本:可讓您使用左側的索引標籤版面來建立多索引標籤最適化表單,以便以任何隨機順序造訪索引標籤。
  • 基本與Acrobat Sign:可讓您使用多個索引標籤和精靈建立表單。 它使用左上標籤版面,可讓您以任何順序造訪標籤。 它使用Adobe Document Cloud設計服務進行簽署和驗證。
  • 空白範本:可讓您建立表單,不含任何頁首、頁尾和初始內容。 您可以新增元件,例如文字方塊、按鈕和影像。 空白範本可讓您建立表單 內嵌於AEM網站頁面.

這些範本具有 sling:resourceType 屬性設為對應的頁面元件。 頁面元件會轉譯CQ頁面,其中包含最適化表單容器,而最適化表單則轉譯為最適化表單。

下表列舉範本與頁面元件之間的關聯:

範本
頁面元件
/libs/fd/af/templates/surveyTemplate
/libs/fd/af/components/page/survey
/libs/fd/af/templates/simpleEnrollmentTemplate
/libs/fd/af/components/page/base
/libs/fd/af/templates/tabbedEnrollmentTemplate
/libs/fd/af/components/page/tabbedenrollment
/libs/fd/afaddon/templates/advancedEnrollmentTemplate
/libs/fd/afaddon/components/page/advandenrollment

使用範本編輯器建立最適化表單範本 creating-an-adaptive-form-template-using-template-editor

您可以使用範本編輯器來指定最適化表單的結構和初始內容。 例如,您希望所有表單作者在註冊表單中都有幾個文本框、導航按鈕和提交按鈕。 您可以建立模板,供作者用來建立與其他註冊表單一致的表單。 AEM範本編輯器可讓您:

  • 在結構層中添加表單的頁眉和頁腳元件
  • 提供表單的初始內容。
  • 指定主題。
  • 指定提交、重設和導覽等動作。

如需詳細資訊,請參閱 範本編輯器.

從CRXDE建立最適化表單範本 creating-an-adaptive-form-template-from-crxde

您可以建立範本,並使用範本建立最適化表單,而不使用可用的範本。 自訂範本是以參考最適化表單容器和頁面元素(例如頁首和頁尾)的各種頁面元件為基礎。

您可以使用網站的基礎頁面元件來建立這些元件。 或者,您也可以擴充使用現成範本的最適化表單的頁面元件。

執行以下步驟以建立自定義模板,如simpleEnrollmentTemplate。

  1. 導覽至製作執行個體上的CRXDE Lite。

  2. 在/apps目錄下,建立應用程式的資料夾結構。 例如,如果應用程式名稱為mycompany,請建立具有此名稱的資料夾。 應用程式資料夾通常包含元件、配置、模板、src和安裝目錄。 在此範例中,建立元件、設定和範本資料夾。

  3. 導覽至資料夾/libs/fd/af/templates。

  4. 複製 simpleEnrollmentTemplate 節點。

  5. 導覽至資料夾/apps/mycompany/templates。 按一下右鍵並選擇 貼上.

  6. 如有必要,請重新命名您複製的範本節點。 例如,將其更名為註冊模板。

  7. 導覽至/apps/mycompany/templates/enrollment-template位置。

  8. 修改 jcr:titlejcr:description 屬性 jcr:content 節點,以區分範本與您複製的範本。

  9. jcr:content 已修改模板的節點包含 guideContainerguideformtitle 元件。 guideContainer 是容納最適化表單的容器。 此 guideformtitle 元件顯示應用程式名稱、說明等。

    而非 guideformtitle,您可以包含自訂元件,或 parsys 元件。 例如,移除 guideformtitle,並新增自訂元件或 parsys 元件節點。 確保 sling:resourceType 元件的屬性會參考元件,而相同的屬性會在頁面中定義 component.jsp 檔案。

  10. 導覽至/apps/mycompany/templates/enrollment-template/jcr:content位置。

  11. 開啟 屬性 ,並變更 cq:designPath 屬性轉換為/etc/designs/mycompany。

  12. 現在,為 cq:Page 類型。

建立最適化表單頁面元件 create-an-adaptive-form-page-component

自訂範本的樣式與預設範本相同,因為範本會參照頁面元件/libs/fd/af/components/page/base。 可以將元件引用作為屬性來查找 sling:resourceType 在節點/apps/mycompany/templates/enrollment-template/jcr:content中定義。 由於基礎是核心產品元件,因此請勿修改此元件。

  1. 導覽至節點/apps/mycompany/templates/enrollment-template/jcr:content並修改屬性的值 sling:resourceType 到/apps/mycompany/components/page/enrollmentpage

  2. 將節點/libs/fd/af/components/page/base複製到資料夾/apps/mycompany/components/page。

  3. 將複製的元件更名為 enrollmentpage.

  4. (只有在您已有內容頁面時) 如果您已有 contentpage元件。 如果您沒有現有 contentpage元件,可將 resourceSuperType屬性來指向OOTB基頁。

    1. enrollmentpage 節點,設定屬性的值 sling:resourceSuperType 至mycompany/components/page/contentpage。 此 contentpage 元件是您網站的基礎頁面元件。 其他頁面元件可加以擴充。 移除下方的指令碼檔案 enrollmentpage,除 head.jsp, content.jsp,和 library.jsp. 此 sling:resourceSuperType 元件, contentpage 在此情況下,會包含所有這類指令碼。 標題(包括導覽列和頁尾)繼承自 contentpage 元件。

    2. 開啟檔案 head.jsp.

      JSP檔案包含行 <cq.include script="library.jsp"/>.

      library.jsp 檔案包含 guide.theme.simpleEnrollment 用戶端程式庫,其中包含最適化表單的樣式。

      頁面元件 enrollmentpage 有獨家 head.jsp 會覆寫 head.jsp 檔案 contentpage 元件。

    3. head.jsp 檔案 contentpage 元件 head.jsp 檔案 enrollmentpage 元件。

    4. content.jsp 指令碼中,您可以新增其他頁面內容或參考至頁面呈現時包含的其他元件。 例如,如果您新增自訂元件 applicationformheader,請確保將以下引用添加到JSP檔案中的元件:

      <cq:include path="applicationformheader" resourceType="mycompany/components/applicationformheader"/>

      同樣地,如果您新增 parsys 元件(在範本節點結構中),也包含自訂元件。

建立最適化表單用戶端程式庫 creating-an-adaptive-form-client-library

head.jsp 檔案 enrollmentpage 新範本的元件包含用戶端程式庫 guide.theme.simpleEnrollment. 預設模板還使用此客戶端庫。 使用下列方法的,更改新模板中的樣式:

  • 定義自訂主題並取代預設主題 guide.theme.simpleEnrollment 搭配自訂主題。
  • 在/etc/designs/mycompany下定義新的用戶端程式庫。 在jsp頁中的預設主題條目後面包括客戶端庫。 在此客戶端庫中包含所有被覆蓋的樣式和其他Java Script檔案。
NOTE
主題是指包含在頁面元件中用於轉譯最適化表單的用戶端程式庫。 用戶端程式庫主要控制最適化表單的外觀。
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da