EasyRepro与测试自动化（一）概览

EasyRepro是一个框架，允许在特定的Dynamics 365组织上执行自动化UI测试。你可以使用它来自动化冒烟测试、回归测试和负载测试等。该框架是由开源项目Selenium构建的，Selenium在业界的各种项目和应用程序中有着广泛应用。

整个EasyRepro框架都是开源的，可在GitHub上获得。本文的目的是逐步介绍EasyRepro框架的设置。本文假设读者已经掌握某些概念，例如如何在Visual Studio中使用单元测试，如何下载NuGet软件包以及从GitHub克隆repo。

本文链接：https://www.cnblogs.com/hhelibeb/p/13556244.html

英文原文：Test Automation and EasyRepro: 01 - Overview and Getting Started

现在，你已经对EasyRepro的用处有了基本的了解，可能想开始使用它了。

启动和运行EasyRepro非常简单，因为该框架在设计时就考虑了灵活性和敏捷性。但是，像使用其他实用程序一样，要开始使用EasyRepro，需要学习一些东西和克服一些障碍。让我们从依赖关系开始！

准备

依赖

第一个依赖项涉及EasyRepro程序集和Selenium框架。

第二个涉及.NET，特别是.NET框架（可以使用.NET核心并将其作为功能分支包含在内！）。

最后，根据你使用框架的方式，你会希望有一个测试框架来设计，构建和运行单元测试。

选择如何使用EasyRepro框架

使用EasyRepro框架有两种方法，一种是直接使用NuGet软件包，另一种是从GitHub repo克隆或下载。具体选择主要取决于你希望了解还是扩展框架。直接使用源代码可以探索EasyRepro如何与Dynamics 365进行交互。但是，如果是为了扩展框架，使用NuGet软件包并在顶部进行构建的方法可以提高灵活性。

使用NuGet软件包管理器下载

EasyRepro框架入门的最快方法是直接将NuGet包引用添加到你的单元测试项目。可以通过在NuGet软件包管理器命令行中运行以下命令来执行此操作：

创建单元测试项目，然后导航到NuGet软件包管理器CLI。使用Install-Package命令获取PowerApps.UIAutomation.Api软件包，如下面的命令所示（v9.0.2是撰写本文时的最新版本，请参阅此链接以获取任何更新：

Install-Package PowerApps.UIAutomation.Api -Version 9.0.2

这将立刻提供使用框架所需的引用。安装后，应该将以下软件包下载到单元测试项目中：

完成后，所需的程序集就可以用了，因此可以开始使用EasyRepro框架。需要一些设置才能让框架连接到Dynamics 365组织，如果你是该框架的新手，可能不了解设置选项的意义。如果是这样，建议你看下一部分，该部分将启动EasyRepro框架的克隆，包括大量的示例单元测试，这些示例单元测试显示了如何与框架进行交互。

从Github克隆

我认为，如果你是该框架的新手，这是开始熟悉其工作原理以及如何构建各种单元测试的最佳方法。如果你想了解EasyRepro是如何基于Selenium框架构建以及如何扩展的，这也是正确路径。

首先，请访问位于https://github.com/Microsoft/EasyRepro的官方EasyRepro项目。打开后，需要查看分支。分支采用GitFlow方法构建，因此，如果您要使用Dynamics 365的最新版本，请查看releases / *分支。对于最新的开发，我建议develop分支。

首先从本地克隆项目开始，以检查内容并观察框架之间如何进行交互。

下面的gif显示了克隆到Azure DevOps的功能，当然也支持直接从GitHub本地克隆。

从Azure DevOps本地克隆

我强烈建议的方式是克隆到Azure DevOps项目，然后在本地对其进行克隆。这将使我们能够自动化CI / CD。具体细节将在另一篇文章中介绍。如果您决定从GitHub克隆到Azure DevOps，则下一步是在本地克隆。

下面的gif显示了从Azure DevOps存储库本地克隆。

查看EasyRepro源代码项目

EasyRepro源代码包括一个Visual Studio解决方案，其中包含三个类库项目，一个用于示例单元测试。

