第4课 - Ranorex测试套件

正如第2课：Ranorex模块 - 测试操作中已经提到的那样，建议将测试用例分成可重复使用和可参数化的测试自动化模块。在Ranorex测试套件中，您不仅可以通过组合现有的自动化模块轻松创建新的测试用例 - 还可以指定全局参数和数据连接器来设置数据驱动的测试用例。

在下面的课程中，您将了解到：

• 测试套件编辑器
• 模块组编辑器
• 测试套件的一般结构
• 运行测试套件
• 在没有Ranorex Studio的情况下运行测试
• 测试套件设置
• 测试用例和智能文件夹设置
• 在测试套件中使用数据
• 条件

测试套件编辑器

创建新的测试套件项目后，Ranorex Studio项目会自动包含<ProjectName> .rxtst文件。

默认情况下，测试套件文件是自动打开的。

Ranorex测试套件文件

使用在课程1到3中创建的项目，您现在可以基于现有模块创建新的测试用例。要打开测试套件，可以双击* .rxtst文件或使用工具栏面板中显示的“View Test Suite”按钮。

Ranorex Studio工具栏

添加一个新的测试用例或智能文件夹

点击“添加”按钮即可添加新的测试用例或智能文件夹。根据测试套件的当前项目选择，您可以添加不同类型的测试套件元素。测试套件可以由以下项目组成：

• 测试用例
• 智能文件夹
• 录音模块
• 代码模块
• 模块组

这些项目可以根据特殊的层次结构进行添加和排列。你可以在这里找到更多关于它的信息。

添加一个新的测试用例

新创建的测试用例将用于验证KeePass版本号的正确性，因此应该更改测试用例的名称。选择并单击测试用例并将其重命名为“TC_ValidateVersionNumber”。

重命名测试用例

重用现有模块

现在您可以重新使用Ranorex模块浏览器视图中的两个现有记录模块。

您可以简单地将项目从模块浏览器拖放到测试用例中，也可以使用上下文菜单添加新项目或现有项目，如图所示。

添加现有的录制模块

从列表中选择“StartSUT”模块

按'OK'将记录模块添加到测试用例。

重复这些步骤将记录项'LogIn'和'CloseSUT'添加到测试用例中。

插入一个新的录音模块

目前，测试用例仅涵盖启动待测应用程序，使用三个现有模块登录和关闭待测应用程序。

为了验证KeePass应用程序的版本号，您可以创建一个新的记录模块用于测试用例。

再次使用上下文菜单，但是这次将新的记录插入到测试用例中。

  

插入一个新的录音模块

在开始新录制之前，您应该确认KeePass正在运行 - 如果未运行，您可以手动启动应用程序。

新的录制模块“ValidateVersionNumber”应该包含以下步骤：

• 打开关于对话框
• 验证版本号
• 关闭关于对话框

请记住，您需要选择“即时录制”选项，因为待测系统将由重新使用的录制模块“StartSUT”启动。

新创建的录制场景

在验证步骤中，Ranorex自动为持有KeePass版本号的单元创建一个新的储存库项 - 文本本身用于识别单元（路径）。由于单元格的内容（KeePass的版本号）用于识别，更高的版本号会导致测试用例失败，因为单元格不再被找到 - 独立于验证步骤本身版本号的匹配。为了避免这种情况，这个单元格的路径应该被修改为更健壮。路径可以使用路径编辑器进行编辑。另外，它不应该使用版本号本身来识别。

点击'按间谍编辑'按钮打开路径编辑器

更改标识属性：取消选择文本属性并选择列和行索引属性

即使发布新版本，使用索引进行标识也可确保单元的可访问性。要完成此记录，您可以修改验证操作以使用名为'varCurrentKeePassVersion'的新变量，其默认值为'2.20.1'，而不是与常量值匹配。这个模块变量可以绑定到一个新的全局变量'GlobalCurrentKeePassVersion'。

现在测试用例'ValidateVersionNumber'已准备好运行。

使用上下文菜单项“运行选定的测试用例”来运行它并查看它是否有效。

运行选定的测试用例

模块组编辑器

将属于一组的模块组合在一起以更容易地重用它们会很有用。

例如，将模块的StartSUT和LogIn组合到KeePass示例项目中的StartAndLogin模块组中可能很有用，因为启动被测系统需要这两个模块。这同样适用于可以与模块组“SaveAndClose”结合使用的模块“Save”和“CloseSUT”。

