developer_guide:voicexml_references:elements:data [Voximal documentation]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== < data > ======

===== Description =====

The <data> element allows a VoiceXML application to fetch arbitrary XML data from a document server without transitioning to a new VoiceXML document. The XML data fetched by the <data> element is bound to ECMAScript through the named variable that exposes a read-only subset of the W3C Document Object Model.

===== Syntax =====

<code>
Text
</code>

===== Attributes =====

|src|Specifies the URI where the external XML content is located.Constraints: Exactly one of the src or srcexpr attributes must be specified.|
|name|Specifies the name of the ECMAScript form item variable. Each name assigned to a data element must be unique.|
|srcexpr|Specifies an ECMAScript expression that evaluates to the target URI.Constraints: Exactly one of the src or srcexpr attributes must be specified.|
|method|Specifies the HTTP method to use. The allowable values for this attribute are: GET - The GET method is used for the request. POST - The POST method is used for the request. If unspecified, then the GET value is assumed, unless the submission of multi-part or form data is encountered, in which case the POST value is assumed.|
|namelist|Specifies a space-separated list of variables to submit. By default, no variables are submitted.|
|fetchaudio|Specifies the URI of the audio file to play to the caller in the event of an extended document fetch. This attribute allows audio to be played to the caller while the fetch is being made, instead of silence.|
|fetchhint|Specifies when the resource should be fetched during application execution. The following values are permitted: prefetch - Begin the resource fetch upon initial document execution. safe - Only fetch the resource when it is specifically called in the application|
|fetchtimeout|Specifies how long, in seconds or milliseconds, the interpreter should wait for the content to be returned before reverting to any backup TTS, if present, or before the application execution skips the contents of the <audio> element, if no backup TTS is present. Valid Values: A character string in CSS2 format.|
|maxage|Specifies the maximum acceptable age, in seconds, of the resource in question. We do not recommend that you rely on this attribute for cache control; caching is always best controlled by the response headers of the hosting server. If no headers are specified, then no cache control is present, regardless of the value set for the maxage attribute.Valid Values: An ECMAScript Expression that returns a valid time value for the request.|
|maxstale|Specifies the maximum acceptable staleness, in seconds, of the resource in question.We do not recommend that you rely on this attribute for cache control; caching is always best controlled by the response headers of the hosting server. If no headers are specified, then no cache control is present, regardless of the value set for the maxstale attribute. Valid Values: An ECMAScript Expression that returns a valid time value for the request.|

===== Parents =====

<code>
<block> <catch> <error> <filled> <form> <help> <if> <noinput> <nomatch> <vxml>
</code>

===== Children =====

<code>
None.
</code>

===== Extensions =====

<code>
The Voximal interpreter adds the support to generate and parse the JSON request.
Using the contenttype you can set json with differents encodings.
The MimeType set by the Web Server can force the result parsing too.

A Shadow variable with the duration of the HTTP and parsing request (example: varname$.duration).
</code>

===== Limitations/Restrictions =====

<code>
None.
</code>

===== Example Code =====

<code>
text
</code>