Defining artifact usage information report URLs

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

About this task

Report URLs for artifact usage information use the artifactUseActivity report path.

Reports that contain build usage information include the following optional parameters:
Table 1. artifactUseActivity: Optional Parameters
Parameter Acceptable parameter values Description
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 An 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 artifact usage report will return 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
  • Team info
  • Eclipse project
  • Artifact

Example

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

Feedback