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

Use this gadget to view information about the current application's recorded test cases and saved unit test suites. From this gadget, you can also play back test cases and view test case saved results.

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.

Use this gadget to see the results of all of the unit test suites that you requested to be run during the past five days.

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 the run of a particular unit test suite, click the appropriate line in the report below the chart.

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 during the past week appears along with an indication of how the results compare to the expected results.

To examine the results from a specific test case within the unit test suite, click the appropriate line from the report that appears below the chart.

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.

To schedule a unit test suite:

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:
   • To run immediately, select Run Now and click OK.

     The system runs the unit test suite. When the run is complete, the system displays the Dashboard gadget with the results of the run.

   • To run this unit test suite only once, select One Time. For example, select One Time to try out the unit test suite and verify that the returned results are what you expect to get.
   • To run this unit test suite on a recurring basis, select one of the standard time periods: Daily, Weekly, Monthly, or Yearly.
3. For patterns other than Run Now, specify the starting time:
   • Specify a date and time in the Start field. You can type in a date-time (for example 8/31/2010 09:42 PM) or click the calendar button to open the Calendar window to select the date and time:

     In the Calendar window, select a time and month using the drop-down lists, and then click the numerical day in the calendar grid. (Note: Even if the intended day is already highlighted, you must click the day to save the date-time selection.) When you click the day, the Calendar window closes and the selected date is displayed in the Start field.

   • For the recurrent patterns like Daily, select the appropriate recurrence pattern. For example, if Weekly, select the day of the week.
4. Optional: For patterns other than Run Now, you can 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.
5. Optional: For patterns other than Run Now, you can choose to have the email that is sent on completion of the unit test suite to go to multiple email addresses. Use the Send Completion Email to array to specify the email addresses.
6. 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 an email message with the results.