Retrieving reporting information

Create a custom report by creating a report Web address that gathers data about assets, users, and the repository. You can produce data in XML and JSON formats. To display report information, use an external product such as Business Intelligence and Reporting Tools (BIRT).

About this task

Report URLs use the Rational Asset Manager Web services URL, /reporting/, and then one or more report types and parameters (ReportType1:Parameter=ParameterValue) that determine the data. The following example shows the basic syntax:

http://<Host Name>:<Port>/ram.ws/reporting/Report:Parameter=ParameterValue

If the report takes multiple parameters, separate multiple parameters by using commas:

http://.../reporting/Report:Parameter1=Parameter1Value,Parameter2=Parameter2Value

If you are requesting more than one type of reports, separate report types with a pipe (|).

Report data is produced as serialized objects. By default, report URLs output data in XML. You can output data in JSON format by adding settings:format=json| before other report paths. For example,
http://<Host Name>:<Port>/ram.ws/reporting/settings:format=json|Report:Parameter:ParameterValue

From the IBM® Rational® Asset Manager client API, report data is produced as serialized objects.

To learn about the report paths that you can use to create URLs, view sample reports, and combine data URLs so that the result of one URL can become the parameter for another URL, see the links at the end of this topic.

Report URLs use the Web services URL (not the application URL) as the base.

Procedure

To retrieve the Web services URL:

  1. Log in to the Rational Asset Manager Web client.
  2. Click Help.
  3. In the Help drop-down list, click Extensions.
  4. On the Extensions page, in the Web Services section, highlight and copy the URL for the Repository location, which is the Web Services URL. This is the base for your report URLs.

Feedback