建立具有可重複區段的表單 creating-forms-with-repeatable-sections

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

管理員
使用者
開發人員

Adobe 建議使用新式且可擴充的資料擷取核心元件，用來建立新的最適化表單或將最適化表單新增到 AEM Sites 頁面。這些元件代表最適化表單建立方面的重大進步，可確保令人印象深刻的使用者體驗。本文會介紹使用基礎元件編寫最適化表單的舊方法。

可重複區段是可動態新增或移除至表單的面板。

例如，在申請工作時，求職者會提供之前的就業詳細資料，例如公司名稱、角色、專案和其他資訊。所有僱主的資訊都需要不同但外觀相似的區段。在這種情況下，僱用表單會提供僱主區段，並提供動態新增更多此類區段的選項。這些動態新增的區段稱為可重複區段。

您可以使用下列其中一種方法來建立可重複的面板：

透過指令碼使用執行個體管理員 using-instance-manager-via-scripts-nbsp

在編輯模式中，選取面板，然後選取。在側邊欄的[內容]下，啟用 讓面板可重複。指定 最大值 和 最小值 欄位的值。

「最大值」欄位會指定面板在頁面上可出現的最大次數。您可以在「最大計數」欄位中指定–1，讓面板無限次出現。

「最小值」欄位指定面板在表單上顯示的最小次數。如果您將「最小計數」欄位設為零，稍後您可在轉譯完成後透過指令碼移除所有例項。

note note
NOTE
若要建立不可重複的面板，請將「最大值」和「最小值」欄位的值設為1。摺疊式功能表配置在Maximum Count欄位中不支援–1。您可以指定高數字，以提供無限值的概念。

面板的父項（即將重複）應包含新增和刪除按鈕，以管理可重複面板的例項。執行以下步驟，將按鈕插入父項，並在按鈕上啟用指令碼：

從側邊欄中，將按鈕元件拖放至面板的父面板。選取元件並選取。按鈕的規則會在規則編輯器中開啟。

在[規則編輯器]視窗中，按一下[建立]。。

選取[表單物件與函式]列中的 視覺化編輯器。

在規則區域的WHEN下，選取狀態 已按一下。
在THEN底下：
- 若要建立新增面板按鈕，請選取 新增執行個體，並使用拖放面板，或使用 拖放物件或在這裡選取。
- 若要建立刪除面板按鈕，請選取 移除執行個體，然後使用拖放面板，或使用 拖放物件或選取這裡。

選取[表單物件與函式]列中的 程式碼編輯器。按一下 編輯規則，然後在程式碼區域中：

若要建立新增面板按鈕，請指定this.panel.instanceManager.addInstance()
若要建立刪除面板按鈕，請指定this.panel.instanceManager.removeInstance(this.panel.instanceIndex)

按一下 「完成」。

note note
NOTE
如果欄位屬於可重複面板，則無法在指令碼中使用其名稱直接存取它。若要存取欄位，請在`InstanceManager`中使用`instances` API指定欄位所屬的可重複執行個體。在`InstanceManager`中使用`instances` API的語法為：
`<panelName>.instanceManager.instances[<instanceNumber>].<fieldname>`
例如，您可以建立最適化表單，其可重複面板具有文字方塊。當您使用三個可重複的文字方塊預填表單時，您需要以下的xml：
`<panel1><textbox1>AA1</panel1></textbox1>`
`<panel1><textbox1>AA2</panel1></textbox1>`
`<panel1><textbox1>AA3</panel1></textbox1>`
若要讀取AA1資料，請指定：
`Panel1.instanceManager.instances[0].textbox.value`
若要讀取AA2資料，請指定：
`Panel1.instanceManager.instances[1].textbox.value`
如需詳細資訊，請參閱AEM Forms Java API參考中的Class： InstanceManager#instances。

note note
NOTE
從最適化表單中移除面板的所有執行個體時，若要新增已移除面板的執行個體，請使用_panelName語法來擷取面板的執行個體管理員，並使用執行個體管理員的addInstance API來新增已刪除的執行個體。例如，_panelName.addInstance()。它會新增已移除面板的例項。

使用上層面板的收合式選單配置 using-the-accordion-layout-for-the-parent-panel-nbsp

面板有各種版面配置選項。摺疊式設計的「版面配置」選項具有可重複面板的現成支援。執行以下步驟，使用「Layout for accordian design」（摺疊式設計的配置）選項重複面板：

