Oracle Portal-to-Go Implementation Guide Release 1.0.2.2 A86635-02 |
Library | Service | Contents | Index

# A
Simple Result DTD Notes

The Simple Result DTD is the Portal-to-Go internal representation of the result returned by an adapter. If an adapter does not return the result in this format, the master service must use the result transformer to convert the result into the Simple Result format.

The following notes describe the content of the DTD including the elements, the usage, the attributes, the children, and the DTD declarations.

### SimpleResult

##### Element

SimpleResult is the result element.

##### Usage

This element contains the result.

##### Children

SimpleContainer

##### Attributes

title

##### DTD Declaration

<!ELEMENT SimpleResult (SimpleContainer+)>

<!ATTLIST SimpleResult

title CDATA #IMPLIED

>

### SimpleContainer

##### Element

SimpleContainer is a compound UI consisting of several simple UI elements.

##### Usage

Used as a logical container for one or more simple elements.

##### Children

SimpleText

SimpleMenu

SimpleForm

SimpleTable

SimpleImage

SimpleBreak

SimpleHref

SimplePhone

SimpleEmail

SimpleHelp

##### DTD Declaration

<!ELEMENT SimpleContainer (SimpleHelp?, (SimpleText | SimpleMenu

| SimpleForm | SimpleTable

| SimpleImage | SimpleBreak | SimpleHref | SimplePhone |

SimpleEmail)+)>

<!ATTLIST SimpleContainer

title CDATA #IMPLIED

>

### SimpleText

##### Element

SimpleText is used for displaying one or more blocks of text.

##### Usage

Used for plain text.

##### Children

SimpleTextItem

SimpleHelp

##### Attributes

title

##### DTD Declaration

<!ELEMENT SimpleText (SimpleHelp?, SimpleTextItem+)>

<!ATTLIST SimpleText>

### SimpleTextItem

##### Element

SimpleTextItem is a block of text.

##### Usage

Holds one block of text, normally a single paragraph.

##### Children

#PCDATA (the actual text)

##### Comments

There is no line feed at the end of each SimpleTextItem. See "SimpleBreak".

##### Attributes

name

title

##### DTD Declaration

