Using the stand-alone TestRunner application

To automate the running of a suite of unit tests, use the stand-alone TestRunner application. This command-line application is installed along with Robot Studio, in the Robot Studio installation folder.

Follow these steps to run a test:

Open the command prompt dialog and go to the folder that contains the stand-alone TestRunner application (OpenSpan.ConsoleTestRunner.exe).
Enter the following command:

OpenSpan.consoletestrunner /project="full path and name of deployed package"

Here is an example:

C:\Program Files\Pegasystems\Pega Robot Studio\OpenSpan.ConsoleTestRunner.exe /project="C:\Deployed Design\OSUnitTests.openspan"

The TestRunner application loads the project and runs the test automations. Messages appear to let you know the project is loaded and to show you the status of the test. Here is an example:

Loading Project - C:\Deployed Design\OSUnitTests.openspan

------------------

Running Tests...

Running Test: ChildControls_test...

FAILED

Running Test: CRMMDI_Test...

PASSED

Running Test: NewCall_Test...

PASSED

------------------

When TestRunner finishes running the test automations in the deployment package, a summary of the results appears. The following is an example:

------------------

Tests completed

Tests Passed: 2

Tests Failed: 1

Tests Did Not Finish: 0

Total Tests Run: 3

------------------

Results saved to - C:\Users\OpenSpanUser\My Documents\Pega Robot Studio\TestResults.xml

ConsoleTestRunner done

You can include these command line parameters when running TestRunner.

Parameter	Description
/project=	Enter the name and full path of the project you want to test.
/resultsfile=	Enter the name and full path of the results file you want the TestRunner application to create.
/test= (19.1.85 or later)	Enter the name of the unit test.
/runFirstTest (19.1.85 or later)	Runt the first unit test in the project before running the test that you specified with the /test parameter.
/noresults	Include if you do not want to see results.
/silent	Include if you do not want to see any console messages while the TestRunner application is running.
/pauseBeforeExit	Include if you want the TestRunner application to wait until you press Enter before it finishes processing and closes.
/help (or /?)	Shows you a list of the command line parameters with short descriptions.

Note: You can preface these parameters with either a slash (/) or a dash (-).

Related information

Unit Test Automations

Running Unit Tests from Studio

Using the TestRunner Application