====== < 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 =====

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

===== 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 =====

<code>
<form>
</code>

===== Children =====

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

===== Extensions =====

<code>
None.
</code>

===== Limitations/Restrictions =====

<code>
None.
</code>

===== Example Code =====

<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>
</code>