Element "zpro > joker > JokerDataSource"

JokerDataSource element can be used to configure a DataService class without creating a library element.

Properties

DataService Class Name

The name of the Java class that implements org.moremotion.datasrc.DataService interface.

Unit Name (Accepts MScript)

The name of the unit that implies the name of the resource file.

Scope (Accepts MScript)

The value of this element defines the scope of the data object (ADOM) that is generated by the data service class. The valid values are "Request", "Session" and "Application".

Refresh Timeout (Accepts MScript)

The life duration of the data object (ADOM) in seconds. This parameter is applicable for "Session" and "Application" scopes only. The default value is "0". MoreMotion AF will not call the data service class again if the given value is not expired.

Parameters (Accepts MScript)

The parameters and their values can be defined with this property in XML format as follows.

Example:

<param name="param1">ABC</param>

<param name="param1">XYZ</param>

Refresh Timeout (Accepts MScript)

The life duration of the data object (ADOM) in seconds. This parameter is applicable for "Session" and "Application" scopes only. The default value is "0". MoreMotion AF will not call the data service class again if the given value is not expired.

Execution Precondition (Accepts MScript)

The MScript expression to test to call the data service. The data service is called only is the test result of this expression is true.

Example: ID != ''

Items Per Page (Accepts MScript)

This property defines the number of the items (records) to be generated by the data service for each call. The responsibility to provide the data in parts belongs to the data service class. The MoreMotion AF's responsibility is just transferring the navigation instructions received from the Navigation controls to the the data service to let it know which part of the data to be generated.

Pages Per Block (Accepts MScript)

This parameter is meaningful together with Items Per Page property and it defines the number of the page indexes. The value of this property is evaluated by the MoreMotion AF to prepare and insert additional control data into the generated data request elements.

Defining this parameter instructs the data service to obtain the total number of items and therefore should not be used for the data sources that provide big amount of data since it may slow down the execution.

Resource Name (Accepts MScript)

If a resource bundle name is defined with this optional element, the $res() resource definitions existing in the data generated by the data service class is resolved with the resources existing in the resource bundle.

Access Control (Accepts MScript)

See Access Control

Debug (Accepts MScript)

To request information about the execution of the Data Service Class, a number between 1 and 3 can be specified here. The data service class will dump the desired level of information to the system console.