使用XML模式创建自适应表单

前提条件

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

使用XML模式作为表单模型

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

使用XML模式的主要功能有：

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

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

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

XML元素或属性	自适应表单组件
`xs:string`	文本框
`xs:boolean`	复选框
`xs:unsignedInt` `xs:xs:int` `xs:decimal` 所有类型的数值	数值框
`xs:date`	日期选取器
`xs:enumeration`	下拉列表
任何复杂类型元素	面板

示例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模式元素添加以下属性，以向相关自适应表单的字段添加特殊属性。

模式属性	以自适应形式使用	支持
`use=required`	将字段标记为必填	属性
`default="default value"`	添加默认值	元素和属性
`minOccurs="3"`	指定最小发生次数 (对于可重复的子表单（复杂类型）	元素（复杂类型）
`maxOccurs="10"`	指定最大值 (对于可重复的子表单（复杂类型）	元素（复杂类型）

注意

将模式元素拖动到自适应表单时，将通过以下方式生成默认标题：

大写元素名称的第一个字符
在大小写混合边界处插入空白。

例如，如果添加userFirstName模式元素，则自适应表单中生成的描述为User First Name。

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

可以向XML模式元素添加以下限制以限制自适应表单组件可接受的值：

模式属性	数据类型	描述	组件
`totalDigits`	字符串	指定组件中允许的最大数字数。指定的位数必须大于零。	数值框数值步进器
`maximum`	字符串	指定数值和日期的上界。默认情况下，包含最大值。	数值框数值步进器日期选取器
`minimum`	字符串	指定数值和日期的下限。默认情况下，会包括最小值。	数值框数值步进器日期选取器
`exclusiveMaximum`	布尔型	如果为true，则表单组件中指定的数字值或日期必须小于为maximum属性指定的数字值或日期。如果为false，则表单组件中指定的数字值或日期必须小于或等于为maximum属性指定的数字值或日期。	数值框数值步进器日期选取器
`exclusiveMinimum`	布尔型	如果为true，则表单组件中指定的数字值或日期必须大于为最小属性指定的数字值或日期。如果为false，则表单组件中指定的数字值或日期必须大于或等于为最小属性指定的数字值或日期。	数值框数值步进器日期选取器
`minLength`	字符串	指定组件中允许的最少字符数。最小长度必须等于或大于零。	文本框
`maxLength`	字符串	指定组件中允许的最大字符数。最大长度必须大于零。	文本框
`length`	字符串	指定组件中允许的字符数。长度必须等于或大于零。	文本框
`fractionDigits`	字符串	指定组件中允许的最大小数位数。 fractionDigits必须等于或大于零。	数据类型为浮点或小数的数字框
`pattern`	字符串	指定字符的顺序。如果字符符合指定的模式，则组件接受这些字符。模式属性映射到相应自适应表单组件的验证模式。	映射到XSD模式的所有自适应表单组件