Skip to main content

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

Creating unit test suites with AUT

Updated on April 8, 2022

Unit Test Suites identify a collection of Test Cases and their rulesets, and a user (Operator ID) whose credentials are used to run the Unit Test Suite. Unit Test Suites are used to automatically run groups of test cases together and make unit testing more efficient.

The Unit Test Suite rule form consists of the Contents tab.

Note: AUT is deprecated. Use PegaUnit testing instead to create automated test rules.

Automated unit testing information is available on the Testing Applications landing page on Pega Community and in the automated unit testing topics in the help.

You must have the AutomatedTesting privilege to work with unit test suite rules.

You can create a unit test suite that includes all the test cases for a specific rule type, or you can select individual rules and specify the sequence in which to run them.

To run a unit test suite, use the Schedule gadget on the Automated Unit Testing landing page. For more information, see Working with the deprecated AUT tool. From that gadget, you can choose to run the unit test suite immediately or schedule the run for a future time.

For unit test suites that are scheduled to run at future times, an agent activity in the Pega-AutoTest agents rule checks for unit test suite requests every five minutes and runs those that are due. When the agent activity finishes running a unit test suite, it sends an email message with the results. By default, this completion email message is sent to the person who scheduled the unit test suite run, and to any additional email addresses specified at the time the run is scheduled. If no email addresses are specified at the time the run was scheduled, no email message is sent.


For more information, see Working with the deprecated AUT tool to work with the Unit Test Suites that are available to you. You can:

  • Use the Automated Unit Tests gadget to see the Unit Test Suites and the test cases in each.
  • Use the Create Suite button on the Schedule gadget to create unit test suites.
  • Use the calendar button on the Schedule gadget to run unit test suites immediately and to schedule unit test suite runs.


Unit Test Suites are instances of the Rule-AutoTest-Suite class. They belong to the SysAdmin category.

  • Creating test cases with AUT

    You can automate testing of rules by creating test cases for automated unit testing. Automated unit testing validates application data by comparing expected output to the actual output that is returned by running rules.

  • Contents form in AUT test suite

    Use the Contents tab to define the unit test suite. Specify a user (Operator ID) that the Pega-AutoTest agents are to use by default when running the suite, and select the test cases to include.

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