Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

How to configure an activity to run a list view report using parameters as selection criteria

Updated on September 20, 2019


You can configure an activity to run a list view report where the selection criteria (defined on the Content tab) depend on the value of parameters defined in the Parameters tab.

For example, your activity can accept a positive integer representing a number of days as its input parameter. The activity can compute two list view parameters, StartDate and EndDate, where StartDate is today and EndDate is today minus the number of days parameter value.

The report can select and display those work objects in the current application that were created between the computed start date and end date parameter values.

This article describes how to configure the activity and send parameters to the list view rule.


Suggested Approach

  1. Create a new activity.
  2. Enter a name for the activity.
  3. Click Create.
  4. On the Steps tab in the first step, enter a description and, in the Method field, Property-Set. Then identify parameters using the notation Param.paramname. In the example, a range of dates is specified, along with the key parts of the list view rule. The final parameter is set to refresh or display the output.


  1. In the second step, enter a description and, in the Method field, Call Rule-Obj-ListView.ShowView. (If you only want to retrieve and sort the data, leaving it on the clipboard but not displaying it in a web page, you can use the Obj-List-View method rather than call the ShowView activity.)


  1. Enable the Pass current parameter page option. This will pass the parameters that you specified in Step 1 to the list view.
  2. In the example, the user is prompted to enter the number of days to search for work objects. Typically, this value is passed to the activity as a parameter. For purposes of this example, the default value has been set to 30  to demonstrate the feature.


  1. Save the activity rule.
  2. Create a list view rule. Set with the Applies To key part, Purpose key part, and Owner key part you selected as the ViewClass, ViewPurpose and ViewOwner parameter values. Specify the content and display fields as desired..
  3. On the Content tab, enter an identifier for the row in the Label field.
  4. In the Field field, select a property that you want to compare against from the SmartPrompt list.
  5. Choose a condition from the drop-down list.
  6. In the Value field, enter the text "param.", then choose a parameter to use as the selection criteria from the SmartPrompt list. In the example, the parameters are StartDate and EndDate, specified in the activity you just created.


  1. Open the Parameters tab.
  2. In the Name fields, enter StartDate and EndDate.
  3. In the Data Type field for each parameter, select String from the drop down list.


  1. Save the List View form.
  2. Open the activity.
  3. Click the Run toolbar button RUN. The report displays according to the criteria you specified. In the example, the report shows objects created in the last 30 days.


Related Topics

Comparing the Obj-List-View, Obj-Browse and Obj-List methods


Pega Platform 7.1.1 - 7.4 Reporting Financial Services Healthcare and Life Sciences Insurance Communications and Media Government Healthcare and Life Sciences Consumer Services Consumer Services Manufacturing Consumer Services

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us