Regression Suite Automation Tool 教程

注释

可使用 Internet 浏览器工具下载此页并以 pdf 格式保存。

本教程演练 Regression Suite Automation Tool (RSAT) 的部分高级功能，包括演示分配，还介绍策略和关键学习点。

值得注意的 RSAT 和任务录制器功能

验证字段值

RSAT 允许您在测试用例中包含验证步骤，以验证期望值。 有关此功能的信息，请参阅文章验证期望值。

以下示例演示如何使用此功能来验证现有库存量是否超过 0（零）。

1. 在 USMF 公司的演示数据中，创建一个包含以下步骤的任务录制：

   1. 转到产品信息管理 > 产品 > 已发布产品。
   2. 使用“快速筛选器”以查找记录。 例如，对物料编号字段使用值 1000 进行筛选。
   3. 选择现有库存量。
   4. 使用“快速筛选器”以查找记录。 例如，对站点字段使用值 1 进行筛选。
   5. 在列表中，标记所选的行。
   6. 验证可用合计字段的值是否为 411.0000000000000000。

2. 将任务录制另存为开发人员录制，并在 Azure DevOps 中将其附加到测试用例中。

3. 将测试用例添加到测试计划，然后将测试用例加载到 RSAT 中。

4. 打开 Excel 参数文件，转到 TestCaseSteps 选项卡。

5. 要验证现有库存量是否总是大于 0，转到验证可用总计步骤，将值从 411 更改为 0。 将运算符字段的值从等号 (=) 更改为大于号 (>)。

6. 保存并关闭 Excel 参数文件。

7. 选择上载将对 Excel 参数文件执行的更改保存到 Azure DevOps。

现在，如果库存中指定物料的可用合计字段的值大于 0（零），无论实际现有库存量值是多少，测试都将失败。

保存的变量和链接测试用例

RSAT 的一项关键功能是链接测试用例，即一个测试将变量传递给其他测试这项功能。 有关详细信息，请参阅文章复制变量以链接测试用例。

派生测试用例

RSAT 让您可以对多个测试用例使用同一个任务录制，从而可以使用不同数据配置运行一个任务。 有关详细信息，请参阅文章派生测试用例。

验证通知和消息

可使用此功能验证是否执行了某个操作。 例如，创建、估计，然后开始履行生产订单时，应用程序将显示“生产 - 开始”消息，通知您已开始履行生产订单。

可通过 RSAT 验证此消息，方法是在相应录制的 Excel 参数文件的 MessageValidation 选项卡上输入消息文本。

运行测试用例之后，将把 Excel 参数文件中的消息与显示的消息进行比较。 如果这些消息不匹配，测试用例将失败。

注释

可在 Excel 参数文件中的 MessageValidation 选项卡上输入多条消息。 这些消息也可以是错误消息或警告消息，而不是参考消息。

快照

此功能用于拍摄任务录制期间执行的步骤的屏幕快照。 非常适合审核或调试用途。

• 若要在通过用户界面运行 RSAT 时使用此功能，请打开 RSAT 安装文件夹（如 C:\Program Files (x86)\Regression Suite Automation Tool）下的 Microsoft.Dynamics.RegressionSuite.WindowsApp.exe.config 文件，然后将以下元素中的值从 false 更改为 true。

  <add key="VerboseSnapshotsEnabled" value="false" />
  

• 若要在通过 CLI（例如 Azure DevOps）运行 RSAT 时使用此功能，请打开 RSAT 安装文件夹（如 C:\Program Files (x86)\Regression Suite Automation Tool）下的 Microsoft.Dynamics.RegressionSuite.ConsoleApp.exe.config 文件，然后将以下元素中的值从 false 更改为 true。

  <add key="VerboseSnapshotsEnabled" value="false" />
  

运行测试用例时，RSAT 将在工作目录中测试用例的播放文件夹内生成步骤的快照（映像）并保存它们。 在播放文件夹中，创建了名为 StepSnapshots 的单独子文件夹。 该文件夹包含运行的测试用例的快照。

赋值

应用场景

