ViewURLModeless function

Syntax

ViewURLModeless(URL, [modal_options])

Description

Use the ViewURLModeless function to open a modeless modal window displaying the non-component content (for example, an iScript or external content) specified by the URL parameter. The user must dismiss the modeless window before continuing work in the page from which the modeless window was called.

To be displayed within the iframe of the modeless window, the external content and the PeopleSoft application must either reside within the same domain or they must both set the document.domain property to the same value. For more information on how the domain and same-origin is determined, see Same-origin policy.

Important:

Use this function within fluid applications only.

Parameters

Parameter Description

URL

Specify the location to navigate to. You can specify the URL either as a string value or as a URL saved in the URL table using the following format: URL. URL_ID

modal_options

Specifies custom modal options as a String value. See Fluid User Interface Developer’s Guide: Modal Options for more information.

Returns

None.

Examples

The following example displays iScript content in a modal window:

Local string &sUrl;
Local string &sMenuTitle;
Local string &sOptions;

&sUrl = GenerateScriptContentURL(%Portal, %Node, Record.WEBLIB_PTNUI, Field.FUNCLIB, "FieldFormula", "IScript_GroupletDiag");
&sMenuTitle = EscapeHTML(MsgGetText(11124, 525, "Message Not Found: iScript"));
&sOptions = "sTitle@" | &sMenuTitle | ";width@600;height@400;");
ViewURLModeless(&sUrl, &sOptions);

The following example displays external content in a modal window:

Local string &sMenuTitle;
Local string &sOptions;

&sMenuTitle = EscapeHTML(MsgGetText(11124, 526, "Message Not Found: Oracle.com"));
&sOptions = "sTitle@" | &sMenuTitle | ";width@600;height@400;");
ViewURLModeless("http://www.oracle.com", &sOptions);

Modeless Windows

In addition to modal secondary windows, you can create modeless secondary windows. A modeless window is different from a modal window launched by any of the DoModal* functions in that its state is separate from that of the parent, launching component. When a modeless window is launched from a classic component using the TransferModeless function, the modeless window does not mask the parent window, which allows the user to update the modeless and parent window from the same browser session at the same time.

Note:

While the title bar of a modeless window includes an X (or cancel) button, it cannot include any custom buttons.

Important:

Only one active child modeless window can be open at one time. Therefore, after opening a modeless child window from the parent, you cannot open a second modeless child window from that modeless window. However, you can open a modal window from that modeless window.

Related Topics