这可以使用模块组编辑器完成。

除了测试套件文件之外，测试套件项目还包含一个定义项目中现有模块组的文件。该模块组文件自动生成为<Project-Name> .rxtmg。

在项目视图中双击该文件将在模块组编辑器中打开它。

打开模块组编辑器

创建新的解决方案后，将创建一个空模块组文件。

模块组编辑器

您可以通过以下方式将模块组添加到项目中：

• 在模块组编辑器中按下“新建模块组”按钮
• 使用测试套件编辑器中的上下文菜单将模块组添加到测试用例/智能文件夹
• 使用测试套件编辑器中的上下文菜单将选定的模块分组到模块组中

使用测试套件编辑器中的上下文菜单将模块组添加到测试用例

使用测试套件编辑器中的上下文菜单将现有模块分组到新模块组中

通过将现有模块分组到模块组中，模块组将填充所选模块。另外，所选模块的可能数据绑定将自动应用于创建的模块组，因此这是建议的方法。添加新模块组时，模块组为空，可以使用模块组中的上下文菜单填充模块，然后添加新模块或现有模块。

使用上下文菜单将现有模块添加到模块组

除了添加现有模块之外，还可以将文件夹添加到模块组以添加其他层级。

也可以使用从模块浏览器或项目视图拖放到模块组编辑器中的模块组添加现有模块。

将模块拖放到模块组中

要允许按 第3课 - 数据驱动的测试中 所述的数据驱动方法 ，有必要将数据源或参数中的值通过模块组传递给该模块组中包含的模块。

您可以使用右键单击模块组出现的上下文菜单项“数据绑定...”为模块组中的模块定义数据绑定。

打开模块组的数据绑定对话框

通过数据绑定对话框，您可以指定哪些模块变量应该可以从模块组外部更改，哪些模块变量应该在模块组内部具有常数值。

注意在模块组内使用常量值的机制允许隐藏模块变量。这可以降低复杂度并增加模块组的清晰度，因为并不总是需要分别设置每个模块变量。

定义哪些模块变量应该从模块组外部传递值，以及哪些模块变量应该具有常数值

注意通过按“自动创建”按钮，将根据模块变量的名称生成每个未绑定模块变量的组变量。通过按'自动绑定'按钮，未绑定的模块变量将被绑定到具有相同名称的组变量。

定义模块组及其数据绑定后，可以将模块添加到测试用例或智能文件夹中，方法与添加模块的方式相同。

模块组的数据绑定与模块的工作方式完全相同。

有关使用模块和数据绑定的更多详细信息，请参见第2课：Ranorex模块和测试操作以及第3课：数据驱动的测试。

将模块组添加到测试用例

测试套件的一般结构

在最后一节中，您学习了如何通过将现有模块与新创建的记录相结合来将新测试用例添加到测试套件。

要查看组织更复杂测试套件项目的不同方式，请从Ranorex Studio开始页面打开示例测试套件项目“KeePassTestSuite”。

打开示例测试套件项目'KeePassTestSuite'

此示例包含可在测试套件中使用的不同类型的元素，并涵盖所有可能的组合。

Ranorex测试套件结构

＃1测试套件	表示整个测试套件并且是结构的根级别
＃2测试用例	代表一个测试用例
＃3安装区域	用于准备测试用例的组模块（例如，启动被测系统，初始化数据库等）
＃4智能文件夹	用于组织其他项目。智能文件夹可以嵌套（智能文件夹可能包含其他智能文件夹）
＃5模块组	用于将几个模块分组为一个可重用的集合
＃6拆解区域	用于清理测试用例的组模块（例如删除测试执行期间生成的文件，关闭应用程序等）
＃7代码模块	用代码编写的自动化模块
＃8录制模块	自动化模块通过记录生成

这些项目遵循层次结构。这意味着有一些规则可以定义哪些项目可以直接添加到测试套件结构中的其他项目中。下表说明了这一点。

测试套件：在根级别，您可以添加测试用例，智能文件夹和安装/拆卸区域。

测试用例：您可以添加智能文件夹，安装/拆卸区域，模块和模块组。

智能文件夹：您可以添加测试用例*，其他智能文件夹，设置/拆卸区域，模块**和模块组**。

设置/拆卸：您可以添加模块和模块组。

*仅当智能文件夹不属于测试用例时。
**只有智能文件夹是测试用例的一部分时才有效。

