|
Newsletters
|
|
|
|
|
Voice XML Reference
Voice XML Reference
Bookmark this page
The submit Element - <submit>
Description:
The <submit> element is similar to <goto> in that it results in a new document being obtained.
Unlike <goto>, it lets you submit a list of variables to the document server via an HTTP GET or
POST request.
Example:
<submit next="log_request" method="post" namelist="name rank serial_number"
fetchtimeout="100s" fetchaudio="audio/brahms2.wav"/>
| Attributes |
| Name |
Value |
Description |
| next |
URI |
The URI to which the query is submitted. |
| expr |
URI |
Like next, except that the URI is dynamically determined by
evaluating the given ECMAScript expression. One of next or expr is
required. |
| namelist |
PCDATA |
The list of variables to submit. By default, all the named field item
variables are submitted. If a namelist is supplied, it may contain
individual variable references which are submitted with the same
qualification used in the namelist. |
| method |
"get" or "post" |
The request method: get (default) or post. |
| enctype |
ContentType |
Specifies the content type to be used to submit the parameter to the server when the method is "post". The default value for this attribute is "application/x-www-form-urlencoded". |
| caching |
'safe' or 'fast' |
Eithere safe to force a query to fetch the most recent copy of the content, or fast to use the cached copy of the content if it has not expired. If not specified, a value derived from the innermost caching property is used. |
| fetchaudio |
URI |
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. |
| fetchint |
"prefetch", "safe", "stream" |
Defines when the interpreter context should retreive content from the server. prefetch indicates a file may be downloaded when the page is loaded, whereas safe indicates a file that should only be downloaded when actually needed. In the case of a very large file (implying long download times) or a streaming audio source, stream indicates to the interpreter context to begin processing the content as it arrives and should not wait for full retrieval of the content. If not specified, a value derived from the innermost relevant *fetchint property is used. |
| fetchtimeout |
integer |
The interval to wait for the content to be returned before throwing an error.badfetch event. If not specified, a value derived from the innermost fetchtimeout is used. |
Back to Tag Listing
|
|
