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 Extensions --> 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 already have a TestResults.io account (which is the case if you followed the first steps tutorial for the portal), select the Existing User button and follow the instructions on the screen

  • If you are a new user without a TestResults.io account, select the New 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 and click Ok.

Step 5 - Connect to 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)

  • Double click on the "Static Image" test environment to connect to it.

Step 6 - Add your first screen

  • Activate the Screen Editor by clicking the button

  • Enter "MyFirstScreen" as the screen name and select Screens in screen location

  • Click the arrow for the Screen loaded image and mark a rectangle around the "Static Test Image" text in the test environment.

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

  • Click Add multiple elements and select Button.

  • Mark another rectangle around the click area (indicated by the large mouse cursor) in the Remote Viewer.

  • Enter "MyFirstButton" as the name of the selected element.

  • Click Add Buttons to Page and then Generate Screen.

Step 7 - Modify the test case

  • In the Solution Explorer, open the class representing the test case (if your test case is "001 - My Test Case", the test case class is called "My_Test_Case.cs" in project TC001_Rev1).

  • Replace the contents of the test step 1 method as follows:

[TestStep(1,
TestInput = "First Test input",
ExpectedResults = "First Expected Result")]
public void Step1(ITester t)
{
App.MyFirstScreen.Activate();
App.MyFirstScreen.MyFirstButton.Click(App.MyFirstScreen.WaitForDisappear);
t.Report.PassStep("Click was successful");
}
  • Delete the PreconditionStep, CleanupStep and TearDown for now. Your TestCase should now look like this, with small changes depending on the name of your test case and software model:

using Progile.ATE.TestFramework;
using MySoftware_Model;
namespace TC001_Rev1
{
[TestCase(1)]
public class MyTestCase
{
private MySoftwareApp App { get; set; }
[SetupTest]
public bool Setup(ITester t)
{
App = new MySoftwareApp(t);
return true;
}
[TestStep(1,
TestInput = "TestInput1",
ExpectedResults = "Expected1")]
public void Step1(ITester t)
{
App.MyFirstScreen.Activate();
App.MyFirstScreen.MyFirstButton.Click(App.MyFirstScreen.WaitForDisappear);
t.Report.PassStep("Click was successful");
}
}
}

Step 8 - Run the test case

  • Press 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 solution (top entry)

  • From the TestResults.io context menu select the Publish All option

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