创建包含可重复部分的表单

可重复部分是可动态添加到表单或从中移除的面板。

例如，求职者在申请工作时，提供以前的雇佣详细信息，如公司名称、角色、项目和其他信息。 所有雇主的信息要求不同但外观相似的部门。 在这种情况下，雇佣表单会提供一个雇主部分，并提供动态添加更多此类部分的选项。 这些动态添加的部分称为可重复部分。

您可以使用以下方法之一来创建可重复面板：

通过脚本使用实例管理器 

  1. 在编辑模式下，选择一个面板，然后点按 cmppr. 在侧栏中的属性下，启用 使面板可重复. 指定值 最大值 和 最小值 字段。

    “最大值”字段指定面板在页面上可出现的最大次数。 可以在Maximum Count字段中指定–1 ，以允许面板无限次显示。

    “最小值”字段指定面板在表单上显示的最小次数。 如果将Minimum Count字段设置为零，则以后可以在演绎版完成之后通过脚本删除所有实例。

    注意

    要创建不可重复的面板，请将“最大值”和“最小值”字段的值设置为1。 折叠面板布局在Maximum Count字段中不支持–1。 可以指定高数字来给出无限值的概念。

  2. 面板的父项（要重复）应包含添加和删除按钮以管理可重复面板的实例。 执行以下步骤，将按钮插入到父代，并在按钮上启用脚本：

    1. 从侧栏中，将按钮组件拖放到面板的父面板。 选择组件并点按 edit-rules. 按钮的规则将在规则编辑器中打开。

    2. 在规则编辑器窗口中，单击 创建.

      选择 可视编辑器 “表单对象和函数”行中的。

      1. 在规则区域的WHEN下，选择state 已单击.

      2. 在THEN下：

        • 要创建添加面板按钮，请选择 添加实例，并使用拖放面板 切换侧面板 或使用以下方式选择它 拖放对象或在此选择。
        • 要创建删除面板按钮，请选择 删除实例，并使用拖放面板 切换侧面板 或使用以下方式选择它 拖放对象或在此选择。

      选择 代码编辑器 “表单对象和函数”行中的。 单击 编辑规则 在代码区域中：

      • 要创建添加面板按钮，请指定 this.panel.instanceManager.addInstance()
      • 要创建删除面板按钮，请指定 this.panel.instanceManager.removeInstance(this.panel.instanceIndex)

      单击​完成。

      注意

      如果某个字段属于可重复面板，则无法在脚本中直接使用该字段名称访问该字段。 要访问字段，请使用指定字段所属的可重复实例 instances 中的API InstanceManager. 使用的语法 instances 中的API InstanceManager 为：

      <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

      有关详细信息，请参阅中的Class： InstanceManager#instances AEM Forms Java API参考.

      注意

      从自适应表单中删除面板的所有实例时，要添加已删除面板的实例，请使用_panelName语法捕获面板的实例管理器，并使用实例管理器的addInstance API添加已删除的实例。 例如，_panelName.addInstance()。 它会添加已删除面板的一个实例。

使用父面板的可折叠项布局  

面板具有各种布局选项。 折叠式设计选项的布局对可重复面板提供开箱即用支持。 对带有Layout for accordian设计选项的可重复面板执行以下操作：

  1. 在要重复的面板的父面板上，点按 cmppr. 您可以在侧栏中看到属性。 在 版面 下拉列表，选择 可折叠项.

  2. 在要重复的面板上，点按 cmppr. 您可以在侧栏中看到面板属性。 启用 使面板可重复 选项卡，并指定 最大值 和 最小值 字段。

    现在，您可以使用加号(+)并删除( delete-panel)按钮以添加和移除面板。

使用表单模板中的重复子表单(XDP/XSD)

可重复子表单类似于自适应Forms中的可重复面板。 在AEM Forms Designer中，执行以下步骤以创建重复的子表单：

  1. 在层次面板中，选择要重复的子表单的父子表单。
  2. 在“对象”面板中，单击“子表单”选项卡，然后在“内容”列表中选择“流式”。
  3. 选择要重复的子表单。
  4. 在“对象”面板中，单击“子表单”选项卡，然后在“内容”列表中选择“已定位”或“已流动”。
  5. 单击“绑定”选项卡，并为每个数据项选择“重复子表单”。
  6. 要指定最小重复次数，请选择最小计数，然后在关联的框中键入一个数字。 如果将此选项设置为0，并且在数据合并时没有为子表单中的对象提供数据，则在渲染表单时不会放置子表单。
  7. 要指定子表单重复的最大次数，请选择“最大”，然后在相关框中键入一个数字。 如果未在“最大值”框中指定值，则子表单重复次数将无限制。
  8. 要指定一组子表单重复次数，而不考虑数据量，请选择“初始计数”，然后在相关框中键入一个数字。 如果选择此选项，并且没有可用数据，或者存在的数据条目少于指定的“初始计数”值，则子表单的空实例仍会放置在表单上。
  9. 在父子表单中添加两个按钮 — 一个用于添加实例，另一个用于删除可重复子表单的实例。 有关详细步骤，请参阅 构建操作.
  10. 现在，将表单模板链接到自适应表单。 有关详细步骤，请参阅 基于模板创建自适应表单.
  11. 使用步骤9中创建的按钮添加和删除子表单。

附加的.zip文件包含一个示例可重复的子表单。

获取文件

使用XML架构(XSD)的重复设置

您可以从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>
注意

对于非折叠布局，使用自适应表单按钮组件添加和删除实例。

在此页面上