本页概述 SOAtest 的命令行界面（soatestcli）。

章节目录：

关于命令行界面

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

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

最理想的团队配置是在团队构建机器上安装一个 SOAtest（Automation Edition），在每个开发人员/测试人员工作站上安装 SOAtest（Desktop Edition），在架构师机器上安装一个 SOAtest（Architect Edition）。 

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

此外，SOAtest 还会将结果发送到 Parasoft 报告中心，通过电子邮件向每位团队成员发送只包含分配给个人的任务相关的报告，并通过电子邮件向小组经理发送列出所有团队/项目质量任务的报告，同时确定每项任务由哪位团队成员负责。

前提条件

• 命令行模式要求命令行界面许可证（在 SOAtest Automation Edition 可用）。
• 从命令行运行测试之前，您需要对项目、.tst 文件和测试套件进行配置。详情请参阅添加项目、.tst 文件和测试套件。
• 强烈推荐您在启动测试之前配置 DTP、报告以及其他在配置中说明的 Parasoft 首选项。

设置 CLI

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

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

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

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

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

测试配置可来自内建设置，也可早 GUI 中使用 SOAtest 交互模式创建。我们建议将内建配置作为特定客户配置的初始模板，然后将其存储在磁盘内。

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

步骤 1：配置首选项

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

• 许可证：指定许可证或许可证服务器设置。
• 源码控制：这些设置使工具结果自动映射到最后更改受影响代码或测试工件的人员。选择源码控制系统，并根据连接到源码控制资源库中的说明设置适合 SCM 的选项。
• 范围和作者：选择适合环境的选项，如配置任务分配和代码作者设置中所述。
• 报告：默认启用以下选项，这是一个很好的起点：
  • 为开发者提供详细报告（包括详细的任务故障）。
  • 按作者分配的任务概述（概要表）。
  • 在命令行模式下生成格式化的报告。
  • 抑制详情（仅应用于静态分析）。
• E-mails：输入将用于发送邮箱报告的设置。这需要存在一个可访问 SOAtest 测试机器的邮箱服务器上的邮箱账号。
• 报告 > Email 通知：
  • 如果需要，请启用 通过电子邮件发送报告。邮箱分发将使用以上电子邮件设置。
  • 管理员报告包括 SOAtest 生成的所有测试结果汇总。开发人员和测试人员报告仅包括单个开发人员和测试人员的结果。启用该选项并根据性地指定邮箱地址。

步骤 2：自定义测试配置

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

步骤 3：创建设置文件

根据设置文件 - 选项中的描述创建设置文件。

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

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

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

每次批处理运行后都将发送报告，同时趋势报告将填充数据。