Retrieving Reports From the ReportCaster Library

This RESTful web service request can be used to retrieve a report for a specific version from the ReportCaster Library.

HTTP Method: POST

REST URL Format:

http://host:port/ibi_apps/rs/ibfs/WFC/Repository/FolderName/ContentName

where:

host

Is the name of the system where WebFOCUS is installed.

port

Is the port number used by WebFOCUS.

FolderName

Is the name of the folder used for the stored WebFOCUS report. If the folder used for the stored WebFOCUS report exists as a subfolder, then the path to the subfolder name must be included in the REST URL. For example, TopFolderName/SubFolderName.

ContentName

Is the name of the stored WebFOCUS report as defined in the name attribute when listing the content of a folder. For more information, see Listing Reports, Schedules, and Library Content Within WebFOCUS Managed Reporting.

Body Format:

IBIRS_action=run&IBIRS_args=Object

where:

Object

Is the XML object that defines the version of the report that is to be retrieved.

   <object _jt="HashMap">
<entry>
   <key _jt="string" value="IBFS_content_revision"/>
   <value _jt="intval" value="versionNumber"/>
</entry>
</object>

where:

versionNumber

Is the version of the report that is to be retrieved.

Note: The IBIRS_args parameter is optional. If it is left out, then the last version of the report will be retrieved.

Example:

In the following example, the 12th version of a stored library report identified by L1748ltvgq02.lib within the Car_Reports folder is retrieved. The Car_Reports folder is a subfolder of the RESTful_Web_Services folder. L1748ltvgq02.lib is defined in the name attribute when listing the content of a folder. For more information, see Listing Reports, Schedules, and Library Content Within WebFOCUS Managed Reporting.

POST Request URL:

http://localhost:8080/ibi_apps/rs/ibfs/WFC/Repository/RESTful_Web_Services/
Car_Reports/L1748ltvgq02.lib

Body:

IBIRS_action=run&IBIRS_args=<object _jt="HashMap"><entry><key _jt="string" value="IBFS_content_revision"/><value _jt="intval" value="12"/></entry></object>

Response:

The response is a report in either HTML, Excel, PDF, active report, or a Graph.


WebFOCUS