可用的 soatestcli 选项被列在下面的表中。

双引号 vs. 单引号

使用“双引号”（而不是‘单引号’）来指定选项。例如：-config "team://Our Configuration"

选项目的注意
-appconsole stdout将详细输出打印到 stdout。这将打印与控制台中显示的输出类型相同的输出（如果从 GUI 运行）。

-data
%WORKSPACE_DIR%

指定要使用的 Eclipse 工作空间目录的位置。默认为当前用户的依赖用户。如果未使用 -data 选项，则将使用  [SOAtest_workspace]\parasoft\workspace（在 "SOAtest_workspace” 可能是 C:\Users\yourname 的地方) 下找到的默认工作空间。
-import %ECLIPSE PROJECT%将指定的 Eclipse 项目导入到 Eclipse 工作空间。

如果 %ECLIPSE_PROJECT% 是一个 .project 文件，则将导入所选定项目
如果它是一个目录，则将导入在所选定目录和子目录中找到的所有 Eclipse 项目。

例如：
-import \".project\"
-import \"c:\\DevelRootDir\"

如果需要，多次运行 soatestcli 和 -import ：一次是用于每个项目或要导入的项目集。一旦导入了所有必需项目，则运行 soatestcli ，而不使用 -import。比如，使用 -config 和任何其他所需参数执行测试。

-resource
%RESOURCE%

指定要运行测试套件的路径。

若要运行单个测试套件，则指定 <test suite name.tst> 相对工作空间的路径。

若运行目录中的所有测试套件，则指定相对工作空间的目录路径。

使用多次以指定多个资源。当资源路径包含空格或其他非字母数字字符时，使用引号。

如果 %RESOURCE% 是一个 .properties 文件，则对应于 com.parasoft.xtest.checkers.resources 的值将被解释为以冒号（:）分割的资源列表。只有一个属性文件可以使用这种方式指定。如果 %RESOURCE% 是一个 .lst 人间，则每行将被视为一个资源。如果灭有相似命令行上指定资源，则将测试整个工作空间。

团队项目集文件（PSF）支持 CVS、SVN、Star Team 和其他源控制系统（取决于安装的 Eclipse 插件功能）。

路径（甚至绝对路径）相对于 -data 参数指定的工作空间。

如果指定来自不同项目的多个测试，请注意，测试将按多个 -resource 参数或 .lst 文件中指定的顺序逐个项目进行分组。相同项目中的所有测试作为第一资源首先运行，然后再是不同项目中的测试（比如，如果按照 /ProjectA/A.tst, /ProjectB/B.tst, /ProjectA/C.tst 序列指定资源，则它们将按 /ProjectA/A.tst, /ProjectA/C.tst, /ProjectB/B.tst 顺序执行）。

示例：
-resource "Acme Project"
-resource "/MyProject/tests/acme"
-resource testedprojects.properties

-config
%CONFIG_URL%		指定要运行在  %CONFIG_URL% 上可用的测试配置。

此参数必需。

%CONFIG_URL% 被解释为 URL，测试配置名称或本地文件路径。

例如：

  • 按文件名：
    -config "mylocalconfig.properties"
  • 按 URL：
    -config "http://intranet.acme.com/SOAtest/team_config.properties"
  • 内置配置：
    -config "builtin://Demo Configuration"
    -config "Demo Configuration"
  • 用户定义的配置：
    -config "user://My First Configuration"
  • 团队配置：
    -config "team://Team Configuration"
    -config "team://teamconfig.properties"
-localsettings
%LOCALSETTINGS_FILE%		读取全局首选项的本地设置文件 %LOCALSETTINGS_FILE% 。这些设置指定类似报告中心设置、邮箱设置和团队服务器设置的详细信息。

本地设置文件是一个属性文件。这些文件可以控制报告首选项（报告发送给谁，应如何标记，应使用什么邮箱服务器和域等）、团队服务器设置、报告中心设置、邮箱设置等等。