注意如果拖放操作或复制/粘贴操作会创建嵌套测试用例，则受影响的测试用例将转换为智能文件夹。由此产生的智能文件夹将以与原始测试用例相同的方式工作。

设置和拆卸区域

安装和拆卸区域用于准备和清理单个测试用例/智能文件夹运行。

设置区域将在测试用例/智能文件夹保存的任何其他模块之前运行，并且应该包含将测试系统正好置于测试可以开始的状态所需的任何模块。使用本节的典型案例是启动待测试应用程序并与用户一起登录。

拆卸区域将在测试用例/智能文件夹中的所有模块之后运行，或者当错误导致测试用例/智能文件夹运行中止时运行拆卸区域。拆解区域应该包含清理被测系统所需的任何模块，并使其达到原始状态。使用此部分的典型案例是删除所有添加的数据并关闭测试中的应用程序。

安装区域将自动放置在开始处，拆卸区域将自动放置在测试套件，测试用例或智能文件夹的末尾。

使用上下文菜单指定来自测试用例或智能文件夹的哪些模块或模块组应该是设置或拆卸过程的一部分。

将模块添加到安装区域

注意如果您想为一组测试用例定义一个设置和一个拆卸区域，只需使用如下图所示的智能文件夹

智能文件夹包含一般设置和拆卸区域的测试用例

注意为了定义全局设置和拆卸区域，请单击测试套件节点上下文菜单中的“添加设置”或“添加拆卸”，然后拖放需要的模块或模块组以显示设置和拆卸区域。

在测试套件级别显示setup和teardown区域

将模块拖放到全局设置区域

为了快速停用某个模块，而不是删除它，请使用上下文菜单项“禁用”。

搜索元素

使用'搜索'文本框查找测试套件中的元素。

文字的搜索结果'添加'

运行测试套件

要运行测试套件，请单击测试套件编辑器工具栏中显示的“RUN”按钮或Ranorex Studio工具栏中的运行按钮。这将始终使用当前选定的运行配置运行测试套件。

运行配置

运行配置定义测试期间将执行哪些测试用例和智能文件夹。使用复选框指定要运行的元素。选中测试套件级别的复选框将勾选所有其他选项。您也可以保存您当前的配置。就是这样：

• 选中所需元素的框。
• 单击测试套件编辑器工具栏中的下拉菜单并选择“管理运行配置...”。
• 点击“添加”。
• 输入名称并单击确定。
• 您现在可以通过从下拉菜单中选择运行配置来应用运行配置。

注意运行配置只能与创建它们的测试套件一起使用。

激活不同的测试套件运行配置

添加或删除测试套件运行配置

运行迭代

运行迭代可让您在测试运行期间运行特定的测试用例或智能文件夹任意次。您可以按如下方式启用它们：

• 点击您想要迭代的测试用例或智能文件夹。
• 转到“查看”并点击“属性”或按F4。属性栏会出现。
• 在“迭代计数”中输入所需的迭代次数。

所选项目现在将在测试执行期间运行指定的次数。

自动重试

使用此选项，您可以在不中断测试执行的情况下自动重新运行失败的测试用例或智能文件夹一段指定的时间。这很有用，因为在UI测试中，错误有时会发生，因为AUT没有响应。在这些情况下，解决方案是简单地重新运行测试。

要激活此选项，请按照下列步骤操作：

1. 选择一个测试用例或智能文件夹
2. 按F4以显示其属性。
3. 在“重试计数”字段中输入所需的重试次数。

如果有数据绑定或运行迭代，重试将在故障点开始。例如，如果失败发生在迭代3或5，那么重试将开始。只有每次重试失败的测试用例或智能文件夹才会在报告中标记为失败。 

在没有Ranorex Studio的情况下运行测试

正如您在第一课 - 入门中学到的，Ranorex Studio会从您的测试套件项目中创建一个可执行文件。为了在运行时环境中执行测试套件，必须将生成的可执行文件（* .EXE）和测试套件文件（* .RXTST）放在同一个目录中。如果您的Ranorex Studio解决方案包含多个项目，则需要确保库（* .DLL）文件也是同一目录的一部分。简而言之，要将Ranorex测试部署到运行时机器，需要将完整的输出文件夹（例如'bin / debug'）复制到目标机器。

您可以使用以下某种方法在Ranorex Studio之外执行测试套件：

• Ranorex测试套件亚军
• 命令行

Ranorex测试套件亚军

