本主题解释如何将现有的 SOAtest 或 WebKing 自动化夜间处理从传统命令行接口（传统）迁移到 SOAtest 9.x 的 soatestcli。本章包含：
命令行调用
下表显示了原来版本的 SOAtest 或 WebKing 与当前版本的 SOAtest 在命令行调用方面的差异。
| OS | 以前的 WebKing 选项 | 以前的 SOAtest 选项 | SOAtest 9.x 选项 |
|---|---|---|---|
| Windows | wk.exe -cmd [options] | st.exe -cmd [options] | soatestcli.exe [options] |
| Linux | webking -cmd [options] | soatest -cmd [options] | soatestcli [options] |
示例
运行单个测试套件
SOAtest 5.5 以及更早版本：如果运行单个测试套件并将 HTML 格式的报告写入文件的 SOAtest 命令行调用是
st.exe -cmd -runtest <test suite name.tst> -reportHTML -detailed <report file name>
则 SOAtest 命令行调用可能为
soatestcli.exe -config <configuration name> -resource <path to test suite name.tst relative to the workspace> -report <report file>
WebKing: 如果运行单个测试套件并将 HTML 格式的报告写入文件的 WebKing 命令行调用是
wk.exe -cmd -runtest <test suite name.tst> -reportHTML -detailed <report file name>
则 SOAtest 命令行调用可能为
soatestcli.exe -config <configuration name> -resource <path to test suite name.tst relative to the workspace> -report <report file>
运行所有测试套件
SOAtest 5.5 以及更早版本：如果运行目录中所有测试套件的 SOAtest 命令行调用是
st.exe -cmd -runtest -all <directory path>
则 SOAtest 命令行调用可能为
soatestcli.exe -config <configuration name> -resource <directory path relative to the workspace> -report <report file>
WebKing: 如果运行目录中所有测试套件 WebKing 命令行调用是
wk.exe -cmd -runtest -all <directory path>
则 SOAtest 命令行调用可能为
soatestcli.exe -config <configuration name> -resource <相对于工作空间的目录路径> -report <报告文件>
命令行选项
下表显示了原来版本的 SOAtest 或 WebKing 与 SOAtest 9.x 在命令行选项方面的差异。
顶级选项
注意，以下选项不能同时使用。
| 操作 | 以前的 SOAtest/WebKing 选项 | SOAtest 9.x 选项 |
|---|---|---|
| 运行测试 | -runTest | 不需要标记 |
| 在 wsdl 上运行静态分析 | -runwsdltest | 已弃用 - 但是替换为等价的 WSDL 静态分析选项。有关更多详情，请查阅以下注意事项。 |
| 执行脚本 | -run | 已弃用 - 关于迁移脚本到 9.x 的帮助，请联系技术支持。 |
WSDL 静态分析
在 SOAtest 9.x 中有三种方法可以静态分析 WSDLs：
- 在第一次生成测试时应用策略文件（例如，
examples目录中的示例策略）。这将生成一个“WSDL 处理程序”工具，该工具将 WSDL 分解为其导入的 WSDL 和模式部分。然后，WSDL 部分链接到 WSDL 验证规则，模式链接到模式验证规则。 - 手动创建一个编码标准工具，该工具接受 WSDL 或模式文件作为输入，然后在其中启用所需的模式规则。
- 将模式文件放在工作区项目中，然后右键单击其 Navigator 视图、节点并运行启用了静态分析的测试配置。SOAtest 的内置测试配置包括一些示例静态分析配置，包括 WSDLs 和模式的静态分析配置。
运行测试选项
| 操作 | 以前的 SOAtest/WebKing 选项 | SOAtest 9.x 选项 |
|---|---|---|
| 从指定的目录开始递归地运行所有测试。 | -all <directory> | 若要在工作空间中运行所有测试：不需要任何标志 在一个特定项目中运行所有测试：-resource <相对于工作空间的目录路径> |
| 忽略测试 | -ignore <file name> | 忽略/包含子文件夹中的所有测试：-exclude <子文件夹> / -include <子文件夹>.这个 -include 标志允许指定由 -resource 标志指示的资源的子集。（不要在 -include/-exclude 标志后面使用 '/ ‘ 启动资源。） 若要忽略/包含来自 -resource 标志中指定的资源的测试：-exclude <文件名> / -include <文件名> （不要在带有 '/’ 的 -include/-exclude 标志之后启动资源。） |
| 运行特定的测试文件 | <file name> | -resource <相对于工作空间的测试套件名称.tst 的路径> |
| 搜索和替换路由器 | -router [matchWhole] | -router matchWhole <searchURI:URI> <replaceURI:URI> 此功能现在已弃用。请使用环境（Environments）代替。 |
| 指定测试名称模式 | -testName [-match] <pattern> [-dataSourceRow <row>] [-dataSourceName <name>] | -testName [match:]<测试名称> -dataSourceRow <行> -dataSourceName <名称> |
| 指定环境选项 | -environment <environment_name> | -environment <environment_name> |
| 使用单个数据源行运行测试 | [-dataSourceRow <row>] [-dataSourceName <name>] | -dataSourceRow <row> -dataSourceName <name> |
| 将测试结果报告到 HP (Mercury) TestDirector | -testDirector <test file> <report file> | -testDirector <testFile:file> <reportFile:file> |
| 将结果报告到 Rational TestManager | -testManager [-v] | -testManagerVerbose |
| 指定用于 web 场景回放的浏览器。 | -browserType | 请查阅 配置浏览器回放选项。 |
工具执行选项
| 操作 | 以前的 SOAtest/WebKing 选项 | SOAtest 9.x 选项 |
|---|---|---|
| 执行指定的工具 | <toolname> | 运行一个测试配置，该配置执行包含指定工具的 .tst 文件。或者，运行一个测试配置，在静态分析期间应用指定类型的工具 |
报告选项
| 操作 | 以前的 SOAtest/WebKing 选项 | SOAtest 9.x 选项 |
|---|---|---|
| 生成报告 | -genreport or <report format flag> <report file> （请查阅 "Report formats"） | -report <report file> |
| 显示成功测试的通讯报文 | -reportAllTraffic | 已弃用 |
| 报告格式 | -reportHTML, -reportXML, and -reportPDF | 使用以下选项在本地属性文件中指定： report.format=html|pdf|custom |
| 详细报告与摘要报告 | -detailed 和 -summary | 使用以下选项在本地属性文件中指定： report.developer_errors=true|false |
| 邮件报告 | -mail -attach to:[email protected] | 使用以下选项在本地属性文件中指定： report.mail.enabled=true|false: 有关详细信息，请查阅 Testing from the Command Line Interface - soatestcli 。 |
| 发布报告到 DTP | N/A | -publish 在 SOAtest 9.10.2 之前版本，此选项向团队服务器发布报告（请查阅 Team Server Options）。此功能还要求 DTP 5.3.x 或更高版本。 |
| 指定要用于生成报告的配置 | -config:<configuration name> | 使用可用报告选项在本地属性文件中指定： |
项目中心选项
| 操作 | 以前的 SOAtest/WebKing 选项 | SOAtest 9.x 选项 |
|---|---|---|
| 与项目中心进行通信 | -logger | 使用以下选项在本地属性文件中指定： concerto.reporting=true|false |
| 指定正在运行项目中心的计算机的名称 | -J-Dlogger.host=<host>. | 使用以下选项在本地属性文件中指定： concerto.server=[server] |
| 指定与项目中心进行通信的端口 | -J-Dlogger.port=<port>. | 使用以下选项在本地属性文件中指定： grs.port=[port] |
| 启动通信并将所有通信发送到项目中心 | -traffic | 已弃用 |
| 指定自定义的报告属性 | -grs <attribute name>=<attribute value> | 使用以下选项在本地属性文件中指定： concerto.user_defined_attributes=[ attributes]; 使用格式 key1:value1; key2:value2 |
团队服务器选项
| 操作 | 以前的 SOAtest/WebKing 选项 | SOAtest 9.x 选项 |
|---|---|---|
| 发送报告到团队服务器 | N/A | -publishteamserver 注意，-publishteamserver 默认使用 GUI 中的团队服务器配置。或者，您可以在本地属性文件中指定这些设置。有关向团队服务器发布报告的信息，请查阅 Project Center Options 。 |
许可证选项
| 操作 | 以前的 SOAtest/WebKing 选项 | SOAtest 9.x 选项 |
|---|---|---|
| 指定本地许可证 | -password [expiration date] [password] | 使用以下选项在本地属性文件中指定： <tool name>.license.local.expiration=[expiration] and <tool name>.license.local.password=[password] |
| 指定许可证服务器： | -licenseserver [host]:[port] | 使用以下选项在本地属性文件中指定： <工具名>.license.network.host 和 <工具名>.license.network.port |
其他选项
| 操作 | 以前的 SOAtest/WebKing 选项 | SOAtest 9.x 选项 |
|---|---|---|
| 显示帮助信息 | -dump | -help |
| 显示版本信息 | N/A | -version |
| 安装器选项 | -initjython, -installcertificate, -uninstallcertificate | -initjython, -installcertificate, -uninstallcertificate |
| 指定类路径条目 | -extraClasspath | 使用以下选项在本地属性文件中指定： system.properties.classpath |
关于 SOAtest 9.x 命令行接口的更多信息，请查阅 Testing from the Command Line Interface - soatestcli。
