Defining asset activities report URLs

Create a report URL that outputs asset activity information.

Before you begin

You can only see the asset information for those assets that you have Browse permission for in the repository. To view repository activity, you must be a repository administrator.

About this task

Report URLs about asset activities use the assetActivity report path.

The optional parameters for reports containing asset activity information include:
Table 1. assetActivity: Optional Parameters
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
  • Expiration date - 150
  • State change -220
  • Review instance -240
  • Review - 280
  • Reviewer rating - 310
  • Rating - 350
  • Anonymous rating - 380
  • New topic - 430
  • Update topic - 431
  • Delete topic - 432
  • New post - 460
  • Update post - 461
  • Delete post - 462
  • New forum - 480
  • Update forum - 481
  • Delete forum - 482
  • Search view - 560
  • Download - 610
  • Create subscription - 630
  • Delete subscription - 633
  • Browse artifact - 650
  • Submit - 675
  • Update - 680
  • Delete - 690
  • Publish - 700
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.

Results

The asset activity report returns the following asset data:

Example

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
Note: The above example would only be available for repository administrators

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)

Feedback