使用 Test Studio

项目
04/18/2023

在本快速入门中，您将为名为 Kudos 的画布应用创建测试。您还可以浏览和发现测试概念，并将其应用于为自己的画布应用编写测试。示例 Kudos 应用是员工参与应用套件的一部分，可从员工体验初学者套件中下载。

观看此视频，了解如何使用测试工作室：

打开 Test Studio

登录到 Power Apps。
创建新应用或编辑现有应用。
将应用保存到 Power Apps 以打开 Test Studio。

备注

必须先保存应用，然后才能为应用编写测试。
在左侧导航栏中，选择高级工具。
选择打开测试，为此应用程序打开 Test Studio。此操作将在新的浏览器选项卡中打开 Test Studio。

备注

测试将发布并存储在应用包中。将画布应用包导出和导入到其他环境中时，还将包含所有测试定义，如您创建的测试套件和测试用例。

创建测试套件

默认将在 Test Studio 中为您创建测试套件和测试用例。测试套件用于将测试用例组织到一起。一个应用可以包含一个或多个测试套件。您可以使用默认测试套件和测试用例来立即开始编写测试，也可以创建新的测试套件。

选择新建套件。
在主网格中选择字段，更新测试套件名称和描述。

创建测试用例

根据测试的组织或分组方式，您可以在测试套件中创建多个测试用例。每个用例都可以测试应用中的特定功能或功能子集。

选择测试套件。
在顶部菜单中选择新建用例，创建一个新用例。
在主网格中选择字段，更新测试用例名称和描述。

新建测试用例。

录制测试用例

测试用例由包含各种操作的测试步骤组成。测试操作使用执行任务的 Power Apps 表达式编写。与应用交互时，可以使用录制器自动生成测试步骤。记录后，可以更新测试用例，添加新步骤，删除步骤，以及编写验证测试结果的测试断言。

备注

仅在录制模式下播放已发布的应用。在开始录制测试用例之前，应向应用发布任何最近的更改。录制而不发布最近的更改会导致上次发布的应用版本在录制模式下播放。

在顶部菜单中选择录制。此操作将在新的浏览器选项卡中使用录制模式打开已发布的应用。

重要

在现有测试用例上进行录制会覆盖已存在的任何现有测试步骤。
与应用交互。您的操作在左侧窗格中录制。
交互完成后，选择完成。（可选）可以选择取消返回 Test Studio，这将不会录制交互。
查看在 Test Studio 中自动生成的测试步骤和表达式。
如有必要，编辑主网格中的步骤描述文本。您还可以通过在主网格中选择公式来更新测试步骤操作。

添加测试步骤和测试断言

每个测试用例都应有预期结果。在 Kudos 示例中，发送 Kudo 的一个预期结果是在 Microsoft Dataverse (Dataverse) 数据库中创建一条新记录。现在，您将更新测试用例并添加其他测试步骤来验证记录是否创建成功。

请按照以下步骤来验证记录是否创建成功：

在测试用例开始时，初始化数据库中 Kudo 记录计数的变量。
在测试用例结束时，初始化数据库中 Kudo 记录计数的变量。
编写测试断言表达式，验证计数是否递增。如果计数不递增，则测试断言失败，并且您的测试用例会失败。

要在 Kudos 应用中添加测试步骤和测试断言，请执行以下操作：

选择步骤 1 或要在其上方插入新步骤的步骤。
在顶部菜单中选择在上方插入一个步骤或从活动行中选择选项。此操作将创建一个空步骤。

备注

选择在上方插入一个步骤后，将在当前步骤的上方添加一个新的空步骤。您还可以改用 Assert、SetProperty、Select 或 Trace 操作。这会添加带有可编辑的相应操作公式的步骤。
更新步骤描述。例如，“在数据库中对 Kudo 记录计数”。
在执行测试前，在操作输入中输入表达式或公式以对数据库中的记录进行计数。

您可以使用支持的任何表达式。还可以查询应用中包含的任何数据源、集合、变量或运行流，以及创建要在测试中使用的新的全局变量或集合。
```
Set(kudosBeforeTest, CountRows(Filter(Kudos, Receiver.Email = "someone@example.com")))```
```
Select Step 2 or the step above which you want to insert a new step.
Select Insert a step above from the top menu or by selecting the option from the active row. This action creates an empty step.
Enter an expression or formula in the action input to Trace and write the kudosBeforeTest value to test the results record.
```
Trace("kudosBeforeTest : " & kudosBeforeTest);
```
测试完成后，转到测试用例的底部并插入一个新步骤，以对数据中的记录进行计数。
```
Set(kudosAfterTest, CountRows(Filter(Kudos, Receiver.Email = "someone@example.com")))```
```
Add a final step to validate that the record count in the database has increased by a count of 1, and enter the following assertion action to verify:
```
Assert(kudosAfterTest = kudosBeforeTest + 1, "Kudos count incorrect. Expected : " & kudosBeforeTest + 1  & " Actual :" & kudosAfterTest)
```
在 Test Studio 的右上方菜单中保存测试用例。

