Plum Voice Platform Programmer's Reference Manual

fetchaudio	The URI of the audio clip to play while the fetch is being done. If not specified, the fetchaudio property is used, and if that property is not set, no audio is played during the fetch. The fetching of the audio clip is governed by the audiofetchhint, audiomaxage, audiomaxstale, and fetchtimeout properties in effect at the time of the fetch. The playing of the audio clip is governed by the fetchaudiodelay, and fetchaudiominimum properties in effect at the time of the fetch.
fetchhint	This attribute is not supported.
fetchtimeout	(defaults to "fetchtimeout" global property value) The timeout for fetches. Must be specified with the appropriate time units (e.g., "120s" for 120 seconds).
maxage	(defaults to "documentmaxage" global property value) Tells the platform the maximum acceptable age, in seconds, of cached documents.
maxstale	(defaults to "documentmaxstale" global property value) Tells the platform the maximum acceptable staleness, in seconds, of expired cached documents.
next	The URI to go to. This URI is a document (perhaps with an anchor to specify the starting dialog) or a dialog in the current document (just a bare anchor).
expr	Like next, except that the URI is dynamically determined by evaluating the given ECMAScript expression.
dtmf	The DTMF sequence for this link. It is equivalent to a simple DTMF <grammar> and DTMF properties to recognition of the sequence.
event	Specify an event to be thrown instead of specifying a next.
eventexpr	An ECMAScript expression evaluating to the name of the event to be thrown.
message	A message string providing additional context about the event being thrown. The message is available as the value of the variable "_message" within the scope of the catch element.
messageexpr	An ECMAScript expression evaluating to the message string.

Child Tags
<grammar>

Parent Tags
<field>, <form>, <initial>, <vxml>

Notes
Exactly one of "next", "expr", "event", and "eventexpr" must be specified. Exactly one of "message" and "messageexpr" may be specified.

Example

<?xml version="1.0"?>
<vxml version="2.0">
    <form>
        <!-- These two links are active for all field items within this -->
        <!-- form only. -->
        <link event="assistance">
            <grammar>
                ( Operator | Assistance )
            </grammar>
        </link>
        <link next="http://nonexistent.domain.com/weather.vxml">
            <grammar>
                weather
            </grammar>
        </link>
        <block>
            <prompt>
                You can say "Operator Assistance" or "weather" at any
                time within this form and you'll be forwarded to the
                assistance dialog or weather dialog.
            </prompt>
        </block>
        <field name="tempfield" type="digits">
            <prompt>
                Enter digits or say "Operator Assistance" or "weather".
            </prompt>
        </field>
        <catch event="assistance">
            <prompt>
                Sorry, there is no operator assistance available.
            </prompt>
        </catch>
    </form>
</vxml>

An interaction with the above script could be:

Computer: You can say "Operator Assistance" or "weather" at any time within this form and you'll be forwarded to the...
Human: (interrupts) Operator.
Computer: Sorry, there is no operator assistance available.