Child Elements

The ACTION_CONTROL element can contain the following child elements:

Table 1. Child Elements of the ACTION_CONTROL Element

Element Name

Cardinality / Description

LINK

0..1. An action control with a TYPE of ACTION that has no LINK element will create a link to the previous page in the history that had SAVE_LINK set to true on the link that led to this page (this is typically used for Cancel buttons). However this type of ACTION_CONTROL should not be present on a page that is directly referenced by any tabbed configuration artifact. Also, if this type of ACTION_CONTROL is preceded by another ACTION_CONTROL of the same type in the page history, there is the potential of a circular reference between these pages.

An action control with a TYPE of SUBMIT that has no LINK element will submit the field values to the action phase and then return to the previous page in the history that had SAVE_LINK set to true on the link that led to this page.

An action control with a TYPE of FILE_DOWNLOAD only requires a link if it must provide the page parameter values specified in the INPUT elements of its configuration. Each CONNECT element in the link can contain a SOURCE element to specify the value and a TARGET element specifying the page parameter to which to map the value. The PROPERTY attribute value of the page parameter must match the PAGE_PARAM attribute value of the INPUT element in the configuration.

CONNECT

0..1. A CONNECT element specifying a single SOURCE end-point. As a direct child it is used only for an action control with a TYPE of CLIPBOARD. Such an action control places predefined textual data into the system clipboard when clicked.

Text to be copied to clipboard can be sourced from the server, the request or a properties file.

The CONNECT element used can only contain a SOURCE element with a NAME property of PAGE, TEXT or the name of a server interface defined within the page.

SCRIPT

0..n. A script element associated with an action control. For a detailed description of this element see SCRIPT.

SCRIPT elements are not supported on ACTION_CONTROL elements with a type of CLIPBOARD.

CONDITION

0..1. Affects whether or not the ACTION_CONTROL is displayed.

When linking to another page, the link must specify all page parameters declared on the target page.