建立自訂最適化表單範本

必備條件

適用性表單範本

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

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

預設最適化表單範本

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

  • 基本:可讓您使用左側的索引標籤版面來建立多索引標籤適用性表單,以便以任何隨機順序造訪索引標籤。
  • 基本與Adobe 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

使用範本編輯器建立最適化表單範本

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

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

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

從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:content節點的jcr:titlejcr:description屬性,以區分範本與您複製的範本。

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

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

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

  11. 開啟​Properties​標籤,並將cq:designPath屬性的值變更為/etc/designs/mycompany。

  12. 現在為cq:Page類型建立/etc/designs/mycompany節點。

建立最適化表單頁面元件

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

  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驟(a-d)。如果您的網站沒有現有的contentpage元件,可以保留resourceSuperType屬性以指向OOTB基本頁面。

    1. 對於enrollmentpage節點,將屬性sling:resourceSuperType的值設定為mycompany/components/page/contentpage。 contentpage元件是您網站的基本頁面元件。 其他頁面元件可加以擴充。 移除enrollmentpage下的指令碼檔案,但head.jspcontent.jsplibrary.jsp除外。 sling:resourceSuperType元件(在此例中為contentpage)包含所有此類指令碼。 標題(包括導航欄和頁尾)繼承自contentpage元件。

    2. 開啟檔案head.jsp

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

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

      頁面元件enrollmentpage具有專用的head.jsp檔案,該檔案覆蓋contentpage元件的head.jsp檔案。

    3. contentpage元件的head.jsp檔案中的所有指令碼包含到enrollmentpage元件的head.jsp檔案中。

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

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

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

建立最適化表單用戶端程式庫

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

  • 定義自訂主題,並將預設主題guide.theme.simpleEnrollment替換為自訂主題。
  • 在/etc/designs/mycompany下定義新的用戶端程式庫。 在jsp頁中的預設主題條目後面包括客戶端庫。 在此客戶端庫中包含所有被覆蓋的樣式和其他Java Script檔案。
注意

主題是指包含在頁面元件中用於轉譯最適化表單的用戶端程式庫。 用戶端程式庫主要控制最適化表單的外觀。

本頁內容