dataSource

Top  Previous  Next

  <dataSource name="" basedon="">
    <class></class>
    <accessControl></accessControl>
    <unitname></unitname>
    <resbundle></resbundle>
    <scope></scope>
    <refreshTimeOut></refreshTimeOut>
    <precond></precond>
    <itemsPerPage></itemsPerPage>
    <pagesPerBlock></pagesPerBlock>
    <debug></debug>
    <param name=""></param>
  </dataSource>

 

Attributes of "dataSource" element

Attribute

MScript

Description

name

-

The name of the Data Source

basedon

-

Defines the base configuration element of the data source

 

Nested elements of "dataSource" element

Nested Element

MScript

Description

class

-

Defines the name of the data service class that implements org.moremotion.datasrc.DataService interface.

accessControl

-

The accessControl element can be used to control the accessing of the data source with a sufficient authority. See accessControl configuration element.

unitname

ü

This element defines the resource bundle name of the data service class. Resource bundles contain multi-lingual resources

resbundle

ü

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.

scope

ü

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"

refreshTimeout

ü

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

precond

-

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 != ''

itemsPerPage

ü

This parameter 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.

pagesPerBlock

ü

This parameter is meaningful together with itemsPerPage parameter and it defines the number of the page indexes.

debug

ü

Data service classes should be designed to print the log records about their execution in order to let the users to trace it. This parameter accepts a number value between 1 and 3 as the level of the logging.

param

ü

The parameters defined with param element are evaluated by the data service classes.