只需双击项目输出文件夹中的* .RXTST文件即可打开Ranorex Test Suite Runner。

外部Ranorex测试套件亚军

您可以使用Ranorex Test Suite Runner来运行测试套件，执行特定的测试用例和智能文件夹，或者运行特定的自动化模块。

另外，您可以像在Ranorex Studio项目中一样创建新的运行配置。

通过命令行运行测试

注意以下所有示例均基于Ranorex Studio中包含的桌面和iOS示例项目。

使用以下命令模式，可以从命令行执行测试套件：

<GeneratedTestSuite> .EXE

例如

KeePassTestSuite.exe。可执行程序

要使用其中一个可用参数，请使用以下命令模式：

<GeneratedTestSuite> .exe / <参数>

例如

KeePassTestSuite.exe /帮助。exe / help

要使用多个参数，请使用空格分隔参数，如下所示：

<GeneratedTestSuite> .exe / <第一个参数> / <第二个参数>

例如 

KeePassTestSuite.exe / zr / ju。exe / zr / ju

注意当从命令行执行测试套件时，返回值'0'表示测试脚本成功执行，返回值'-1'表示失败，返回值'42'表示没有可用许可证。

下表列出了所有可用的命令行参数。大多数论据都有完整和简短的版本。您可以随意使用，甚至可以混合使用。

将尖括号<>中的任何文字替换为项目的相应值。

