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. Typical states include submitted and approved.
uid The identifier for a user in a community This parameter limits output to a specific user. For example: admin. Find the identifier values by observing the URL when administering a community.
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

You can use this query to find the master lifecycle identifiers to use in subsequent queries.

Example 2: Get all community lifecycles for a list of master lifecycles
http://baseUrl/ram.ws/reporting/lifecycle:masterLifecycles=(master1,master2)

You can use this query to find the community lifecycle identifiers to use in subsequent queries. You can also find community lifecycle identifiers by observing the URL when you move your mouse over the name of a lifecycle listed on the Lifecycles page of a community.

Example 3: Get all assets that use a master lifecycle
http://baseUrl/ram.ws/reporting/assetLifecycle:masterLifecycles=(master1,master2)

You can use this query to determine identifiers to use in subsequent queries. For example, for any given asset, the id element is the user identifier. The stateName element is the state identifier.

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