Accessing parameter values from the viewer

The actuate.Viewer.setParameterValues( ) function adds the parameters set by the user to the viewer component. The setParameterValues( ) function takes as an input parameter an object composed of variables whose names correspond to parameter names. The downloadParameterValues( ) function returns a properly formatted object for use with actuate.Viewer.setParameterValues( ). The following code example shows how to call downloadParameterValues( ) and move the parameter name and value array into the viewer with actuate.Viewer.setParameterValues( ):

function runReport(ParameterValues){

var viewer = new actuate.Viewer("viewerpane");

viewer.setReportName("/Customer Order History.rptdesign");

viewer.setParameterValues(ParameterValues);

viewer.submit( );

}

When the viewer calls submit( ), the client transfers the parameters to the server with the other asynchronous operations for the viewer.

The following code example shows a custom web page that displays parameters and then shows the report in a viewer using those parameters:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"

"http://www.w3.org/TR/html4/strict.dtd">

<html>

<head>

html;charset=utf-8" />

<title>Viewer With Parameters Page</title>

</head>

src="http://localhost:8080/webapp/jsapi"></script>

function init( ) {

actuate.load("viewer");

actuate.load("parameter");

actuate.initialize( "http://localhost:8080/webapp", null,null, null, displayParams);

}

function displayParams( ) {

param = new actuate.Parameter("parampane");

param.setReportName("/Customer Order History.rptdesign");

param.submit(

function ( ) {this.run.style.visibility = 'visible';});

}

function processParameters( ) {

param.downloadParameterValues(runReport);

}

</script>

</div>

<input type="button" class="btn" name="run"

value="Run Report" onclick="processParameters( )"

style="visibility: hidden">

function runReport(paramvalues) {

var viewer = new actuate.Viewer("viewerpane");

viewer.setReportName("/Customer Order History.rptdesign");

viewer.setParameterValues(paramvalues);

viewer.submit( );

}

</script>

</div>

</body>

</html>

The code in the example access a report and its parameters at the following path:

/Customer Order History.rptdesign