Working with automated unit tests

When your operator ID has the AutomatedTesting privilege through an access role, you can use the Automated Unit Testing landing page to work with recorded test cases and unit test suites, including playing them back, scheduling when to run them, and examining their results.

Viewing, playing back, and rerecording test cases

1. Click the Automated Unit Tests tab.
2. Select Unit Test Cases in the Show field.
   • To play back a test case, click its name in the Name column.
   • To rerecord a test case, right-click the test case name and click Re-record. Note: If the underlying test case rule belongs to a ruleset that uses the check-out feature, you must have the test case rule checked out to you before re-recording the test case.

Opening rules in test cases and unit test suites

1. Click the Automated Unit Tests tab.
2. Right-click a test case or suite and click Open to open its rule.

Withdrawing test cases and unit test suites

1. Click the Automated Unit Tests tab.
2. Right-click a test case or suite and click Withdraw.

Withdrawn test cases and suites are not displayed on the Automated Unit Tests tab.

Unit test suite run results

You can view the results of your recent unit test suite runs in either the Dashboard tab or Reports tab. The Dashboard tab displays the ten most recent runs. The Reports tab displays earlier results and, for a given unit test suite, shows results from the last fifty (50) runs of that unit test suite.

If you ran a unit test against a saved test case for a decision table, decision tree, activity, or Service SOAP rule and selected the All Cases option in the Run Rule form, those results also appear in the Dashboard tab.

For activity test cases, if the activity test case has an approval list, differences are reported only for pages and properties on the list. If the test case has a approval list and the only differences are for pages and properties not on the list, those differences are not reported. If differences are found for items on the approval list, you can remove the item from white list for that test case.

Creating and scheduling unit test suites

To create a unit test suite:

1. Click the Schedule tab.
2. Click Create Suite.
3. In the New Rule form, enter the requested information for creating a unit test suite.

To run a unit test suite or to schedule a run:

1. Click the Schedule tab.
2. Click the Calendar icon in the Schedule column for the unit test suite you want to run.
3. In the Pattern section in the Schedule Unit Test Suite window, specify how to run this unit test suite. When the run is complete, the system displays the results in the Dashboard tab. When you select To run immediately, the system runs the test suite in the foreground; for all other options, the system runs the test in the background.
4. For scheduled runs, you can run specify additional options.
Complete the following actions.

1. Optional: Select to run the unit test suite by using a different operator ID. In the Advanced Settings section, enter the Operator ID in the Override Default and Run Suite As field. The system runs the unit test suite by using the rulesets and access rights associated with that operator. If the operator ID form has multiple access groups, the default access group is used.
2. Optional: Send the completion email to multiple email addresses. Use the Send Completion Email to field to specify the email addresses.

   If you do not want any emails sent, clear the Send Completion Email field.

5. Click OK.

By default, the Pega-AutoTest agents run scheduled unit test suites run every five minutes. When the suite is finished, the agent activity sends an email with the results. By default, this email is sent to the operator who requested the unit test suite run and to any email addresses listed in the Send Completion Email array. If no email addresses appear in that field, no email message is sent.

Related information

Open topic with navigation