使用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模式的所有自适应表单组件

常见问题

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

在内容查找器中多次单击某个元素时,将显示一个字段名称和一个名为bindRef的属性。 此属性将树元素映射到模式中的元素或属性。

XML模式元素的二进制字段

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

注意

属性的bindRef值中有一个@符号,以区分它们与元素。 例如,/config/projectDetails/@duration

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

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

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

您有两种选择:

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

什么是bindRef?

bindRef是自适应表单组件与模式元素或属性之间的连接。 它指定XPath,从此组件或字段捕获的值在输出XML中可用。 从预填充(预填充)XML预填充字段值时,也使用bindRef

在此页面上