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

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

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

This gadget lists the unit test suites and test cases that are stored in those RuleSets listed in the array of Application RuleSets for the current application. (See Application form — Completing the General tab.)

For example, if your test cases are stored in Tests:01-01, then that RuleSet must be in the current application's Application RuleSets array to see them in this gadget.

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. GRP-15910

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 gadget. (See Withdrawn rule.)

Use this gadget 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 gadget.

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 gadget.

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.GRP-15897

Use this gadget 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.GRP-15897

Use this gadget 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 gadget.

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 gadget.

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.