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

  • Download Visual Studio (Community Edition is enough) from the Microsoft website.

  • After VS is installed, install the TestResults.io extension by following these steps:

    • 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

Step 2 - Create a TestResults.io solution

  • 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 the TestSolution

  • Enter the name of solution and press OK

Step 3 - Connect to your TRIO server

  • From the TestResults.io top menu (Visual Studio 2017) or from the Extensions-->TestResults.io menu (Visual Studio 2019) select the Connections tab.

  • In the Connections tab select Servers

  • Add a new TestResults.io server

  • Enter the server name and your credentials and confirm the action with the Add button

  • After adding the server your connections tab will look like this

Step 4 - Connect to your Customer and Project

  • Select the Projects tab

  • Select the desired Customer

  • Select the desired Project

  • After a successful selection the tab will look as follows

Step 5 - Download the TestResults.io Engine

  • Select the Engines tab

  • Select the Download button next to the latest engine version

  • After a successful download the tab will look as follows

Step 5 - Add a TestResults.io test case to your solution

  • Open the Solution Explorer

  • Right click on the solution (top node)

  • From the TestResults.io context menu select the New Test Case project option

  • When prompted select the test case which has been added in the portal and afterwards select Add

  • The test case will be added to the solution. The solution explorer will look as follows:

Step 6 - 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 Environments tab.

  • 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 7 - Take a picture of any control in the Test Environment

  • Double click on the added test env.

  • Once the Remote Viewer is opened switch to 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 8 - Modify the test case

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

  • Replace the content of the TestCase class as follows:

[SetupTest]
public bool Setup(ITester t)
{
return true;
}
[TestStep(1,
TestInput = "First Test input",
ExpectedResults = "First Expected Result")]
public void Step1(ITester t)
{
t.Testee.Mouse.Click(TestImages.TC001_Rev1.Images.TestImage);
t.Report.PassStep("First run");
}

Step 9 - 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 10 - Generate and publish your test case container

  • Open the Solution Explorer

  • Right click on the test case project

  • From the TestResults.io context menu select the Generate Test Case test container option

  • 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.