Class actuate.DataService

Connects to an Actuate web application service to retrieve data from Actuate BIRT reports as a ResultSet.

actuate.DataService(string iportalUrl, actuate.RequestOptions requestOptions)

String. Optional. The URL of an Actuate web application service. The DataService uses the web application service set in actuate.initialize if one is not specified.

actuate.RequestOptions object. Optional. Specifies the request options for the iportal web service connection. The DataService uses the options set in actuate.initialize if one is not specified.

Table 44‑16 actuate.DataService functions
Function	Description
downloadResultSet( )	Retrieves data from a report in a ResultSet object

void DataService.downloadResultSet(string datasource, actuate.data.Request request, function callback, function errorCallback)

Returns data from an Actuate BIRT report document managed by an Actuate web application. The actuate.data.ResultSet object that downloadResultSet( ) returns is used by the callback function.

String. The repository path and name of the file from which to retrieve data.

actuate.data.Request object. Specifies the request for the report.

Function. The callback function to use after the ResultSet finishes downloading. This function must take the returned ResultSet object as an input parameter.

Function. Optional. The function to call when an error occurs. The possible errors are actuate.Exception objects. The errorCallback( ) function must take an exception as an argument.

This example retrieves a result set as specified by the myRequest request object, and calls the makeAscendingSales function, which must take a actuate.data.ResultSet object as an input parameter:

var myRequest = new actuate.data.Request("Top_5_Customers", 1, 0);

var myDataService =

new actuate.DataService( "http://127.0.0.1:8900/iportal" );

myDataService.downloadResultSet("/Public
/BIRT and BIRT Studio Examples/Customer Dashboard.rptdocument", myRequest, makeAscendingSales, errorCallback);