Unit testing a data transform

You can use the Run Rule feature to test a data transform individually before testing it in the context of the application that you are developing. Optionally, you can convert the run into a Pega unit test case.

  1. Open a data transform by clicking Records > Data Model > Data Transform and selecting the data transform that you want to open.
  2. Click Actions > Run.
  3. From the Thread list in the Run context pane, select the thread in which you want to run the rule.
  4. By using the Page list, specify if you want to set up initial values on the clipboard.
    You can choose from:
    Copy existing page
    Copy values from an existing clipboard page in the selected thread to the RunRecordPrimaryPage main test page. You can use the Page to copy list to select the page which values you want to copy.
    Empty test page
    You can select this option if you do not want to prepopulate RunRecordPrimaryPage with values from an existing page.
  5. Select the Apply data transform check box and select a data transform to apply to the values to 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, set up the clipboard to populate the page with initial values. See Setting up your test environment.
  6. In the main test page, enter values for parameters, if any, to pass to the rule.
  7. Click Run.
    Result: A dialog box that displays the results of the rule run appears. You must close the dialog box to continue.
  8. To convert the test to a Pega unittest case to validate data in a continuous delivery environment, do the following tasks:
    1. Click Convert to Test.
      Result: A new tab appears in the main Designer Studio window.
    2. Configure the Pega unittest case.
      For more information, see Configuring Pega unit test cases.
  9. Optional: In the Clipboard tool, examine the pages that are generated by the unit test by clicking Show Clipboard.
    For information, see Clipboard pages created by the Run Rule feature.
  10. Optional: If the rule has errors, click Trace to debug the rule with the Tracer tool.