Defining build usage information report URLs

Create a report URL that outputs information about the usage of assets in build processes.

About this task

Report URLs for build usage information use the buildUseActivity report path.

Reports that contain build usage information include the following optional parameters:
Table 1. buildUseActivity: Optional Parameters
Parameter Acceptable parameter values Description
buildID Identifier for the build. A unique identifier for your build.
fromTime A Unix timestamp (the number of seconds since January 1, 1970, 00:00:00 GMT) Defines a the starting time of a time range.
guid the Unique ID for an asset, for example {EE4545D5–118E-33G4–1D3F-395FDB4EE123} Limits output to a specific asset. Requires the version parameter
modifiedSince You must use the format: yyyy-MM-dd'T'HH:mm:ss.SSSZ to specify the date since modifications have been made (year-month-dayThour:minutes:seconds.SimpleDateFormat where SimpleDateFormat is milliseconds (S) and timezone (Z)). For example: 2010-06-07T00:00:00.000-0500 Defines the starting time since modifications have been made. Use the modifiedSince parameter when creating report URLs for Rational Insight data warehousing, where you have to return changes that have happened since the last time information was added to the data warehouse.
teamArea Identifier for the team area. An arbitrary string that defines the team area.
toTime A Unix timestamp (the number of seconds since January 1, 1970, 00:00:00 GMT) Defines the ending time for a time range
uid Identifer for a user Limits output to the user that performed the activity
version the version number of an asset, for example 1.0 Limits output to a specific version of an asset. Requires the guid parameter

This report can be joined with the Asset Information reporting URL syntax. You can use either the GUID and version parameter or join this URL with the parameter in the asset information URL.

Results

The build usage report returns the following asset data:

  • User information
  • Activity type ID
  • Timestamp
  • Description
  • Title of the activity
  • A link to the object that the activity was against (for example, asset or rating)
  • Team server
  • Team area
  • Team type
  • Build ID
  • Artifact

Example

Build usage information - Use the following example URL to help you construct the report URL to output build usage information for the assets with the specific GUID and version:
http://example.com:9080/ram.ws/reporting/buildUseActivity:guid={EE4545D5–118E-33G4–1D3F-395FDB4EE123},version=1.0

Feedback