1. 产品设计人员创建一个新发布的产品。
2. 生产经理发起一个生产订单以将库存水平提升到两件。
3. 制造将开始履行和终止生产订单，并验证现有数量是否为两件。
4. 销售团队收到一个包含四件新产品的订单。 因此，销售团队通过动态计划更新净需求。 因为没有更多产能，所以默认订单策略设置为“以买代造”。因此，将创建一个计划采购订单。
5. 买方将添加一个供应商，确认计划采购订单，然后确认该采购订单。
6. 采购的货物到店时，商店操作员将搜索相关采购订单并收货。 因为订单现在已完成，所以可以针对销售订单拣货和为货物打包。
7. 财务将过帐采购发票和销售发票。

下图显示此场景的流程。

下图显示该方案在业务流程建模器中的业务流程层次结构。

策略 – 关键学习点

数据

• 确保您有代表数据卷（生产/黄金配置数据加迁移数据的副本）。

• 通过任务录制器生成新数据时，请创建与现有名称不冲突的测试名称（例如，使用 RSATxxx 之类前缀）。

• 使用 Azure 时间点还原在非一级环境中重新运行测试。

• 如果使用 Excel 函数 RANDOM 和 NOW 生成唯一组合，则工作量非常大。 下面是一个示例。

  product = "AT" &TEXT(NOW(),"yyymmddhhmm")
  

任务录制器

• 开始录制前定义场景。 一个管理有方的项目已预定义了测试场景。 若要生成测试案例，请注意这些测试场景的结果可预测程度。
• 如果录制由不同角色执行，或者如果执行下一步之前需要等待或存在外部事件，请拆分录制。
• 请避免选择列表中的值。 而是改用文本格式，如 FIFO、AudioRM 和 SiteWH。 如果在列表中进行选择，则会录制值在列表中的位置，而不是录制值本身。 如果向该列表添加物料，值的位置可能会改变。 因此，录制将使用其他参数，并且可能会影响场景的其余部分。
• 请注意多用户行为。 例如，不要想当然地以为始终会自动选中新建的销售订单。 请始终改用筛选器查找正确订单。
• 任务录制器中的复制功能用于保存新建产品的名称，以便在链式测试用例中使用。
• 任务录制器中的验证功能用于设置检查点来验证是否已正确运行了步骤。

RSAT

• 若要在另一个公司中运行测试，可以在 Excel 参数文件的常规选项卡上更改公司。 确保新选择的公司中有设置和数据。
• 可在 Excel 参数文件的常规选项卡上更改测试用户。 指定将运行测试用例的用户的电子邮件 ID。 这样，就可以通过使用所指定用户的安全权限运行测试用例。
• 若要在开始测试之前等待，可在 Excel 参数文件的常规选项卡上定义暂停。 可在批处理作业中使用此暂停（例如，如果必须向运行工作流，才能执行下一个步骤。）

高级脚本

CLI

可以从命令提示符 或 PowerShell 窗口调用 RSAT。

注释

请验证环境变量 TestRoot 是否设置为 RSAT 安装路径。 （在 Microsoft Windows 中，打开控制面板，选择系统和安全 > 系统 > 高级安全设置，然后选择环境变量。）

1. 以管理员身份打开命令提示符或 PowerShell 窗口。

2. 浏览至 RSAT 安装目录。

   cd "c:\Program Files (x86)\Regression Suite Automation Tool\"
   

3. 列出所有命令。

   C:\Program Files (x86)\Regression Suite Automation Tool>Microsoft.Dynamics.RegressionSuite.ConsoleApp.exe help
   
   Usage:
       Microsoft.Dynamics.RegressionSuite.ConsoleApp.exe command
       or
       Microsoft.Dynamics.RegressionSuite.ConsoleApp.exe /settings "C:\Path to\file.settings" command
   
   Available commands:
       ?
       about
       cls
       download
       downloadsuite
       edit
       generate
       generatederived
       generatetestonly
       generatetestsuite
       help
       list
       listtestplans
       listtestsuite
       listtestsuitebyid
       listtestsuitenames
       playback
       playbackbyid
       playbackmany
       playbacksuite
       playbacksuitebyid
       quit
       upload
       uploadrecording
       usage
   

