Defining asset information report URLs

Create a report URL that outputs asset information such as the user name of the user that submitted the asset, the user names of the asset owners, or information about any of the related assets.

Before you begin

You can only see the asset information for those assets that you have Browse permission for in the repository.

About this task

Report URLs for asset information use the asset report path.

The optional parameters for reports containing asset information include:
Table 1. asset: Optional Parameters
Parameter Acceptable parameter values Description
shortcut A Rational Asset Manager search shortcut, for example ramSearch:(1txt%2Ckeyword) Limits output to results for an asset search. To create a search shortcut:
  1. Open the Assets page.
  2. Type a search string or query using any combination of filters and keywords.
  3. Click the View search shortcut icon view search shortcut icon. The search shortcut appears.
  4. Copy the search shortcut for use in the reporting URL
guid the Unique ID for an asset, for example {EE4545D5–118E-33G4–1D3F-395FDB4EE123} Limits output to a specific asset. Requires the version parameter
version the version number of an asset, for example 1.0 Limits output to a specific version of an asset. Requires the guid parameter

Results

The asset information report returns the following data:

  • Asset attributes;
  • User name and information of the submitter;
  • User name and information of the owners;
  • Information about the related assets: the asset name, asset ID, version, relationship type, and the name that is displayed for the relationship type.

Example

Example 1: Information about a specific asset

Use the following example URL to help you construct the report URL to retrieve asset information for a specific asset (with guid and version.

http://example.com:9080/ram.ws/reporting/asset:guid={EE4545D5–118E-33G4–1D3F-395FDB4EE123},version=1.0
Example 2: Information about search results

Use the following example URL to help you construct the reporting URL that retrieves asset information by using a search shortcut. In this case, the search shortcut is for assets with the tag policy:

http://example.com:9080/ram.ws/reporting/asset:shortcut=ramSearch:(1fTag,policy)

Feedback