Set up your tools

Visual Studio Community

https://www.visualstudio.com/vs/community

Tips:

Ensure you install the ASP.NET and Web Development, Azure Development, Data storage and processing, and .NET Core cross-platform development packages during the install process. To check this, go to Tools > Get tools and features and check the “workloads” you have.

You’ll also need to add the following extensions to Visual Studio:

  • SpecFlow for Visual Studio 2017

  • NUnit3 Test Adapter

  • NUnit VS Templates

You'll need to install them through the `Tools > Extensions and Updates` menu in the ribbon bar at the top of Visual Studio.

Git

https://git-scm.com/download/win

Tips:

Follow the online instructions to download and install.

CHROME Browser

https://www.google.com/chrome/

Tips:

Follow the online instructions to download and install.

Setup your tools

Postman

https://www.getpostman.com/apps

Tips:

Follow the online instructions to download and install.

Switchy Omega

Install the following extension into Chrome

https://chrome.google.com/webstore/detail/proxy-switchyomega/padekgcemlokbadohgkifijomclgjgif?hl=en

Java 8 JDK

The azure reports mentioned in the manual use Java, so to use it you must have a java development kit installed to use it.

http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

NOTE: You MUST install the jdk NOT the jre.

Tips:

You will need to update your computer environment variables. There are different ways of getting to the environment variables depending on your operating system version, Google ‘environment variables for java installation’ to check what you need to do for yours.

You need to set your JAVA_HOME environment variable to point at your Java 8 directory. This is something like:
C:\Program Files\Java\jdk1.8.0_131

Add the Java bin directory to your PATH environment variable:
%JAVA_HOME%\bin

INSTALL SCOOP

Scoop is a command line installer tool for windows (in our case, it’ll allow us to then install Allure for reporting). https://scoop.sh/

Copy all of the following command and paste it into powershell:

Set-ExecutionPolicy RemoteSigned -scope CurrentUser iex(new-object net.webclient).downloadstring('https://get.scoop.sh')

Other tools

Instructions for dependencies and plugins are provided in the manuals, or included in your repository at the end of the course


Download your Framework

Clone your repository

This is the Test Automation Framework you created on the course.

  1. Start Visual Studio. If there is a pop up the asks you to update licence or for account info, opt to log in. Otherwise, when the application has loaded, select the “login” option on the top right hand side.

  2. Sign in with the account you used/created on the course.

  3. Select File > Open > Open from source control. This will open the Team Explorer tab with “connect” selected in the drop down.

  4. Select “Manage connections” and choose “connect to project” which will open a pop up showing all of the repositories in your account

  5. Select the repository you want, and select “clone”.

  6. Your code will now be copied to your computer (your local repository) and will be shown in your Solution explorer. It will likely be showing you the Folder rather than the solution view, if so Click on the Solutions and Folders message at the top and select the .sln option.

  7. Go to Test > Windows > Test Explorer and then click on Run All in the Test Explorer to check everything is working ok!

Troubleshooting:

  • If Visual Studio doesn’t automatically re-import your packages from NuGet, you may need to do this manually. The easiest way is to go to Tools > NuGet Package Manager > Package Manager Console and type:
    Update-Package -reinstall

  • You’ll need to bring up a local database as we did on the course. Using the NuGet package manager console, (make sure you have the Web project selected) use the commands:
    Add-Migration Initial
    Then:
    Update-Database

  • You may also need to restart Visual Studio.


Allure reports

Please note: Allure reports require a lot of configuration and work to get up and running fully, and are not a part of the course, however it’s a powerful reporting tool and so information is provided here to help you get started. For further info if your reports aren’t working, please see the Allure reporting documentation here: https://docs.qameta.io/allure/

Generating allure reports from Visual Studio with Specflow

  1. Install a Java SDK (allure is Java based) as shown in tools section above

  2. Install the Allure command line tool, you may need to install scoop first: https://docs.qameta.io/allure/#_commandline

  3. In Visual Studio, using NuGet, Install SpecFlow.Allure in the acceptance tests project

  4. An allureConfig.json file should have been added to your project. Edit the allureConfig.json to define the directory that you want the results files to be saved in. If you do not change this, the results will be saved somewhere like:
    C:\User\AppData\Local\Temp\allure-results

  5. Navigate to your project directory on your computer: ‘User Home Directory’\source\repos\ToolsList

  6. Copy the allureConfig.json to the following directory within your project directory: \ToolsList.AcceptanceTests\bin\Debug

  7. Run tests

  8. To see the report, we need to generate it from the json results that were generated in the allure-results during the test run. Open powershell, and type:

    1. allure serve <directory-with-json-results>
      This will generate the report in a temporary folder and open it in a browser all in one command.

      e.g: allure serve C:\User\AppData\Local\Temp\allure-results

    2. Alternatively, you can use the following two commands to create the allure report in a different directory:

      1. allure generate <directory-with-json-results> -o <directory-for-generated-reports>

      2. allure open <directory-for-generated-reports>

      The first command will generate the report in a folder you specify, the second will open it in the browser. This is helpful if you want to share the results from a consistent location.

  9. If you want to remove the generated report data use allure report clean command.

GENERATING ALLURE REPORT FROM XML

  1. Open command prompt, and type:
    allure serve <directory-with-xml-results>

NOTE: Not all XML files are compatible with allure


Keep in Touch

Slack

Safebear slack invite

This is a group chat that includes some of our instructors.

We constantly want to improve our courses and keep them relevant to your job, so we hugely value your feedback.

Call or email us

EMAIL: hello@safebear.co.uk
PHONE: 02921 28 0321

Send us a message

Name *
Name