播放测试

您可以播放录制的测试来验证应用功能。您可以播放单个测试套件或单个测试用例中的所有测试。

在播放包含最近更改的录制之前，必须发布该应用：

播放但不发布。

重要

如果跳过发布，录制播放将不包含最新的测试更改。将对应用播放最近发布的测试用例或测试套件。

选择发布自动保存并发布测试。
选择测试套件或单个测试用例。
选择播放。已发布的应用将在播放模式下打开，并且您可以看到测试步骤自动播放。绿色的复选标记指示测试步骤执行成功。如果某个步骤失败，将显示一个红色失败指示器以及一条失败消息。
选择完成返回 Test Studio。

失败的断言

在本部分中，您将更改测试断言以体验失败的测试：

选择表达式框，以编辑断言步骤。
在测试操作中将 + 1 更新为 + 2。此更新意味着测试需要创建两条记录，这是不正确的。如果测试成功，则只应在数据库中创建一条记录。
```
Assert(kudosAfterTest = kudosBeforeTest + 2, "Kudos count incorrect. Expected : " & kudosBeforeTest + 2  & " Actual :" & kudosAfterTest)
```
选择发布。
选择播放。
查看正在播放的测试。最后一个步骤会失败，并显示一个错误以及在断言步骤中提供的消息。

在浏览器中播放测试

您可以复制链接，以在 Test Studio 外的单独浏览器中播放测试。这有助于在持续生成和发布管道（如 Azure DevOps）中集成测试。

选定测试的播放链接保持不变。它不会因测试套件或测试用例而更改。您可以更新测试，而无需修改生成和发布过程。

要在浏览器中播放测试，请执行以下步骤：

在右窗格中选择测试套件或测试用例。
选择复制播放链接。
如果有任何未发布的更改，系统会提示您发布测试。
您可以选择跳过发布过程并复制播放链接。如果跳过，新的测试更改将不会播放。
打开浏览器并将 URL 粘贴到地址栏中，以播放测试。
查看正在播放的测试。

设置测试

测试套件的 OnTestCaseStart 属性可用于设置测试。在案例开始执行之前，为此属性输入的表达式会为套件中的每个测试案例触发。 OnTestCaseStart 可帮助您避免在每个案例开始时编写相同的测试步骤。您可以自定义此属性来运行套件中所有案例通用的设置任务，如：

始终从第一个屏幕开始执行测试。
初始化通用集合或变量。
从数据源中获取测试数据以用于当前正在执行的测试

TestCaseInfo 记录包含正在执行的当前测试的详细信息。其中包含以下属性：

TestCaseName – 测试用例的名称。
TestCaseDescription – 测试案例的说明。
TestCaseId – 测试用例的 ID。
TestSuiteName – 用例所属的测试套件名称。
TestSuiteDescription – 测试套件的说明。
TestSuiteId – 用例所属的测试套件 ID。

在下面的示例中，您将自定义 OnTestCaseStart 属性，让每个测试案例从应用中的第一个屏幕开始。您还将从可以在测试案例的步骤中引用的数据源获取测试数据。

在左侧窗格中选择测试，或选择套件标头上的查看。
选择 OnTestCaseStart 操作。

输入一个表达式导航到第一个屏幕，并为您的测试获取测试数据。

//Start every cases on the first screen in the Kudos app
Navigate('Dashboard Screen');

//Initialize my test data for the current case. 
Set(currentTestData, LookUp(KudosTestData, TestCase = TestCaseInfo.TestCaseName));

//Set kudosBeforeTest to 0
Set(kudosBeforeTest, 0)

OnTestCaseStart 示例。

处理测试结果

使用浏览器时，在 Test Studio 中播放测试时可见的测试面板将不可见。由于此行为，不能确定执行的特定测试步骤，也不能确定测试是通过还是失败。

要确定 Test Studio 外的测试结果，可以在测试对象中使用名为 OnTestCaseComplete 和 OnTestSuiteComplete 的两个属性，您可以使用这些属性来处理测试结果。将测试集成到持续生成和发布管道（如 Azure DevOps）中时，可使用这些属性确定是否应继续进行应用部署。

每个用例或套件完成时，将触发为这些属性输入的表达式。您可以自定义这些属性，以处理测试结果并将其发送到各种数据源或服务，例如：

SQL Server。
Dataverse。
Power Automate。
使用 Office 365 发送电子邮件。