?

列出所有命令或显示特定命令的帮助以及可用参数。

Microsoft.Dynamics.RegressionSuite.ConsoleApp?[command]

?：可选参数

command：其中 [command] 是前面列表中的命令之一。

关于

显示已安装 RSAT 的版本。

Microsoft.Dynamics.RegressionSuite.ConsoleAppabout

cls

清除屏幕内容。

Microsoft.Dynamics.RegressionSuite.ConsoleAppcls

下载

将指定测试用例的附件（录制、执行和参数文件）从 Azure DevOps 下载到输出目录。 您可以使用 list 命令获取所有可用的测试用例，然后使用第一列中的任何值作为 test_case_id 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleAppdownload[/retry[=<seconds>]] [test_case_id] [output_dir]

download：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，下载过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。

download：必需参数

• test_case_id：表示测试用例 ID。

download：可选参数

• output_dir：表示输出工作目录。 该目录必须存在。 如果未指定此参数，将使用设置中的工作目录。

download：示例

download 123 c:\temp\rsat

download /retry=240 765

downloadsuite

将指定测试套件中所有测试用例的附件（录制、执行和参数文件）从 Azure DevOps 下载到输出目录。 您可以使用 listtestsuitenames 命令获取所有可用的测试套件，然后使用任何值作为 test_suite_name 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleAppdownloadsuite[/retry[=<seconds>]] ([test_suite_name] | [/byid] [test_suite_id]) [output_dir]

downloadsuite：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，下载过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。
• /byid：此切换指示所需的测试套件由其 Azure DevOps ID 标识，而不是测试套件名称。

downloadsuite：必需参数

• test_suite_name：表示测试套件名称。 如果未指定 /byid 切换，此参数是必需的。 此名称是 Azure DevOps 测试套件名称。
• test_suite_id：表示测试套件 ID。 如果指定了 /byid 切换，此参数是必需的。 此 ID 是测试套件 Azure DevOps ID。

downloadsuite：可选参数

• output_dir：表示输出工作目录。 该目录必须存在。 如果未指定此参数，将使用设置中的工作目录。

downloadsuite：示例

downloadsuite NameOfTheSuite c:\temp\rsat

downloadsuite /byid 123 c:\temp\rsat

downloadsuite /retry=240 /byid 765

downloadsuite /retry=240 /byid 765 c:\temp\rsat

编辑

允许您在 Excel 程序中打开和编辑参数文件。

Microsoft.Dynamics.RegressionSuite.ConsoleAppedit[excel_file]

edit：必需参数

• excel_file：必须包含现有 Excel 文件的完整路径。

edit：示例

edit c:\RSAT\123\TestCase_123_Base.xlsx

edit e:\temp\TestCase_456_Base.xlsx

generate

在输出目录中为指定的测试用例生成测试执行和参数文件。 可使用 list 命令获取所有可用的测试用例。 将第一列的任何值用作 test_case_id 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleAppgenerate[/retry[=<seconds>]] [/dllonly] [/keepcustomexcel] [test_case_id] [output_dir]

generate：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，生成过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。
• /dllonly：仅生成测试执行文件。 不会重新生成 Excel 参数文件。
• /keepcustomexcel：升级现有参数文件。 还重新生成执行文件。

generate：必需参数

• test_case_id：表示测试用例 ID。

generate：可选参数

• output_dir：表示输出工作目录。 该目录必须存在。 如果未指定此参数，将使用设置中的工作目录。

generate：示例

generate 123 c:\temp\rsat

generate /retry=240 765 c:\rsat\last

generate /retry=240 /dllonly 765

generate /retry=240 /keepcustomexcel 765

generatederived

生成所提供测试用例的新派生测试用例（子测试用例）。 新测试用例还会被添加到指定的测试套件中。 您可以使用 list 命令获取所有可用的测试用例，然后使用第一列中的任何值作为 test_case_id 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleAppgeneratederived[/retry[=<seconds>]] [parent_test_case_id] [test_plan_id] [test_suite_id]

