使用XML架构创建自适应表单

前提条件

使用XML架构作为其表单模型来创作自适应表单需要对XML架构有基本的了解。 此外，还建议在阅读本文之前阅读以下内容。

• 创建自适应表单
• XML 架构

使用XML架构作为表单模型

AEM Forms支持使用现有XML架构作为表单模型来创建自适应表单。 此XML架构表示组织内的后端系统生成或使用数据的结构。

使用XML架构的主要功能包括：

• XSD的结构在自适应表单创作模式的“内容查找器”选项卡中显示为树。 您可以将XSD层次结构中的元素拖放到自适应表单中。
• 您可以使用与关联架构兼容的XML预填充表单。
• 提交时，用户输入的数据将以与关联架构一致的XML形式提交。

XML架构由简单和复杂的元素类型组成。 元素具有可向元素添加规则的属性。 将这些元素和属性拖动到自适应表单上后，会自动将它们映射到相应的自适应表单组件。

XML元素与自适应表单组件的映射如下所示：

XML架构示例

以下是XML架构的示例。

<?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="assignmentStartBirth" 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>

使用XML架构向字段添加特殊属性

您可以将以下属性添加到XML架构元素，以向关联的自适应表单的字段添加特殊属性。

限制自适应表单组件的可接受值

您可以向XML架构元素添加以下限制，以限制自适应表单组件可接受的值：

常见问题

如何知道树中的哪个元素与哪个XML元素相关联？

在内容查找器中双击某个元素时，弹出窗口会显示一个字段名称和一个名为bindRef的属性。 此属性将树元素映射到架构中的元素或属性。

bindRef字段显示树元素与架构中元素或属性之间的关联。

为什么我无法为可重复的子表单（minOccours或maxOccurs值大于1）拖动子表单的单个元素（从任何复杂类型生成的结构）？

在可重复的子表单中，您必须使用完整的子表单。 如果只希望选择字段，请使用整个结构并删除不需要的字段。

我在内容查找器中有一个很长的复杂结构。如何查找特定元素？

您有两个选项：

• 滚动浏览树结构
• 使用“搜索”框查找元素

什么是bindRef?

bindRef是自适应表单组件与架构元素或属性之间的连接。 它指示XPath，在输出XML中，可从此组件或字段捕获的值可用。 从预填充（预填充）XML中预填充字段值时，也会使用bindRef。