Report URLs about asset activities use the assetActivity report path.
| Parameter | Acceptable parameter values | Description |
|---|---|---|
| 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 |
| tid |
|
Limits to a specific activity type. Use only the number, for example tid=462. If not defined, the constant AUDIT_ASSET_ACTIVITIES is used. |
| uid | A user id | Limits to a specific user |
| fromTime | A Long that specifies the number of milliseconds since January 1, 1970, 00:00:00 GMT. A Unix timestamp (the number of seconds since January 1, 1970, 00:00:00 GMT) | Defines a the starting time of a time range. |
| toTime | A Long that specifies the number of milliseconds since January 1, 1970, 00:00:00 GMT. A Unix timestamp (the number of seconds since January 1, 1970, 00:00:00 GMT) | Defines the ending time for a time range |
| 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. |
This URL can be joined with the asset information parameters.
The asset activity report returns the following asset data:
Example 1: Asset-wide download activity - Use the following example URL to help you construct the report URL to retrieve asset activities information. The following example will return the repository-wide download information.
http://example.com:9080/ram.ws/reporting/assetActivity:tid=610
Example 2: Download activity for a single asset - Use the following example URL to help you construct the report URL for the download activity for a single asset:
http://example.com:9080/ram.ws/reporting/assetActivity:guid={EE4545D5–118E-33G4–1D3F-395FDB4EE123},version=1.0,tid=610
You can query for multiple asset activity types by using the notation, tid=(XXX, YYY, ZZZ). For example:
http://example.com:9080/ram.ws/reporting/assetActivity:guid={EE4545D5–118E-33G4–1D3F-395FDB4EE123},version=1.0,tid=(610, 710, 820)