Actuate BIRT Viewer Reference : Actuate BIRT Viewer URIs : execute report page
 
execute report page
Submits a run report job request.
When executing a report job, a cancel button appears after a specified wait time passes. You can change the time by setting the EXECUTE_REPORT_WAIT_TIME configuration parameter in the appropriate Actuate Information Console configuration file.
For reports that accept run‑time parameters, you can set the parameter in the URL by adding an ampersand (&), the parameter name, and an equal (=) sign, followed by the parameter value in quotes.
Name
<context root>\executereport.do
Parameters
Table 14‑7 describes the parameters for the execute report page. The execute report page also uses the common URI parameters.
Table 14‑7 Execute report URI parameters 
URI parameter
Description
_ _ageDays
Use with _ _ageHours to determine how long output objects exist before they are automatically deleted. Use only if _ _archivePolicy is set to Age. _ _ageDays can be any positive number.
_ _ageHours
Use with _ _ageDays to determine how long output objects exist before they are automatically deleted. Use only if _ _archivePolicy is set to Age. _ _ageHours can be any positive number.
_ _executableName
The name of the executable file for this request.
invokeSubmitEXECUTE_REPORT_WAIT_TIME
Controls whether the browser is redirected to the parameter screen or whether the report job is run immediately. If true, the report job is executed without displaying the parameters. If false, the parameters are displayed. False is the default.
_ _outputDocName
The name and path of the resulting BIRT document. This parameter is only usable for BIRT reports when the BIRT_SAVE_REPORT_DOCUMENT_ENABLED parameter is set to TRUE in web.xml.
If the given path is absolute, then executereport saves the report to that path. If the given path is relative, then executereport saves the report to the path set in the BIRT_SAVE_REPORT_DOCUMENT_PATH web.xml parameter.
_ _priority
Specifies the job submission priority. Values are High, Medium, and Low.
_ _priorityValue
Specifies a number ranging from 1 to 1000 and corresponding to the job submission priority. You can only specify values allowed by your functionality level.
_ _progressive
Indicates whether to display the report document after it generates. If false, the report document displays after it generates. If true, the report document displays progressively, as it generates.
_ _serverURL
Contains the URI that accesses the JSP engine, such as http://Services:8900.
_ _wait
If "wait", Information Console waits for the report generation to be completed before displaying it. If "nowait", Information Console displays the first page right away even if the report job is not completed.
For example, the following URL executes the Sales By Territory.rptdesign report immediately with the Territory run-time parameter set to EMEA:
http://localhost:8080/ActuateJavaComponent/executereport.do?
__requesttype=immediate&__executableName=/Public
/BIRT%20and%20BIRT%20Report%20Studio%20Examples
/Sales%20by%20Territory.rptdesign&userid=anonymous&
__saveOutput=false&Territory=%22EMEA%22&invokeSubmit=True
The following parameter names are reserved for internal use only by the execute report page:
*doframe
*inputfile
*jobType
*name
*selectTab
Used by
Not applicable.