generatederived：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，生成过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。

generatederived：必需参数

• parent_test_case_id：表示父测试用例 ID。
• test_plan_id：表示测试计划 ID。
• test_suite_id：表示测试套件 ID。

generatederived：示例

generatederived 123 8901 678

generatederived /retry 123 8901 678

generatetestonly

仅为指定的测试用例生成测试执行文件。 不会生成 Excel 参数文件。 文件在指定的输出目录中生成。 您可以使用 list 命令获取所有可用的测试用例，然后使用第一列中的任何值作为 test_case_id 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleAppgeneratetestonly[/retry[=<seconds>]] [test_case_id] [output_dir]

generatetestonly：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，生成过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。

generatetestonly：必需参数

• test_case_id：表示测试用例 ID。

generatetestonly：可选参数

• output_dir：表示输出工作目录。 该目录必须存在。 如果未指定此参数，将使用设置中的工作目录。

generatetestonly：示例

generatetestonly 123 c:\temp\rsat

generatetestonly /retry=240 765

generatetestsuite

为指定测试套件中的所有测试用例生成测试自动化文件。 您可以使用 listtestsuitenames 命令获取所有可用的测试套件，然后使用任何值作为 test_suite_name 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleAppgeneratetestsuite[/retry[=<seconds>]] [/dllonly] [/keepcustomexcel] ([test_suite_name] | [/byid] [test_suite_id]) [output_dir]

generatetestsuite：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，生成过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。
• /dllonly：仅生成测试执行文件。 不会重新生成 Excel 参数文件。
• /keepcustomexcel：升级现有参数文件。 还重新生成执行文件。
• /byid：此切换指示所需的测试套件由其 Azure DevOps ID 标识，而不是测试套件名称。

generatetestsuite：必需参数

• test_suite_name：表示测试套件名称。 如果未指定 /byid 切换，此参数是必需的。 此名称是 Azure DevOps 测试套件名称。
• test_suite_id：表示测试套件 ID。 如果指定了 /byid 切换，此参数是必需的。 此 ID 是测试套件 Azure DevOps ID。

generatetestsuite：可选参数

• output_dir：表示输出工作目录。 该目录必须存在。 如果未指定此参数，将使用设置中的工作目录。

generatetestsuite：示例

generatetestsuite Tests c:\temp\rsat

generatetestsuite /retry Purchase c:\rsat\last

generatetestsuite /dllonly /byid 121

generatetestsuite /keepcustomexcel /byid 121

help

与 ? 命令相同。

列表

列出当前测试计划中所有的可用测试用例。

Microsoft.Dynamics.RegressionSuite.ConsoleApplist

listtestplans

列出所有可用的测试计划。

Microsoft.Dynamics.RegressionSuite.ConsoleApplisttestplans

listtestsuite

列出指定测试套件的测试用例。 您可以使用 listtestsuitenames 命令获取所有可用的测试套件，然后使用列表中的任何值作为 suite_name 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleApplisttestsuite[test_suite_name]

listtestsuite：必需参数

• test_suite_name：所需套件的名称。

listtestsuite：示例

listtestsuite "sample suite name"

listtestsuite NameOfTheSuite

listtestsuitebyid

列出指定测试套件的测试用例。

Microsoft.Dynamics.RegressionSuite.ConsoleApplisttestsuitebyid[test_suite_id]

listtestsuitebyid：必需参数

• test_suite_id：所需套件的 ID。

listtestsuitebyid：示例

listtestsuitebyid 12345

listtestsuitenames

列出当前测试计划中所有的可用测试套件。

Microsoft.Dynamics.RegressionSuite.ConsoleApplisttestsuitenames

playback

播放与指定 Excel 参数文件关联的测试用例。 此命令使用现有的本地自动化文件，不从 Azure DevOps 下载文件。 POS 商务测试用例不支持此命令。

Microsoft.Dynamics.RegressionSuite.ConsoleAppplayback[/retry[=<seconds>]] [/comments[="comment"]] [excel_parameter_file]