充分的论据	简洁版本	描述
帮帮我	？	显示包含所有可用参数的帮助文本。 例如 KeePassTestSuite.exe /帮助 。exe / help 要么  KeePassTestSuite.exe /？。exe /？
listconfigparams	LCP	列出所有可设置的配置参数及其值。 例如 KeePassTestSuite.exe / listconfigparams。exe / listconfigparams 或例如 KeePassTestSuite.exe / lcp。exe / lcp
config：<配置参数名称> = <值>	cfg：<配置参数名称> = <值>	设置配置参数的值。 例如 KeePassTestSuite.exe /config:adapter.defaultsearchtimeout=15000ms。exe / config ：适配器。defaultsearchtimeout = 15000ms 要么 KeePassTestSuite.exe /cfg:adapter.defaultsearchtimeout=15000ms。exe / cfg ：适配器。defaultsearchtimeout = 15000ms
端点：<端点名称>	ep：<端点名称>	在测试执行期间显示将用作自动化根的端点的名称。如果未指定端点，则使用“localhost”。 例如 iOSKeePassSample.exe /端点：iPad。exe / endpoint ：iPad 要么 iOSKeePassSample.exe / ep：iPad。exe / ep ：iPad 请注意：该解决方案没有端点。终点iPad被选为演示目的。
reportfile：<报告文件路径>	rf：<报告文件路径>	设置报告文件的名称（和路径）。如果没有提供路径，则使用当前目录。默认情况下，使用rxtst文件中指定的文件名。（例如：％S_％Y％M％D_％T.rxlog）。 例如 KeePassTestSuite.exe /reportfile:C:\AllReports\%H\%S_%Y-%M-%D_%T.rxlog。exe / reportfile ：C ：\ AllReports \％H \％S_ ％Y - ％M - ％D_ ％T 。rxlog 要么 KeePassTestSuite.exe /rf:C:\AllReports\%H\%S_%Y-%M-%D_%T.rxlog。exe / rf ：C ：\ AllReports \％H \％S_ ％Y - ％M - ％D_ ％T 。rxlog
zipreport	ZR	将报告（包括关联文件）压缩到单个存档（“.rxzlog”扩展名）。 例如 KeePassTestSuite.exe / zipreport。exe / zipreport 要么  KeePassTestSuite.exe / zr。exe / zr
JUnit的	菊	也以JUnit格式创建报告。报告将放置在原Ranorex报告的相同位置。 例如 KeePassTestSuite.exe / junit。exe / junit 要么  KeePassTestSuite.exe / ju。exe / ju
zipreportfile：<zip报告文件路径>	zrf：<zip报告文件路径>	与参数zipreport一起使用时  ，设置压缩报表文件的名称（和路径）。如果没有提供路径，则使用报告文件的路径。如果文件扩展名不是“.rxzlog”，则扩展名将替换为“.rxzlog”。默认情况下，rxtst文件中指定的报告文件名或参数reportfile的值与扩展名“.rxzlog”（例如：％S_％Y％M％D_％T.rxzlog）一起使用。 例如 KeePassTestSuite.exe /zipreportfile:C:\AllReports\%H\zipped\%S_%Y-%M-%D_%T.rxzlog。exe / zipreportfile ：C ：\ AllReports \％H \ zipped \％S_ ％Y - ％M - ％D_ ％T 。rxzlog 要么 KeePassTestSuite.exe /zrf:C:\AllReports\%H\zipped\%S_%Y-%M-%D_%T.rxzlog。exe / zrf ：C ：\ AllReports \％H \ zipped \％S_ ％Y - ％M - ％D_ ％T 。rxzlog
reportlevel：<report level>	rl：<报告级别>	设置日志消息需要包含在日志文件中的最小报告级别。可能的值包括：无，调试，信息，警告，错误，成功，失败或任何整数值。指定'无'来完全禁用报告。这些级别对应于以下整数值：Debug = 10，Info = 20，Warn = 30，Error = 40，Success = 110，Failure = 120 例如 KeePassTestSuite.exe / reportlevel：警告。exe / reportlevel ：警告 要么  KeePassTestSuite.exe / rl：警告。exe / rl ：警告
listglobalparams	唱片	列出所有全局参数及其值。 例如 KeePassTestSuite.exe / listglobalparams。exe / listglobalparams 要么  KeePassTestSuite.exe / lp。exe / lp
listtestcaseparams：<测试用例或智能文件夹的名称或指导>	ltcpa：<测试用例或智能文件夹的名称或指导>	列出所有测试用例或智能文件夹参数及其值。 例如 KeePassTestSuite.exe / listtestcaseparams：AddEntryByCodeModule。exe / listtestcaseparams ：AddEntryByCodeModule 要么  KeePassTestSuite.exe / ltcpa：AddEntryByCodeModule。exe / ltcpa ：AddEntryByCodeModule
测试用例：<测试用例或智能文件夹的名称或指导>	tc：<测试用例或智能文件夹的名称或指导>	仅运行此测试用例或智能文件夹。 例如 KeePassTestSuite.exe / testcase：AddNewEntry。exe / testcase ：AddNewEntry 要么  KeePassTestSuite.exe / tc：AddNewEntry。exe / tc ：AddNewEntry
测试套件：<测试套件文件的路径>	ts：<测试套件文件的路径>	运行测试套件（rxtst）文件定义的测试用例或智能文件夹。  默认 使用与<TestSuiteExe>具有相同名称的rxtst文件 或与<TestSuiteExe>相同的文件夹中的第一个rxtst文件。 例如 KeePassTestSuite.exe /testsuite:AlternativeKeePassTestSuite.rxtst。exe / testsuite ：AlternativeKeePassTestSuite 。rxtst 要么  KeePassTestSuite.exe /ts:AlternativeKeePassTestSuite.rxtst。exe / ts ：AlternativeKeePassTestSuite 。rxtst 请注意：该解决方案只附带一个测试套件。测试套件文件'AlternativeKeePassTestSuite'被选为演示目的。
runco​​nfig：<运行配置名称>	rc：<运行配置名称>	运行指定运行配置的测试用例或智能文件夹。运行配置可以使用Ranorex Studio或TestSuiteRunner进行编辑。默认情况下，使用当前选择的运行配置。 例如 KeePassTestSuite.exe / runco​​nfig：SmokeTest。exe / runco​​nfig ：SmokeTest 要么  KeePassTestSuite.exe / rc：SmokeTest。exe / rc ：SmokeTest
模块：<模块名称或GUID>	mo：<模块的名称或指导>	使用指定的名称或guid运行模块。搜索由<GeneratedTestSuite>加载的程序集和rxtst文件中引用的程序集。 例如 KeePassTestSuite.exe /模块：ValidateEntry。exe / module ：ValidateEntry 要么  KeePassTestSuite.exe / mo：ValidateEntry。exe / mo ：ValidateEntry
参数：<全局参数名称> = <值>	pa：<全局参数名称> = <值>	设置或覆盖全局参数的值。 例如 iOSKeePassSample.exe / param：Global_DeviceName = iPhone6。exe / param ：Global_DeviceName = iPhone6 要么 iOSKeePassSample.exe / pa：Global_DeviceName = iPhone6。exe / pa ：Global_DeviceName = iPhone6
testcaseparam：<测试用例或智能文件夹的名称或GUID>：<参数名称> = <值>	tcpa：<测试用例或智能文件夹的名称或指导>：<参数名称> = <值>	设置或覆盖测试用例或智能文件夹参数的值。 例如 KeePassTestSuite.exe / testcaseparam：AddEntryWithArguments：DefaultTitle = Ranorex。exe / testcaseparam ：AddEntryWithArguments ：DefaultTitle = Ranorex 要么  KeePassTestSuite.exe / tcpa：AddEntryWithArguments：DefaultTitle = Ranorex。exe / tcpa ：AddEntryWithArguments ：DefaultTitle = Ranorex 请不要：解决方案中不存在测试用例AddEntryWithArguments的参数，只是为了解释上面的用法。
runlabel：<自定义值>	rul：<自定义值>	为测试运行设置自定义运行标签。 例如 KeePassTestSuite.exe / runlabel：SpecialRunLabel。exe / runlabel ：SpecialRunLabel 要么  KeePassTestSuite.exe / rul：SpecialRunLabel。exe / rul ：SpecialRunLabel
testcasedatarange：<测试用例或智能文件夹的名称或指导> = <数据范围>	tcdr：<测试用例或智能文件夹的名称或指导> = <数据范围>	设置测试用例或智能文件夹的数据范围。 例如 KeePassTestSuite.exe / testcasedatarange：AddEntryByRecording = 2。exe / testcasedatarange ：AddEntryByRecording = 2 要么  KeePassTestSuite.exe / tcdr：AddEntryByRecording = 2。exe / tcdr ：AddEntryByRecording = 2
testrail		通过API将测试运行结果报告给TestRail。需要'truser'和'trpass'参数。 例如 KeePassTestSuite.exe / testrail / truser=janedoe@jane.com / trpass =密码。exe / testrail / = janedoe @ jane 。com / trpass = 密码
truser = <电子邮件>		需要'testrail'。用于登录TestRail的电子邮件。 例如 KeePassTestSuite.exe / testrail / truser=janedoe@jane.com / trpass = securepassword。exe / testrail / = janedoe @ jane 。com / trpass = securepassword
trpass = <密码>		需要'testrail'。用'truser'指定的用户的密码或API密钥。 例如 KeePassTestSuite.exe / testrail / truser=janedoe@jane.com / trpass =密码。exe / testrail / = janedoe @ jane 。com / trpass = 密码
trrunid = <运行ID>		需要'testrail'：（可选）TestRail中现有测试运行的标识符，以将测试结果报告给TestRail。没有这个参数，就会创建一个新的测试运行。 例如 KeePassTestSuite.exe / testrail / truser=janedoe@jane.com / trpass = password / trrunid = 123。exe / testrail / = janedoe @ jane 。com / trpass = password / trrunid = 123
trrunname = < “名称”>		需要'testrail'：（可选）在TestRail中创建一个新的测试运行，并使用指定的名称向其报告测试结果。没有这个参数，使用默认名称。 例如 KeePassTestSuite.exe / testrail / truser=janedoe@jane.com / trpass = password / trrunname =“TestRun”。exe / testrail / = janedoe @ jane 。com / trpass = password / trrunname = “TestRun”

