Application category — Automated Unit Testing page
Automated Unit Tests, Dashboard, Reports, and Schedule tabs

Use this tab to work with and view information about the current application's recorded test cases and saved unit test suites. From this tab, you can:

• Play back test cases
• Re-record test cases
• View test case saved results
• Open the underlying rules for the test cases and unit test suites
• Withdraw test cases or suites

This tab lists the unit test suites and test cases that are stored in:

• The RuleSets listed in the array of Application RuleSets for the current application.
• The RuleSets from the current application's parent application, if the Include Parent checkbox is selected in the current application's Application rule.

See Application form — Completing the General tab.

For example, if your test cases are stored in Tests:01-01 and that RuleSet is in the current application's Application RuleSets array, those test cases are listed on this tab.

If you choose Unit Test Cases in the Show field, a list of saved test cases appears. To see any resume test cases associated with a flow test case, drill down through the folder structure of the parent flow test case. In the list, you can examine information about the test case, such as when it was created and the status of its last run. If results are saved for a test case, you can click its link in the Saved Results column to view them.

To play back a test case, click its name in the Name column. The Run Rule (for non-flow test cases) or Testing Flow (for flow test cases) window opens and you can play back that test case.

To re-record a test case, right-click the test case name and select Re-record from the context menu. The Run Rule (for non-flow test cases) or the flow window opens for the rule associated with that test case. Proceed with running the rule and then click the Save Test Case button to replace the previous recording with the new one. 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.

To open the rule for either a test case or suite, right-click its name and select Open from the context menu.

To withdraw a test case or suite, right-click its name and select Withdraw from the context menu. Withdrawn test cases and suites are not displayed on the Automated Unit Tests tab. (See Withdrawn rule.)

Use this tab to see the results of your recent unit test suite runs.

The ten most recent runs are displayed. For results from earlier runs, use the Reports tab.

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

To examine the results from a run of a particular unit test suite:

Click the corresponding item in either the graph or in the report below the chart. The list of test cases in that unit test suite run is displayed with details about their individual runs.

To examine the results from a specific test case run, click that test case in the list.

From the differences found display, you can select to have differences ignored in future runs of the test case:

1. Select specific differences to have the system ignore them either for that individual test case, or for all test cases in the application.
2. Click Save Ignores to save your choices.

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

Use this tab to see the test results from executing specific unit test suites. When you select a particular unit test suite from the drop-down list, a chart of the results from each time it ran appears along with an indication of how the results compare to the expected results. For a given unit test suite, the display shows results from the last fifty (50) runs of that unit test suite.

To examine the results from a specific run:

Click the appropriate line from the report that appears below the chart, or click the entry within the chart itself. The list of test cases in that unit test suite run is displayed with details about their individual runs.

To examine the results from a specific test case run, click that test case in the list.

From the differences found display, you can select to have differences ignored in future runs of the test case:

1. Select specific differences to have the system ignore them either for that individual test case, or for all test cases in the application.
2. Click Save Ignores to save your choices.

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

Use this tab to:

• Create unit test suites
• Run an individual unit test suite once
• Schedule recurring unit test suite runs for standard time intervals (for example, weekly)
• See a list of the unit test suites in the system that are currently scheduled to run

To create a unit test suite:

1. Click Create Suite. The New Rule window opens.
2. Enter the requested information for creating a new unit test suite. (See also Unit Test Suite form — Completing the Contents tab.)

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

1. Locate the suite you want to run in the list and then click the calendar button () in its Schedule column. The Schedule Unit Test Suite window opens.
2. In the Pattern section, specify how to run this unit test suite. When the run is complete, the system displays the results in the Dashboard tab.

For scheduled runs (runs other than the Run Now choice):

1. Optional: Select to run the unit test suite 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 using the RuleSets and access rights associated with that operator. If the operator ID form has multiple access groups, their default one is used.
2. Optional: Send the completion email to multiple email addresses. Use the Send Completion Email to array to specify the email addresses.

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

3. Click OK to save the schedule. The Schedule Unit Test Suite window closes. The unit test suite run is added to the list of currently scheduled unit test suites on the Schedule tab.

By default, the Pega-AutoTest agents which run scheduled unit test suites run every five minutes. (Scheduled unit test suites are those where Run Now is not selected.) When a scheduled unit test suite is due to run, the agent activity runs that unit test suite. When the suite is finished, the agent activity sends the completion email message 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 array, no email message is sent.