Quick Start - How to write a Test Case?


Table of Contents

1. Define and Execute a Test Case
1.1. First Steps to write a Test Case
1.2. Create a Project
1.3. Create a Test Environment
1.4. Create a System under Test
1.5. Define the Test Case
1.6. Create Test Steps
1.7. Execute Test Case
1.8. Show Test Result

1. Define and Execute a Test Case

1.1. First Steps to write a Test Case

In this step-by-step guide we show you how to write a test case, assign test steps to it, execute the test case and view the evaluation.

Four objects must be created to execute a manual test case:

  1. The project in which all other objects are saved.

  2. One or more test environments in which the test case is to be executed, such as operating systems or browser variants.

  3. The test system, (also test object, system under test, test object)

  4. The test case itself with its process description, which is divided into individual test steps.

Create Project -> Create Test Environment -> Define System under Test -> Define Test Case -> Add Test Steps -> Execute Test Case -> View Result Report

1.2. Create a Project

We start with the creation of the project. Projects are the units that combine all test-related objects into a specific test project. In our example a time recording software is to be tested.

Create a Project

Figure 1. Create a Project


Define -> Projects -> New -> Description: "Test time recording software" Save

Select the Activate this project function to the far left of the Project ID or to the left of the Action column. The selected project now appears - as long as it is selected - in the project selection at the top right.

1.3. Create a Test Environment

Next, the test environment is created. In Klaros-Testmanagement a test environment summarizes the definition of external circumstances that can influence the test result. This could be the operating system, a physical environment, the version of a customer system or, as in ourExample, the web browser.

Create a Test Environment

Figure 2. Create a Test Environment


Define -> Test Environments -> New -> Description: "Chrome" -> Save

1.4. Create a System under Test

Now we need the test system. Other terms are also used for this: system to be tested, test system, system under test, test object. This refers to the identification of the system/object to be tested. Here we use the version number of the time recording software.

Create a System under Test

Figure 3. Create a System under Test


Define -> Systems under Test -> New -> Version: "Clockify Version 2.45 2.45" -> Save

1.5. Define the Test Case

Now the actual test case with the detailed test instructions is still missing.

Define the Test Case

Figure 4. Define the Test Case


Define -> Test Cases -> New -> Name: "Record Time" -> Execution: Manual -> Save

1.6. Create Test Steps

At least one test step must be created so that the tester knows which work steps to perform. We insert two steps here.

Now click on the edit icon ("Edit this test case") in the column Action and you will get to the "Overview" page of the test case. Here we select the tab Steps.

Create Test Steps

Figure 5. Create Test Steps


Steps -> New -> Action "Login with Username and Password" -> Save

Create Test Steps

Figure 6. Create Test Steps


New -> Action "Record 2 hours working time" -> Save

[Note] Note

With Change view mode a compressed tab view is displayed. This is especially useful for many test steps.

The "Record time" test case in the "Test time recording system" project now contains its minimum specifications and can be executed. For this purpose we switch to the Execute section.

1.7. Execute Test Case

Execute Test Case

Figure 7. Execute Test Case


In the Community Edition, you can go directly to the submenu item Run Test Case. In the Enterprise Edition select Run Test Case from the side menu.

Confirm Execution Parameters

Figure 8. Confirm Execution Parameters


Execute -> Execute Test Cases -> Action: Execute -> A dialog opens -> Entries can be checked -> Execute -> A new browser window (testrunner) opens.

[Note] Note

A separate window for executing the test case now opens. Please make sure that your browser allows popup windows to be opened.

The tester is now guided step by step through the test case while the results are automatically recorded. For a better overview, two possible representations can be shown here can be selected: "Detailed" and "Tabular". If required, the application window can now be minimized to leave the screen free for executing the test steps.

Execute Test Step 1

Figure 9. Execute Test Step 1


Step 1 - Click

Execute Test Step 2

Figure 10. Execute Test Step 2


Step 2 - Click Passed

End Test Execution

Figure 11. End Test Execution


Click OK to confirm

Before the test case execution is finished, additional information can be added or binaries can be attached to the test case result.

Now we open the application window again. After clicking on Close the execution of the test case is terminated and you will now see the current results.

Exit -> Close -> Switch to the application window.

1.8. Show Test Result

Select the Test Result

Figure 12. Select the Test Result


For this we select the area Evaluate -> Test Case Results and get to the overview page of all test case results. In our example, only one result exists. Clicking on the plus icon in the turquoise bar displays further information. In the example, however, no test case attributes have been created yet, so most of the fields are empty.

Now select in the column Action the magnifying glass symbol to get to the detail page "Test Case Results".

Test Result Details Page

Figure 13. Test Result Details Page


All test case results of the selected test case are displayed here. Since the test case was executed only once, only one result is listed here. A further click on the magnifying glass symbol takes you to the detail page of the test case result.

If it should become necessary that the test step result is changed again, this is possible in the table below. The test case result is permanently marked as changed using a light bulb symbol. The changes are also logged in the " Changes tab.

In the action column, an attachment can still be uploaded if needed.

Test Result Details

Figure 14. Test Result Details


[Important] Alternative

Alternatively, the result can also be displayed by clicking on the number "1" in the overview view under the column "Results". You return to the area Define -> Test Cases -> Test Case Results. Here you select the magnifying glass symbol and return to the Evaluate.

Clicking on the bookmark symbol in the upper action bar creates a permanently valid URL for this test result. This will be copied directly to the clipboard and can be sent to team members.

A click on the print symbol creates an optimized view of the test result and can be printed directly from the browser.

The first test case has now been successfully created, executed and evaluated. Its result can be sent as a link or printed as a document.