playback：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，播放过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。
• /comments[="comment"]：提供自定义信息字符串，该字符串将包含在 Azure DevOps 测试用例运行的摘要和测试结果页面上的注释字段中。

playback：必需参数

• excel_parameter_file：Excel 参数文件的完整路径。 此文件必须存在。

playback：示例

playback c:\RSAT\2745\attachments\Create_Purchase_Order_2745_Base.xlsx

playback /retry e:\temp\test.xlsx

playback /retry=300 e:\temp\test.xlsx

playback /comments="Payroll solution 10.0.0" e:\temp\test.xlsx

playbackbyid

同时播放多个测试用例。 测试用例由它们的 ID 标识。 此命令将从 Azure DevOps 下载文件。 您可以使用 list 命令获取所有可用的测试用例，然后使用第一列中的任何值作为 test_case_id 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleAppplaybackbyid[/retry[=<seconds>]] [/comments[="comment"]] [test_case_id1] [test_case_id2] ... [test_case_idN]

playbackbyid：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，播放过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。
• /comments[="comment"]：提供自定义信息字符串，该字符串将包含在 Azure DevOps 测试用例运行的摘要和测试结果页面上的注释字段中。

playbackbyid：必需参数

• test_case_id1：现有测试用例的 ID。
• test_case_id2：现有测试用例的 ID。
• test_case_idN：现有测试用例的 ID。

playbackbyid：示例

playbackbyid 878

playbackbyid 2345 667 135

playbackbyid /comments="Payroll solution 10.0.0" 2345 667 135

playbackbyid /retry /comments="Payroll solution 10.0.0" 2345 667 135

playbackmany

同时播放多个测试用例。 测试用例由 Excel 参数文件标识。 此命令使用现有的本地自动化文件，不从 Azure DevOps 下载文件。

Microsoft.Dynamics.RegressionSuite.ConsoleAppplaybackmany[/retry[=<seconds>]] [/comments[="comment"]] [excel_parameter_file1] [excel_parameter_file2] ... [excel_parameter_fileN]

playbackmany：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，播放过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。
• /comments[="comment"]：提供自定义信息字符串，该字符串将包含在 Azure DevOps 测试用例运行的摘要和测试结果页面上的注释字段中。

playbackmany：必需参数

• excel_parameter_file1：Excel 参数文件的完整路径。 此文件必须存在。
• excel_parameter_file2：Excel 参数文件的完整路径。 此文件必须存在。
• excel_parameter_fileN：Excel 参数文件的完整路径。 此文件必须存在。

playbackmany：示例

playbackmany c:\RSAT\2745\attachments\Create_Purchase_Order_2745_Base.xlsx

playbackmany e:\temp\test.xlsx f:\RSAT\sample1.xlsx c:\RSAT\sample2.xlsx

playbackmany /retry=180 /comments="Payroll solution 10.0.0" e:\temp\test.xlsx f:\rsat\sample1.xlsx c:\RSAT\sample2.xlsx

playbacksuite

播放一个或多个指定测试套件中的所有测试用例。 如果指定了 /local 切换，将使用本地附件进行播放。 否则，将从 Azure DevOps 下载附件。 您可以使用 listtestsuitenames 命令获取所有可用的测试套件，然后使用第一列中的任何值作为 suite_name 参数。

Microsoft.Dynamics.RegressionSuite.ConsoleAppplaybacksuite[/updatedriver] [/local] [/retry[=<seconds>]] [/comments[="comment"]] ([test_suite_name1] .. [test_suite_nameN] | [/byid] [test_suite_id1] .. [test_suite_idN])

playbacksuite：可选切换

• /updatedriver：如果指定了此切换，在运行播放流程之前，将根据需要更新 Internet 浏览器的 webdriver。
• /local：此切换指示应使用本地附件进行播放，而不是从 Azure DevOps 下载文件。
• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，播放过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。
• /comments[="comment"]：提供自定义信息字符串，该字符串将包含在 Azure DevOps 测试用例运行的摘要和测试结果页面上的注释字段中。
• /byid：此切换指示所需的测试套件由其 Azure DevOps ID 标识，而不是测试套件名称。