在要重複的面板父項上，選取。您可以在側邊欄中檢視屬性。在配置下拉式清單中，選取 收合式選單。
在要重複的面板上，選取。您可以在側邊欄中看到面板屬性。啟用 讓面板可重複 索引標籤，並指定 最大值 和 最小值 欄位的值。

現在，您可以使用加號(+)和刪除( )按鈕來新增和移除面板。

使用表單範本中的重複子表單(XDP/XSD) using-repeating-subforms-from-form-template-xdp-xsd

可重複子表單類似於最適化Forms中的可重複面板。在AEM Forms Designer中，執行下列步驟以建立重複的子表單：

在「階層」浮動視窗中，選取要重複的子表單的父子表單。
在「物件」浮動視窗中，按一下「子表單」標籤，然後在「內容」清單中，選取「流程」。
選取要重複的子表單。
在「物件」浮動視窗中，按一下「子表單」標籤，然後在「內容」清單中選取「已定位」或「已流動」。
按一下「繫結」標籤，並為每個資料專案選取「重複子表單」。
若要指定最小重複次數，請選取「最小計數」，並在相關方塊中輸入數字。如果此選項設為0，且資料合併時沒有為子表單中的物件提供資料，則轉譯表單時不會放置子表單。
若要指定子表單重複次數的最大值，請選取「最大值」，並在相關方塊中輸入數字。如果您未在「最大值」方塊中指定值，則子表單重複次數將無限制。
若要指定一組子表單重複次數，而不考慮資料數量，請選取「初始計數」，並在相關方塊中輸入數字。如果選取此選項，但無可用資料或資料專案少於指定的初始計數值，則表格上仍會放置子表格的空白執行個體。
在父子表單中新增兩個按鈕 — 一個用於新增例項，另一個用於刪除可重複子表單的例項。如需詳細步驟，請參閱建置動作。
現在將表單範本連結至最適化表單。如需詳細步驟，請參閱根據範本建立最適化表單。
使用在步驟9中建立的按鈕來新增和移除子表單。

附加的.zip檔案包含一個範例可重複的子表單。

取得檔案

使用XML結構描述(XSD)的重複設定 using-repeat-settings-of-an-xml-schema-xsd-br

您可以從XML結構描述以及任何複雜型別元素的minOccours & maxOccurs屬性建立可重複的面板。如需XML結構描述的詳細資訊，請參閱使用XML結構描述作為表單模型建立最適化表單。

在下列程式碼中，SampleType面板使用minOccours & maxOccurs屬性。

<?xml version="1.0" encoding="utf-8" ?>
    <xs:schema targetNamespace="https://adobe.com/sample.xsd"
                    xmlns="https://adobe.com/sample.xsd"
                    xmlns:xs="https://www.w3.org/2001/XMLSchema"
                >

        <xs:element name="sample" type="SampleType"/>

        <xs:complexType name="SampleType">
            <xs:sequence>
                <xs:element name="leaderName" type="xs:string" default="Enter Name"/>
                <xs:element name="assignmentStartDate" type="xs:date"/>
                <xs:element name="gender" type="GenderEnum"/>
                <xs:element name="noOfProjectsAssigned" type="IntType"/>
                <xs:element name="assignmentDetails" type="AssignmentDetails"
                                            minOccurs="0" maxOccurs="10"/>
            </xs:sequence>
        </xs:complexType>

        <xs:complexType name="AssignmentDetails">
            <xs:attribute name="name" type="xs:string" use="required"/>
            <xs:attribute name="durationOfAssignment" type="xs:unsignedInt" use="required"/>
            <xs:attribute name="numberOfMentees" type="xs:unsignedInt" use="required"/>
             <xs:attribute name="descriptionOfAssignment" type="xs:string" use="required"/>
             <xs:attribute name="financeRelatedProject" type="xs:boolean"/>
       </xs:complexType>
  <xs:simpleType name="IntType">
            <xs:restriction base="xs:int">
            </xs:restriction>
        </xs:simpleType>
  <xs:simpleType name="GenderEnum">
            <xs:restriction base="xs:string">
                <xs:enumeration value="Female"/>
                <xs:enumeration value="Male"/>
            </xs:restriction>
        </xs:simpleType>
    </xs:schema>

NOTE

對於非摺疊式版面，請使用最適化表單按鈕元件來新增和移除執行個體。

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2