关于创建本地设置文件的更多详情，请查阅 本地设置（Local Settings）文件 - 选项。

-publish发布报告到 DTP。

在 9.10.2 及更高版本的 SOAtest 中，此选项发送报告数据到 DTP（要求 5.3.x 及更高版本的 DTP）。在更早版本的 SOAtest 中，此选项发送报告到团队服务器。

-publishteamserver发布报告到团队服务器。团队服务器位置可以在 GUI 中或本地设置文件中指定（如 -localsettings %LOCALSETTINGS_FILE% 条目中所述）。
-report
%REPORT_FILE%		生成 XML 报告到给定文件 %REPORT_FILE% 并在同一目录下添加具有相同名称不同扩展名的 HTML （或 PDF 或自定义格式-如果使用 report.format 选项指定）报告。

以下所有命令将生成 HTML 报告 filename.html 和 XML 报告 filename.xml。

  • -report filename.xml
  • -report filename.htm
  • -report filename.html

如果指定的路径以 ".html"/".htm"/ ".xml” 扩展名结尾，则它将被视为要生成的报告文件的路。否则，它将被视为应该生成报告的目录。

如果文件名在命令中显示指定，且使用此名的文件早已存在指定位置，则将重写之前的报告。如果命令没有显示指定文件名，则现有文件将不会被重写，且新文件将命名为 repXXXX.html，其中 XXXX 是一个随机数。

如果没有指定 -report 选项，则将使用当前目录中的默认名称 "report.xml/html” 生成报告。in the current directory.

-router matchWhole <searchURI:URI>
<repla-ceURI:URI>		指定搜索替换参数。

例如：
-router searchURI:host1.adobe.com replaceURI:host2.adobe.com  
或  
-router searchURI:* replaceURI:http://host2.adobe.com/service

此功能现在已弃用。请使用环境代替。

-testName [match:]<test name>指定测试名称模式；测试套件名称有效

允许指定要在测试套件中运行的测试的名称。例如，如果希望运行名为 WSDL 的测试套件，则可以使用 soatestcli.exe -data "C:\workspace" -resource "MyService" -config "user://"Example Configuration" -testName "WSDL Tests"
SOAtest 将找到包含指定的特定字符串的测试，但不执行实际模式匹配（如通配符或正则表达式）。

例如， -testName match: something 将运行所有名称中包含单词 something的所有测试。

若要运行多个测试使用 -testName name1 -testName name2 ，其中 name1 和 name2 对应于所需测试的名称。

注意，可以用引号包围该值，以便在名称中允许空格。例如， -testName match: "hello world” 将寻找其名中使用实际字符串 hello world 的测试。

若要限制匹配指定名称的测试的行使用，则可以使用 dataSourceRow:<row> 和 dataSourceName: <Name>  参数紧跟着 [match:]<test name>. 

dataSourceRow: 可以获取行号或行范围的列表。例如：
5
1,2,5
3-9
2-5,7,20-30

dataSourceName: <Name> 参数是可选的。如果使用，则必须紧跟在 dataSourceRow:<row>之后。

-dataSourceRow
<row> -dataSource-Name <name>		运行具有指定数据源行的所有测试

-dataSourceName <name> 参数是可选的。如果使用，则必须紧跟在 -dataSourceRow <row>之后。

dataSourceRow <row> 可以获取行号或行范围的列表。例如：
5
1,2,5
3-9
2-5,7,20-30

例如：

  • -dataSourceRow 1-5 将导致任何使用数据源的任何测试运行行 1 到行 5 。
  • -dataSourceRow 1,5 -dataSource-Name "Data" 将导致任何使用名为“Data”的数据源的任何测试运行行 1 到行 5 。

如果希望强制执行要使用的所有数据源行（即使数据源保存为只使用特定行），则使用 -dataSourceRow  all。

