Unit testing an activity

You can use the Run Rule feature to test an activity individually before testing it in the context of the application that you are developing. Optionally, you can convert the run to a PegaUnit test case.

You can use the Run Rule feature if one of the following criteria is met:

• The Require Authentication to run check box is selected on the Security tab of the Activity form.

• Your access role allows you to update rules that have the Applies To class of this activity.

To unit test an activity, complete the following steps:

1. Open an activity by clicking Records > Technical > Activity and selecting the activity that you want to open.

2. Select Actions > Run.

3. Select the thread in which you want to run the rule from the Thread list in the Run context pane.

4. Specify if you want to set up initial values on the clipboard.

   Complete the following tasks:

   1. From the Page list, select one of the following options:

      • Copy existing page – Select to copy values on an existing clipboard page in the selected thread to RunRecordPrimaryPage, which is the main test page. Then, in the Page to copy list, select the page whose values you want to copy.

      • Empty test page – Select if you do not want to pre-populate RunRecordPrimaryPage with values from an existing page.

   2. Optional: Select the Apply data transform check box and then select a data transform to apply to the values on the specified page.

   Note: The system always runs the rule instance on the RunRecordPrimaryPage, regardless of the page that you select from this list. If you convert this rule run to a test case, and the RunRecordPrimaryPage requires initial values, you should set the clipboard up to populate the page with initial values. See Setting up your test environment.

5. Optional: In the main test page, enter values for parameters, if any, to pass to the rule.

6. Click Run.

A dialog box appears that displays the results of the rule run. Close the dialog box to continue.

7. Optional: To convert the test to a test case, click Convert to Test. A new Create Test Case tab is displayed in the main Designer Studio window.

   See one of the following topics:

   • See Configuring PegaUnit test cases in the Create Test Case rule form if you are configuring the test case in the Create Test Case rule form. This rule form appears immediately after you create the test case but before you click Create and open or Create and close.
   • See Modifying PegaUnit test cases in the Edit Test Case rule form if you are configuring the test case in the Edit Test Case rule form. This rule form appears after you click click Create and open or Create and close or save the rule form.

8. Optional: Click Show Clipboard to open the Clipboard and examine the pages that are generated by the unit test For information, see Clipboard pages created by the Run Rule feature.

9. Optional:Click Trace to debug the rule with the Tracer tool.

Open topic with navigation