注意压缩报告文件（* .rxzlog）可以通过在资源管理器中右键单击并从上下文菜单中选择“提取”来提取。可以通过在资源管理器中右键单击报告文件（* .rxlog）并从上下文菜单中选择“压缩”来压缩报告文件（* .rxlog）。

测试套件设置

通过在测试套件根节点上选择上下文菜单项“属性”来打开测试套件的设置对话框。

测试套件的一般设置

 

全局参数表

 

报告设置

一般测试套件设置

名称	指定测试套件的名称（与在测试套件编辑器中显示的相同）
描述	测试套件的描述（与测试套件编辑器的描述栏中显示的相同）。使用HTML文本编辑器格式化描述并添加指向描述的链接。格式化的描述将在生成的报告中表示为HTML内容
显示进度对话框	指定在测试套件执行期间是否应显示进度对话框
报告级别	指定与报告文件一起显示的消息的最小报告级别
警告未绑定的变量	指定是否应显示未绑定变量的警告

全局参数

测试套件中的每个测试用例都可以访问和使用全局指定的参数。KeePassTestSuite示例项目使用全局参数来指定被测应用程序的目录路径。您可以轻松地将全局参数与测试案例'TC_AddEntry'中显示的变量连接起来。另外，您可以使用全局参数在测试用例之间传输值或状态。

