This topic explains how to migrate your existing SOAtest or WebKing automated nightly process from the legacy command line interface (cli) to SOAtest 9.x’s soatestcli. Sections include:

Command Line Invocations

The following table shows the differences in command line invocation between previous versions of SOAtest or WebKing and the current version of SOAtest.


OSPrevious WebKing optionPrevious SOAtest optionSOAtest 9.x option
Windowswk.exe -cmd [options]st.exe -cmd [options]soatestcli.exe [options]
Linuxwebking -cmd [options]soatest -cmd [options]soatestcli [options]

Examples

Running a Single Test Suite

SOAtest 5.5 and earlier: If your SOAtest command line invocation to run a single test suite and write a report in HTML format to a file was

st.exe -cmd -runtest <test suite name.tst> -reportHTML -detailed <report file name>

your SOAtest command line invocation might be

soatestcli.exe -config <configuration name> -resource <path to test suite name.tst relative to the workspace> -report <report file> 

WebKing: If your WebKing command line invocation to run a single test suite and write a report in HTML format to a file was 

wk.exe -cmd -runtest <test suite name.tst> -reportHTML -detailed <report file name>

your SOAtest command line invocation might be

soatestcli.exe -config <configuration name> -resource <path to test suite name.tst relative to the workspace> -report <report file> 

Running all Test Suites

SOAtest 5.5 and earlier: If your SOAtest command line invocation to run all test suites within a directory was

st.exe -cmd -runtest -all <directory path>

your SOAtest command line invocation might be

soatestcli.exe -config <configuration name> -resource <directory path relative to the workspace>  -report <report file>

WebKing: If your WebKing command line invocation to run all test suites within a directory was 

wk.exe -cmd -runtest -all <directory path>

your SOAtest command line invocation might be

soatestcli.exe -config <configuration name> -resource <directory path relative to the workspace> -report <report file>

Command Line Options

The following tables show the differences in command line options between previous versions of SOAtest or WebKing and SOAtest 9.x.

Top Level Options

Note that the following options cannot be used together.


ActionPrevious SOAtest/WebKing optionSOAtest 9.x option
Run tests-runTestno flag is needed
Run static analysis on wsdl-runwsdltestDeprecated - but replaced with equivalent WSDL static analysis options. See the note below for details.
Execute script-runDeprecated - please contact Technical Support for assistance migrating scripts to 9.x.

WSDL Static Analysis

There are three ways to statically analyze WSDLs in SOAtest 9.x:

  • Apply a policy file when first generating tests (such as the sample policy in the examples directory). This generates a "WSDL Handler" tool that decomposes a WSDL to its imported WSDL and schema parts. Then, WSDL parts are chained to WSDL validation rules and the schemas are chained to schema validation rules.
  • Manually create a Coding Standards tool that takes a WSDL or schema file as an input, then have the desired schema rules enabled in it.
  • Have the schema file within your workspace project, then right-click its Navigator view, node and run a Test Configuration that has static analysis enabled. SOAtest’s built-in Test Configurations include  a few sample static analysis configurations—including ones for WSDLs and schemas.

Run Test Options

ActionPrevious SOAtest/WebKing optionSOAtest 9.x option
Run all tests recursively starting at the specified directory.-all <directory>

To run all tests in the workspace: no flag is needed

To run all tests in a particular project: -resource <directory path relative to the workspace>

Ignore a test-ignore <file name>

To ignore/include all tests in a sub-folder: -exclude <sub-folder> / -include <sub-folder>. The -include flag allows to specify a subset of the resources indicated by the -resource flag. (DO NOT start the resources after the -include/-exclude flags with a '/ '.)

To ignore/include a test from the resources specified in the -resource flag : -exclude <file name> / -include <file name> (DO NOT start the resources after the -include/-exclude flags with a '/'.)

Run a specific test file<file name>-resource <path to test suite name.tst relative to the workspace>
Search and replace router

-router [matchWhole]
<searchURI> <replaceURI>

-router matchWhole <searchURI:URI> <replaceURI:URI>

This feature is now deprecated. Please use Environments instead.

