Skip Headers

Oracle9iAS Wireless Developer's Guide
Release 2 (9.0.2)

Part Number A90485-02
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

8
XML Tag Glossary

This document present the following topic:

The XML DTD defines the abstract device markup language used in the OracleMobile Online Studio application framework. The goal of the definitions is to be a superset of the markup languages for a variety of devices. Elements in the DTD represent elements of an abstract user interface which translate to device-specific formats. The following is a list of tag elements in the XML DTD. See Oracle Technology Network for more details, and to view the tag element tree. The XML is derived from the DTD of Oracle9iAS Wireless with hosting extensions added. Note that the tag names are case-sensitive as below.

8.1 XML Tags


SimpleAction

This tag provides the ability to define a link or submit action that navigates the user to a new context. Mobile devices can associate a submit action to a number of input methods (of the device), like pressing a Key on wap devices or saying a command on voice enabled devices. Action can have SimpleTextItem as child, this is used for rendering of Action tag in voice.

Table 8-1 SimpleAction Tag
Name Description Value(s) Default Value

name

Name identifier for the element instance.

CDATA

OPTIONAL

callbackurl

ASW Module Support. Indicates the URL to return back if the current action leads the user into a different application (application implementing Wireless Module functionary).

CDATA

OPTIONAL

callbackparam

ASW Module Support. Indicates the return parameters of the callbackurl. When Module returns the context back to the callee application, the callbackparam is passed back for the callee to construct its application state.

CDATA

OPTIONAL

callbacksecure

Indicates the mode of communication, when callback occurs, between Wireless server and the device. Setting callbacksecure="true" will enable a secure connect mode between Wireless and the device when the module performs a callback (to the callbackurl). If not specified, the connect mode will be based on the current request mode.

(true | false)

OPTIONAL

target

URI to navigate to when action is activated. This URL is always rewritten by the Server to point back to Wireless Server, except when mimetype attribute not "text/vnd.oracle.mobilexml". Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

mimetype

mime-type of target URI. Lets the Wireless server know the target resources mime-type. If the target mime-type is not text/vnd.oracle.mobilexml, the Wireless server will not rewrite the URL.

CDATA

ext/vnd.oracle.mobilexml

OPTIONAL

static_target

URI to navigate to when action is activated. This URL is never rewritten by server. If exists, this will override the "target" attribute. Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

secure

Indicates the mode of communication between Wireless server and the device. Setting secure="true" will enable a secure connect mode between Wireless and the device for the specified target. If not specified, the connect mode will be based on the current request mode. This DOES NOT indicate mode of connection between Wireless and the remote content source (the service), Wireless will connect to the remote service based on the protocol specified in the target attribute

("http" vs. "https")

(true | false)

OPTIONAL

fetchaudio

Voice only attribute. The URI of an audio clip to play while the "target" is being fetched.

CDATA

OPTIONAL

type

Defines the type of Binding in the target device. Can take any string value. Continue, primary, secondary are special types. "primary" and "secondary" map to the primary and secondary keys resp. Continue is a special Primary key, tells the Voice service to continue without waiting for the user. If both continue and primary are defined both of them will map to the primary key. The following type will also be support by the transformers for backward compatibility "accept"|"soft1"|"option1"|"option2".

(continue | primary | secondary)

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

icon

Built-in icon name for HDML/WML. Will be used if specified.

CDATA

OPTIONAL

src

The URL to an image. Image from will be displayed. (In SimpleAction/Href this images needs to be used instead of the label.

CDATA

OPTIONAL

addImageExtension

Allows the server to use the right image format from a list of available formats. Based on the available images from the app (specified by the "available" attribute) and based on the device browser capability the server will pick the right image to be used. For example: If image is "oracle" and available is set to "jpg gif wbmp", server will use "oracle.wbmp" in WML (Phone.com) browser, "oracle.gif" for a HTML browser.

(true | false)

true

OPTIONAL

available

Application can specify a list of available image formats, for example: available = "jpg gif g2.gif wbmp bmp" (g2.gif indicates a grayscale depth 2 image, for devices like Palm). This allows the server to use the correct image format supported by device (based on device browser properties).

CDATA

OPTIONAL

label

Label for action button, displayed when action is bound to a button on a visual device

CDATA

OPTIONAL

dtmf

digit to be pressed on phone or DTMF tone. dtmf attribute just takes one value (a simplified form of voice SimpleDTMF tag). Will work on wap devices, if supported by the device.

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Usage

SimpleAction, for a given type, conforms to scopings rule (like the programming languages do).

If SimpleAction is defined as a child of SimpleMenu and also as an child of the enclosing SimpleContainer for a given "type" of SimpleAction, the SimpleAction tag within the Menu overrides the SimpleAction of the SimpleContainer. (Note: If the value for "type" attribute is different then the two SimpleAction's will active within the context. Also if two SimpleActions are defined with same "type" value within same context, then the action is undefined).

The "type" attribute can be used to define device specific actions, along with the deviceclass attribute.

Related Tags

Table 8-2 SimpleAction Related Tags
Parents Children

SimpleText

SimpleCache

SimpleForm

SimpleTextItem

SimpleFormItem

SimpleGrammar

SimpleFormSelect

SimpleDTMF

SimpleContainer

SimpleResult

SimpleMenu


SimpleAudio

Plays an audio file on voice devices.

Table 8-3 SimpleAudio Tag
Name Description Value(s) Default Value

src

The URL to an audio source file. Used in to play audio (Voice).

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). This tag is applicable for Voice devices only. Will not be supported on other devices even if specified.

CDATA

OPTIONAL

Related Tags

Table 8-4 SimpleAudio Related Tags
Parents Children

SimpleTextItem

[PCDATA]

SimpleSpan

SimpleCache

SimpleUnderline

SimpleBreak

SimpleImage

SimpleEm

SimpleHref

SimpleStrong

SimpleStrong

SimpleSpan

SimpleEm

SimpleUnderline

SimpleAudio

SimpleAudio

SimpleSpeech

SimpleSpeech

SimpleTitle

SimpleImage

SimpleValue


SimpleBind

Bind is an extended action tag that can be invoked by multiple events and perform multiple tasks. A task/action can be triggered by events like by device keys (touch tone), by voice commands or by selecting a MenuItem. The action in turn may comprise of set of tasks to perform on match of the event. For e.g. Submit a form can happen when user clicks submit button, or when the user presses a key on the device or just says "submit" on the voice devices. SimpleBind tag defines all these events that needs to matched. SimpleBind tag also defines to set of actions that are mapped to event matches (SimpleMatch). The action can include displaying a flash screen to inform the user of the submit action and then actually submitting the form (2 actions for one set of events). SimpleBind also encloses the SimpleDisplay tag. SimpleDisplay tag is the rendering component of the SimpleBind, Indicates how the Bind action is rendered on the device. This rendering is used to render binding of type menu item and actions. For example: SimpleDisplay can include a SimpleTextItem saying "press or say 1 to submit".

Table 8-5 SimpleBind Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-6 SimpleBind Related Tags
Parents Children

SimpleText

SimpleMatch

SimpleForm

SimpleTask

SimpleFormItem

SimpleDisplay

SimpleFormSelect

SimpleContainer

SimpleResult

SimpleMenu


SimpleBreak

Creates a break, new line on text devices and pause on voice devices.

Table 8-7 SimpleBreak Tag
Name Description Value(s) Default Value

msecs

milliseconds in duration of the break for voice devices.

xsd:nonNegativeInteger

OPTIONAL

rule

Generate an HR with this break (HTML)

(true | false)

false

OPTIONAL

size

size of the break (VoiceXML)

(none | small | medium | large)

medium

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-8 SimpleBreak Related Tags
Parents Children

SimpleTextItem

none

SimpleSpan

SimpleUnderline

SimpleImage

SimpleHref

SimpleStrong

SimpleEm

SimpleAudio

SimpleSpeech

SimpleTitle

SimpleHelp


SimpleCache

An URL can be cache on the gateway (like WAP gateway), client or both of them. Also used when a URL needs to be prefetched while still showing the current content (only supported devices in certain devices). SimpleCache defines all these policies.

Table 8-9 SimpleCache Tag
Name Description Value(s) Default Value

timeout

Time, in milliseconds, to wait while fetching a resource before failing.

xsd:nonNegativeInteger

OPTIONAL

policy

Cache on gateway, client, both or none. Value of "public" indicates cache can on the Gateway (like the WAP), "private" indicates client only cache.

public | private | both | none)

private

OPTIONAL

prefetch

