Skip to content

Launch TestRunner

Launch TestRunner from SoapUI

launch-loadtestrunner

Here we’ve entered some basic values, after pressing the “Launch” button the LoadTest starts from the command line and eventually we get:

launch-loadtestrunner-finished

While running we can see the ongoing output as shown in the dialog above; the loadtestrunner continuously displays its progress (from 0 to 1) and the number of current threads, i.e. a row ending with ”.. progress: 0.72, 6” would mean that the test has come 72% and is currently running with 6 threads.

Just as for the Functional TestCase runner we can scroll up in the log and see the actual command issued at the command-line, making it easy for us to reuse this for automation purposes:

launch-loadtestrunner-command

Launch TestRunner Tabs

Basic

OptionDescriptionComment
TestSuiteSpecifies which TestSuite to runDefault is
TestCaseSpecifies which TestCase to runDefault is
Enable UITurns on access to the UISupport class
TestRunner PathSpecifies location of TestRunner.bat or TestRunner.shEnter manually or use the Browse button
Save ProjectSaves project before running
Add SettingsAdd the global settings to runner
Project PasswordProject password for encrypted projects
user-settings.xml PasswordPassword for settings file
Ignore ErrorsKeep running if errors occur
Save AfterSave the project file after tests have been run
Run in-processUse same process as the GUI

Overrides

overrides.png

OptionDescriptionComment
EnvironmentContext environment to use See Environments
EndpointEndpoint to use for requests
Host:PortAddress and port to receive requests
UsernameUser name for authentication
PasswordPassword for authentication
DomainAuthentication domain to use
WSS Password TypeSpecifies WS-Security password typeChoose Text or Digest

Reports

OptionDescriptionComment
Print ReportCommands the runner to include summary data into the generated reports.
Export JUnit ResultsCommands the runner to create a JUnit-style report.
Export JUnit Results with test propertiesIncludes test case properties into the generated JUnit-style reports.Should be used only if the Export JUnit Results setting is selected.
Export AllIf this check box is clear, the report will contain information only about errors. If the check box is selected, the report will include messages of other types too.
Root FolderThe fully-qualified name of the folder to store the test report files. If the specified folder does not exist, it will be created.
If the specified folder exists, reports’ files in it will be overwritten.
Coverage ReportCommands the runner to generate test coverage reports in HTML format.ReadyAPI License
Open ReportCommands the runner to open the generated reports in your default browser after the test run finishes.ReadyAPI License
Select Report TypeSpecifies the type of the generated report (ReadyAPI feature). You can use the following values:
  • TestCase Report, or
  • JUnit Style HTML, or
  • Data Export

| ReadyAPI License | | Report Format(s) |

Specifies the format of the generated report. Possible values: PDF, XLS, HTML, RTF, CSV, TXT, XML. If you keep this edit box empty, PDF will be used.

Do not specify periods in format names.

To specify multiple formats, separate them with commas, for example: PDF,XML,CSV.

| ReadyAPI License |

TestEngine: An Optimized Test Runner

Execute tests from SoupUI Open Source or SoupUI Pro in parallel to speed up your API Testing.

  • Scale Based on Your Business Needs:

    Dynamically run larger regression tests alongside smaller tests with custom configuration parameters.

  • Job Queuing:

    Execute tests as they arrive, staggering test runs and avoiding bottlenecks at peak times.

  • Supports Multiple Environments:

    Use TestEngine on Docker, VMS, Mac, Windows or Linux.

Learn More About TestEngine

Properties

OptionDescriptionComment
GlobalGlobally defined properties
SystemSystem properties
ProjectProject properties

Custom Arguments

OptionDescriptionComment
Tool ArgsArguments to add to the runnerSee Command Line Arguments