Skip to main content

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

More about List rules

Updated on August 16, 2022

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.

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