-dataGroupConfig指定数据组内活跃的数据源。此参数后必须紧跟 XML 文件的位置，为测试运行中包含的每个 .tst 文件内的每个数据组指定活跃的数据源。该文件的格式应该如 datagroupConfig XML File Format所示。
-environment
<environment_name>		指定环境选项当运行来自命令行的功能测试时，可以使用命令行指定的内容覆盖项目中指定的活跃的环境。注意，如果在项目中没有找到指定的环境，则将使用默认的活跃的环境。
-environmentConfig指定活跃的环境变量。此参数后必须紧跟 XML 文件的位置，指定环境变量值，以用于测试运行中包含的每个 .tst 文件。该文件的格式应该如 environmentConfig XML File Format中所示。
-fail如果报告了任何违规，则返回非零退出码，从而导致构建失败。

返回码表示 2 条静态分析违规，4 条功能测试违规，8 条编码审核违规，1 条任何其他问题。

还请查阅 CLI 退出码。

-Centrasite将测试结果报告到 Software AG CentraSite Active SOA 注册表允许将结果报告发送回 Software AG CentraSite Active SOA 注册表有关更多详情信息，请查阅 使用 Software AG CentraSite Active SOA 与 SOAtest。
-qualityCenter
-qualityCenterReportAllTraffic		将测试结果报告到 HP 质量中心允许将结果发送回 HP 质量中心。有关更多详情信息，请查阅 使用带有 SOAtest 的 HP ALM 和 HP 质量中心。
-testManager
-testManagerVerbose		将结果报告到 Rational TestManager

允许将结果发送回 Rational TestManager。有关更多详情信息，请查阅 使用 IBM/Rational 和 SOAtest。

详细模式提供更多信息，比如请求和响应流量。

-visualStudio将测试结果报告到 Microsoft Visual Studio 团队系统允许将结果发送回 Microsoft VIsual Studio 团队系统有关更多详情信息，请查阅 使用 Microsoft 与 SOAtest。
-include %PATTERN%
-exclude %PATTERN%		指定测试期间包含/不包含的文件。

选中该选项后必须指定文件名或路径。

模式指定文件名，使用接受的 * 和 ? 通配符，以及用于指定多个路径名称段的特殊通配符 **。模式语法类似于 Ant 文件集的语法。

比如，
-include **/Bank.xml （测试 Bank.xml 文件）
-include **/ATM/Bank/*.xml （测试文件夹 ATM/Bank 中的所有 .xml 文件）
-include c:/ATM/Bank/Bank.xml （只测 c:/ATM/Bank/Bank.xml 文件）
-exclude **/internal/** （测试所有除具有 "internal”文件夹的路径的类之外的所有类）
-exclude **/*Test.xml （测试除以 Test.xml 结尾的其他所有文件）

此外，如果模式是具有 .lst 扩展名的文件，则它将被视为带有模式列表的文件。

