First Steps

A short, 25 minutes guide to your first test case in TestResults.io Designer.

This is a direct continuation of the First Steps with the TestResults.io portal chapter. The section below shows you how to create and publish a test case in the TestResults.io designer.

Keep in mind - this chapter only shows a brief summary of how to work with the Designer. For more details refer to the Getting started chapter

Step 1 - Download Visual Studio and TestResults.io Designer

Visual Studio 2017

Visual Studio 2019

  • In Visual Studio go to Tools --> Extensions and Updates

  • Select Online extensions

  • Search for "testresults"

  • Select "Designer for TestResults.io" from the list and click the Download button

  • The TestResults.io extension will be installed automatically upon the next Visual Studio restart

  • You can verify the successful installation of the TestResults.io designer by accessing the Extension and Updates in Visual Studio and checking if you see the extension in the Installed section

  • In Visual Studio go to Extensions --> Manage Extensions

  • Select Online extensions

  • Search for "testresults"

  • Select "Designer for TestResults.io" from the list and click the Download button

  • The TestResults.io extension will be installed automatically upon the next Visual Studio restart

  • You can verify the successful installation of the TestResults.io designer by accessing the Extenstions --> Manage Extensions screen in Visual Studio and checking if you see the extension in the Installed section

Step 2 - Create a TestResults.io solution

Visual Studio 2017

Visual Studio 2019

  • Go to File-->New-->Project from the Top Menu

  • On the left hand side expand the Installed-->Visual C# node and select the TestResults.io node

  • Select TestResults.io solution

  • Enter the name of solution and press OK

  • From the VS 2019 splash screen select Create a new project

  • In the Create new project dialog type in TestSolution in the search field

  • Select TestResults.io solution and press the Next button

  • Enter the Project name and press Create

Step 3 - When prompted Enter the License information in the window

  • If you are a new user without a TestResults.io account, select the New User button and follow the instructions on the screen

  • If you already have a TestResults.io account, select the Existing User button and follow the instructions on the screen

  • Once finished you will see the following information:

Step 4 - Select the Project you will work with

Select the Project you want to work with. Afterwards Select the SW Model you want to create and the first test case you would like to start developing.

Step 5 - Add a Test Environment

  • From the TestResults.io top menu (Visual Studio 2017) or from the Extensions-->TestResults.io menu (Visual Studio 2019) select the Test Environments tab (more information about the Test Environments can be found here)

  • Add a new Environment

  • Enter the Env. details i.e. name, address, credentials and the selected protocol

  • Once the test environment has been successfully added the tab will look as follows:

Step 6 - Take a picture of any control in the Test Environment

  • Double click on the added test env.

  • Once the Remote Viewer is opened ensure you are in Capture mode

  • Using your mouse, mark a rectangle around any control visible in your test environment

  • Select Save Image on the right side of the Remote Viewer

  • Enter any name of for the taken image e.g. TestImage

Step 7 - Modify the test case

  • In the Solution Explorer, open the class representing the test case

  • Replace the content of the TestCase class as follows:

[TestCase(1)]
public class YourTestCaseClass
{
[TestStep(1,
TestInput = "First Test input",
ExpectedResults = "First Expected Result")] public void Step1(ITester t) { t.Testee.Mouse.Click(Images.TestImage); t.Report.PassStep("First run"); }
}

Step 8 - Run the test case

  • Hit the F5 button

  • Observe the execution of the test case (clicking on the selected control) in the Remote Viewer

Step 9 - Publish your test case container

  • Open the Solution Explorer

  • Right click on the test case project

  • From the TestResults.io context menu select the Publish newest test container option

Your test case has been published to the TestResults.io server and is now available for execution in the TestResults.io portal.