Skip to main content


Creating unit test suites with AUT

Suggest edit Updated on August 3, 2020

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.

Did you find this content helpful? YesNo

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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