3.18. form
| Element type | form |
| Attributes | id | scope |
| Parents | vxml |
| Children | block | catch | error | field | filled | grammar | help | initial | link | noinput | nomatch | object | property | record | script | subdialog | transfer | var |
| Description | A collection of form items that are to be collected through a dialog with the user according to the Form Interpretation Algorithm. |
DTD
<!ELEMENT form (%input; | %event.handler; | filled | initial | object | link | property | record | script | subdialog | transfer | %variable;)* > <!ATTLIST form id ID #IMPLIED scope %scope; 'dialog' >
Language model
Attributes
id : ID
The identifier of a form. It allows the form to be a target of a goto, submit, or subdialog element.
scope : (dialog | document)
Indicates the scope of this form's grammars. It can be dialog or document which the VoiceXML interpreter will translate to local or global scope.
Children
filled elements
These are executed once the form is filled in part or in whole depending on the filled elements' mode and namelist attributes.
form.items
These are to be visited according to the Form Interpretation Algorithm.
grammar elements
Grammars that are active during the execution of this form.
link elements
Links that are active throughout the execution of this form.
property elements
These set properties for the duration of the execution of this form.
script elements
Scripts to be executed upon entry into this form.
var elements
These declare variables that are in scope throughout the execution of this form.
Examples
Example 3-20. Forms and transitioning between forms
<?xml version="1.0" encoding="iso-8859-1"?>
<vxml version="1.0">
<form id="getssn" scope="document">
<field name="ssn" type="digits">
<prompt>Enter your nine digit social security number</prompt>
<filled>
<if cond="ssn.length != '9'">
<clear namelist="ssn"/>
<throw event="nomatch"/>
</if>
</filled>
</field>
<filled>
<goto next="#getdob"/>
</filled>
</form>
<form id="getdob" scope="document">
<field name="dob" type="date">
<prompt>Enter your date of birth</prompt>
</field>
<filled>
<goto next="#final"/>
</filled>
</form>
<form id="final" scope="document">
<block>
<prompt>
Your social security number
<value expr="ssn"/>
and date of birth of
<value expr="dob"/>
have been entered.
</prompt>
</block>
</form>
</vxml>
|