其他报告设置

启用报告	指定是否应生成测试报告
报告文件目录	指定生成的报告文件的目录
报告文件	指定报告生成的文件名; 以下占位符可用： ％T时间 ％D日 ％M月 ％％Y年 ％L运行标签 ％C运行配置名称 ％H主机名称 ％S测试套件名称 ％X测试套件结果
自动保存间隔	指定报告文件在执行过程中保存的频率
时间戳	指定相对于测试套件开始时间或相对于测试模块开始时间计算时间戳还是应该计算机器时间
压缩副本	指定是否应将报告的副本生成为压缩文件夹
JUnit兼容文件	指定除了测试报告之外是否应该生成JUnit兼容文件。
在一个子目录中收集截图	指定创建的屏幕截图是存储在每个报告的特定文件夹中还是直接存储在报告文件夹中
在值中显示不可见的字符	指定是否在报告消息中显示不可见字符（如空格或制表符）
报告模板	指定保存自定义样式文件的目录，而不是Ranorex默认样式来显示报告; 按第8课：报告 - 创建自定义报告模板中所述，按“创建自定义模板”按钮即可创建新模板; 可以通过按“选择自定义模板”按钮来选择现有模板
跟踪屏幕截图模式	指定是在前台（执行操作之前）还是后台（执行操作时）捕获屏幕截图，或者捕获跟踪屏幕截图是否被禁用
质量	指定捕获的屏幕截图的图像质量

测试用例和智能文件夹设置

测试用例或智能文件夹属性对话框的'常规'选项卡主要用于设置测试用例或智能文件夹如何影响测试套件中的其他测试用例或智能文件夹。

 

名称	测试用例/智能文件夹的名称
描述	测试用例/智能文件夹的说明（与测试套件编辑器的说明栏中显示的相同）。使用HTML文本编辑器格式化描述并添加指向描述的链接。格式化的描述将在生成的报告中表示为HTML内容
报告级别	指定写入报告文件的消息级别
错误行为	指定测试用例/智能文件夹和测试套件在发生错误时的行为。欲了解更多信息，请查看下一段。

下面的图试图说明几个错误行为设置：

• 继续迭代： Ranorex将继续进行当前测试用例或智能文件夹的下一次迭代。

• 继续使用兄弟： Ranorex将停止执行当前测试用例或智能文件夹，而是继续使用下一个兄弟测试用例或智能文件夹。

• 继续使用父项： Ranorex将停止执行当前的测试用例或智能文件夹，而是继续使用下一个父测试用例或智能文件夹。

• 停止： Ranorex将完全中止测试。

测试用例/智能文件夹属性对话框

使用上下文菜单更改多个测试用例/智能文件夹的报告级别或错误行为。

为多个测试用例指定错误行为

在测试套件中使用数据

如第3课：数据驱动测试中所述，  您可以使用模块中的变量（记录，代码模块）以及存储库中的变量来驱动自动化数据。

这些变量可以连接到内部或外部数据源和参数。

不同种类的数据容器

我们来看看不同种类的数据容器：

模块变量：

变量是模块和包含测试用例或智能文件夹之间的接口，或者 - 如果使用模块组，则分别是模块组。

变量可以用在 

• 录制模块（如“录制中使用变量”部分所述）， 
• 代码模块（如“在代码模块中使用变量”部分所述）和 
• 存储库（如存储库中的使用变量一节中所述）。

在按前面章节描述的测试用例构建测试用例之后，可以将包含的模块变量绑定到组变量，常量值，数据列或参数。

常数值：

可以在模块组中使用常数值来隐藏模块组之外的模块变量。这可以帮助降低复杂性并提高模块组的清晰度。

有关详细信息，请参阅关于模块组编辑器的部分。

组变量：

在模块组中，组变量是嵌套模块和嵌套测试用例之间的接口。

有关详细信息，请参阅关于模块组编辑器的部分。

数据列：

数据连接器的列称为数据列，并指定来自外部数据源的列。

查看数据连接器部分（数据连接器），以获得关于不同类型的数据连接器的概述。数据列可以连接到测试用例的数据绑定对话框中的变量，如变量与测试数据组合中所述。

参数：

模块变量也可以绑定到参数。本地参数是特定测试用例或智能文件夹的一部分，可以在测试用例/智能文件夹和所有子智能文件夹中使用，也可以在整个测试套件中提供全局参数。

