< initial >

< initial >

Description

The < initial > element declares initial logic upon entry into a mixed-initiative form. Unlike < field >, < initial > has no grammars and no < filled > action. < initial > can request user input and handle events. < initial > continues to be visited while its form item variable is undefined and its condition is true. When any of the form’s fields are filled in by user input, then all < initial > form item variables are set to true, before any < filled > actions are executed. Then the form will visit those fields that are still unfilled to complete the form.

Syntax

<initial
name="String"
expr="ECMAScript_Expression"
cond="ECMAScript_Expression">
child elements
</initial>

Attributes

name	The name attribute represents the name of form item variable used. Use this variable if you want to explicitly control the <initial> execution. This attribute is optional and defaults to an inaccessible internal variable.
expr	The expr attribute is the initial value of the form item variable. < initial > will be visited only if the expression evaluates to undefined. This attribute is optional and defaults to undefined.
cond	The cond attribute is a Boolean condition that must evaluate to true in order for the <initial> element to be visited. This attribute is optional and defaults to true.

Parents

<form>

Children

<audio>, <catch>, <error>, <help>, <link>, <noinput>, <nomatch>, <prompt>, <property>, <value>

Extensions

None.

Limitations/Restrictions

None.

Example Code

<?xml version="1.0"?>
<vxml version="2.0" xmlns="http://www.w3.org/2001/vxml">
 <form id="product">
  <grammar type="text/x-grammar-choice-dtmf">
   1 {uno} |
   2 {dos} |
   3 {tres} |
   4 {cuatro} |
   5 {cinco}
  </grammar>
  <block>
   Welcome to the Product Information By Phone.
  </block>
  <initial name="id_product">
   <prompt>Enter the product ID?</prompt>
   <nomatch count="1">
    Please say something like this,
    "1 2 2 3 4".
   </nomatch>
   <nomatch count="2">
    I'm sorry, I still don't understand.
    I'll ask you for information one piece at a time.
    <assign name="id_product" expr="true"/>
    <reprompt/>
   </nomatch>
  </initial>
  <field name="color_product">   
   <prompt>From which city are you leaving?</prompt>
  </field>
  <field name="form_product">
   <prompt>Which city are you going to?</prompt>
  </field>
  <block>
    <prompt>
      You said that you wanted <value expr="color_product"/>
      <value expr="color_product"/>.
    </prompt>
  </block>
 </form>
</vxml>

Table of Contents