这些设置适用于应用中的每个测试套件或测试用例。每个测试套件或测试用例完成后，可在 TestCaseResult 和 TestSuiteResult 记录中获得测试结果和测试中包含的任何跟踪消息。

TestCaseResult 记录包含以下属性：

TestCaseName – 测试用例的名称。
TestCaseDescription – 测试案例的说明。
TestCaseId – 测试用例的 ID。
TestSuiteName – 用例所属的测试套件名称。
TestSuiteDescription – 测试套件的说明。
TestSuiteId – 用例所属的测试套件 ID。
StartTime – 测试的开始执行时间。
EndTime – 测试的结束执行时间。
Traces – 任何测试断言的结果和来自 Trace 函数的任何消息。
Success – 指示测试用例成功完成。
TestFailureMessage – 如果用例失败，则为失败消息。

TestSuiteResult 记录包含以下属性：

TestSuiteName – 测试套件名称。
TestSuiteDescription – 测试套件的说明。
TestSuiteId – 测试套件 ID。
StartTime – 测试套件的开始执行时间。
EndTime – 测试套件的结束执行时间。
TestsPassed – 套件中成功完成的测试用例数。
TestsFailed - 套件中失败的测试用例数。

在本快速入门中，您将在 Dataverse 数据库中创建两个自定义表，来通过自定义 OnTestCaseComplete 和 OnTestSuiteComplete 属性存储测试结果：

在左侧窗格中选择测试，或选择套件标头上的查看。
选择 OnTestCaseComplete 操作。

输入用于处理测试结果的表达式。下面的示例将每个测试案例的结果保存到 Dataverse 中的自定义 AppTestResults 表。可以选择将测试结果存储到 SQL、SharePoint 或任何其他数据源。可能需要根据需要在数据源中设置或增加 Trace 字段。

备注

以下示例连接到 Microsoft Dataverse。您可以创建简单应用或使用 Dataverse 从头开始构建应用。另外，请参阅 Patch 函数引用，详细了解如何修改以下示例中使用的数据源记录。

//Save to Dataverse
Patch(AppTestResults
, Defaults(AppTestResults)
, {
         TestPass: TestCaseResult.TestCaseName & ":" & Text(Now())
         ,TestSuiteId: TestCaseResult.TestSuiteId
         ,TestSuiteName: TestCaseResult.TestSuiteName
         ,TestCaseId: TestCaseResult.TestCaseId
         ,TestCaseName: TestCaseResult.TestCaseName
         ,StartTime: TestCaseResult.StartTime
         ,EndTime: TestCaseResult.EndTime
         ,TestSuccess: TestCaseResult.Success
         ,TestTraces: JSON(TestCaseResult.Traces)
         ,TestFailureMessage: TestCaseResult.TestFailureMessage
}
);

OnTestCaseComplete 示例。

选择 OnTestSuiteComplete 操作。

输入用于处理测试结果的表达式。在以下示例中，您将每个测试套件的结果保存到 Dataverse 中的自定义 AppTestSuiteResults 表中。

//Save to Dataverse
Patch(AppTestSuiteResults
    , Defaults(AppTestSuiteResults)
    , {
         TestSuiteId: TestSuiteResult.TestSuiteId
         ,TestSuiteName: TestSuiteResult.TestSuiteName
         ,StartTime: TestSuiteResult.StartTime
         ,EndTime: TestSuiteResult.EndTime
         ,TestPassCount: TestSuiteResult.TestsPassed
         ,TestFailCount: TestSuiteResult.TestsFailed
    }
);

OnTestSuiteComplete 示例。

可以在这些属性中使用的其他表达式示例包括：

在 Power Automate 中将结果发送到流。
```
MyTestResultsFlow.Run(JSON(TestCaseResult))
```

通过电子邮件发送结果。

Office365.SendMailV2("someone@example.com", "Test case results", JSON(TestCaseResult, JSONFormat.IndentFour))

接收测试结果的应用通知。

例如，在 Test Studio 外的浏览器中播放测试时，测试完成后会收到通知。

Notify(TestCaseResult.TestCaseName & " : "
        & If( TestCaseResult.Success
            , " Passed"
            , TestCaseResult.TestFailureMessage)
        ,If(  TestCaseResult.Success
            , NotificationType.Success
            , NotificationType.Error)
)

测试函数

除 Power Apps 中可用的函数外，以下是编写测试时通常会使用的常用函数。

后续步骤

使用经典编辑器使用 Azure Pipelines 自动执行测试

备注

您能告诉我们您的文档语言首选项吗？进行简短调查。（请注意，此调查是英文版调查）

此调查大约需要七分钟。不会收集个人数据（隐私声明）。

通过