Close popover

Table of Contents

Creating unit test suites with AUT

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 AUT test suite – Contents form tab.

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.

  • Keystores

    A keystore is a file that contains keys and certificates that you use for encryption, authentication, and serving content over HTTPS. In Pega Platform, you create a keystore data instance that points to a keystore file.

  • AUT test suite – Create or Save as form

    Unit Test Suites – Completing the Create or Save As form

  • Creating a content security policy

    Create a content security rule so that browsers load resources only from authorized web sites.

  • AUT test suite – Contents form

    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.

Suggest Edit

Have a question? Get answers now.

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