Parameters of the AWSAjax.properties file

This file is located in the AWSResources subdirectory of your web application.

POOL_REQUEST_INITIAL_NUMBER

Sets the initial number of AJAX requests created in advance for the purpose of running the Web application. Each request is reused once it has been executed. A new request is created if no existing requests are available.

Default value: 5

REQUEST_TIMEOUT

Sets the maximum time that the system waits for an Adelia Web AJAX event to be executed. This time must not exceed the life of an HTTP session (as specified in the file web.xml).

Default value: 5.

The unit of measurement is the minute.

SIMULTANEOUS_DIFFERENT_REQUESTS_RULE

Defines the rule to follow when two different Adelia Web AJAX events need to be executed simultaneously. Two events are defined as being different if their sources are different Javascript events or graphical controls.

You can choose between two rules:

• Rule 1: Use the browser's default behavior. Each browser is able to handle a different number of simultaneous requests. This number is determined by the SIMULTANEOUS_REQUESTS_NUMBER parameter.

• Rule 2: Serialize concurrent events to prevent them from being executed in parallel on the Web application server. Only one event is executed at a time.

Each rule defines a maximum number of events that can be executed simultaneously on the Web application server (several events with rule 1, only one with rule 2). If any other events must be executed, the browser stores them in a queue (with priority management) so that they can be processed as soon as the current event is finished.

Note: Rule 1 should be used with caution, as it causes processes on the Web application server to run in parallel.

Note: It is possible to specify a particular behavior when two identical events (i.e. with the same graphical control and the same Javascript event source) must be executed. This event property is defined in the html page designer (see the "AJAX parameters" section in Inserting a Button object, for example).

Default value: 2

SIMULTANEOUS_REQUESTS_NUMBER

Sets the number of Adelia Web AJAX events that the browser can send to the Web application server simultaneously.

By default, this parameter is set to 2: the leading browsers are able to support two simultaneous requests in accordance with the version 1.1 of the HTTP specifications issued by the World Wide Web Consortium.

It is possible to increase this number for a browser (refer to the browser provider's technical documentation).

Note: This parameter should be used with caution, as it causes processes on the Web application server to run in parallel.

This parameter is only processed if the SIMULTANEOUS_DIFFERENT_REQUESTS_RULE parameter is set to 1.

Default value: 2

RAISING_REQUEST_ERROR_RULE

Defines the rule to follow when an Adelia Web AJAX event causes an HTTP error on the Web application server.

You can choose either or both of the following two rules:

• Rule 1: Displays an error message box; see the definition of these messages in the file located in the Web application's AWSResources subdirectory.

• Rule 2: Displays an error page; see the definition of the URL_ERROR_CODE_OTHERS parameter below.

To select more than one rule, simply set the rule numbers, separated by spaces, as the parameter value.

Example:

RAISING_REQUEST_ERROR_RULE=1 2

Rules are subject to internal priorities: rule 1 is applied before rule 2.

Default value: 1

URL_ERROR_CODE_OTHERS

Defines the URL (relative to the Web site root) of a page that is displayed when an HTTP error occurs while an Adelia AJAX event is being executed.

If an HTTP error with the number XXX is triggered, and the URL_ERROR_CODE_XXX parameter exists, the value of that parameter is adopted as the URL of the page to be displayed; otherwise the value of the URL_ERROR_CODE_OTHERS parameter is used by default.

These parameters can be assigned the values of the <error-page> node defined in the web.xml file, if it exists.

This redirection mechanism pointing to an error page is only enabled if the RAISING_REQUEST_ERROR_RULE parameter contains the value 2.

Default value: None

A list of the main HTTP error codes is given below:

REQUEST_DEFAULT_PRIORITY

Sets the default priority of an Adelia AJAX event if this property of the event was not specified when the HTML page layout was designed.

This parameter's value must not be outside the interval [REQUEST_MIN_PRIORITY, REQUEST_MAX_PRIORITY].

Default value: 5

REQUEST_MIN_PRIORITY

Sets the minimum priority that can be assigned to an Adelia AJAX event in a Web application. The event priority specified when the HTML page layout is designed must not be outside the interval [REQUEST_MIN_PRIORITY, REQUEST_MAX_PRIORITY].

Default value: 10

REQUEST_MAX_PRIORITY

Sets the maximum priority that can be assigned to an Adelia AJAX event in a Web application. The event priority specified when the HTML page layout is designed must not be outside the interval [REQUEST_MIN_PRIORITY, REQUEST_MAX_PRIORITY].

Default value: 0

PROGRESS_INDICATOR_CLASS

Defines a CSS style class assigned to the IFRAME containing the started events indicator. By default, a class is assigned that sets the following attributes:

•  border-style:solid;

•  border-width:3px;

•  border-color:black;

•  background-color:white;

If the new class is to overload any of these attributes, its definition MUST be followed by !important.

Example:

.myClass { background-color: red !important; }

PROGRESS_INDICATOR_POSITION

Sets the position on the browser page of the started events indicator.

Possible values:

Default value: 5 (NORTHEAST)

PROGRESS_INDICATOR_WAIT_IMG

Defines the image displayed by the started events indicator to represent an event that is pending processing. Pending events are only visible if the PROGRESS_INDICATOR_SHOW_ALL_STARTED_REQUEST parameter is set to Y.

The dimensions of this image must match those of the image specified by PROGRESS_INDICATOR_LOADING_IMG.

The default image is a non-animated .GIF.

Default value: /AWSResources/AWSAjaxWait.gif

PROGRESS_INDICATOR_LOADING_IMG

Defines the image displayed by the started events indicator to represent an event that is currently being processed.

The dimensions of this image must match those of the image specified by PROGRESS_INDICATOR_WAIT_IMG.

The default image is an animated .GIF.

Default value: /AWSResources/AWSAjaxLoading.gif

PROGRESS_INDICATOR_SHOW_ALL_STARTED_REQUEST

Specifies whether or not the started events indicator also shows events that are pending processing.

Possible values:

Default value: N

Back to Adelia Web application configuration files

↑ Top of page