playbacksuite：必需参数

• test_suite_name1：表示测试套件名称。 如果未指定 /byid 切换，此参数是必需的。 此名称是 Azure DevOps 测试套件名称。
• test_suite_nameN：表示测试套件名称。 如果未指定 /byid 切换，此参数是必需的。 此名称是 Azure DevOps 测试套件名称。
• test_suite_id1：表示测试套件 ID。 如果指定了 /byid 切换，此参数是必需的。 此 ID 是测试套件 Azure DevOps ID。
• test_suite_idN：表示测试套件 ID。 如果指定了 /byid 切换，此参数是必需的。 此 ID 是测试套件 Azure DevOps ID。

playbacksuite：示例

playbacksuite suiteName

playbacksuite suiteName suiteNameToo

playbacksuite /updatedriver /local /retry=180 /byid 151 156

playbacksuite /updatedriver /local /comments="Payroll solution 10.0.0" /byid 150

playbacksuitebyid

运行指定的 Azure DevOps 测试套件中的所有测试用例。

Microsoft.Dynamics.RegressionSuite.ConsoleAppplaybacksuitebyid[/updatedriver] [/local] [/retry[=<seconds>]] [/comments[="comment"]] [test_suite_id]

playbacksuitebyid：可选切换

• /retry[=seconds]：如果指定了此切换，并且测试用例被其他 RSAT 实例阻止，播放过程将等待指定的秒数，然后再尝试一次。 [seconds] 的默认值为 120 秒。 如果没有此切换，当测试用例被阻止时，此过程将立即取消。
• /comments[="comment"]：提供自定义信息字符串，该字符串将包含在 Azure DevOps 测试用例运行的摘要和测试结果页面上的注释字段中。
• /byid：此切换指示所需的测试套件由其 Azure DevOps ID 标识，而不是测试套件名称。

playbacksuitebyid：必需参数

• test_suite_id：表示存在于 Azure DevOps 中时的测试套件 ID。

playbacksuitebyid：示例

playbacksuitebyid 2900

playbacksuitebyid /retry 2099

playbacksuitebyid /retry=200 2099

playbacksuitebyid /retry=200 /comments="some comment" 2099

quit

关闭应用程序。 此命令仅在应用程序以交互模式运行时有用。

Microsoft.Dynamics.RegressionSuite.ConsoleAppquit

quit：示例

quit

upload

将属于指定测试套件或测试用例的附件文件（录制、执行和参数文件）上载到 Azure DevOps。

Microsoft.Dynamics.RegressionSuite.ConsoleAppupload([test_suite_name] | [test_case_id1] .. [test_case_idN])

upload：必需参数

• test_suite_name：将上载属于指定测试套件的所有文件。
• test_case_id1：表示应上载的第一个测试用例 ID。 应仅在未提供测试套件名称时再使用此参数。。
• test_case_idN：表示应上载的最后一个测试用例 ID。 应仅在未提供测试套件名称时再使用此参数。。

upload：示例

upload sample_suite

upload 2900

upload 123 456

uploadrecording

仅将属于一个或多个指定测试用例的录制文件上载到 Azure DevOps。

Microsoft.Dynamics.RegressionSuite.ConsoleAppuploadrecording[test_case_id1] .. [test_case_idN]

uploadrecording：必需参数

• test_case_id1：表示应上载到 Azure DevOps 的录制的第一个测试用例 ID。
• test_case_idN：表示应上载到 Azure DevOps 的录制的最后一个测试用例 ID。

uploadrecording：示例

uploadrecording 123

uploadrecording 123 456

usage

显示此应用程序的三种使用模式。

Microsoft.Dynamics.RegressionSuite.ConsoleAppusage

以交互方式运行应用程序：

• Microsoft.Dynamics.RegressionSuite.ConsoleApp

通过指定命令来运行应用程序：

• Microsoft.Dynamics.RegressionSuite.ConsoleApp [command]

通过提供设置文件来运行应用程序：

