More about List rules

Use list rules and the Obj-List method for simple selection, search, and reporting needs in your application.

Unit testing

After you save the List form, click Actions > Run to cause the system to create a top level user page named pyQueryResultPage of the Code-Pega-List class and to display the list as a report in a new browser window. You can export this display to Microsoft Excel.

The pxResults pages within the pyQueryResultPage contains an embedded page for each list entry.

Standard activity

Use the standard activity Rule-Obj-List.ShowReport to execute a list rule and display the results in a new window.


To evaluate a list rule, execute the Obj-List method in an activity. The Obj-List method sends results of its search to the clipboard, and you can then use HTML to display these results.

For a class that contains many instances, each of which contains many properties, the Obj-List method can return only a filtered selection of instances, and only selected properties for each selected instance. This improves performance and reduces the clipboard size (and memory demand) compared with retrieving all properties. Pages containing only a portion of the properties of an instance are known as shortcut pages.