<!ELEMENT SimpleTextItem (#PCDATA)>

<!ATTLIST SimpleTextItem

name CDATA #IMPLIED

title CDATA #IMPLIED

>

### SimpleMenu

##### Element

SimpleMenu displays a simple menu.

##### Usage

A single menu with selectable links.

##### Children

SimpleMenuItem

SimpleHelp

##### Comments

A SimpleBreak should be inserted wherever a linefeed is desired.

##### DTD Declaration

<!ELEMENT SimpleMenu (SimpleHelp?, SimpleMenuItem+)>

<!ATTLIST SimpleMenu>

### SimpleMenuItem

##### Element

SimpleMenuItem is a single, selectable option in a SimpleMenu.

##### Usage

This is a menu item that links to something.

##### Children

SimpleMenu

##### Attributes

target (the link target for this item)

icon (the name of the icon without an extension. The file extension is appended by the device transformer.)

##### DTD Declaration

<!ELEMENT SimpleMenuItem (SimpleMenu?)>

<!ATTLIST SimpleMenuItem

target CDATA #REQUIRED

icon CDATA #IMPLIED

>

### SimpleForm

##### Element

SimpleForm displays one or more input fields.

##### Usage

Used as a data-entry form.

##### Children

SimpleFormItem

SimpleHelp

##### Attributes

target (the link target for this form)

submit (the text for the submit button, default is "Submit")

##### DTD Declaration

<!ELEMENT SimpleForm (SimpleHelp?, (SimpleFormItem |

SimpleFormSelect)+)>

!ATTLIST SimpleForm

target CDATA #REQUIRED

submit CDATA #IMPLIED

>

### SimpleFormItem

##### Element

SimpleFormItem is a single input item in a simple form.

##### Usage

Used for user input.

##### Children

#PCDATA (a default value from the server, it deprecates the default attribute)

##### Attributes

value (see the description for "default")

default (a default value for optional fields, it is deprecated by the value of the element. See the child element for more information.)

name (the name of the variable)

title (specifies a title for the element, which may be used in the presentation of this object)

mandatory (indicates that the form item is mandatory)

maxLength (provides a maximum input length)

size (the width of the input field, if the input field is larger than the device screen, it is displayed in multiple lines)

format (the format of inputs, see the WML 1.1 specification for more information)

type (whether the input field should have "password" style, valid values are text or password)

##### DTD Declaration

<!ELEMENT SimpleFormItem (#PCDATA)>

<!ATTLIST SimpleFormItem

name CDATA #REQUIRED

title CDATA #IMPLIED

value CDATA #IMPLIED

default CDATA #IMPLIED

mandatory (yes|no) "no"

maxLength CDATA #IMPLIED

size CDATA #IMPLIED

format CDATA #IMPLIED

type (text|password) "text"

>

### SimpleFormSelect

##### Element

SimpleFormSelect is a selectable option menu in a simple form.

##### Usage

Presents a selectable number of options to the user. This is a radio box group.

##### Children

SimpleFormOption

SimpleHelp

##### Attributes

name (the name of the variable)

title (the display name for the variable)

##### DTD Declaration

<!ELEMENT SimpleFormSelect (SimpleHelp?, SimpleFormOption+)>

<!ATTLIST SimpleFormSelect

name CDATA #REQUIRED

title CDATA #IMPLIED

>

### SimpleFormOption

##### Element

SimpleFormOption is a single option in a simple form.

##### Usage

A single option.

##### Children

#PCDATA (the text of the option)

##### Attributes

value (the value assigned when this option is selected)

##### DTD Declaration

<!ELEMENT SimpleFormOption (#PCDATA)>

<!ATTLIST SimpleFormOption

value CDATA #REQUIRED

>

### SimpleTable

##### Element

SimpleTable is for displaying tabular data.

##### Usage

Used for simple tabular data only.

##### Children

SimpleTableHeader

SimpleTableBody

##### Attributes

title (the title for the table)

##### DTD Declaration

<!ELEMENT SimpleTable (SimpleTableHeader?, SimpleTableBody)>

<!ATTLIST SimpleTable

title CDATA #IMPLIED

>

### SimpleTableHeader

##### Element

SimpleTableHeader contains the table header.

##### Usage

Contains table header information, such as column headers.

##### Children

SimpleCol

##### Attributes

none

##### DTD Declaration

<!ELEMENT SimpleTableHeader (SimpleCol+)>

<!ATTLIST SimpleTableHeader>

### SimpleTableBody

##### Element

SimpleTableBody contains the actual tabular data.

##### Usage

Contains table data rows.

##### Children

SimpleRow

##### Attributes

none

##### DTD Declaration

<!ELEMENT SimpleTableBody (SimpleRow+)>

<!ATTLIST SimpleTableBody>

### SimpleRow

##### Element

SimpleRow contains a single row of data.

##### Usage

Stores a table row.

##### Children

SimpleCol

##### Attributes

none

##### DTD Declaration

<!ELEMENT SimpleRow (SimpleCol+)>

<!ATTLIST SimpleRow>

### SimpleCol

##### Element

SimpleCol contains a single table cell.

##### Usage

Stores a single value for a table cell.

##### Children

#PCDATA (the column value)

##### DTD Declaration

<!ELEMENT SimpleCol (#PCDATA)>

<!ATTLIST SimpleCol>

### SimpleImage

##### Element

SimpleImage displays an image.

##### Usage

Used to reference an external image.

##### Children

none

##### Attributes

target (the URL for this image, without an extension)

alt (the alternative text, if the device does not support images)

width (the width of the image)

height (the height of the image)

##### DTD Declaration

<!ELEMENT SimpleImage EMPTY>

<!ATTLIST SimpleImage

target CDATA #REQUIRED

alt CDATA #IMPLIED

width CDATA #IMPLIED

height CDATA #IMPLIED

>

### SimpleBreak

##### Element

SimpleBreak provides a logical break in the layout.

##### Usage

Used to provide a logical break.

##### Children

none

##### Attributes

none

##### DTD Declaration

<!ELEMENT SimpleBreak EMPTY>

<!ATTLIST SimpleBreak>

### SimplePhone

##### Element

SimplePhone references a phone number.

##### Usage

A phone number.

##### Children

#PCDATA (the name of the phone)

##### Attributes

target (a phone number, for example, +46705104725)

##### DTD Declaration

<!ELEMENT SimplePhone (#PCDATA)>

<!ATTLIST SimplePhone>

### SimpleEmail

##### Element

SimpleEmail references an email address.

##### Usage

Used to reference an email address.

##### Children

#PCDATA (the name of the user)

##### Attributes

target (the email address)

##### DTD Declaration

<!ELEMENT SimpleEmail (#PCDATA)>

<!ATTLIST SimpleEmail

target CDATA #REQUIRED

>

### SimpleHref

##### Element

SimpleHref provides an anchor to another resource.

##### Usage

An anchor to another resource.

##### Children

#PCDATA (the name of the link)

##### Attributes

target (the link)

##### DTD Declaration

<!ELEMENT SimpleHref (#PCDATA)>

<!ATTLIST SimpleHref

target CDATA #REQUIRED

>

### SimpleHelp

##### Element

SimpleHelp indicates a help text.

##### Usage

Used for help text.

##### Children

#PCDATA (the name of the help text)

##### Attributes

none

##### DTD Declaration

<!ELEMENT SimpleHelp (#PCDATA)>

<!ATTLIST SimpleHelp>

| Copyright © 2000 Oracle Corporation. All Rights Reserved. |
Library | Service | Contents | Index