prefetch policy. Certain devices can prefetch a "target" resources, before the user requests for the resources. The attribute controls the policy of such a prefetch-able resource.

(onload | safe | streamed)

safe

OPTIONAL

ttl

Time to live for cached data in milliseconds

xsd:nonNegativeInteger

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-10 SimpleCache Related Tags
Parents Children

SimpleImage

none

SimpleHref

SimpleAction

SimpleAudio

SimpleGrammar

SimpleDTMF

SimpleGo

SimpleMenuItem

SimpleResult


SimpleCase

Tag to write case statements within a SimpleSwitch tag. This allows the developer to perform client side "actions" on devices. Support for Switch/Case is not universal. Is Supported only in Wap (HDML/WML) and Voice (VoiceXML) devices.

Table 8-11 SimpleCase Tag
Name Description Value(s) Default Value

value

The value of for the Case statement (to be compared with the value of form field, identified by the name attribute of SwitchCase)

CDATA

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-12 SimpleCase Related Tags
Parents Children

SimpleSwitch

SimpleGo

SimpleTextItem

SimpleRefresh

SimpleClear

SimpleReprompt

SimpleExit

SimpleDisconnect

SimplePrev

SimpleSubmit


SimpleCatch

Catches an event. Voice only tag. This can be used to capture predefined voice events like "noinput" "exit" etc. and perform actions on it. For example: on "noinput" (formitem) event the user can be given some help instructions and be reprompted for the input. Events include errors generated (Errors are also an instance of event)

Table 8-13 SimpleCatch Tag
Name Description Value(s) Default Value

count

The occurrence of the event (default is 1). The count allows you to handle different occurrences of the same event differently For example:. Need to give extra help messages if the user says "help" twice for the same form item. The form/formitem/menu etc. (where ever SimpleCatch can occur) maintain a counter for each event that occurs while it is being visited, these counters are reset each time the form is re-entered.

Positive Int

1

OPTIONAL

type

Predefined Voice events. Possible values include cancel, error, exit, help, noinput, nomatch, telephone.disconnect.

CDATA

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-14 SimpleCatch Related Tags
Parents Children

SimpleText

[PCDATA]

SimpleForm

SimpleGo

SimpleFormItem

SimpleTextItem

SimpleFormSelect

SimpleRefresh

SimpleResult

SimpleClear

SimpleMenu

SimpleReprompt

SimpleExit

SimpleDisconnect

SimplePrev

SimpleSubmit


SimpleClear

Clears a list of client side form fields identified by the Name list (SimpleName). Works on WML/Voice (Voice) device only. Useful in voice applications e.g. Clearing a form field in voice will allow the Voice engine to reprompt the User for the form field again.

Table 8-15 SimpleClear Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-16 SimpleClear Related Tags
Parents Children

SimpleCatch

SimpleName

SimpleCase

SimpleTask


SimpleCol

Defines a column of a table.

Table 8-17 SimpleCol Tag
Name Description Value(s) Default Value

bgcolor

background color

CDATA

OPTIONAL

rowspan

from HTML table spec

CDATA

OPTIONAL

colspan

from HTML table spec

CDATA

OPTIONAL

bordercolor

from HTML table spec

CDATA

OPTIONAL

height

cell height

CDATA

OPTIONAL

width

cell width

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

valign

vertical alignment

(top | middle | bottom)

top

OPTIONAL

halign

horizontal alignment

(left | center | right)

left

OPTIONAL

wrapmode

text wrap mode

(wrap | nowrap)

wrap

OPTIONAL

Related Tags

Table 8-18 SimpleCol Related Tags
Parents Children

SimpleTableHeader

SimpleTextItem

SimpleRow


SimpleContainer

The root element that contains all major block constructs like form, menu and Text.

Table 8-19 SimpleContainer Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

id

ID attribute of the element. Used for Navigation within a XML response (target="#ID")

xsd:ID

OPTIONAL

Related Tags

Table 8-20 SimpleContainer Related Tags
Parents Children

SimpleResult

SimpleText

SimpleMenu

SimpleForm

SimpleTable

SimpleAction

SimpleBind


SimpleDisconnect

Disconnect's a connection oriented device like the Voice browser.

Table 8-21 SimpleDisconnect Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-22 SimpleDisconnect Related Tags
Parents Children

SimpleCatch

none

SimpleCase

SimpleTask


SimpleDisplay

Supports all rendering characteristics of an SimpleBind (using SImpleTextItem). SimpleTextItem, a child SimpleDisplay, contains the actual render/display content. Useful in two cases i) Allows provides an audio (child of textitem), ii) Render the text for a MenuItem, when Bind is displayed a MenuItem (A Bind can be displayed as MenuItem if the SimpleMatch contains the SimpleMItem element and the SimpleBind occurs as child of SimpleMenu).

Table 8-23 SimpleDisplay Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Usage

SimpleDisplay as the rendering container of SimpleBind.
 <SimpleBind>
  </SimpleMatch>
  <SimpleTask>
  </SimpleTask>
  <SimpleDisplay>
    <SimpleTextItem deviceclass=".."><SimpleAudio .../></SimpleTextItem>
    <SimpleTextItem deviceclass="..">Hello welcome</SimpleTextItem>
    </SimpleDisplay>

Related Tags

Table 8-24 SimpleDisplay Related Tags
Parents Children

SimpleBind

SimpleTextItem


SimpleDTMF

Specify a VoiceXML DTMF grammar. DTMF grammar can be used to indicate a syntax like 1 {San Francisco} | 2 {Wash. DC} | 3 {New York} etc. If the syntax information stored in a remote server, the "src" attribute can be used to specify the URI of the DTMF syntax resource/file.

Table 8-25 SimpleDTMF Tag
Name Description Value(s) Default Value

src

URI to the resource file where the DTMF's/Grammars are stored

CDATA

OPTIONAL

type

The MIME type of the grammar. Represents the Grammar Format (applicable to both the remote URI Grammar file or inline Grammar text). There are different ways of representing a Grammar/DTMF format. Example: "application/x-jsgf",

CDATA

OPTIONAL

scope

VoiceXML scope. Can take "document"/"dialog" possible values. Default scope of grammar in Form/Menu/Text/Grammar/DTMF. If the scope is set to "document", then the grammar is active in the entire document. This allows for e.g. the user to submit a "Form" (in the SimpleResult) from inside a "SimpleMenu".

(document | dialog)

dialog

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). This tag is applicable for Voice devices only. Will not be supported on other devices even if specified.

CDATA

OPTIONAL

Related Tags

Table 8-26 SimpleDTMF Related Tags
Parents Children

SimpleHref

[PCDATA]

SimpleAction

SimpleCache

SimpleForm

SimpleFormItem

SimpleFormSelect

SimpleMatch


SimpleEm

Displays the enclosed text(audio) with emphasis. Text enclosed usually displayed as italicized text.

Table 8-27 SimpleEm Tag
Name Description Value(s) Default Value

level

Voice only attribute. Indicates Level of emphasis.

(strong | moderate | none | reduced)

moderate

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-28 SimpleEm Related Tags
Parents Children

SimpleTextItem

[PCDATA]

SimpleSpan

SimpleBreak

SimpleUnderline

SimpleEm

SimpleImage

SimpleStrong

SimpleHref

SimpleSpan

SimpleStrong

SimpleUnderline

SimpleEm

SimpleAudio

SimpleAudio

SimpleSpeech

SimpleSpeech

SimpleImage

SimpleTitle

SimpleValue

SimpleHelp


SimpleExit

Perform a application exit

Table 8-29 SimpleExit Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-30 SimpleExit Related Tags
Parents Children

SimpleCatch

none

SimpleCase

SimpleTask


SimpleFinish

SimpleFinish indicates the Finish event. This is a tag is supported only in Voice. This can be any event that completes an user task. For example, reaching the end of the form field input on Voice devices.

Table 8-31 SimpleFinish Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-32 SimpleFinish Related Tags
Parents Children

SimpleMatch

none


SimpleForm

This element is used for displaying one or more input fields. The fields are presented using the SimpleFormItem and SimpleFormSelect elements. Form has SimpleTitle as child, if specified will appear as the Title of the form.

Table 8-33 SimpleForm Tag
Name Description Value(s) Default Value

layout

Control Layout of a form in small screen devices. Indicates if the form input fields should be displayed in a sequence of fields (cards) and should there be an enclosing page with all input field listed, allowing the user to select the field in an arbitrary fashion.

(linear | tabular)

linear

OPTIONAL

scope

