在本章节中：

关于命令行界面

SOAtest 命令行界面（soatestcli）允许您执行静态分析，并将测试作为夜间自动化流程的一部分执行。命令行模式可用于 SOAtest 的自动化版本。 

soatestcli 可以发送结果到 Parasoft 报告中心，向团队管理员和 Parasoft 团队服务器发送全面的报告，并向从事 SOA 项目的每个团队开发人员和测试人员发送所关注的报告。可以生成多种格式的报告。本地设置文件可以控制一些细节问题：如报告首选项（报告发送给谁，报告应如何标记，应使用什么服务器和域等等）、团队服务器设置、报告中心设置、邮箱设置、许可证设置等等。

最理想的团队配置是团队构建机器上有一个 SOAtest（自动化版），每个开发人员/测试人员工作台有一个 SOAtest（桌面版），架构师工作台有一个 SOAtest（架构师版），在团队构建机器或其他团队机器上安装一个团队服务器。 

工程师使用他们本地安装的 SOAtest 来开发并运行测试，然后将他们的工作检入源代码控制。每次夜间构建 soatestcli 都在团队机器上运行。根据配置，它可能执行可用的测试、监视策略遵从性和/或执行制定的静态分析测试。完成测试后，工程师可以将测试结果导入 SOAtest GUI，以促进任务回顾和解决。 

此外，SOAtest 将报告发送给 Parasoft 报告中心，并邮件给每个团队成员一份报告，该报告仅包含分配给他的任务，邮件团队管理人员一份报告，该报告列出了团队或项目的所有质量任务并附带每个任务所对应的团队成员，并将报告和结果上传到团队服务器。 

在整个过程中，团队服务器管理测试设置和测试文件的共享和更新；这使整个团队的测试标准化，并帮助团队成员利用彼此的成果。标准的测试设置和自定义团队规则由使用架构师版 SOAtest 的团队架构师配置并维护。

前提条件

• 命令行模式要求命令行界面许可证（在 SOAtest 自动化版可用）。
• 从命令行运行测试之前，您需要对项目、.tst 文件和测试套件进行配置。有关更多详情，请查阅 添加项目、.tst 文件和测试套件 。
• 强烈推荐您在启动测试之前对 DTP、团队服务器、报告以及其他如 配置 中所述的其他 Parasoft 首选项。

设置 CLI

Parasoft SOAtest 有两种用户模式：GUI 中交互式桌面版的使用和通过命令行界面（CLI）的命令行模式。CLI 界面是自动化版的一个标准特性。 

CLI 模式通常用于与常规/持续构建结合一起执行常规或持续的代码分析和测试，或者是作为自动回归测试基础设施的一部分。作为 CLI 执行的一部分，SOAtest 可以执行一个或更多以下操作：

• 功能、安全和回归测试的执行
• 策略执行
• 静态分析
• 分析 SCM 模式代码库，以验证识别自上次运行依赖的代码是否变更，并启动更新代码上的代码查核会话。
• 根据指定的报告配置，生成报告及将其分发到中央报告服务器和/或分发给各个开发人员和管理人员。

作为执行的一部分，SOAtest 会使用您的 SCM 客户端（如果支持），以自动从 SCM 中检索文件调整信息，并根据代码分析和执行测试的结果为特定的个人生成任务。

SOAtest 的特定执行选项是由测试配置和首选项来控制的。 

Test Configurations 可来自内建设置，也可早 GUI 中使用 SOAtest 交互模式创建。我们建议使用内建配置作为用户特定配置的启用模板，然后将其存储在磁盘或 Parasoft 团队服务器（Parasoft Concerto 部署基本础设施）。 

Preferences 可从 SOAtest GUI 进行配置。大多数首选项设置还可由配置文件提供，这些文件作为 CLI 调用的参数。配置文件首选项设置的表格可在 本地设置文件 - 选项中获得。默认情况下，应用 GUI 中设置的 SOAtest 首选项。可以根据配置文件中包含的与给定运行一起使用的首选项值在单个基础上覆盖这些值。这使您能够为所有 CLI 运行配置一组基本的首选项，然后根据需求通过提供额外的配置文件来为特定的运行提供一个给定的测试配置，从而更改各个设置。这一点挺有用的，例如，在报告中包含不同运行的不同信息，或者更改报告的邮箱分发选项，包括报告名称，邮箱标题等。 

步骤 1：配置首选项

通过 Parasoft> 首选项 菜单访问首选项。通过在 Parasoft 组中配置以下首选项启动工具：

• License: 指定许可证或许可证服务器设置。
• Team: 选择 Enable Team Server。如果未自动检测到团队服务器，请在 Server Information> Host Name中输入团队服务器的 IP 地址。如果您正在与您的自动化版产品相同的机器上运行团队服务器，请输入 localhost。除非在安装的时候更改了团队服务器的默认端口（18888），否则不要在此处更改端口。单击 Test Connection 以验证正确的设置。
• Source Controls: 这些设置使工具结果自动映射到最后更改受影响代码或测试工件的人员。选择源代码控制系统，并根据 连接到源代码控制资源库 中的说明设置适合 SCM 的选项。
• Scope and Authorship: 选择适合环境的选项，如 配置任务分配和代码作者设置中所述。
• Reports: 默认启用以下选项，这是一个很好的起点：
  • Detailed report for developers （包括详细的任务故障）
  • Overview of tasks by authors （概要表）
  • Generate formatted reports in command line mode
  • Suppressions Details （仅应用于静态分析）
• E-mails: 输入将用于发送邮箱报告的设置。这需要存在一个可访问 SOAtest 测试机器的邮箱服务器上的邮箱账号。
• Reports> Email Notifications:
  • 如果需要，请启用 通过电子邮件发送报告。不管如何设置，报告都将会上传到 Parasoft 团队服务器，以便以后的查看（由 CLI 选项控制）。邮箱分发将使用以上电子邮件设置。
  • 管理员报告包括 SOAtest 生成的所有测试结果汇总。开发人员和测试人员报告仅包括单个开发人员和测试人员的结果。启用该选项并根据性地指定邮箱地址。

步骤 2：自定义测试配置

创建自定义测试配置，如 配置策略的测试配置和规则中所述。有关 SOAtest 特定选项的更多详情，请查阅 SOAtest 测试配置设置 。

步骤 3：创建 localsettings 文件

创建 localsettings 文件，如 Local Settings Files - 选项中所述。

步骤 4：在当前运行构建系统中激活 CLI（如：批处理脚本）

例如，要添加的示例命令行可能是：

• soatestcli -resource <project name> -config "team://Team Configuration" -publish -localsettings acme_policy.settings

每次批处理运行运行后都将发送报告，同时趋势报告将填充数据。报告还可通过 Parasoft> Explore> Team Server Reports方式进以查看。