Free VoiceXML Resource by C.a.T.S.

<www.vxml.co.za>

<training>

<voicexml tutorial>

Subdialogs

The calling of the subdialog takes place as follow in the same document:

<subdialog name="result" src="#date_check"> 
<!-- The name of the subdialog, and the form id in the subdialog -->
		<param name="Year" expr="1973"/>
		<param name="Age" expr="35"/>
<!-- Two variables named Year and Age are defined with fixed values -->
	    			<filled>
<!-- If the condition of the subdialog is filled, execute the following:-->
				<prompt> The status of your request is  
<!-- Play the value of status-->
<value expr="result.status"/> 		
</prompt>
	    		</filled>
</subdialog> 
<!-- subdialog Starts Here -->
<!-- Comment pointing out where the subdialog starts-->
<form id="date_check">
<!-- The form starting point  -->
  <var name="Year"/>
<!-- Declaration of the variables sent to subdialog -->
  <var name="Age"/>
<!-- Declaration of the variables sent to subdialog -->
    <block>
<!-- Block element which expects no input and only supplies output -->
    	<prompt> The year you entered is <value expr="Year"/> </prompt>
<!-- Prompt playing back the value of the variable Year -->
	<prompt> The age you have entered is <value expr="Age"/> </prompt>
<!-- Prompt playing back the value of the variable Age -->
   <if cond="Year <= 1980">
<!-- "If" condition testing if the variable Year is smaller or equal to 1980   -->
   <var name="status" expr="true"/>
<!-- The value "true" is assigned to the variable "status" if condition is met -->
   </if>
<!-- If element is closed -->
       <if cond="Year >= 1980"> 
       <var name="status" expr="false"/>
       </if>
           <if cond="Age >= 30">
 

<!-- "If" condition testing if the variable Age is greater or equal to 30  -->
           <var name="status" expr="true"/>
           </if>
               <if cond="Age <= 30"> 
               <var name="status" expr="false"/>
               </if>
		<return namelist="status"/>
<!-- The subdialog returns the variable status to the calling dialog -->
    </block>
</form> 
<!-- subdialog Ends Here -->

"If" condition testing if the variable Age is greater or equal to 30:

<var name="status" expr="true"/>
   </if>
       <if cond="Age <= 30"> 
       <var name="status" expr="false"/>
       </if>
<return namelist="status"/>

The subdialog returns the variable status to the calling dialog:

    </block>
</form> 
<!-- subdialog Ends Here -->

The calling of the subdialog takes place as follow if the subdialog is in a separate document:

This complete VXML document calls a subdialog and receives the return value in the result status. The src can be a complete URL, if you use a development environment, check where your workspace is.

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE vxml PUBLIC "-//W3C//DTD VOICEXML 2.1 WVS//EN" "vxml21-0728.dtd">
<vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="en-AU">
<meta name="GENERATOR" content="IBM WebSphere Voice Toolkit" />
<!-- We are calling the Subdialog -->
   <form id="date">
      <subdialog name="result" src="SubDialog.vxml#date_check"> 
         <param name="Year" expr="1978"/>
            <filled>
                 <prompt> The status of your request is  
                         <value expr="result.status"/> </prompt>
            </filled>
      </subdialog>
   </form> 
</vxml>

This complete VXML document contains the sudialog:

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE vxml PUBLIC "-//W3C//DTD VOICEXML 2.1 WVS//EN" "vxml21-0728.dtd">
<vxml version="2.1" xmlns="http://www.w3.org/2001/vxml" xml:lang="en-AU">
<meta name="GENERATOR" content="IBM WebSphere Voice Toolkit" />
<!-- subdialog Starts Here -->
    <form id="date_check">
      <var name="BYear"/> 
          <block>
               <prompt> The year you entered is <value expr="BYear"/>        
	       </prompt>
                  <if cond="Year <= 1980">
                     <var name="status" expr="true"/>
                  </if>
                      <if cond="Year >= 1980"> 
                         <var name="status" expr="false"/>
                      </if>
                           <return namelist="status"/>
          </block>
   </form>
</vxml>

Expiry dates can be used to force the refresh of the subdialog document. Alternatively message can be used.

Now we can go to:
Caller Interactions