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和其他主题。如有任何疑问,请评论,谢谢!