Invoke soapUI TestRunner from Command Prompt

Let us see how to execute soapUI test cases using command prompt.

In this soapUI Tutorial, we will see how can we invoke and execute soapUI test cases from command prompt. If you are familiar with soapUI application, you might have used/ noticed an option named "Launch Testrunner". We are calling this feature from a command prompt window to execute our project/ test suite or test cases. Let us peform the below steps to achieve this.

1. Open a command prompt

2. Navigate to soapUI bin folder. For example "C:\Program Files\SmartBear\soapUI-Pro-4.5.0\bin".

3. Now type the step testrunner.bat "C:\Project-Path\project-file.xml"

4. Hit enter

This will invoke and execute soapUI project in the specified project file. The above mentione is the simple way of executing a soapUI project using command prompt. But there are different options which we can provide to the soapUI testrunner.bat to configure the test execution. Here are the parameters which can be used to invoke soapUI testrunner in command prompt.
e : The endpoint to use when invoking test-requests, overrides the endpoint set in the project file

h : The host:port to use when invoking test-requests, overrides only the host part of the endpoint set in the project file

s : The TestSuite to run, used to narrow down the tests to run

c : The TestCase to run, used to narrow down the tests to run

u : The username to use in any authentications, overrides any username set for any TestRequests

p : The password to use in any authentications, overrides any password set for any TestRequests

w : Sets the WSS password type, either 'Text' or 'Digest'

d : The domain to use in any authentications, overrides any domain set for any TestRequests

r : Turns on printing of a small summary report (see below)

f : Specifies the root folder to which test results should be exported (see below)

j : Turns on exporting of JUnit-compatible reports, see below

a : Turns on exporting of all test results, not only errors

o : Opens the generated report in a browser (soapUI Pro only)

i : Enables soapUI UI-related components, required if you use the UISupport class for prompting or displaying information

t : Sets the soapui-settings.xml file to use, required if you have custom proxy, ssl, http, etc setting

x : Sets project password for decryption if project is encrypted

v : Sets password for soapui-settings.xml file

D : Sets system property with name=value

G : Sets global property with name=value

P : Sets project property with name=value, e.g. -Pendpoint=Value1 -PsomeOtherProperty=value2

S : Sets to save the project file after tests have been run

I : Do not stop if error occurs, ignore them

R : Selects which report to generate for the test objects executed, for example if running the entire project, this could specify the name of a test-suite-level report that would be generated for each TestSuite. The report is saved as specified with the -F option to the folder specified with the -f option. (soapUI Pro only)

F : Sets the format of the report specified with the -R option, for Printable reports this is one of PDF, XLS, HTML, RTF, CSV, TXT, and XML. For Data Export this is either XML or CSV (soapUI Pro only)

g : Sets the output to include Coverage HTML reports ( soapUI Pro only )

E : Sets which environment to use (soapUI Pro only)

soapUI Test Runner from Command Prompt Example

testrunner.bat -rjf "Results" "C:\Project-Path\project-file.xml"