PageToJSP (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Functions specific to WEB

Functions for page management

Outgoing format and page optimization

Caution: a single action can be performed at a time on the same page

See also

PageToJSP (Function)

In french: PageVersJSP

Sends the data found in a page currently displayed in the browser to a JSP server.

Example

// Triggers a validation of the current page
// And sends the content of the current page to the JSP server
PageToJSP("", "http://www.JSPServer.com/TestPage")

Syntax

PageToJSP(<Page> , <Target URL> , <Send method> [, <Destination> [, <Window name> [, <Options> [, <Width> [, <Height> [, <Horizontal position> [, <Vertical position> [, <Javascript parameters>]]]]]]]])

<Page>: Page name

Name of the page whose data must be sent to the JSP server.
If this parameter corresponds an empty string (""), the current page will be taken into account. This page must be currently displayed in the browser.

<Target URL>: Character string (with quotes)

URL of the JSP page to which the data found in the WEBDEV page must be sent.

<Send method>: Character String constant

Method for sending the data to the JSP server:
GET The data is sent to the server via the URL.
POST The data is sent after the HTTP headers, in the body of the request.

<Destination>: Optional character string or constant

Name of target frame. <Destination> can also take the following values:
CurrentFrame the target is the current frame (default value).
ParentFrame the target is the container of the current page (parent frameset, parent browser).
CurrentBrowser the target is the current browser.
NewBrowser the target is a new browser (a new browser window is opened). The following parameters of PageToJSP are used to configure this new window.

<Window name>: Optional character string (with quotes)

Name of window in the new browser if <Target> is equal to the NewBrowser constant. This parameter allows you to redisplay a page in a browser with the same name (if several browsers are open on the computer of the Web user).

<Options>: Optional Integer constant (or combination of constants)

Parameters of the window in the new browser if <Destination> is equal to the NewBrowser constant:
ONLocation The address bar will be displayed.
ONScrollbar The scrollbars will be displayed.
ONFull
(Default value) The window of the new browser will include an address bar and scrollbars (equivalent to the combination of all the previous constants).
ONResizable The window of new browser will be resizable.
ONLink The link bar will be displayed.
ONMenuBar The menu bar will be displayed.
ONSatusBar The status bar will be displayed.
ONToolbar The toolbar will be displayed.
ONSimple The window of the new browser will be a simple window (no combination of constants).

<Width>: Optional integer

Width of window in the new browser (in pixels).

<Height>: Optional integer

Height of window in the new browser (in pixels).

<Horizontal position>: Optional integer

Horizontal position (in pixels) of window in the new browser (in relation to the top left corner of the screen).

<Vertical position>: Optional integer

Vertical position (in pixels) of window in the new browser (in relation to the top left corner of the screen).

<Javascript parameters>: Optional character string (with quotes)

Other Javascript parameters that must be used when opening a new browser if <Target> is equal to the NewBrowser constant.

Remarks

Additional controls

The page can contain additional controls specific to WEBDEV (WD_ACTION, WD_BUTTON_CLICK, ...). These controls are required by WEBDEV in order to operate properly. The value of these controls is also sent to the JSP server.

Outgoing format and page optimization

The values are returned by pairs in the following format: (<Control alias>, <Control value>).

We recommend that you use "Compress the names of controls (..Alias)".

Reminder: This option is available in the characteristics for advanced optimization of the HTML code:

Configuration of projects: "Project" tab of the project description
Configuration of a page: "Advanced" tab of the page description

Caution: a single action can be performed at a time on the same page

PageToJSP triggers an action on the page displayed in the browser of Web user. However, the Internet browsers allow a single action on the page per process.

Consequences: PageToJSP cannot be used in a code triggering an action (automatically or not). This function is ignored:

In the click code of a "submit" button (or in a procedure called by the click code of this button)
In the click code of an "other" button whose action differs from "none" (or in a procedure called by the click code of this button)
If it is followed by PageSubmit or by EmailOpenMail (in the current process, in a procedure called by the current process or in another process called by Execute).

Component : WDJS.DLL