<vxml>

Description

Identifies a VoiceXML document.

Syntax

<vxml

    version="version"

    xmlns="http://www.w3.org/2001/vxml"

    xml:base="URI"

    xml:lang="language"

    application="URI"

    logpage="0" | "1">

  child elements

</vxml>

Attributes

Attribute	Description
version	Specifies the VoiceXML version number. Dialogic supports VoiceXML versions 1.0, 2.0 and 2.1. If an application sets the version to 2.1 (or higher), the IP Media Server will behave as if the `com.voicegenie.STRICTCONFORMANCE` is set to `TRUE`, regardless of its actual value in the defaults file. See Strict Conformance for the resulting behaviour. In standards compliance mode, this attribute is required (in application pages, and the platform defaults file). If the `com.voicegenie.STRICTCONFORMANCE` property is set to `FALSE`, it is optional.
xmlns	The VoiceXML specification requires the use of this attribute (set to `http://www.w3.org/2001/vxml`) to designate the namespace for VoiceXML. In standards compliance mode, this attribute is required (in application pages, root pages, and the platform defaults file). If the `com.voicegenie.STRICTCONFORMANCE` property is set to `FALSE`, it is optional.
xml:base	The base URI of this document. Relative references in this document use this URI as the base URI. Optional.
xml:lang	The language identifier for this document. Used as the language for implicit grammars (i.e., universal grammars, and `<choice>`/`<option>` grammars), multi-language Nuance grammars, and `<prompt>`s. Optional.
application	The URI of this document's application root document. Optional.
logpage	If value is 0, nothing is emailed. If value is 1, the fetched document response - HTTP headers & VoiceXML page - is emailed to the maintainer (specified in the <meta> element), whenever logging information is emailed. This depends on the value of the `LOGLEVEL` property. Set `LOGLEVEL` to 4 if you want logging information to be emailed every time the page is executed. Optional. (Defaults to 0.)

Attribute Notes

Omitting version or xmlns when they are required will result in an error.badfetch being thrown.

An error.badfetch event will be thrown if version is less than 1.0, or is greater than or equal to 3.0.
If version is set higher than 2.1 (ex. 2.5, 3.0), it will be treated as 2.1.

If the root document specified by application cannot be found, an error.badfetch is thrown. If the root document refers to another root document, an error.semantic event is thrown.

Parents

None.

Children

Extensions

Added logpage attribute.

Limitations/Restrictions

Currently, <metadata> is not supported as a child of <vxml>.

Example

<?xml version="1.0"?>

<vxml version="2.0" xmlns="http://www.w3.org/2001/vxml">

  <form>

    <block>

      Hello, world!

    </block>

  </form>

</vxml>