例如，如果使用  -include c:/include.lst 和 include.lst ，其中包含以下内容（每一行被视为一个模式）：
**/Bank.xml
**/ATM/Bank/*.xml
c:/ATM/Bank/Bank.xml

然后，它具有与指定相同的效果：
-include **/Bank.xml -include **/ATM/Bank/*.xml
-include c:/ATM/Bank/Bank.xml"

-browserTestsVisible对于浏览器测试，打开浏览器 UI 并在浏览器中回放测试。这为你提供了一个选项，用于查看和捕获每个测试步骤之后显示的浏览器内容（比如，为遵从性目的）。
-concerto.autoconfig
%PROJECT_NAME@SERV ER_NAME:port%		获取存储在 Concerto 服务器上的设置（建议易于维护，特别是如果你还没有本地存储的本地设置文件)。例如：
-concerto.autoconfig
[email protected]:8080
-encodepass <plain password>生成给定密码的编码版本。

打印消息 'Encrypted password: <encpass>' ，并终止 cli 应用程序。

必须与  -config <url>一起使用。

-showdetails打印详细的测试进程信息。N/A
-J指定额外的 JVM 选项，然后通过 -vmargs 选项将其传递给 Eclipse 可执行文件。

Eclipse -vmargs 参数用于自定义要用于运行 Eclipse 的 Java VM 操作。如果指定了该参数，则此选项必须出现在命令行末尾。即使没有在可执行命令行上进行指定，可执行也将会自动把相关参数（包括正在启动的类）添加到使用 -vmargs 参数传递到 Java 的命令行中。然后 Java Main 将该值存储在 eclipse.vmargs 中。

用法是 -vmargs [vmargs*] (Executable, Main)

-prefs %PREFS_URL%读取 %PREFS_URL% 首选项preference URL 来导入 Eclipse 工作空间首选项。

%PREFS_URL% 被解释为本地 Eclipse 工作空间首选项文件的 URL 或路径。创建工作空间首选项文件的最佳方法是使用 Export 向导。为此：

  1. 选择 File> Export。
  2. 在 Export 向导中，选择 Preferences，则单击 Next。
  3. 进行下列其中一项操作：
    • 若要向文件添加所有首选项，请选择 Export all。
    • 若只向文件添加特定首选项，请选择 Choose specific preferences to export，然后选择要导入的首选项。
  4. 单击 Browse... ，然后指明将首选项文件保存到何处。
  5. 单击 Finish。

我们建议你删除不可应用的属性，并只保留关键属性，如 classpath 属性。我们也建议你通过使用 $(VAR) 符号使用变量替换机器/用户指定的位置。这些变量将替换为相应的 Java 属性，通过使用  -J-D 选项（比如 soatestcli -J-DHOME=/home/user）。运行 soatestcli 。

比如：
-prefs "http://intranet.acme.com/SOAtest/workspace.properties"
-prefs "workspace.properties"

-help显示帮助信息。不要运行测试。
-version显示版本号。不要运行测试。
-initjython, -installcertifi-cate, -unin-stallcertificate安装器选项N/A
-machineid打印机器码。机器码用于授权用途。

注意

  • 若要查看有效命令行选项列表，请输入 soatestcli -help。
  • soatestcli 自动向指定的组管理员和架构师发送报告邮件，此报告列出了所有组/项目任务并确定哪个团队成员负责哪个任务。如果灭有报告任何任务，则除了包含
    report.mail.on.error.only=true 选项的本地设置文件都将发送报告。
  • 如果满足合适的前提条件，则 soatestcli 自动向只包含分配对应任务的每个团队成员发送报告邮件。如果特殊团队成员没有给分配任务，则他或她将不会收到报告邮件。
  • 关于继承自 Eclipse 选项的更多详情，请查阅 Eclipse 文档。

用于 datagroupConfig 和 environmentConfig 的 XML 文件

datagroupConfig XML 文件格式

<tests>
	<test> <!--1 or more-->
		<workspacePath></workspacePath>
		<dataGroups>
			<dataGroup> <!--1 or more-->
				<dataGroupName></dataGroupName>
				<activeDataSourceName></activeDataSourceName>
			</dataGroup>
		</dataGroups>
	</test>
</tests>

environmentConfig XML 文件格式

<tests>
	<test> <!--1 or more-->
		<workspacePath></workspacePath>
		<Environment>
			<Variable> <!--1 or more-->
				<Name></Name>
				<Value></Value>
			</Variable>
		</Environment>
	</test>
</tests>

注意， <workspacePath> 元素应该包含工作空间中而非文件系统路径上的资源（比如，.tst）路径。如果右键单击 Eclipse/SOAtest 中的 .tst 文件，然后选择 Properties，则 Eclipse 将显示 Path 。  例如，下面示例中的路径是 /SOAtest Tutorial/Calculator.tst。


  • No labels

Need assistance? Visit our support page