本主题解释了如何在团队中共享测试配置(和它们所依赖任何规则文件或规则映射文件)。
本章包含:
测试配置基础
关于测试配置
Parasoft 测试产品的每个测试运行,如论是在 GUI 中执行还是通过命令行界面运行,它们都是基于测试配置,该配置定义了测试场景并设置了所有相关联的测试参数(例如,用于于静态分析、测试执行、代码复查扫描、运行时错误检测等)。若要对执行的测试方法进行更改,则修改要使用的测试配置设置。例如,若要对静态分析过程中的检查规则进行调整,则需要修改相关联静态分析测试配置中的设置。
每个 Parasoft 测试产品都提供了内置的测试配置,它们基于基于各种流行测试场景。然而,由于开发项目和团队优先级不同,所以通常需要定制测试配置。
默认的测试配置在内置类别中,无法对其进行修改。创建自定义测试配置的推荐方法是复制一个内置的测试配置到用户定义的类别中,然后修改复制的测试配置,以适应您的首选项和环境。作为一种选择,您可以“从头开始”创建一个新的测试配置,然后根据需求修改它。
收藏配置应该设置为您计划最频繁使用的自定义配置。将首选测试配置设置为收藏配置,可以轻松地从 Parasoft 菜单, Test Using 工具栏按钮或命令行界面运行它。
创建自定义测试配置
若要创建自定义测试配置
- 通过选择 Parasoft> Test Configurations,打开测试配置面板。
- 查看可用的测试配置,以确定您希望基于哪个(如果有的话)自定义测试配置。
- 每个产品的内置测试配置都在相关产品用户指南中有所描述。
- 进行下列其中一项操作:
- 如果希望基于内置测试配置或可用的团队测试配置自定义测试配,则右键单击该测试配置,然后选择 Duplicate。
- 如果希望从头开始创建一个自定义测试配置,则单击 New。
- 选择新的测试配置,将其添加到 User-defined 类别中。
- 根据需求修改设置。 除编码查核(该设置在 配置和运行预提交代码审查扫描 和 配置和运行提交后代码审查扫描中进行了描述)设置之外的设置都在产品用户指南中有所描述。
- (可选项)通过右键单击该测试配置,从快捷菜单选择 Set as Favorite ,然后指定“收藏”位置(默认为 1、2 或 3),将其设置为收藏测试配置。然后将该配置设置为收藏配置;“收藏”图标将添加到测试配置树中的该配置中。
- 单击 Apply,然后选择 Close。
提示 - 导入和导出共享测试配置
如果不使用 Parasoft 团队服务器在团队中共享测试设置,则可以通过导出要共享的每个测试配置,然后让团队成员将其导入,以实现与团队成员共享自定义测试配置。有关更多详情,请查阅 导入/导出测试配置 。
修改收藏测试配置
收藏配置定义了使用指定的 Parasoft 测试产品运行测试时默认使用的测试场景。例如,如果通过单击 Test 按钮启动测试,则 Parasoft 测试将基于收藏配置中定义的参数运行该测试。除了用作默认的测试配置设置外,还可以将其他经常使用的测试配置标记为收藏;这样便更容易对它们进行访问。
若要指明要将哪个测试配置设置为收藏配置:
- 通过选择 Parasoft> Test Configurations 或选择 Test Using 工具栏按钮的下拉菜单中的 Test Configurations ,打卡测试配置面板。
- 右键单击要设置为收藏配置的测试配置,从快捷菜单选择 Set As Favorite ,然后指定“收藏”位置(默认为 1、2 或 3)。
然后将该配置设置为收藏配置;“收藏”图标将添加到测试配置树中的该配置中。
将用户和团队测试配置组织到子目录中
如果需要,可以将用户和团队测试配置组织到用户定义的子目录中。
若要将用户或团队测试配置移动到用户定义的子目录中:
- 通过选择 Parasoft> Test Configurations 或选择 Test 工具栏按钮的下拉菜单中的 Test Configurations ,打开测试配置对话框。
- 右键单击要移动到子目录的测试配置,从快捷菜单选择 Set Folder ,然后指定所需的子目录或子目录。
- 例如,如果希望测试配置显示在 Static Analysis> Security下,则可以输入以下内容:
- 例如,如果希望测试配置显示在 Static Analysis> Security下,则可以输入以下内容:
- 然后单击 OK。如果需要,将创建指定的子目录,并将测试配置移动到该子目录中。
创建的子目录将在 Test Using 目录中可用。
命令行模式的调用将不受子目录影响。在这里,可以仅通过其名称(无需路径)继续引用测试配置。例如:-config "team://Policy Compliance"
将测试配置部署到整个团队中
关于团队测试配置
团队测试配置是应用团队指定测试设置的测试配置(例如,团队决定遵循的静态分析规则,或者更希望使用的测试生成设置,等等)。当所有团队成员使用指定的测试配置时,代码将被一致地检查,并且团队质量和风格指南将一致应用到整个代码库中。
部署团队测试配置
一旦团队测试配置添加到了团队服务器中,则它便可在所有连接的团队 Parasoft 测试安装上访问。如果有一个测试配置使用自定义规则和/或规则映射,则它们将被添加到团队服务器中,然后所有连接的团队 Parasoft 测试安装都可自动访问。
若要在团队范围内共享一个团队测试配置,则架构师或管理人员需要在已连接到团队服务器的 Parasoft 测试安装上(架构师或服务端版本)执行以下步骤:
- 如果仍然没有这样做,则创建一个用户定义的测试配置,该配置应用指定的团队设置。
- 有关更多说明,请查阅 Creating a Custom Test Configuration 。
- 按照以下步骤将该配置上传到团队服务器:
- 通过选择 Parasoft> Test Configurations,打开测试配置对话框。
- 右键单击表示要上传的测试配置的测试配置类别。
- 从快捷菜单选择 Upload to Team Server 。
可以配置多个团队测试配置(例如,一个用于静态分析,一个用于单元测试,一个用于回归测试)。
提示
如果您的团队测试配置使用自定义规则或规则映射,则可按照本主题后面所描述的那样共享相关文件。
修改团队测试配置
团队测试配置可以从 Parasoft 测试架构师版本或服务器版本直接编辑。
若要直接从架构师或服务器版本修改团队测试配置:
- 通过选择 Parasoft> Test Configurations 或选择 Test 工具栏按钮的下拉菜单中的 Test Configurations ,打开测试配置对话框。
- 在左窗格中,选择 Team> [your_team_Test_Configuration]。
- 根据需求修改设置。
- 单击 Apply 或者 Close ,提交修改的设置。
然后将在团队服务器上更新这些设置,并且更新后的设置将在整个团队中共享。
设置团队收藏测试配置
团队收藏测试配置定义了在团队服务器连接的团队成员使用指定的 Parasoft 测试产品运行测试时默认使用的测试场景。例如,如果通过单击 Test 按钮启动测试,则 Parasoft 测试将基于团队收藏配置中定义的参数运行该测试。
若要设置团队收藏测试配置,请从 Parasoft 测试架构师或服务器版本中执行以下步骤:
- 选择 Parasoft> Explore> Team Server。将打开浏览对话框。
- 打开浏览对话框的 Configurations 选项卡。
- 选择要用作团队收藏测试配置的测试配置。
- 单击 Set as Team Favorite 按钮。
跨团队部署自定义规则映射
规则映射是配置 Parasoft 测试的关键一步,以便强制执行团队或组织的编码策略(例如,通过自定义内置规则名称、严重度和类别以匹配策略中定义的规则)。
可以使用团队服务器以确保所有团队成员都可以访问 rulemap.xml
文件,该文件自定义 Parasoft 的规则类别和严重度级别。有关如何创建此文件的更多详情,请查阅 修改规则类别、ID、规则名称和严重度。
若要上传 rulemap.xml
文件到团队服务器,请从 Parasoft 测试产品授权的架构师版本或服务器版本执行以下步骤:
- 在可以访问要共享
rulemap.xml
文件的机器上启动 Parasoft 测试产品。 - 选择 Parasoft> Explore> Team Server。将打开浏览对话框。
- 打开浏览对话框的 Rules 选项卡。
- 单击 Upload 按钮。将打开一个文件选择器。
- 选择创建的
rulemap.xml
文件,然后单击 Open。刚上传的rulemap.xml
文件现在应该列在浏览对话框的 Rules 选项卡中。该文件汇总指定的规则配置将只适用于连接到团队服务器的所有相关联的 Parasoft 测试产品安装。 - 单击 Done,单击 Apply,然后关闭 Parasoft 首选项对话框。
- 重启项目。不必首先停止服务器。
- 通过选择 Parasoft> Test Configurations 或在 Test Using 工具栏按钮的下拉菜单中选择 Test Configurations ,打开测试配置对话框。
- 选择任意测试配置,并打开 Static 选项卡。应该应用新的规则设置。
提示
- 如果稍后修改主
rulemap.xml
文件,则必须重复 Deploying Custom Rule Mappings Across the Team 步骤,上传修改的文件;如果修改的文件没有上传,则修改将不会被共享。
跨团队部署自定义规则
可以使用团队服务器以确保所有团队成员可以访问并选中使用 RuleWizard 模块自定义的静态分析规则。当团队服务器管理规则时,连接到团队服务器的所有 Parasoft 测试安装都将自动访问到最新版本的规则。如果规则变更和修改的规则上传到团队服务器汇总,则所有团队 Parasoft 测试安装上的版本也将自动更新。
架构师在已连接到团队服务器的 Parasoft 测试架构师或服务器版本上(或其他指定的团队成员)执行以下步骤:
- 在 RuleWizard 中创建一个或多个自定义规则。
- 保存每条规则,并为其分配一个
.rule
扩展名。可以将规则保存在任何位置。 - 如果任何新规则应该属于新类别,则如下创建新类别:
- 通过选择 Parasoft> Test Configurations 或在 Test Using 工具栏按钮的下拉菜单中选择 Parasoft> Test Configurations 。
- 选择任意测试配置类别。
- 打开 Static> Rules Tree 选项卡。
- 单击 Edit Rulemap 按钮。
- 打开 Categories 选项卡。
- 单击 New。将添加一个新的条目到类别表中。
- 在新条目中输入类别 ID 和类别说明。例如,组织可能选择使用 ACME 作为类别 ID,选择 ACME INTERNAL RULES 作为类别说明。
- 注意,rulemap 文件的位置列在该对话框的顶部。将在步骤 9 中需要这些信息。
- 单击 OK ,保存新类别。
- 选择 Parasoft> Explore> Team Server。将打开浏览对话框。
- 打开浏览对话框的 Rules 选项卡。
- 单击 Upload 按钮。将打开一个文件选择器。
- 选择一个或多个您创建的新的
.rule
文件,然后单击 Open。刚上传的.rule
文件将列在浏览对话框的 Rules 选项卡。该选项卡中表示的所有规则将适用于连接到团队服务器的所有 Parasoft 测试安装。 - 重复之前两个步骤添加额外的团队规则。
- 如果添加了任何新的规则类别或对规则映射进行了任何其他更改,则单击 Upload,选择编写的 rulemap 文件,然后单击 Open。刚上传的文件现在应该列在浏览对话框的 Rules 选项卡。该文件将可用于连接到团队服务器并为适用的 Parasoft 产品授权的 Prasoft 测试安装。该文件控制如何对团队规则进行分类。
- 通过选择 Parasoft> Test Configurations,打开测试配置对话框。
- 选择任意测试配置,然后打开 Static> Rules Tree 选项卡。
- 单击 Reload。新规则应该在所有可用的测试配置中可用,并在团队类别下进行了分类。默认情况下,该规则将被禁用。
- 如果希望团队测试配置检查这些规则:
- 配置要检查这些规则的新测试配置或现有测试配置。添加的规则默认是禁用的,因此需要启用您想要检查的任何规则。
确保修改的测试配置适用于团队,如 Deploying Test Configurations Across the Team中所述。即使您正在修改已共享的测试配置,也必须遵循该步骤。
- 单击 Apply 或者 Close ,提交修改的设置。
提示
- 如果自定义规则在测试配置规则树(例如,通过 Import 按钮导入它)中可见,则可以只需右键单击规则,然后从快捷菜单选择 Upload to Team Server ,将其上传到团队服务器。
- 如果稍后修改团队规则,则必须重复 Deploying Custom Rules Across the Team 步骤,以上传修改后的规则文件;如果修改的
.rule
文件没有上传,则规则修改将不会共享。
从团队服务器中移除规则
若要从团队服务器中移除规则,则架构师(或其他指定的团队成员)需要在 Parasoft 测试架构师版本或服务器版本中执行以下步骤:
- 选择 Parasoft> Explore> Team Server。将打开浏览对话框。
- 打开浏览对话框的 Rules 选项卡。
- 选择要移除的规则。
- 单击 Delete。
- 单击 Done。
测试配置:高级话题
指定测试配置继承
如果希望多个测试配置共享一些相同的参数设置(例如,希望多个测试配置启用相同的规则),则可以参考一个父测试配置创建新的子测试配置。子测试配置将继承父测试配置的设置;当子测试配置中不存在相应的首选项时将使用父测试配置中的首选项值。
继承是递归的;也就是说,可以让 MyConfig2 测试配置继承 MyConfig1 的配置,同时让 MyConfig3 继承 MyConfig 2 的配置。因此,在 MyConfig3 继承 MyConfig2 时也将继承一些 MyConfig1 的设置。
可以在测试配置面板中显示的测试配置中创建一个子测试配置,或者指定一个测试配置 URL(用于通过 HTTP 提供的测试配置)。
如要从测试配置面板中显示的测试配置创建子测试配置:
- 打开测试配置面板。
- 右键单击所需的父测试配置节点,然后从快捷菜单中选择 New Child 。
若要通过 HTTP 从可用的测试配置创建一个子配置:
- 打开测试配置面板。
- 右键单击 User-Defined 节点,然后从快捷菜单中选择 New Child 。
在打开的对话框中,为所需父测试配置输入 URL(http://config_address/)。例如:
http://SOAtest.acme.com/configs/static.properties
若要断开父子之间的连接:
- 打开测试配置面板。
- 单击 Parent 字段后侧的 Disconnect 按钮。
重要说明
- 一旦设置了父子关系,便不可修改其关联性。例如,如果测试配置 A 是测试配置 Z 的父类,则不能将测试配置 Z 的父类切换为测试配置 B。从父类继承的测试配置必须从一开始就使用“New Child”操作的方式创建。
- 一旦子测试配置与其父节点断开了连接,则将无法再次连接。断开连接时,所有继承的设置都将直接应用于子节点。
- 一个给定的测试配置可能拥有只有一个父配置。不支持多继承。
比较测试配置
如果希望查看两个测试配置之间的差异,则可以对它们进行比较,以便突出显示这些差异。例如,在遇到下面的情况时您可能希望比较测试配置:
- 自定义了一个以前产品版本内置的静态测试配置,并且希望查看内置测试配置的当前版本中添加和启用了什么新规则。
- 希望知道在以“Quick Mode”运行一个给定的测试配置时,什么设置将受到影响。
- 希望将焦点对准子测试配置和其父配置之间的差异。
若要将测试配置管理器中显示的任意两个测试配置进行比较:
- 选择这两个测试配置,然后右键单击选择项,并选择 Compare。
若要将子测试配置和其父配置进行比较:
- 右键单击子测试配置,然后选择 Compare with> Parent Configuration。
若要将子测试配置和其快速模式等效项进行比较:
- 右键单击子测试配置,然后选择 Compare with> Quick Mode Configuration。
更改将在打开的比较编辑器中突出显示。
注意,比较确定了两个在面板中明显存在的差异(如,一个设置在一个测试配置中是禁用的,而在另一个配置中为启用状态)以及更深层次的差异(如,规则在一个测试配置中参数化的方式不同)。
比较测试配置
若要将两个测试配置进行比较:
- 通过选择 Parasoft> Test Configurations打开测试配置面板。
- 右键单击要进行比较的其中一个测试配置,然后从快捷菜单选择 Export ,然后使用文件选择器表明希望保存
.properties
文件的位置(选择工作区中的文件夹,并且可用于包视图)。 - 对另一个要比较的测试配置重复以上步骤。
- 在导航器中选择两个不同的
.properties
文件,右键单击选择项,然后选择 Compare with> Each other。
导入/导出测试配置
如果创建了要与团队成员共享(或用于 Parasoft 测试产品升级版)的测试配置,则可以将测试配置导出到一个属性文件中。然后可以通过导入相关属性文件添加该测试配置。
导出
若要导出测试配置:
- 通过选择 Parasoft> Test Configurations,打开测试配置面板。
- 右键单击要导出的测试配置,从快捷菜单选择 Export ,然后使用文件选择器表明希望保存为该测试配置创建的属性文件的位置。
然后将属性文件保存在指定位置。将打开一个对话框,以确认新建属性文件的位置。
导入
如要将以前导出的测试配置导入到属性文件中:
- 通过选择 Parasoft> Test Configurations,打开测试配置。
- 右键单击 User-defined 类别,从快捷菜单选择 Import ,然后使用文件选择器选择合适的属性文件。