Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Live Forms automatically  automatically manages the set of XML instance documents that are generated by a submitted form to ensure that it is valid with respect to the [[#Document_Types| document types ]] in the form. The validity of values is enforced as described above and in discussion on [[V4_Designing_Forms#Pattern | patterns]]in Valid Forms and in the discussion on patterns.

However, Live Forms   also ensures that the structure of a submitted document conforms to its type. This is best explained with an example. Consider the following schema fragment uploaded to Live Forms.

Code Block
<xsd:element name="customer">   
  <xsd:complexType>     
   <xsd:sequence>       
     <xsd:element name="firstname" type="xsd:string"/>        
     <xsd:element name="lastname" type="xsd:string"/>
     <xsd:element name="fullname" type="xsd:string"/>      
   </xsd:sequence>   
  </xsd:complexType> 
</xsd:element>

and assume Assume that the user adds the element customer to the form's types. All three elements (firstname, lastname and fullname) are required by the type. But, the form designer is not obligated to add all three controls to the form. Let's say the designer adds controls for firstname and lastname but omits fullname. The form will have two invalid controls when initially loaded and the submit button is disabled.

...

However, this would generate an invalid XML document with respect to the schema since the schema specifies that a customer must also have a fullname. Live Forms   manages this automatically by creating an empty fullname element in the document. The generated document looks like:

...