与本地参数不同，可以从命令行设置全局参数，如通过命令行运行测试一节中所述。

查看将变量与参数组合在一起  以查看参数如何连接到变量。

数据容器的范围

全局参数可在整个测试套件中使用。这意味着您可以将全局参数绑定到测试套件的任何测试用例或智能文件夹中的任何模块。

测试用例或智能文件夹的本地参数和数据列由所有子测试用例或智能文件夹继承。这意味着你可以将它们绑定到

• 包含在父测试用例或智能文件夹中的任何模块。
• 包含在儿童测试用例或智能文件夹中的任何模块。

下图说明了不同数据容器的范围。

 

数据容器的范围

 

绿色矩形：全局参数的范围。
蓝色矩形：SmartFolder2的本地参数和数据列的范围。
红色矩形：TestCase2的本地参数和数据列的范围。

这意味着您可以将以下参数和数据列绑定到TestCase2中的模块：

• 所有全局参数（绿色矩形）

• SmartFolder2的所有本地参数和数据列（蓝色矩形）

• TestCase2的所有本地参数和数据列（红色矩形）

这在以下屏幕截图中进行了说明：

TestCase2的数据绑定对话框

绿色矩形显示全局参数，蓝色矩形显示名为'SmartFolder2'的智能文件夹的本地参数和数据列，红色矩形显示名为'TestCase2'的测试实例的本地参数和数据列。

修改参数和数据列值

参数值和数据列值可以通过模块进行更改。为了将值从一个模块传送到另一个模块，一旦模块完成执行，参数或数据列值将从其绑定的模块变量更新。

这意味着您可以在参数或数据列的范围内自由传输值。

此应用程序的一个示例是动态从UI中获取应该在另一个模块中重用的值，如第5课：Ranorex Recorder - 其他编辑选项 -  解决Get Value操作或代码示例的操作类型- 访问测试用例和测试套件上下文。

条件

条件允许您根据您可以定义的特定规则控制是否在测试执行期间运行测试容器。您可以为每个测试用例或智能文件夹设置一个条件，但条件最多可以有10条规则。

要设置条件，请右键单击测试套件中的测试容器，然后单击“条件...”

条件窗口将打开。

如果条件不包含任何规则，则它处于空白状态，如下所示：

点击'添加规则'将第一条规则添加到条件中。窗口将会变成如下所示：

＃1	这是测试容器的整个条件。
＃2	点击此复选框以激活或取消激活条件。在测试执行期间只会应用活动条件。
＃3	如果您已经为条件添加了多个规则，请指定是否需要为要运行的测试容器匹配全部或任意数量的规则。如果条件只包含一个规则，则可以忽略此选择。
＃4	规则尚未完成。请参阅下面的规则更详细的说明。
＃5	点击此处清除条件中的所有规则并将其返回到其空闲状态。
＃6	点击此处从条件中清除此规则。
＃7	点击此处为条件添加另一个规则。您最多可以为条件添加10条规则。

规则

规则告诉Ranorex应该检查什么来确定整个条件是否已经满足。规则可以应用于数据源或参数源。根据两条规则中哪一条适用，您可以进行的选择将会改变。完成配置规则后，即视为已完成。这由规则旁边的蓝色图标表示。如果规则不完整，橙色图标将出现在缺少的字段和规则旁边。

完整的规则，如蓝色图标所示

一个不完整的规则，如橙色图标所示

注意规则完成时，仅表示所有字段都包含有效值。这并不意味着该规则将在测试执行期间匹配。

配置规则以应用于数据源

1. 选择数据源。
2. Ranorex将自动选择测试容器的数据源。如果没有数据源分配给测试容器，则该规则无法完成。
3. 选择包含您希望规则检查的值的列。
4. 选择操作员。
5. 选择从3中选择的列取得的现有值，或者输入您自己的值。

配置要应用于参数的规则

1. 选择参数。
2. 选择参数是全局参数还是本地参数。
3. 选择您希望规则检查其值的参数。
4. 选择操作员。
5. 选择从您在3中选择的参数中获取的现有值，或者输入您自己的值。

添加完所有规则后，点击“应用”或“确定”保存条件。点击'取消'会将条件恢复到上次保存的状态并放弃更改。

状态的状态将由测试套件视图中的图标指示。您可以双击该图标直接访问条件窗口。

	积极的条件 与一个或多个完整的规则
	有一个或多个不完整规则的活动状态
	不活跃的条件 与一个或多个规则