Defining asset lifecycle report URLs

You can create a report URL that provides asset lifecycle information. With this information, you can identify which assets use master or community lifecycles, which assets are in a particular lifecycle state, and which assets are approved for the current state.

Before you begin

You can see the asset information for only those assets that you have Browse permission for in the repository.

About this task

Report URLs for asset lifecycle information use the asset report path.

The following table shows the optional parameters for reports that contain asset lifecycle information:
Table 1. asset: Optional parameters
Parameter Acceptable parameter values Description
master, community The identifier of a master or community lifecycle When a user queries for asset lifecycle information by master or community lifecycle, the user must specify a list of lifecycle identifiers. The identifier for a lifecycle is in the information that is returned by the lifecycle reports.
state The state in a lifecycle This parameter limits output to a specific lifecycle state.
uid The identifier for a user in a community This parameter limits output to a specific user.
fromTime The date is in this format: MM-dd-yyyy. For example: 12-30-1988. This parameter defines the starting time of a time range.
toTime The date is in this format: MM-dd-yyyy. For example: 12-30-1988. This parameter defines the ending time for a time range.
years, months, weeks, days Days are the base unit. These parameters have these units:
  • years = 365 days
  • months = 30 days
  • weeks = 7 days
You can combine the years, months, weeks, and days parameters.

Results

The asset lifecycle information report returns the following data:

  • Assets that use a particular master lifecycle or community lifecycle.
  • Assets that are in a particular state
  • Assets that are approved, rejected, or have not been voted for in the current state
  • Information about assets that have entered their current state

Example

Example 1: Get all master lifecycles
http://baseUrl/ram.ws/reporting/lifecycle
Example 2: Get all community lifecycles for a list of master lifecycles
http://baseUrl/ram.ws/reporting/lifecycle:masterLifecycles=master1-master2
Example 3: Get all assets that use a master lifecycle
http://baseUrl/ram.ws/reporting/assetLifecycle:masterLifecycles=master1-master2
Example 4: Get all assets that use a community lifecycle
http://baseUrl/ram.ws/reporting/assetLifecycle:communityLifecycles=community1-community2
Example 5: Get all assets that are in a particular state
http://baseUrl/ram.ws/reporting/assetLifecycle:currentState=state1-state2
Example 6: Get all assets where an approver has approved the asset in the current state
http://baseUrl/ram.ws/reporting/assetLifecycle:approved=(uid1,uid2)
Example 7: Get all assets where an approver has rejected the asset in the current state
http://baseUrl/ram.ws/reporting/assetLifecycle:rejected=(uid1,uid2)
Example 8: Get all assets where an approver has not submitted a vote for the asset in the current state
http://baseUrl/ram.ws/reporting/assetLifecycle:pending=(uid1,uid2)
Example 9: Get all assets that have entered their current state from a specified time to the current time
http://baseUrl/ram.ws/reporting/assetLifecycle:fromTime=MM-dd-yyyy
Example 10: Get all assets that have entered their current state from a specified time to another specified time
http://baseUrl/ram.ws/reporting/assetLifecycle:fromTime=MM-dd-yyyy,toTime=MM-dd-yyyy
Example 11: Get all assets that have entered their current state for an amount of time before a given date
http://baseUrl/ram.ws/reporting/assetLifecycle:toTime=MM-dd-yyyy,years=NumberOfYears,months=NumberOfMonths,weeks=NumberOfWeeks,days=NumberOfDays
Example 12: Get all assets that have entered their current state for an amount of time after a given date
http://baseUrl/ram.ws/reporting/assetLifecycle:fromTime=MM-dd-yyyy,,years=NumberOfYears,months=NumberOfMonths,weeks=NumberOfWeeks,days=NumberOfDays

Feedback