使用XML架构创建自适应表单 creating-adaptive-forms-using-xml-schema
前提条件 prerequisites
使用XML架构作为其表单模型来创作自适应表单需要对XML架构有基本的了解。 此外,还建议在阅读本文之前阅读以下内容。
使用XML架构作为表单模型 using-an-xml-schema-as-form-model
AEM Forms支持使用现有XML架构作为表单模型来创建自适应表单。 此XML架构表示组织内的后端系统生成或使用数据的结构。
使用XML架构的主要功能包括:
- XSD的结构在自适应表单创作模式的“内容查找器”选项卡中显示为树。 您可以将XSD层次结构中的元素拖放到自适应表单中。
- 您可以使用与关联架构兼容的XML预填充表单。
- 提交时,用户输入的数据将以与关联架构一致的XML形式提交。
XML架构由简单和复杂的元素类型组成。 元素具有可向元素添加规则的属性。 将这些元素和属性拖动到自适应表单上后,会自动将它们映射到相应的自适应表单组件。
XML元素与自适应表单组件的映射如下所示:
示例XML架构 sample-xml-schema
以下是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>
NOTE
确保XML架构只有一个根元素。 不支持具有多个根元素的XML架构。
使用XML架构向字段添加特殊属性 adding-special-properties-to-fields-using-xml-schema
您可以将以下属性添加到XML架构元素,以向关联的自适应表单的字段添加特殊属性。
NOTE
将架构元素拖动到自适应表单时,会生成默认标题:
- 将元素名称的第一个字符大写
- 在驼峰式大小写边界处插入空格。
例如,如果您将
userFirstName
架构元素中,自适应表单中生成的描述为 User First Name
.限制自适应表单组件的可接受值 limit-acceptable-values-for-an-adaptive-form-component
您可以向XML架构元素添加以下限制,以限制自适应表单组件可接受的值:
常见问题 frequently-asked-questions
如何知道树中的哪个元素与哪个XML元素相关联?
在内容查找器中双击某个元素时,弹出窗口会显示一个字段名称和一个名为 bindRef
. 此属性将树元素映射到架构中的元素或属性。
bindRef 字段显示树元素与架构中的元素或属性之间的关联。
NOTE
属性具有
@
符号 bindRef
值,以便与元素区分开来。 例如:/config/projectDetails/@duration
。为什么我无法为可重复的子表单(minOccours或maxOccurs值大于1)拖动子表单的单个元素(从任何复杂类型生成的结构)?
在可重复的子表单中,您必须使用完整的子表单。 如果只希望选择字段,请使用整个结构并删除不需要的字段。
我在内容查找器中有一个很长的复杂结构。 如何查找特定元素?
您有两个选项:
- 滚动浏览树结构
- 使用“搜索”框查找元素
什么是bindRef?
A bindRef
是自适应表单组件与架构元素或属性之间的连接。 它决定了 XPath
其中,从此组件或字段捕获的值在输出XML中可用。 A bindRef
从预填充(预填充)XML预填充字段值时,也会使用。
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da