VoiceXML scope. Can take "document"/"dialog" possible values. Default scope of grammar in Form/Menu/Text/Grammar/DTMF. If the scope is set to "document", then the grammar is active in the entire document. This allows for e.g. the user to submit a "Form" (in the SimpleResult) from inside a "SimpleMenu".

(document | dialog)

dialog

OPTIONAL

callbackurl

Wireless Module Support. Indicates the URL to return back if the current action leads the user into a different application (application implementing Wireless Module functionality).

CDATA

OPTIONAL

callbackparam

Wireless Module Support. Indicates the return parameters of the callbackurl. When Module returns the context back to the callee application, the callbackparam is passed back for the callee to construct its application state.

CDATA

OPTIONAL

callbacksecure

Indicates the mode of communication, when callback occurs, between Wireless server and the device. Setting callbacksecure="true" will enable a secure connect mode between Wireless and the device when the module performs a callback (to the callbackurl). If not specified, the connect mode will be based on the current request mode.

(true | false)

OPTIONAL

target

URI to navigate to when action is activated. This URL is always rewritten by the Server to point back to Wireless Server, except when mimetype attribute not "text/vnd.oracle.mobilexml". Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

mimetype

mime-type of target URI. Lets the Wireless server know the target resources mime-type. If the target mime-type is not text/vnd.oracle.mobilexml, the Wireless server will not rewrite the URL.

CDATA

text/vnd.oracle.mobilexml

OPTIONAL

static_target

URI to navigate to when action is activated. This URL is never rewritten by server. If exists, this will override the "target" attribute. Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

secure

Indicates the mode of communication between Wireless server and the device. Setting secure="true" will enable a secure connect mode between Wireless and the device for the specified target. If not specified, the connect mode will be based on the current request mode. This DOES NOT indicate mode of connection between Wireless and the remote content source (the service), Wireless will connect to the remote service based on the protocol specified in the target attribute ("http" vs. "https")

(true | false)

OPTIONAL

fetchaudio

Voice only attribute. The URI of an audio clip to play while the "target" is being fetched.

CDATA

OPTIONAL

id

ID attribute of the element. Used for Navigation within a XML response (target="#ID")

xsd:ID

OPTIONAL

method

HTTP Method get or post

(get | post)

get

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-34 SimpleForm Related Tags
Parents Children

SimpleContainer

SimpleTitle

SimpleProperty

SimpleTextItem

SimpleTextField

SimpleFormItem

SimpleFormSelect

SimpleCatch

SimpleAction

SimpleBind

SimpleGrammar

SimpleDTMF


SimpleFormItem

Specified if Input is mandatory. This attribute is supported only if the target device supports such an functionality. The application must always validate the field on the server side

Table 8-35 SimpleFormItem Tag
Name Description Value(s) Default Value

mandatory

Specified if Input is mandatory. This attribute is supported only if the target device supports such an functionality. The application must always validate the field on the server side

(yes | no)

no

OPTIONAL

maxlength

Max length of the field

Positive Int

OPTIONAL

type

Indicates the data type, like boolean, digits etc. For backward compatibility will also accept displaymode attribute values (text|textarea|password etc).

(none | audio | boolean | currency | date | digits | number | phone | time | transfer)

REQUIRED

format

WML/HDML format attribute. Supported only in WML/HDML devices

CDATA

OPTIONAL

value

default value ("defaultvalue" attribute also supported for backward compatibility).

CDATA

OPTIONAL

size

display size of the input field

Positive Int

OPTIONAL

name

Input Field name

CDATA

REQUIRED

displaymode

To Specify the display characteristics of the field like noecho (password), textarea etc.

(text | textarea | noecho | hidden)

text

OPTIONAL

rows

Number of rows if displaymode is textArea.

Positive Int

OPTIONAL

cols

Number of rows if displaymode is textArea.

Positive Int

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

modal

VoiceXML modal. If this is true (the default) all higher level speech and DTMF grammars are turned off while making the transcription. If false, the grammar is scoped to the form item/select.

(true | false)

true

OPTIONAL

slot

VoiceXML slot. Slot exist part of a Voice Grammar syntax. The input's grammar slot values are assigned to the corresponding field item variables. This allows the user to say one sentence an fill-in more than form field.

CDATA

OPTIONAL

dest

VoiceXML dest. Valid only when the type="transfer". Specifies the phone number to transfer the call to.

CDATA

OPTIONAL

bridge

VoiceXML bridge. Valid only when the type="transfer". If "true" allows the original caller to resume the current session, once the transfer/third party call is complete.

(true | false)

false

OPTIONAL

connecttimeout

VoiceXML connect timeout in milliseconds. Valid only when the type="transfer". The time to wait while trying to connect the call before returning the noanswer condition (Default is specific a Voice Gateway platform).

xsd:nonNegativeInteger

OPTIONAL

maxtime

VoiceXML maxtime in milli seconds. Valid only when the type="transfer" and brige="true". The time that the call is allowed to last, or 0 if it can last arbitrarily long. Default is 0.

xsd:nonNegativeInteger

OPTIONAL

beep

VoiceXML beep. If true, a tone is emitted just prior to transcription. Defaults to false. Used when type="audio".

(true | false)

true

OPTIONAL

finalsilence

VoiceXML finalsilence milliseconds. The interval of silence that indicates end of speech.

xsd:nonNegativeInteger

OPTIONAL

enctype

VoiceXML enctype. The MIME encoding type of the submitted document. Used when type="audio" to indicate the format of the recording requested.

CDATA

OPTIONAL

dtmfterm

VoiceXML dtmfterm. If true, a DTMF keypress terminates transcription.

(true | false)

false

OPTIONAL

Related Tags

Table 8-36 SimpleFormItem Related Tags
Parents Children

SimpleForm

[PCDATA]

SimpleTitle

SimpleAction

SimpleBind

SimpleCatch

SimpleProperty

SimpleHelp

SimpleGrammar

SimpleDTMF


SimpleFormOption

Provides value for a formitem as a predefined list of values. Element is an item in a selectable menu. "FormOption" takes PCDATA and SimpleTextItem as child. SimpleTextItem is used to render the an Rich Text (useful when using Radio buttons and Checkboxes). Certain devices do not allow RichText as part of MenuItem, in such cases the text inside SimpleTextItem are collected and rendered. If SimpleTextItem does not exist, then the PCDATA is rendered. PCDATA is required, because in Voice the user select's the option by uttering the "PCDATA". "PCDATA",parsable character format, specifies default values for the form item.

Table 8-37 SimpleFormOption Tag
Name Description Value(s) Default Value

selected

is this option selected by default (same semantics as HTML SELECTED)

(true | false)

false

OPTIONAL

value

value of select variable when this is selected

CDATA

REQUIRED

dtmf

digit to be pressed on phone or DTMF tone. dtmf attribute just takes one value (a simplified form of voice SimpleDTMF tag). Will work on wap devices, if supported by the device.

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-38 SimpleFormOption Related Tags
Parents Children

SimpleFormSelect

[PCDATA]

SimpleOptGroup

SimpleTextItem


SimpleFormSelect

This element displays a select and option list. Can display option list, checkbox or radio box.

Table 8-39 SimpleFormSelect Tag
Name Description Value(s) Default Value

displaymode

To Specify the display characteristics of the select like drop down, check box etc. Radio button if multiple is false and displaymode is checkbox. For backward compatibility should support the "type" attribute (values checkbox, radio).

(list | checkbox)

list

OPTIONAL

multiple

Supports multiple options to be selected for the Select. Bot Supported in Voice

(true | false)

false

OPTIONAL

name

Name of the select field

CDATA

REQUIRED

size

display size of the select list (if displaymode is list)

Positive Int

1

OPTIONAL

modal

VoiceXML modal. If this is true (the default) all higher level speech and DTMF grammars are turned off while making the transcription. If false, the grammar is scoped to the form item/select.

(true | false)

true

OPTIONAL

slot

VoiceXML slot. Slot exist part of a Voice Grammar syntax. The input's grammar slot values are assigned to the corresponding field item variables. This allows the user to say one sentence an fill-in more than form field.

CDATA

OPTIONAL

autoprompt

VoiceXML auto prompt. Tells the Voice browsers not to perform an auto prompt. Valid in menu's and formselect's. If set to false, the voice browser will not list the items in the menu/select. Typically set to false if need to use a audio file (listing all the menus, rather than using the TTS of the Voice gateway).

(true | false)

true

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-40 SimpleFormSelect Related Tags
Parents Children

SimpleForm

SimpleTitle

SimpleFormOption

SimpleOptGroup

SimpleCatch

SimpleAction

SimpleBind

SimpleHelp