• Microsoft.Dynamics.RegressionSuite.ConsoleApp/settings [drive:\Path to\file.settings] [command]

Windows PowerShell 示例

循环运行测试用例

您有一个测试脚本用于创建新客户。 通过脚本，可以在运行每个迭代之前随机化以下数据来运行此测试用例。

• 客户 ID
• 客户名称
• 客户地址

客户 ID 的格式为 ATCUS<number>，其中， <number> 是一个 000000001 与 999999999 之间的值。

以下示例使用一个参数 start 定义使用的第一个数字。 使用第二个参数 nr 定义必须创建的客户数量。 对于每个迭代，可使用 UpdateCustomer 函数更改 Excel 参数文件中的参数。 然后，在 RunTestCase 函数中调用 RSAT 命令行。

在管理模式下打开 Microsoft Windows PowerShell 集成脚本环境 (ISE)，然后将以下代码粘贴到名称为 Untitled1.ps1 的窗口中。

param ( [int]$start = 1, [int]$nr = 1 )
function UpdateCustomer
{
    param ([string]$paramFilename, [string]$sheetName, [string]$CustId)
    $xl = New-Object -COM "Excel.Application"
    $xl.Visible = $false
    $wb = $xl.Workbooks.Open($paramFilename)
    $ws = $wb.Sheets.Item($sheetName)
    $ws.Cells.Item(3, 2).Value = "ATCUS" + $CustId
    $ws.Cells.Item(4, 2).Value = "Automated Test Customer " + $CustId
    $ws.Cells.Item(8, 2).Value = "Automated Test Street " + $CustId
    $wb.Save()
    $wb.Close()
    $xl.Quit()
    [System.Runtime.Interopservices.Marshal]::ReleaseComObject($xl)
}
function RunTestCase
{
    param ( [string]$filename )
    $cmd = "cd c:\Program Files (x86)\Regression Suite Automation Tool\ &&  "
    $cmd = $cmd + "Microsoft.Dynamics.RegressionSuite.ConsoleApp.exe playback "
    $cmd = $cmd + $filename
    cmd /c $cmd
}
$excelFilename = "full path to Excel parameter file"
l$sheetName = "DirPartyQuickCreateForm"
for ($i = $start; $i -lt $start + $nr; $i++ )
{
    $CustomerId = $i.ToString("000000000")
    Write-Host "customer : " $CustomerId
    UpdateCustomer $excelFilename $sheetName $CustomerId
    RunTestCase $excelFilename

在 Microsoft Dynamics 365 中运行依赖数据的脚本

以下示例使用开放数据协议 (OData) 调用查找采购订单的订单状态。 例如，如果状态不是已开票，则可调用 RSAT 测试用例以过帐发票。

function Odata_Get
{
    Param ( [string] $environment, [string] $cmd )
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    $tenant = "your tenant"
    $creds = @{
        grant_type = "client_credentials"
        client_id = "your client application Id"
        client_secret = "your client secret"
        resource = $environment
    }
    $headers = $null
    $bearer = Invoke-RestMethod https://login.microsoftonline.com/$tenant/oauth2/token -Method Post -Body $creds -Headers $headers;
    $headers = @{
        Authorization = "Bearer " + $bearer.access_token
    }
    $Odata_cmd = $environment + '/data/' + $cmd
    return (Invoke-RestMethod -Uri $Odata_cmd -Method Get -Headers $headers -ContentType application/json )
}
function PurchaseOrderStatus
{
    Param ( [string] $environment, [string] $purchaseOrderNumber )
    $cmd = 'PurchaseOrderHeaders?$filter=PurchaseOrderNumber eq '
    $cmd = $cmd + "'" + $purchaseOrderNumber + "'"
    $response = Odata_Get -environment $environment -cmd $cmd
    return $response.value.PurchaseOrderStatus
}
$environment = "https://your environment"
$orderStatus = PurchaseOrderStatus -environment $environment -purchaseOrderNumber '000003'
if ($orderStatus -eq $null) {   write-host 'doesn''t exist'}
elseif ($orderStatus -ne 'invoiced') { RunTestCase "PostInvoice" }