Creating adaptive forms using XML Schema creating-adaptive-forms-using-xml-schema

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

Prerequisites prerequisites

Authoring an adaptive form using an XML schema as its form model requires basic understanding of XML schemas. Also, it is recommended to read through the following content before this article.

Using an XML schema as form model using-an-xml-schema-as-form-model

AEM Forms supports creation of an adaptive form by using an existing XML schema as the form model. This XML schema represents the structure in which data is produced or consumed by the back-end system in your organization.

The key features of using an XML schema are:

  • The structure of the XSD is displayed as a tree in the Content Finder tab in the authoring mode for an adaptive form. You can drag and add element from the XSD hierarchy to the adaptive form.
  • You can pre-populate the form using XML that is compliant with the associated schema.
  • On submission, the data entered by the user is submitted as XML that aligns with the associated schema.

An XML schema consists of simple and complex element types. The elements have attributes that add rules to the element. When these elements and attributes are dragged onto an adaptive form, they are automatically mapped to the corresponding adaptive form component.

This mapping of XML elements with adaptive form components is as follows:

XML element or attribute
Adaptive form component
xs:string
Text box
xs:boolean
Check box
  • xs:unsignedInt
  • xs:xs:int
  • xs:decimal
  • All types of numerical values
Numeric box
xs:date
Date picker
xs:enumeration
Drop down
Any complex-type element
Panel

Sample XML Schema sample-xml-schema

Here’s an example of an XML schema.

<?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
Ensure that your XML schema has only one root element. An XML schema with more than one root element is not supported.

Adding special properties to fields using XML schema adding-special-properties-to-fields-using-xml-schema

You can add the following attributes to XML Schema elements to add special properties to the fields of the associated adaptive form.

Schema property
Use in adaptive form
Supported in
use=required
Marks a field mandatory
Attribute
default="default value"
Adds a default value
Element and attribute
minOccurs="3"

Specifies minimum occurrences

(For repeatable subforms (complex types))

Element (complex type)
maxOccurs="10"

Specifies maximum occurrences

(For repeatable subforms (complex types))

Element (complex type)
NOTE
When you drag a schema element to an adaptive form, a default caption is generated by:
  • Capitalizing the first character of the element name
  • Inserting white space at Camel Case boundaries.
For example, if you add the userFirstName schema element, the caption generated in the adaptive form is User First Name.

Limit acceptable values for an adaptive form component limit-acceptable-values-for-an-adaptive-form-component

You can add the following restrictions to XML schema elements to limit the values acceptable to an adaptive form component:

Schema property
Data Type
Description
Component
totalDigits
String
Specifies the maximum number of digits allowed in a component. The number of digits specified must be greater than zero.
  • Numeric box
  • Numeric Stepper
maximum
String
Specifies the upper bound for numeric values and dates. By default, the maximum value is included.
  • Numeric box
  • Numeric Stepper
  • Date Picker
minimum
String
Specifies the lower bound for numeric values and dates. By default, the minimum value is included.
  • Numeric box
  • Numeric Stepper
  • Date Picker
exclusiveMaximum
Boolean

If true, the numeric value or date specified in the component of the form must be less than the numeric value or date specified for the maximum property.

If false, the numeric value or date specified in the component of the form must be less than or equal to the numeric value or date specified for the maximum property.

  • Numeric box
  • Numeric Stepper
  • Date Picker
exclusiveMinimum
Boolean

If true, the numeric value or date specified in the component of the form must be greater than the numeric value or date specified for the minimum property.

If false, the numeric value or date specified in the component of the form must be greater than or equal to the numeric value or date specified for the minimum property.

  • Numeric box
  • Numeric Stepper
  • Date Picker
minLength
String
Specifies the minimum number of characters allowed in a component. The minimum length must be equal to or greater than zero.
  • Text box
maxLength
String
Specifies the maximum number of characters allowed in a component. The maximum length must be greater than zero.
  • Text box
length
String
Specifies the exact number of characters allowed in a component. The length must be equal to or greater than zero.
  • Text box
fractionDigits
String
Specifies the maximum number of decimal places allowed in a component. The fractionDigits must be equal to or greater than zero.
  • Numeric Box with data type float or decimal
pattern
String

Specifies the sequence of the characters. A component accepts the characters if the characters conform to specified pattern.

The pattern property maps to the validation pattern of the corresponding adaptive form component.

  • All adaptive forms components which are mapped to an XSD schema

Frequently asked questions frequently-asked-questions

How do I know which element in the tree is associated with which XML element?

When you double-click an element in Content Finder, a pop-up displays a field name and a property called bindRef. This property maps the tree element to the element or attribute in the schema.

A bindref field of an XML schema element

The bindRef field shows the association between a tree element and an element or attribute in a schema.

NOTE
Attributes have an @ symbol in their bindRefvalue to distinguish them from elements. For example, /config/projectDetails/@duration.

Why I am not able to drag individual elements of a subform (structure generated from any complex type) for repeatable subforms (minOccours or maxOccurs values are greater than 1)?

In a repeatable subform, you must use the complete subform. If you want only selective fields, use the entire structure and delete the unwanted ones.

I have a long complex structure in Content Finder. How can I find a specific element?

You have two options:

  • Scroll through the tree structure
  • Use the Search box to find an element

What is a bindRef?

A bindRef is the connection between an adaptive form component and a schema element or attribute. It dictates the XPath where the value captured from this component or field is available in the output XML. A bindRefis also used when prepopulating a field value from prefilled (prepopulated) XML.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da