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

<catch>, <data>, <error>, <form>, <help>, <link>, <menu>, <meta>, <noinput>, <nomatch>, <property>, <script>, <var>

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>