property

Article
03/26/2013

property element

Specifies speech parameters for an entire application, document, or form. Although the default value for each property is provided below, these values are subject to change. If your voice application relies on a specific value, set the property explicitly in your application root document.

Syntax

<property 
expr = "ECMAScript_Expression"
name = "string"
value = "string"
/>

Attributes

expr	An ECMAScript expression that evaluates to the value assigned to the property. This attribute is a Tellme extension.
value	The value to assign to the property. Values are specific to the property.
name	See the following list of attribute names.

Parents

field, form, initial, menu, object, record, subdialog, transfer, vxml

Children

None.

Remarks

The property element lets you specify default speech parameters for an entire application, vxml, form, or field.

Examples

The following example reads back a fictitious financial news story to the user. The bargeintype property is set to "hotword" because the story is lengthy, and we only want to interrupt the story if the user says "stop." The timeout property is set to zero because we want to transition to the query_repeat_story dialog immediately after the story ends.

<?xml version="1.0"?>
<vxml version="2.1"
 xmlns="http://www.w3.org/2001/vxml">
   <property name="timeout" value="1s"/>

   <form id="read_story">

      <field name="cmd">
         <!-- when story is finished, timeout immediately -->
         <property name="timeout" value="0s"/>
         <!-- only respond when the user says stop -->
         <property name="bargeintype" value="hotword"/>
         
         <prompt>
            <!-- play a story. typically this story would 
                 come from a dynamic feed -->
         On Wall Street today, 
         tech stocks rallied with the naz dack climbing 200 points. 
         Telecommunication giant A T and T 
         gained a collosal thirty points while software 
         maker Microsoft gained a strong twenty points 
         thanks to strong quarterly earnings.
         <break/>
         </prompt>
         
         <grammar mode="voice"
         root="root_rule"
         tag-format="semantics/1.0"
         type="application/srgs+xml"
         version="1.0"
         xml:lang="en-US">
                  <rule id="root_rule" scope="public">
                           <one-of>
                                    <item>
                                             <one-of>
                                                      <item>
                                                               stop
                                                      </item>
                                             </one-of>
                                             <tag>out.cmd = "cmd_stop";</tag>
                                    </item>
                           </one-of>
                  </rule>

         </grammar>

   
         <noinput><goto next="#query_repeat_story"/></noinput>
   
         <filled><goto next="#query_repeat_story"/></filled>

      </field>
   </form>

   <form id="query_repeat_story">
      <field type="boolean" name="yesno">

         <prompt>Do you want to hear this story again?</prompt>

         <catch event="noinput nomatch">
            Sorry. I didn't get that. 
            Please say yes to hear the story again.
            Say no to return to the main menu.
         </catch>
      </field>

      <filled>
         <if cond="yesno">
            <goto next="#read_story"/>
         <else/>
            <exit />
         </if>
      </filled>
   </form>
</vxml>