Other ePortal Controls

The following controls have preset values. 

Control

Action

ePortal:ePortalCloseButton

Closes the current ClearPath server session.

ePortal:ePortalGeneratedContent

When used within a build-time template, the ePortalGeneratedContent tag is replaced with the content generated by ePortal Developer, for example a captured screen.

When used within a runtime template, the ePortalGeneratedContent tag is replaced with the dynamically generated content of the uncaptured screen.

ePortal:ePortalPageNumber

Displays the current page number or the desired page of a multipage application.

If the number is changed, the ePortalSubmitButton must be used to initiate the change to the new page.

ePortal:ePortalRefreshButton

Refreshes the current page with information from the ClearPath server.

ePortal:ePortalSubmitButton

Submits the current page to the ClearPath server.

ePortal:ePortalTerminalKeys

This control is a special form of a dropdown list, designed for use with OS 2200 UTS applications that require the use of function keys. Refer to the topic Controlling the Look and Feel in a UTS Data Source Project for more information on function keys.

This control adds a dropdown list to the page. By default, the Items attribute is populated with the list of all function keys available for a UTS application (for example, F1 through F22). In addition, this control is automatically associated with the field _KeySequence, and this association cannot be changed.

Since most applications do not use all 22 function keys, you can edit the Items attribute to remove the function keys that you do not use. In addition, you can edit the Text for each item in the Items list to something that is meaningful for your application.

ePortal:AlertBox

The ePotal:AlertBox control does not render anything visible on the web page. However, if the Text property is set to a non-empty value, and Show and Visible are both true, a popup box appears with the text. The user must dismiss the popup box by clicking or tapping OK.

Note: The ePortal:AlertBox control is used for both web forms and mobile applications.

The following properties are unique to ePortal:AlertBox:

Property Name

Type

Default Value

Description

Text

String

Empty String

The text to be displayed in a pop-up box. If this value is empty, no pop-up window is displayed.

Show

Boolean

False

If True, displays the alert modal dialog when the page is loaded, if Text is not empty and Visible is True.

ePortal:Image

The ePortal:Image control renders a dynamically selected image.

ePortal:AbsEaeScriptManager

The ePortal:AbsEaeScriptManager control does not render anything visible on the web page. Instead, this control adds JavaScript to the web page, to support certain AB Suite/EAE functions.

In particular, the JavaScript is used to implement the automated AB Suite/EAE Teach form presentation. In addition, the JavaScript exposes the following functions that the web page or mobile web app developer can call from controls on the page:

Note: The ePortal:AbsEaeScriptManager control is used for both web forms and mobile applications.

AbsEae.ShowMessages()

This JavaScript function has no arguments and is called to locate the AlertBox control with an ID of MessageList_ and set the Show property to True. This causes a pop up box to display any error messages that apply to the page.

Typically, this function is called from the OnClientClick property of a button. For example, by default, ePortal generates a web browser page with the following control:

<asp:Button ID="MessageButton1" runat="server"
     onclientclick="return AbsEae.ShowMessages();" Text="Messages" />

If there are multiple messages, in some cases the messages may appear in reverse order. You can control the ordering by configuring the option Reverse Message Sequence at the data source level using the AB Suite/EAE Data Source Project Property Pages Dialog or for a particular presentation project (refer to Viewing or Changing ePortal Application Configuration Properties).

AbsEae.SelectIspecs()

This JavaScript function has no arguments and is called to cause the _SelectIspec web form or mobile app form to open in the browser window.

The application user uses the _SelectIspec form to navigate directly to another page in the same AB Suite/EAE application. Typically, this function is called from the OnClientClick property of a button.

For example, by default, ePortal generates a web browser page with the following control:

<asp:Button ID="SelectIspecButton1" runat="server"
     onclientclick="AbsEae.SelectIspec();" Text="Select Form" />

Refer to Support for Form Selection in Support for AB Suite/EAE Features for more information.