本主题解释如何将现有的 SOAtest 或 WebKing 自动化夜间处理从传统命令行接口（cli）迁移到 自动化夜间处理从传统命令行接口（传统）迁移到 SOAtest 9.x 的 soatestcli。本章包含：
| Table of Contents | ||
|---|---|---|
|
命令行调用
下表显示了先前版本的 下表显示了原来版本的 SOAtest 或 WebKing 与当前版本的 SOAtest 在命令行调用方面的差异。
...
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 选项 |
|---|---|---|
| 从指定的目录开始递归地运行所有测试。 | -all <目录><directory> | 若要在工作空间中运行所有测试：不需要任何标志 在一个特定项目中运行所有测试：-resource <相对于工作空间的目录路径> |
| 忽略测试 | -ignore <文件名><file name> | 忽略/包含子文件夹中的所有测试：-exclude <子文件夹> / -include <子文件夹>.这个 -include 标志允许指定由 -resource 标志指示的资源的子集。（不要在 -include/-exclude 标志后面使用 '/ ‘ 启动资源。） 若要忽略/包含来自 -resource 标志中指定的资源的测试：-exclude <文件名> / -include <文件名> （不要在带有 '/’ 的 -include/-exclude 标志之后启动资源。） |
| 运行特定的测试文件<文件名> | <file name> | -resource <相对于工作空间的 name<相对于工作空间的测试套件名称.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 选项 |
|---|---|---|
| 生成报告 | -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 |
...