SimpleGrammar

SimpleDTMF


SimpleGo

Defines the "Go" task. Go is one the many possible tasks of a Bind operation (SimpleBind) and is defined as is child of SimpleTask. SimpleGo is an empty tag (no child tags).

Table 8-41 SimpleGo Tag
Name Description Value(s) Default Value

callbackurl

Wireless Module Support. Indicates the URL to return back if the current action leads the user into a different application (application implementing Wireless Module functionary).

CDATA

OPTIONAL

callbackparam

Wireless Module Support. Indicates the return parameters of the callbackurl. When Module returns the context back to the callee application, the callbackparam is passed back for the callee to construct its application state.

CDATA

OPTIONAL

callbacksecure

Indicates the mode of communication, when callback occurs, between Wireless server and the device. Setting callbacksecure="true" will enable a secure connect mode between Wireless and the device when the module performs a callback (to the callbackurl). If not specified, the connect mode will be based on the current request mode.

(true | false)

OPTIONAL

target

URI to navigate to when action is activated. This URL is always rewritten by the Server to point back to Wireless Server, except when mimetype attribute not "text/vnd.oracle.mobilexml". Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

mimetype

mime-type of target URI. Lets the Wireless server know the target resources mime-type. If the target mime-type is not text/vnd.oracle.mobilexml, the Wireless server will not rewrite the URL.

CDATA

text/vnd.oracle.mobilexml

OPTIONAL

static_target

URI to navigate to when action is activated. This URL is never rewritten by server. If exists, this will override the "target" attribute. Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

secure

Indicates the mode of communication between Wireless server and the device. Setting secure="true" will enable a secure connect mode between Wireless and the device for the specified target. If not specified, the connect mode will be based on the current request mode. This DOES NOT indicate mode of connection between Wireless and the remote content source (the service), Wireless will connect to the remote service based on the protocol specified in the target attribute ("http" vs. "https")

(true | false)

OPTIONAL

fetchaudio

Voice only attribute. The URI of an audio clip to play while the "target" is being fetched.

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-42 SimpleGo Related Tags
Parents Children

SimplePrev

SimpleCache

SimpleCatch

SimpleCase

SimpleTask


SimpleGrammar

Provides the voice grammar for the enclosing item like SimpleMenuItem. For example: for SimpleMenuItem with enclosing text like "Oracle9iAS Wireless.", the Voice Engine would say "your options are Oracle9iAS Wireless.". Use SimpleGrammar for voice if you want to invoke this MenuItem when the user says "Oracle" | "Oracle9i" | "9i" | "Wireless"

Table 8-43 SimpleGrammar Tag
Name Description Value(s) Default Value

src

URI to the resource file where the DTMF's/Grammar's are stored

CDATA

OPTIONAL

type

The MIME type of the grammar. Represents the Grammar Format (applicable to both the remote URI Grammar file or inline Grammar text). There are different ways of representing a Grammar/DTMF format. Example: "application/x-jsgf",

CDATA

OPTIONAL

scope

VoiceXML scope. Can take "document"/"dialog" possible values. Default scope of grammar in Form/Menu/Text/Grammar/DTMF. If the scope is set to "document", then the grammar is active in the entire document. This allows for e.g. the user to submit a "Form" (in the SimpleResult) from inside a "SimpleMenu".

(document | dialog)

dialog

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). This tag is applicable for Voice devices only. Will not be supported on other devices even if specified.

CDATA

OPTIONAL

Related Tags

Table 8-44 SimpleGrammar Related Tags
Parents Children

SimpleHref

[PCDATA]

SimpleAction

SimpleCache

SimpleMenuItem

SimpleForm

SimpleFormItem

SimpleFormSelect

SimpleMatch


SimpleHelp

