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:
| 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