Skip to main content

Running Pega scenario test cases and verifying results

Scenario test cases can be run in Dev Studio or in a User portal

Running Pega scenario test cases in a User portal - Normal mode

In a User portal, you can run only one test case at a time. It is not possible to select multiple test cases and run them in a batch.

Pega scenario test cases can be run in a User portal in either Normal mode or Debug mode. In Normal mode, the test case runs from the first step to the final step, regardless of the result of each step. 

There are three steps to run a test case in Normal mode:

  1. Log in to the User portal. 
  2. Open the Scenario tests panel.
  3. Select the test case and then click Run, or open the test case by clicking it and then click Run.
     
    image depicts how the user must select the test case and click the Run button. Alternately, open the test case by clicking on it and clicking the Run button.

Scenario test cases start running when you launch either or both of the corresponding portal and case type. The steps recorded in the test case are run sequentially. 

Each step in the test is indicated with a Green or Red dot indicating a pass or fail. A test case is marked as “Passed” only when all the steps of the test case have passed. Even if a single step of the test case fails, the entire test case is marked “Failed”. 

Once the test case has run and finished, the result is displayed next to the test case. 

By clicking Passed or Failed, you can view the following details of the test case run:  

  • Test case name
  • Portal/case type details
  • Timestamp of the test case run 
  • The user who ran the test case
  • The access group used to run the test case
  • Errors and unexpected results (for failed tests)

The following figure shows an example of a Pega scenario test case results page:

image depicts the failed test results.

Check your knowledge with the following interaction:

Running Pega scenario test cases in a User portal - Debug mode

In Debug mode, the test case run halts at every step that fails and waits for your interaction before it proceeds.

There are three steps to running a test case in Debug mode:

  1. Log in to the User portal. 
  2. Open the Scenario tests pane.
  3. Select the test case and click Debug, or open the test case and then click Debug.
     
    image depicts the debug mode
    Debug mode tests run in a similar way to Normal mode. However, when a step fails, the run halts and waits for your interaction. You must verify the details of the step, modify the details, and then click Resume to continue with the subsequent steps:
     
    Image depicts the Resume option in the debug mode

    This mode is helpful in debugging failed steps and taking corrective actions interactively.

Check your knowledge with the following interaction: 

Running Pega scenario test cases in Dev Studio

In Dev Studio, you can run a single test case or multiple test cases as a batch, on the Scenario testing landing page. 

The process of running Pega scenario test cases, viewing their results, and test case run history is similar to how Pega unit test cases are handled.

For more information, see Performing Pega unit testing: Run Pega unit test cases and view results


This Topic is available in the following Module:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice