The purpose of this library is to provide Dynamics customers the ability to facilitate automated UI testing for their projects. These API's provide an easy to use set of commands that make setting up UI testing quick and easy. The functionality provided covers the core CRM commands that end users would perform on a typical workday and working to extend that coverage to more functionality.
Supported Operating System
Windows 10 , Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2
Supported Visual studio
Microsoft Visual Studio 2015, Microsoft Visual Studio 2017
Easy Repro supports below CRM Versions
- Microsoft Dynamics 365 Online Version 8.2 (8.2.x) (DB 8.2.x) online
- Microsoft Dynamics 365 Online Version 9.0 (9.0.x) (DB 9.0.x) online
- Microsoft Dynamics 365 Online Version 9.0.2 (9.0.2) (DB 9.0.2) online
- Microsoft Dynamics 365 Online Version 9.1 (9.1.x) (DB 9.1.x) online
Selenium Webdriver & Support
|File Name||Version||Release date|
|Selenium.WebDriver||v3.11.2||April 12, 2018|
|Selenium.Support||v3.11.2||April 12, 2018|
CRM Functionality Covered
- Activity Record Wall
- Business Process Flow
- Entities (Create, Update, Delete, Duplicate Detection, Assign)
- Global Search
- Guided Help
- Performance Center
- Quick Create
- Run Workflows
- Run Reports
CRM Functionality Not Covered
- Settings Area (Administration)
- Advanced Find Query execution(Open Advanced Find is available)
- Export to Excel
- Other Add on Applications
Although we don't have specific commands to cover the above funcationality, we have generic commands that will allow you to still interact with those features.
- Microsoft Edge Browser, based on Chromium, is currently not supported.
- Firefox has sometimes been inconsistent with testing results. The click command is inconsistent. This is a known issue and has been reported to that team that manages that driver.
- IE Driver has a 32-bit version and a 64-bit version. If you're using the 32-bit version on 64-bit windows with 64-bit IE then the driver will not work as intended. Use the appropriate version of IE Driver with the specific version of IE.
The Sample project should have NUGET packages added and you just need to build the solution and restore the packages. For the specific browser drivers, you can add them using NUGET. The default driver is Chrome and the NUGET package is already installed on the Sample project.
Run the Sample Project
Change the keys in your
app.config below to match your environment. Open the Test explorer window. Right click and run one test to ensure everything works. Trying the
CreateAccount test under
Microsoft.Dynamics365.UIAutomation.Sample.Web is a good start.
<add key="OnlineUsername" value="email@example.com" /> <add key="OnlinePassword" value="*********" /> <add key="OnlineCrmUrl" value="https://org.crm.dynamics.com/" />
If the account you are using has MFA (Multi-Factor Authentication) enabled, you will also need to provide an MFA Secret Key. You can obtain an MFA secret key for your account using these instructions - you will need Microsoft's Authenticator App to get this working:
- Go to your Office365 'Security info' page at: https://mysignins.microsoft.com/security-info
- Enter your O365 login and password
- Click 'Add method' and select "Authenticator app" in Combobox, click Add
- Click on "I want to use a different authenticator app" link if you want to use not 'Microsoft Authenticator' authenticator app
- Click on the 'Next' button, click on the 'Next' button
- Click on 'Can't scan image?'
- Make a note of the 'Code' which is displayed
- Click the '+' to add an account and select 'work or school account'
- Scan the QR code displayed on the web page
- If the App displays a six-digit code, click 'Next' on the web page
- Enter the six-digit verification code from the app into the web page and Click the 'Next' button
- Add your MFA Secret key from step 8 with the spaces removed to your app.config as shown below, in the same section that you add your username and password
<add key="MfaSecretKey" value="MfaSecretKeyWithSpacesRemoved" />
Supported Browser WebDriver
The application supports following browser:
|Chrome||ChromeDriver||v.126.96.36.199||April 21, 2018|
|Firefox||GeckoDriver||v.0.16.1||April 27, 2017|
|IE||IEDriver||v.3.4||April 22, 2017|
|Edge||MicrosoftWebDriver||v.10.0.15063.0||April 18, 2017|
Browser Driver Download and install instructions
If you want to download the drivers manually you can go to the specific driver download links and put them in the bin folder of your project.
Download the Chrome Web driver from the below link Download chrome driver
Download the IE Web driver from the below link Download IE driver
The Firefox web driver can be installed through Nuget package manager.
- In Visual studio ,Go to Tools -> NuGet Package Manager -> Manage Nuget Packages for the solution FileName : Selenium.WebDriver.GeckoDriver.Win64
Click on the below link to download Edge driver Download Edge driver