Used to display Help text for a field. Used by SSD/PDA style devices to display help text for the FormItem/Select (In voice SimpleCatch "type="help" is used).

Table 8-45 SimpleHelp Tag
Name Description Value(s) Default Value

color

color

CDATA

OPTIONAL

font

font

CDATA

OPTIONAL

size

size

CDATA

OPTIONAL

wrapmode

Text wrap mode.

(wrap | nowrap)

wrap

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-46 SimpleHelp Related Tags
Parents Children

SimpleFormItem

[PCDATA]

SimpleFormSelect

SimpleHref

SimpleBreak

SimpleEm

SimpleStrong

SimpleImage


SimpleHref

Specifies a hyperlink.

Table 8-47 SimpleHref Tag
Name Description Value(s) Default Value

callbackurl

Wireless Module Support. Indicates the URL to return back if the current action leads the user into a different application (application implementing Wireless Module functionary).

CDATA

OPTIONAL

callbackparam

Wireless Module Support. Indicates the return parameters of the callbackurl. When Module returns the context back to the callee application, the callbackparam is passed back for the callee to construct its application state.

CDATA

OPTIONAL

callbacksecure

Indicates the mode of communication, when callback occurs, between Wireless server and the device. Setting callbacksecure="true" will enable a secure connect mode between Wireless and the device when the module performs a callback (to the callbackurl). If not specified, the connect mode will be based on the current request mode.

(true | false)

OPTIONAL

target

URI to navigate to when action is activated. This URL is always rewritten by the Server to point back to Wireless Server, except when mimetype attribute not "text/vnd.oracle.mobilexml". Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

mimetype

mime-type of target URI. Lets the Wireless server know the target resources mime-type. If the target mime-type is not text/vnd.oracle.mobilexml, the Wireless server will not rewrite the URL.

CDATA

text/vnd.oracle.mobilexml

OPTIONAL

static_target

URI to navigate to when action is activated. This URL is never rewritten by server. If exists, this will override the "target" attribute. Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

secure

Indicates the mode of communication between Wireless server and the device. Setting secure="true" will enable a secure connect mode between Wireless and the device for the specified target. If not specified, the connect mode will be based on the current request mode. This DOES NOT indicate mode of connection between Wireless and the remote content source (the service), Wireless will connect to the remote service based on the protocol specified in the target attribute ("http" vs. "https")

(true | false)

OPTIONAL

fetchaudio

Voice only attribute. The URI of an audio clip to play while the "target" is being fetched.

CDATA

OPTIONAL

label

Label for action button, displayed when action is bound to a button on a visual device

CDATA

OPTIONAL

dtmf

digit to be pressed on phone or DTMF tone. dtmf attribute just takes one value (a simplified form of voice SimpleDTMF tag). Will work on wap devices, if supported by the device.

CDATA

OPTIONAL

src

The URL to an image. Image from will be displayed. (In SimpleAction/Href this images needs to be used instead of the label.

CDATA

OPTIONAL

addImageExtension

Allows the server to use the right image format from a list of available formats. Based on the available images from the app (specified by the "available" attribute) and based on the device browser capability the server will pick the right image to be used. Example: if image is "oracle" and available is set to "jpg gif wbmp", server will use "oracle.wbmp" in WML (Phone.com) browser, "oracle.gif" for a HTML browser.

(true | false)

true

OPTIONAL

available

Application can specify a list of available image formats, for example: available = "jpg gif g2.gif wbmp bmp" (g2.gif indicates a grayscale depth 2 image, for devices like Palm). This allows the server to use the correct image format supported by device (based on device browser properties).

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-48 SimpleHref Related Tags
Parents Children

SimpleTextItem

[PCDATA]

SimpleHelp

SimpleCache

SimpleGrammar

SimpleDTMF

SimpleBreak

SimpleEm

SimpleStrong

SimpleSpan

SimpleUnderline

SimpleAudio

SimpleSpeech

SimpleImage

SimpleValue


SimpleImage

Table 8-49 SimpleImage Tag
Name Description Value(s) Default Value

alt

alt string if Image not found

CDATA

OPTIONAL

border

Width of border

CDATA

OPTIONAL

width

Image width

CDATA

OPTIONAL

height

Image height

CDATA

OPTIONAL

vspace

Vertical space (from HTML)

CDATA

OPTIONAL

hspace

Horizontal space (from HTML)

CDATA

OPTIONAL

src

The URL to an image. Image from will be displayed. (In SimpleAction/Href this images needs to be used instead of the label.

CDATA

OPTIONAL

addImageExtension

Allows the server to use the right image format from a list of available formats. Based on the available images from the app (specified by the "available" attribute) and based on the device browser capability the server will pick the right image to be used. Example: if image is "oracle" and available is set to "jpg gif wbmp", server will use "oracle.wbmp" in WML (Phone.com) browser, "oracle.gif" for a HTML browser.

(true | false)

true

OPTIONAL

available

Application can specify a list of available image formats for example: available = "jpg gif g2.gif wbmp bmp" (g2.gif indicates a grayscale depth 2 image, for devices like Palm). This allows the server to use the correct image format supported by device (based on device browser properties).

CDATA

OPTIONAL

valign

Vertical alignment

(top | middle | bottom)

top

OPTIONAL

halign

Horizontal alignment

(left | center | right)

left

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-50 SimpleImage Related Tags
Parents Children

SimpleTextItem

[PCDATA]

SimpleSpan

SimpleCache

SimpleUnderline

SimpleBreak

SimpleImage

SimpleEm

SimpleHref

SimpleStrong

SimpleStrong

SimpleSpan

SimpleEm

SimpleUnderline

SimpleAudio

SimpleAudio

SimpleSpeech

SimpleSpeech

SimpleTitle

SimpleImage

SimpleHelp

SimpleValue


SimpleKey

SimpleKey defines the device key for the Bind operation. SimpleKey, like SimpleAction has a type attribute that identified the Key on device for the Bind operation.

Table 8-51 SimpleKey Tag
Name Description Value(s) Default Value

type

Defines the type of Binding in the target device. Can take any string value. Types primary, secondary are special values and map to the primary and secondary keys respectively. Also transformers will support "accept"|"soft1"|"option1"|"option2" (for backward compatibility).

(primary | secondary)

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-52 SimpleKey Related Tags
Parents Children

SimpleMatch

none


SimpleMatch

A Bind (SimpleBind) can be triggered by various actions like pressing a key, event or saying a key word (voice). Each of these actions are indicated by separate tags. SimpleMatch is the container tag for all such possible Bind Invocation tags.

Table 8-53 SimpleMatch Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-54 SimpleMatch Related Tags
Parents Children

SimpleBind

SimpleFinish

SimpleKey

SimpleGrammar

SimpleDTMF

SimpleMItem

SimpleEvent


SimpleMenu

This element represents a single menu with selectable links which are defined by the children SimpleMenuItem elements.

Table 8-55 SimpleMenu Tag
Name Description Value(s) Default Value

scope

VoiceXML scope. Can take "document"/"dialog" possible values. Default scope of grammar in Form/Menu/Text/Grammar/DTMF. If the scope is set to "document", then the grammar is active in the entire document. This allows for e.g. the user to submit a "Form" (in the SimpleResult) from inside a "SimpleMenu".

(document | dialog)

dialog

OPTIONAL

id

ID attribute of the element. Used for Navigation within a XML response (target="#ID")

xsd:ID

OPTIONAL

autoprompt

VoiceXML auto prompt. Tells the Voice browsers not to perform an auto prompt. Valid in menu's and formselect's. If set to false, the voice browser will not list the items in the menu/select. Typically set to false if need to use a audio file (listing all the menus, rather than using the TTS of the Voice gateway).

(true | false)

true

OPTIONAL

wrapmode

Text wrap mode.

(wrap | nowrap)

wrap

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-56 SimpleMenu Related Tags
Parents Children

SimpleContainer

SimpleTitle

SimpleProperty

SimpleCatch

SimpleMenuItem

SimpleBind

SimpleAction


SimpleMenuItem

This element represents a single, selectable option in a menu defined by SimpleMenu.

Table 8-57 SimpleMenuItem Tag
Name Description Value(s) Default Value

separator

If defined this adds visual separator after or before the menuitem (like the windows "Menu").

(before | after | none)

none

OPTIONAL

callbackurl

Wireless Module Support. Indicates the URL to return back if the current action leads the user into a different application (application implementing Wireless Module functionary).

CDATA

OPTIONAL

callbackparam

Wireless Module Support. Indicates the return parameters of the callbackurl. When Module returns the context back to the callee application, the callbackparam is passed back for the callee to construct its application state.

CDATA

OPTIONAL

callbacksecure

Indicates the mode of communication, when callback occurs, between Wireless server and the device. Setting callbacksecure="true" will enable a secure connect mode between Wireless and the device when the module performs a callback (to the callbackurl). If not specified, the connect mode will be based on the current request mode.

(true | false)

OPTIONAL

target

URI to navigate to when action is activated. This URL is always rewritten by the Server to point back to Wireless Server, except when mimetype attribute not "text/vnd.oracle.mobilexml". Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

mimetype

mime-type of target URI. Lets the Wireless server know the target resources mime-type. If the target mime-type is not text/vnd.oracle.mobilexml, the Wireless server will not rewrite the URL.

CDATA

text/vnd.oracle.mobilexml

OPTIONAL

static_target

URI to navigate to when action is activated. This URL is never rewritten by server. If exists, this will override the "target" attribute. Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

secure

Indicates the mode of communication between Wireless server and the device. Setting secure="true" will enable a secure connect mode between Wireless and the device for the specified target. If not specified, the connect mode will be based on the current request mode. This DOES NOT indicate mode of connection between Wireless and the remote content source (the service), Wireless will connect to the remote service based on the protocol specified in the target attribute ("http" vs. "https")

(true | false)

OPTIONAL

fetchaudio

Voice only attribute. The URI of an audio clip to play while the "target" is being fetched.

CDATA

OPTIONAL

label

Label for action button, displayed when action is bound to a button on a visual device

CDATA

OPTIONAL

dtmf

digit to be pressed on phone or DTMF tone. dtmf attribute just takes one value (a simplified form of voice SimpleDTMF tag). Will work on wap devices, if supported by the device.

CDATA

OPTIONAL

wrapmode

Text wrap mode.

(wrap | nowrap)

wrap

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-58 SimpleMenuItem Related Tags
Parents Children

SimpleMenu

[PCDATA]

SimpleCache

SimpleTextItem

SimpleGrammar


SimpleMeta

Defines all WML/HDML/HTML meta tags (pass through)

Table 8-59 SimpleMeta Tag
Name Description Value(s) Default Value

content

The content of the emulated HTTP header or associated content of Meta NAME

CDATA

REQUIRED

http-equiv

The equivalent HTTP header you are emulating

CDATA

REQUIRED

name

a descriptive name of the meta attribute

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-60 SimpleMeta Related Tags
Parents Children

SimpleResult

none


SimpleMItem

Empty tag to indicate the Bind needs to rendered as a MenuItem. This is allowed only when SimpleBind is a child of SimpleMenu. Use SimpleTextItem, as a child of SimpleDisplay, to display for the actual text of a menu item text. Defines all WML/HDML/HTML meta tags (pass through)

Table 8-61 SimpleMItem Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-62 SimpleMItem Related Tags
Parents Children

SimpleMatch

none


SimpleName

Identifies Client side form field names. Used to specify a list of client side form fields, that need to cleared. Useful in voice, as clearing of form fields allows for reprompt by the VoiceXML browser.

Table 8-63 SimpleName Tag
Name Description Value(s) Default Value

name

Name of Client side form field

CDATA

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-64 SimpleName Related Tags
Parents Children

SimpleClear

none

SimpleSubmit


SimpleOptGroup

Group SimpleFormOptions into a hierarchy. To support Small screen devices, where long lists of options cannot not deliver good UIs. On devices where optgroup is not supported the display strings of options, inside the optgroups, are concatenated with label defined in the optgroup.

Table 8-65 SimpleOptGroup Tag
Name Description Value(s) Default Value

label

For platforms that support hierarchical option lists, the label is displayed when navigating non-leaf nodes

CDATA

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-66 SimpleOptGroup Related Tags
Parents Children

SimpleFormSelect

[PCDATA]

SimpleFormOption


SimplePhone

A Bind (SimpleBind) can be triggered by any event and also these can be device specific events. The SimpleEvent element describes the possible events that would trigger the Bind action. This Element allows you to take advantage of device specific event handlers and define actions that can be triggered on such events. The attribute "type" identifies the device specific events. For Voice applications you can use events like "noinput", "cancel" etc. For WML it can be events like "onenterforward", "onpick" etc.

Table 8-67 SimplePhone Tag
Name Description Value(s) Default Value

count

Applicable to Voice events only. The occurrence of the event (default is 1). The count allows you to handle different occurrences of the same event differently for example. If need to give extra help messages if the user says "help" twice for the same form item. The form/formitem/menu etc (where ever SimpleCatch can occur) maintains a counter for each event that occurs while it is being visited, these counters are reset each time the form is re-entered.

Positive Int

1

OPTIONAL

type

Predefined device level events. Possible values for voice include for cancel, error, exit, help, noinput, nomatch, telephone.disconnect etc. Possible values for WML devices include "onpick", "onenterforward" etc.

CDATA

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-68 SimplePhone Related Tags
Parents Children

SimpleMatch

none


SimplePrev

Tag for the "PREV" (previous) functionality. Has SimpleGo as child and the target of the SimpleGo is the destination URL if "PREV" is not supported natively by the browser.

Table 8-69 SimplePrev Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-70 SimplePrev Related Tags
Parents Children

SimpleCatch

SimpleGo

SimpleCase

SimpleTask


SimpleProperty

Set VoiceXML engine properties

Table 8-71 SimpleProperty Tag
Name Description Value(s) Default Value

name

The name of a property.

CDATA

REQUIRED

value

The name of a property.

CDATA

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-72 SimpleProperty Related Tags
Parents Children

SimpleForm

none

SimpleFormItem

SimpleResult

SimpleMenu


SimpleRefresh

Perform a refresh of the device if supported by the device

Table 8-73 SimpleRefresh Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-74 SimpleProperty Related Tags
Parents Children

SimpleCatch

none

SimpleCase

SimpleTask


SimpleReprompt

This task will reprompt the user for the field input. Valid in Voice apps only and used for reprompting the form fields/inputs.

Table 8-75 SimpleReprompt Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-76 SimpleReprompt Related Tags
Parents Children

SimpleCatch

none

SimpleCase

SimpleTask


SimpleResult

The root tag of Wireless XML. SimpleResult encloses the complete response for a request

Table 8-77 SimpleResult Tag
Name Description Value(s) Default Value

application

VoiceXML application. Attribute used in voice (VoiceXML). This is an URL, which points to "root" document for the VoiceXML generated.

CDATA

OPTIONAL

bgcolor

Sets the Background color in supported devices

CDATA

OPTIONAL

lang

language of this document. Used for Voice, indicates the language of the XML document

CDATA

OPTIONAL

Related Tags

Table 8-78 SimpleResult Related Tags
Parents Children

none

SimpleMeta

SimpleCatch

SimpleProperty

SimpleCache

SimpleAction

SimpleBind

SimpleContainer

SimpleTimer


SimpleRow

Defines row of a table.

Table 8-79 SimpleRow Tag
Name Description Value(s) Default Value

bgcolor

Sets the Background color in supported devices

CDATA

OPTIONAL

bordercolor

from HTML table spec

CDATA

OPTIONAL

valign

Vertical alignment

(top | middle | bottom)

top

OPTIONAL

halign

Horizontal alignment

(left | center | right)

left

OPTIONAL

wrapmode

Text wrap mode

(wrap | nowrap)

wrap

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-80 SimpleRow Related Tags
Parents Children

SimpleTableBody

SimpleCol


SimpleSpan

Element to control Style of Text. Control for font, color and size of text.

Table 8-81 SimpleSpan Tag
Name Description Value(s) Default Value

color

Color

CDATA

OPTIONAL

font

Font

CDATA

OPTIONAL

size

Font size

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-82 SimpleSpan Related Tags
Parents Children

SimpleTextItem

[PCDATA]

SimpleSpan

SimpleBreak

SimpleUnderline

SimpleEm

SimpleImage

SimpleStrong

SimpleHref

SimpleSpan

SimpleStrong

SimpleUnderline

SimpleEm

SimpleAudio

SimpleAudio

SimpleSpeech

SimpleSpeech

SimpleImage

SimpleTitle

SimpleValue


SimpleSpeech

Control prosody, class, and other VoiceXML text-to-speech engine parameters.

Table 8-83 SimpleSpeech Tag
Name Description Value(s) Default Value

class

VoiceXML 'sayas' class. Allows the Voice browser to say something like "6505067000" as phone number, when class="phone"(rather than saying this as number which would 6 million ...).

(phone | date | digits | literal | currency | number | time

OPTIONAL

phon

VoiceXML 'sayas' phonetics. The representation of the Unicode International Phonetic Alphabet (IPA) characters that are to be spoken instead of the contained text.

CDATA

OPTIONAL

pitch

VoiceXML prosody pitch. numeric attribute that sets the baseline pitch in Hertz. Values can be "n" (set volume to n) or +n or -n. Also can be +n% , -n% or reset.

CDATA

OPTIONAL

range

VoiceXML prosody range. numeric attribute that sets the pitch range in Hertz. Values can be "n" (set volume to n) or +n or -n. Also can be +n% , -n% or reset. The pitch range represents the amount of variation in pitch above the baseline.

CDATA

OPTIONAL

rate

numeric attribute that sets the speaking rate in words per minute. Value Can be an exact number like "150" (sets the speaking rate of 150 words per minute) or can be +n (or -n) (increase or decrease the rate by n from the current level). Also can be +n% , -n% or reset

CDATA

OPTIONAL

sub

VoiceXML 'sayas' sub. Defines substitute text to be spoken instead of the contained text.

CDATA

OPTIONAL

vol

VoiceXML prosody volume. Numeric attribute that sets the output volume on a scale of 0.0 to 1.0 where 0.0 is silence and 1.0 is maximum loudness. Values can be "n" (set volume to n) or +n or -n. Also can be +n% , -n% or reset

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). This tag is applicable for Voice devices only. Will not be supported on other devices even if specified.

CDATA

OPTIONAL

Related Tags

Table 8-84 SimpleSpeech Related Tags
Parents Children

SimpleTextItem

[PCDATA]

SimpleSpan

SimpleBreak

SimpleUnderline

SimpleEm

SimpleImage

SimpleStrong

SimpleHref

SimpleSpan

SimpleStrong

SimpleUnderline

SimpleEm

SimpleAudio

SimpleAudio

SimpleSpeech

SimpleSpeech

SimpleImage

SimpleTitle

SimpleValue


SimpleStrong

Displays enclosed text in a stronger representation, usually bold

Table 8-85 SimpleStrong Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-86 SimpleStrong Related Tags
Parents Children

SimpleTextItem

[PCDATA]

SimpleSpan

SimpleBreak

SimpleUnderline

SimpleEm

SimpleImage

SimpleStrong

SimpleHref

SimpleSpan

SimpleStrong

SimpleUnderline

SimpleEm

SimpleAudio

SimpleAudio

SimpleSpeech

SimpleSpeech

SimpleImage

SimpleTitle

SimpleValue

SimpleHelp


SimpleSubmit

Defines the Submit task of a Bind. SimpleSubmit is child of SimpleTask. SimpleSubmit bind performs a submit action. You may provide a list of Form item names that has to be submitted. If provide a name list is provided then only those form item will be submitted. An Empty SimpleSubmit will Submit all the form items.

Table 8-87 SimpleSubmit Tag
Name Description Value(s) Default Value

name

Name of the Submit button/action (just like HTML). The Submit "name" and "Value" will be submitted back to the app as parameters.

CDATA

REQUIRED

value

Value of the Submit button/action (just like HTML). The Submit "name" and "value" will be submitted back to the app as parameters.

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

method

HTTP Method get or post

(get | post)

get

OPTIONAL

callbackurl

Wireless Module Support. Indicates the URL to return back if the current action leads the user into a different application (application implementing Wireless Module functionary).

CDATA

OPTIONAL

callbackparam

Wireless Module Support. Indicates the return parameters of the callbackurl. When Module returns the context back to the callee application, the callbackparam is passed back for the callee to construct its application state.

CDATA

OPTIONAL

callbacksecure

Indicates the mode of communication, when callback occurs, between Wireless server and the device. Setting callbacksecure="true" will enable a secure connect mode between Wireless and the device when the module performs a callback (to the callbackurl). If not specified, the connect mode will be based on the current request mode.

(true | false)

OPTIONAL

target

URI to navigate to when action is activated. This URL is always rewritten by the Server to point back to Wireless Server, except when mimetype attribute not "text/vnd.oracle.mobilexml". Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

mimetype

mime-type of target URI. Lets the Wireless server know the target resources mime-type. If the target mime-type is not text/vnd.oracle.mobilexml, the Wireless server will not rewrite the URL.

CDATA

text/vnd.oracle.mobilexml

OPTIONAL

static_target

URI to navigate to when action is activated. This URL is never rewritten by server. If exists, this will override the "target" attribute. Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

secure

Indicates the mode of communication between Wireless server and the device. Setting secure="true" will enable a secure connect mode between Wireless and the device for the specified target. If not specified, the connect mode will be based on the current request mode. This DOES NOT indicate mode of connection between Wireless and the remote content source (the service), Wireless will connect to the remote service based on the protocol specified in the target attribute ("http" vs. "https")

(true | false)

OPTIONAL

fetchaudio

Voice only attribute. The URI of an audio clip to play while the "target" is being fetched.

CDATA

OPTIONAL

Related Tags

Table 8-88 SimpleSubmit Related Tags
Parents Children

SimpleCatch

SimpleName

SimpleCase

SimpleTask


SimpleSwitch

Tag to write switch statements on form field name/value. Allows to compare the Value of the form field input on the client side and can branch to perform different Tasks.

Table 8-89 SimpleSwitch Tag
Name Description Value(s) Default Value

name

Name of the form field the switch is based on.

CDATA

REQUIRED

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-90 SimpleSwitch Related Tags
Parents Children

SimpleTask

SimpleCase


SimpleTable

Table 8-91 SimpleTable Tag
Name Description Value(s) Default Value

separator

Used when table is not supported by the target device. If defined add a separator between column values where table cannot be supported.

CDATA

none

OPTIONAL

id

ID attribute of the element. Used for Navigation within a XML response (target="#ID")

xsd:ID

OPTIONAL

bgcolor

background color

CDATA

OPTIONAL

border

Width of Border.

CDATA

OPTIONAL

bordercolor

Table bordercolor

CDATA

OPTIONAL

cellpadding

Cellpadding. As in HTML table

CDATA

OPTIONAL

cellspacing

Cellspacing. As in HTML table

CDATA

OPTIONAL

width

table Width

CDATA

OPTIONAL

height

table Height

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-92 SimpleTable Related Tags
Parents Children

SimpleContainer

SimpleTableHeader

SimpleTableBody


SimpleTableBody

Table 8-93 SimpleTableBody Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-94 SimpleTableBody Related Tags
Parents Children

SimpleTable

SimpleRow


SimpleTableHeader

Table 8-95 SimpleTableHeader Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-96 SimpleTableHeader Related Tags
Parents Children

SimpleTable

SimpleCol


SimpleTask

Container tag for all task items of a Bind (SimpleBind). Tag encloses all the possible tasks like go, submit, exit etc. Task also includes TextItem as a child, this allows rendering of an audio or text (speech) before performing an action (useful in voice applications)

Table 8-97 SimpleTask Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-98 SimpleTask Related Tags
Parents Children

SimpleBind

SimpleSwitch

SimpleGo

SimpleTextItem

SimpleRefresh

SimpleClear

SimpleReprompt

SimpleExit

SimpleDisconnect

SimplePrev

SimpleSubmit


SimpleText

Container for block of Texts (SimpleTextItem's)

Table 8-99 SimpleText Tag
Name Description Value(s) Default Value

wait

VoiceXML Wait. Tells The voice browser if a wait has to happen before proceeding to the next construct in the SimpleResult.

(true | false)

true

OPTIONAL

wrapmode

Text wrap mode.

(wrap | nowrap)

wrap

OPTIONAL

scope

VoiceXML scope. Can take "document"/"dialog" possible values. Default scope of grammar in Form/Menu/Text/Grammar/DTMF. If the scope is set to "document", then the grammar is active in the entire document. This allows for e.g. the user to submit a "Form" (in the SimpleResult) from inside a "SimpleMenu".

(document | dialog)

dialog

OPTIONAL

id

ID attribute of the element. Used for Navigation within a XML response (target="#ID")

xsd:ID

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-100 SimpleText Related Tags
Parents Children

SimpleContainer

SimpleTitle

SimpleCatch

SimpleTextItem

SimpleAction

SimpleBind


SimpleTextField

Used to display non-editable field inside a form. For example, changing an password, where the userid is an non-editable field.

Table 8-101 SimpleTextField Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-102 SimpleTextField Related Tags
Parents Children

SimpleForm

SimpleTitle

SimpleTextItem


SimpleTextItem

This element contains one block of plain text, typically a single paragraph.

Table 8-103 SimpleTextItem Tag
Name Description Value(s) Default Value

timeout

VoiceXML timeout. The the interval of silence before the next construct is played

xsd:nonNegativeInteger

OPTIONAL

color

color

CDATA

OPTIONAL

font

font

CDATA

OPTIONAL

size

font size

CDATA

OPTIONAL

wrapmode

Text wrap mode

(wrap | nowrap)

wrap

OPTIONAL

bargein

VoiceXML bargein. Control whether a user can interrupt a when the text is being read by the VoiceXML browser.

(true | false)

true

OPTIONAL

count

VoiceXML count. A number that allows you to emit different prompts if the user is doing something repeatedly. If omitted, it defaults to "1".

Positive Int

1

OPTIONL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-104 SimpleTextItem Related Tags
Parents Children

SimpleText

[PCDATA]

SimpleForm

SimpleHref

SimpleTextField

SimpleBreak

SimpleFormOption

SimpleEm

SimpleCol

SimpleStrong

SimpleAction

SimpleSpan

SimpleDisplay

SimpleUnderline

SimpleMenuItem

SimpleAudio

SimpleCatch

SimpleSpeech

SimpleCase

SimpleImage

SimpleTask

SimpleValue


SimpleTimer

Invokes a "goto" target task after a specified delay time.

Table 8-105 SimpleTimer Tag
Name Description Value(s) Default Value

timer

Invokes a "goto" target task after a specified delay time. Time in milliseconds

xsd:nonNegativeInteger

REQUIRED

target

URI to navigate to when action is activated. This URL is always rewritten by the Server to point back to Wireless Server, except when mimetype attribute not "text/vnd.oracle.mobilexml". Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

mimetype

mime-type of target URI. Lets the Wireless server know the target resources mime-type. If the target mime-type is not text/vnd.oracle.mobilexml, the Wireless server will not rewrite the URL.

CDATA

text/vnd.oracle.mobilexml

OPTIONAL

static_target

URI to navigate to when action is activated. This URL is never rewritten by server. If exists, this will override the "target" attribute. Also supports "callto:" for Phone call and "mailto:" for email support.

CDATA

OPTIONAL

secure

Indicates the mode of communication between Wireless server and the device. Setting secure="true" will enable a secure connect mode between Wireless and the device for the specified target. If not specified, the connect mode will be based on the current request mode. This DOES NOT indicate mode of connection between Wireless and the remote content source (the service), Wireless will connect to the remote service based on the protocol specified in the target attribute ("http" vs. "https")

(true | false)

OPTIONAL

fetchaudio

Voice only attribute. The URI of an audio clip to play while the "target" is being fetched.

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-106 SimpleTimer Related Tags
Parents Children

SimpleResult

none


SimpleTitle

Title element for form Field and Menu container (SimpleMenu)

Table 8-107 SimpleTitle Tag
Name Description Value(s) Default Value

timeout

VoiceXML timeout. The the interval of silence allowed while waiting for user input in a form input (after prompting the user for input).

xsd:nonNegativeInteger

OPTIONAL

color

Color

CDATA

OPTIONAL

font

Font

CDATA

OPTIONAL

size

Font size

CDATA

OPTIONAL

bargein

VoiceXML bargein. Control whether a user can interrupt a when the text is being read by the VoiceXML browser.

(true | false)

true

OPTIONAL

count

VoiceXML count. A number that allows you to emit different prompts if the user is doing something repeatedly. If omitted, it defaults to "1".

Positive Int

1

OPTIONAL

wrapmode

Text wrap mode.

(wrap | nowrap)

wrap

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-108 SimpleTitle Related Tags
Parents Children

SimpleText

[PCDATA]

SimpleMenu

SimpleBreak

SimpleForm

SimpleEm

SimpleTextField

SimpleStrong

SimpleFormItem

SimpleSpan

SimpleFormSelect

SimpleUnderline

SimpleAudio

SimpleSpeech

SimpleImage

SimpleValue


SimpleUnderline

Underline a text.

Table 8-109 SimpleUnderline Tag
Name Description Value(s) Default Value

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-110 SimpleUnderline Related Tags
Parents Children

SimpleTextItem

[PCDATA]

SimpleSpan

SimpleBreak

SimpleUnderline

SimpleEm

SimpleImage

SimpleStrong

SimpleHref

SimpleSpan

SimpleStrong

SimpleUnderline

SimpleEm

SimpleAudio

SimpleAudio

SimpleSpeech

SimpleSpeech

SimpleImage

SimpleTitle

SimpleValue


SimpleValue

Substitute the value of the client side form field variable, just like a macro. Possible with WML, VoiceXML etc. Can be used to provide a client side confirmation display/screen like "you entered 5, do you want continue" (Where the value 5 is the value of a form item).

Table 8-111 SimpleValue Tag
Name Description Value(s) Default Value

audiobase

VoiceXML base from value element

CDATA

OPTIONAL

class

VoiceXML 'class' from value element. Can take any value on the enumerated list (or can be any string).

(none | audio | boolean | currency | date | digits | number | phone | time | transfer)

OPTIONAL

mode

VoiceXML mode. The type of rendering: tts (the default), or recorded. Can use the audiobase attribute to specify base directory of the audio files

CDATA

OPTIONAL

name

Name of the client variable to substitute

CDATA

OPTIONAL

deviceclass

This tag is interpreted only for the specified deviceclass (conditional transform). The server will transform this element only for certain devices (all devices that belong to the specified deviceclass). Values can be any combination of following "pdabrowser", "pcbrowser", "voice", "microbrowser", "micromessenger", "messenger". If not specified, the tag is interpreted for all devices.

CDATA

OPTIONAL

Related Tags

Table 8-112 SimpleValue Related Tags
Parents Children

SimpleTextItem

none

SimpleSpan

SimpleUnderline

SimpleImage

SimpleHref

SimpleStrong

SimpleEm

SimpleAudio

SimpleSpeech

SimpleTitle

8.2 Using Mobile Context Information in XML

Mobile Contexts are equivalent to scriptlets in many scripting languages like JSP, ASP etc. Mobile Scripting is primarily a context variable substitution. In other words, Mobile Contexts are placeholder for properties substituted by Oracle9iAS Wireless core at the runtime. Though, embedded Mobile Context are not literal to Oracle9iAS Wireless runtime, nonetheless, they do not violate rules of XML document. Oracle9iAS Wireless predefines a set of Mobile Contexts for application developers to use.

Oracle9iAS Wireless also sends all the Mobile Context information as HTTP Headers while invoking a request. It allows application developers to retrieve the Mobile Context information as HTTP Headers. Mobile Contexts as HTTP may be used to make any application-level decisions, or may be used for generating responses while embedded Mobile Contexts may only be used for generating responses.

Mobile Contexts are primarily divided into following four categories.

Table 8-113 User Context
Variable Name DataType Description

user.name

String

Login name of the User. If anonymous user, this should not be set.

user.displayname

String

Display name of the User.

Table 8-114 User Location Context
Variable Name DataType Description

user.location.addressline1

String

Address line1 of the location

user.location.addressline2

String

Address line2 of the location

user.location.companyname

String

Company name of the address

user.location.addresslastline

String

Address line3 of the location

user.location.block

String

Location Block

user.location.city

String

Location City

user.location.county

String

Location county

user.location.state

String

Location state

user.location.postalcode

String

Location zip/postal code

user.location.postalcodeext

String

Extended zip/postal code

user.location.country

String

Country

user.location.type

String

Values are "profile"/"auto"

Table 8-115 Service Context
Variable Name DataType Description

service.home.url

String

URL to the Home Page of the current service.

home.url

String

URL to the User's Wireless home Page

service.parent.Url

String

URL to folder container

Table 8-116 Module Context
Variable Name DataType Description

module.callback.url

String

The callback URL for Module return statement.

module.callback.label

String

Display Label for the Module, calling back the caller.

8.3 Using Mobile Context Information from HTTP Headers

Table 8-117 User Context
Header Name DataType Description

X-Oracle-User.Locale

String

User Locale Information

Table 8-118 User Locale
Header Name DataType Description

X-Oracle-User.name

String

Login name of the User. If anonymous user, this should not be set. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.DisplayName

String

Display name of the User. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.userkind

String

Indicates if user is "anonymous", "virtual" (implicit Identity) or "registered".

X-Oracle-User.authkind

String

Indicates current session's auth mode, values are "unauthenticated", "weak" (weak authentication, implicit identity) or "authenticated"

Table 8-119 User Location Context
Header Name DataType Description

X-Oracle-User.Location.AddressLine1

String

Address line1 of the location. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.AddressLine2

String

Address line2 of the location. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.Companyname

String

Company name at the address.(Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.AddressLastLine

String

Address line3 of the location. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.Block

String

Location Block. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.City

String

Location City. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.County

String

Location county. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.State

String

Location state. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.PostalCode

String

Location zip/postal code. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.PostalCodeExt

String

Extended zip/postal code. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.Country

String

Country. (Value Encoded based on InputEncoding Setting. See Section on Encoding)

X-Oracle-User.Location.Type

String

Values are "profile" or "auto"

X-Oracle-User.Location.X

String

X Cord of the location (float)

X-Oracle-User.Location.Y

String

Y Cord of the location (float)

Table 8-120 Service Context
Header Name DataType Description

X-Oracle-Service.Home.Url

String

URL to the Home deck of the current service.

X-Oracle-Service.Parent.Url

String

URL to folder container.

X-Oracle-Home.Url

String

URL to the User's Wireless home deck.

Table 8-121 Module Context
Header Name DataType Description

X-Oracle-Module.CallBack.Url

String

The callback URL for Module return statement.

X-Oracle-Module.CallBack.Label

String

Display Label for the Module, calling back the caller.

8.3.1 Encoding and Escaping Locale String from Request

Headers are encoded in ISO8859-1 character set according to HTTP 1.1 specification.

All request parameters and certain Headers as specified above (location, user etc.) are encoded as described by encoding parameter of service definition. Further the values are URL encoded as per HTTP 1.1 specification.

Application may retrieve these requests values by performing the following steps.

  1. Use URL decoding to undo base64 encoding.

  2. Construct the new string using service specific encoding.

For example a typical jsp scriptlet for Big5 (traditional Chinese) may look as follows for Java Programming Language.

<%
// let the encoding of service be Big5
String userName = request.getHeader("X-Oracle-User.DisplayName");
userName = java.net.URLDecoder.decode(userName);
userName = new String(userName.getBytes(), "Big5");
%>

8.3.1.1 User Location Context

Table 8-122 User Location Context
Variable Name DataType Description

user.location.addressline1

String

Address line1 of the location

user.location.addressline2

String

Address line2 of the location

user.location.companyname

String

Company name of the address

user.location.addresslastline

String

Address line3 of the location

user.location.block

String

Location Block

user.location.city

String

Location City

user.location.county

String

Location county

user.location.state

String

Location state

user.location.postalcode

String

Location zip/postalcode

user.location.postalcodeext

String

Extended zip/postal code

user.location.country

String

Country

user.location.type

String

Values are "profile"/"auto"

8.3.1.2 Service Context

Table 8-123 Service Context
Variable Name DataType Description

service.home.url

String

URL to the Home Page of the current service.

home.url

String

URL to the User's Wireless home Page

service.parent.Url

String

URL to folder container.

8.3.1.3 Module Context

Table 8-124 Module Context
Variable Name DataType Description

module.callback.url

String

The callback URL for Module return statement.

module.callback.label

String

Display Label for the Module, calling back the caller.

For example, the following two applications can be used to greet the user.

8.3.1.4 HelloUserMobileScript.xml

<?xml version = "1.0" encoding = "UTF-8" standalone="yes" ?>
<!DOCTYPE SimpleResult PUBLIC "-//ORACLE//DTD SimpleResult 1.1//EN" 
"http://xmlns.oracle.com/ias/dtds/SimpleResult_1_1_0.dtd">
<SimpleResult>
 <SimpleContainer>
  <SimpleText>
   <SimpleTextItem>
    <SimpleStrong>Hello %value user.displayname%</SimpleStrong>
   </SimpleTextItem>
  </SimpleText>
 </SimpleContainer>
</SimpleResult>

8.3.1.5 HelloUserMobileScriptHTTP.jsp

<?xml version = "1.0" encoding = "UTF-8" standalone="yes" ?>
<!DOCTYPE SimpleResult PUBLIC "-//ORACLE//DTD SimpleResult 1.1//EN" 
"http://xmlns.oracle.com/ias/dtds/SimpleResult_1_1_0.dtd">
<%
String userName = request.getHeader("X-Oracle-User.DisplayName");
userName = (userName == null) ? request.getHeader("X-Oracle-User.name") : 
userName;
userName = (userName == null) ? "Visitor" : userName;
userName = java.net.URLDecoder.decode(userName);
%>
<SimpleResult>
 <SimpleContainer>
  <SimpleText>
   <SimpleTextItem halign="center">Hello <%=userName%></SimpleTextItem>
  </SimpleText>
 </SimpleContainer>
</SimpleResult>

Figure 8-1 Output of HelloUserMobileScript.xml and HelloUserMobileScriptHTTP.jsp

Text description of xml8-1.gif follows.

Text description of the illustration xml8-1.gif


Go to previous page Go to next page
Oracle
Copyright © 2002 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index