统一接口使用的项目是Microsoft.Dynamics365.UIAutomation.Api.UCI和Microsoft.Dynamics365.UIAutomation.Api.Browser。

EasyRepro和单元测试之间的大多数用法将通过Microsoft.Dynamics365.UIAutomation.Api.UCI项目中的对象和命令进行。该项目包含与Dynamics Unified Interface模块和表单进行交互的对象。 Microsoft.Dynamics365.UIAutomation.Api.Browser项目仅限于与浏览器驱动程序和其他内部组件进行交互。

单元测试示例

查看打开Account示例单元测试

单元测试项目Microsoft.Dynamics365.UIAutomation.Sample包含数百个单元测试，这些单元测试可以作为一个很好的学习工具，以更好地了解如何使用EasyRepro框架。强烈建议在开始在测试策略中使用框架前探索这些测试。本质上，许多常规任务和特定任务已经包含在其中，并且可以根据你的需求进行转换。示例包括打开表单（OpenRecord），导航（OpenSubArea）和搜索记录（Search），创建和更新记录（Save）。

在本练习中，我们将打开UCITestOpenActiveAccount单元测试，您可以使用Visual Studio中的“查找”（Ctrl + F）来找到它。找到后，你应该会看到类似以下内容的内容：

跟随单元测试中的步骤，你可以看到它旨在执行基本的用户操作来读取Account。我们首先登录一个组织（登录）。然后，我们继续打开标题为“ Sales”（OpenApp）的UCI应用程序。进入组织后，我们打开“Account”子区域（OpenSubArea），然后在“快速查找”视图（“搜索”）中搜索“Adventure”。最后，我们在快速查找视图结果中打开第一个记录（OpenRecord（0））。

探索测试设置

在当前的样本单元测试项目中，在两个位置测试设置：位于项目根目录中的app.config文件和位于所有测试中的类对象TestSettings.cs文件。
应用程序配置文件
app.config文件包括字符串配置，这些字符串告诉测试要登录的组织，登录的用户以及其他设置，例如运行哪种浏览器以及如何运行测试。

应用配置文件设置

Property	Description
OnlineUsername	String. 测试用户
OnlinePassword	String. 测试用户密码Used to represent the test user password.
OnlineCrmUrl	String. 代表组织Used to represent the organization (例如 https://<your org>.crm.dynamics.com/main.aspx)
AzureKey	String. GUID 代表 Azure Application Insights Instrumentation Key.
BrowserType	String. 枚举类型 Microsoft.Dynamics365.UIAutomation.Browser.BrowserType.
RemoteBrowserType	String. 枚举类型 Microsoft.Dynamics365.UIAutomation.Browser.BrowserType. 只有BrowserType是Remote的时候会用.
RemoteHubServer	String. Selenium 服务器远程 hub URL. 只有BrowserType是Remote的时候会用.

在本文中，我们将把BrowserType设置为“ Chrome”，从而关注通过Google Chrome浏览器在本地简单运行测试。

在app.config文件中，还有三个我们需要修改的设置，分别称为OnlineUsername，OnlinePassword和OnlineCrmUrl。就我而言，我正在使用试用版，如下所示，我正在使用“ user@tenant.onmicrosoft.com”用户名和“ https：// <orgname> .crm.dynamics.com / main.aspx”的URL 。

设置前，

设置后，

测试设置和BrowserOptions对象

另一个关键对象是TestSettings类和其中的各种属性。该类告诉单元测试如何渲染浏览器、浏览器驱动程序的位置以及其他属性。 TestSettings类将需要包含在单元测试项目中，并实例化BrowserOptions对象，如下所示：

在下一篇文章中，我们将探讨这些设置如何改变你使用单元测试的体验，以及有哪些可用的选项。

总结

根据本文，你应该可以立即在Dynamics 365组织中开始使用EasyRepro。后续文章将介绍设计和调试单元测试、扩展EasyRepro代码、使用Azure DevOps和其他主题。如有任何疑问，请评论，谢谢！

Easy Repro