Specify test name patterns-testName [-match] <pattern> [-dataSourceRow <row>] [-dataSourceName <name>]-testName [match:] <test name> -dataSourceRow <row> -dataSourceName <name>
Specify environment options

-environment <environment_name>

-environment <environment_name>

Run tests with a single data source row[-dataSourceRow <row>] [-dataSourceName <name>]-dataSourceRow <row> -dataSourceName <name>
Report test results to HP (Mercury) TestDirector-testDirector <test file> <report file>-testDirector <testFile:file> <reportFile:file>
Report test results to Rational TestManager-testManager [-v]

-testManagerVerbose

Integration with Rational TestManager is deprecated.

Specify browser used for web scenario playback.-browserTypeSee Configuring Browser Playback Options.

Tool Execution Options

ActionPrevious SOAtest/WebKing optionSOAtest 9.x option
Execute the specified tool<toolname>

Run a Test Configuration that executes a .tst file that includes the specified tool. Or, run a Test Configuration that applies the specified type of tool
(check links, check spelling, etc.) during static analysis.

Reporting Options

ActionPrevious SOAtest/WebKing optionSOAtest 9.x option
Generate reports-genreport or <report format flag> <report file> (see "Report formats")-report <report file>
Show traffic for successful tests-reportAllTrafficDeprecated
Report formats-reportHTML, -reportXML, and -reportPDFSpecified in the local properties file using the following option:
report.format=html|pdf|custom
Detailed versus summary reports-detailed and -summarySpecified in the local properties file using the following option:
report.developer_errors=true|false 
Mailing reports

-mail -attach to:[email protected]

Specified in the local properties file using the following options:

report.mail.enabled=true|false: 
report.mail.attachments=true|false
report.mail.cc=[email_addresses]
report.mail.include=[email_addresses]

See Testing from the Command Line Interface - soatestcli for details

Publish reports to DTPN/A

-publish

Prior to SOAtest 9.10.2, this option published reports to Team Server (see Team Server Options). This feature also requires DTP 5.3.x or later.

Specify configuration to be used for report generation-config:<configuration name>Specified in the local properties file using the available reporting options.

Project Center Options

ActionPrevious SOAtest/WebKing optionSOAtest 9.x option
Enable communication with Project Center-loggerSpecified in the local properties file using the following option:
concerto.reporting=true|false
Specify the name of the machine that is running Project Center-J-Dlogger.host=<host>. Specified in the local properties file using the following option:
concerto.server=[server]
Specify the port to communicate with Project Center-J-Dlogger.port=<port>. Specified in the local properties file using the following option:
grs.port=[port]
Enable communication and send all traffic to Project Center-trafficDeprecated
Specify custom Report attributes-grs <attribute name>=<attribute value>Specified in the local properties file using the following option:

concerto.user_defined_attributes=[ attributes];

Use the format key1:value1; key2:value2 

Team Server Options

ActionPrevious SOAtest/WebKing optionSOAtest 9.x option
Send reports to Team ServerN/A

-publishteamserver

Note that -publishteamserver uses the Team Server configuration in the GUI by default. Alternatively, you can specify these settings in the local properties file. See Project Center Options for information on publishing reports to Team Server.

Licensing Options

ActionPrevious SOAtest/WebKing optionSOAtest 9.x option
Specify local license-password [expiration date] [password]

Specified in the local properties file using the following options:

<tool name>.license.local.expiration=[expiration] and <tool name>.license.local.password=[password]

Specify license server:-licenseserver [host]:[port]

Specified in the local properties file using the following options:

<tool name>.license.network.host and <tool name>.license.network.port

Other Options

ActionPrevious SOAtest/WebKing optionSOAtest 9.x option
Show help-dump-help
Show versionN/A-version 
Installer options-initjython, -installcertificate, -uninstallcertificate-initjython, -installcertificate, -uninstallcertificate
Specify classpath entries-extraClasspathSpecified in the local properties file using the following option:
system.properties.classpath


For more details on SOAtest 9.x’s command line interface, see Testing from the Command Line Interface - soatestcli.

  • No labels