Programmed AJAX

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Overview
AJAX management functions
Procedures that can be called by AJAX
WLanguage functions useless in AJAX

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Programmed AJAX

Overview

The diagram below presents the use of "programmed AJAX" in a WEBDEV site:


	Running a browser process (AJAXExecute or AJAXExecuteAsynchronous).
	Request to execute a server procedure.
	Running the server procedure.
	Generating the result. The procedure result will be contained in a character string or in an XML document.
	Sending the procedure result (RESULT keyword).
	The result of the procedure is analyzed.
	Displaying the modified information. Only the necessary controls are refreshed.

AJAX management functions

Several AJAX functions can be used to manage the complex processes in WEBDEV:


AJAXAvailable	Used to find out whether the AJAX technology is supported by the current browser.
AJAXExecute	Runs a server procedure without refreshing the page. This function is locking. No process will be run as long as the procedure result run is not retrieved.
AJAXExecuteAsynchronous	Runs a server procedure without refreshing the page. This function is not locking. The other processes continue to run (no matter whether the result of the procedure run is retrieved or not).
AJAXAsynchronousCallPending	Used to find out whether a server procedure called by AJAXExecuteAsynchronous is currently run.
AJAXCancelAsynchronousCall	Cancels the automatic execution of browser procedure called by AJAXExecuteAsynchronous.

These functions allow you to run a server procedure from a browser process.

Caution: The information stored on the server must be consistent with the information displayed on the Web user's computer. For example, if data is modified, this data must be modified both on the server and on the page displayed in the browser.

Procedures that can be called by AJAX

To secure the WEBDEV sites, the server procedures are protected from illegal calls (attempt to re-route a session for example). To run a server procedure from a browser process (AJAXExecute or AJAXExecuteAsynchronous), you must allow this procedure to be called by AJAX.

To allow a server procedure to be called by AJAX, all you have to do is click "AJAX" in the bar of the procedure:

Procedure that cannot be called by AJAX

Procedure that can be called by AJAX

WLanguage functions useless in AJAX

All the functions available in WEBDEV server can be used in AJAX. However, the folllowing functions are useless in AJAX. Therefore, these functions are not available in AJAX.


StringDisplay	Displays a character string (or a buffer) in the browser.
ContextClose	Closes a page context
ContextOpen	Opens a new page context without returning the information to the browser.
FileDisplay	Displays a file in the browser of Web user.
FramesetRefresh	Refreshes a frameset displayed in the browser of the Web user from the context found on the server.
FramesetDisplay	Displays a WEBDEV frameset in the browser of Web user.
FramesetUse	Displays a WEBDEV frameset in the browser of the Web user and closes all the current page and frameset contexts.
InitWindow	Resets (or not) the controls found in the current page and runs the initialization processes of controls.
PageInitialization	Resets (or not) the controls found in the current page and runs the initialization processes of controls.
PageUse	Displays a WEBDEV page in the browser of the Web user and closes all the current page contexts.
ScriptDisplay	Calls an external script (.php, .asp, .mhtml or .mht) and returns the result page in the current browser window.
UploadCopyFile	Saves on the server a file "uploaded" by the Web user.
UploadFileName	Returns the name of a file "uploaded" by the Web user.
Use	Displays a page in the browser of Web user.

This list can evolve. It is recommended to check the documentation for each function. The

logo indicates whether the function is available in AJAX.