Report URLs for build usage information use the buildUseActivity report path.
| 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.
The build usage report returns the following asset data:
http://example.com:9080/ram.ws/reporting/buildUseActivity:guid={EE4545D5–118E-33G4–1D3F-395FDB4EE123},version=1.0