Docs

First Steps

Welcome to SystemTestPortal!

This tutorial shows the usage of SystemTestPortal (STP). As an example we want to test the search engine DuckDuckGo.org. Make sure the system is installed and running.

Register / Sign In

First of all, you have to sign in to STP. Otherwise you can't create or edit any data.

Either you ask a registered user to register you or just use our default user. (Email: default@example.org, Password: default)
Click on "Sign In"

Insert your e-mail address and your password and click on "Sign In"

Create

Create a project

All testing related to DuckDuckGo.org will be contained in a project.

To create this project click on the " + New Project" button.
Insert a name and a description and click on "Create Project"

Create a test case

Let’s create our first test case!

Click on "+ New Test Case"
Insert a name, a description and conditions for the test case. Next add some test steps to your test case by clicking on "Add Test Step".
Fill in a task description and what you expect to happen afterwards. Confirm by clicking the OK button. Repeat this as many times as you like to get many test steps.
When you are pleased with the number of test steps save your new test case by clicking the Save button.

But hey, why don't you add some more test cases?

Create a test sequence

You don’t want to execute just single test cases but multiple cases in a row? Create a test sequence!

Go to the test sequences by clicking on the Sequence tab.
Click on "+ New Test Sequences"
Insert a name, a description and conditions for the test sequence. Now click on "Add Test Case" for adding some test cases to the sequence.
Add all test cases you want to have in this sequence. In this example we add all test cases regarding searching. Confirm the dialog and save the sequence by clicking the Save button.

Execute

Enough preparation done, let’s get to the execution.

Execute a test case

We want to execute the case “Change Theme”. Therefore, we go to the test case list (tab “Test Cases”) and click on the test case we want to execute. ‚Äč

On the overview page, there is a Start button. Click it to execute the case.
Choose the version of the system that you are testing and insert the environment you are testing in. Afterwards click on “Next”.
This is the first test step. First perform the step task (1.), then compare your result with the expected result (2.). If you like, you can add your actual result (3.) and/or notes (4.) to the test step. Rate the test step and choose an adequate result from the list (5.). Proceed to the next step by clicking “Next” (6.).
For all coming steps, proceed as in the first step. Perform task, check expected result, write actual result and note, select result and continue to next step.
When you worked through all steps of the case the summary page is shown. Here you can see a list of all test step results and can also have a look at your written notes and actual results by expanding the list item. After you looked through the results you can write notes and also choose a summary result for the whole test case.

Execute a test sequence

Executing test sequences is quite similar to executing test cases. A test sequence simply groups test cases in a given order.

First go to the overview page of the sequence you want to execute und click on "Start".
Like in test case execution, a start page is shown where you can get some general information and insert the version of the system that you are testing as well as the environment you are testing in. Confirm by clicking "Next".
After the start page of the sequence itself, the start page of the first step appears. Since you already gave information like version and environment, this is just for you information.
Hooray! We made it to the first test step! Just like before perform task, check expected result, write actual result and note, select result and continue to next step. At the end of the first test case a summary page will be shown and afterwards the system will continue with the start page of the next test case.
When you worked through all cases with all their steps, you will see the summary page of the test sequence with a list of all executed test cases. Complete the test sequence execution by clicking the Finish button.

View Protocols

You want to have a look on the protocols of already executed tests? Ok, we will go to the protocols.

Switch to the "Protocols" tab, choose if you want to look for case or sequence protocols and select the case/sequence you want.
Now a list of all protocols for the selected case/sequence is shown. You can filter the protocols at the right side bar. Click on a protocol for a detailed view.
In the detailed view of the protocol you can read through all information you gave during the execution.

Sign out

Ok, enough testing done for today. Time to log out and call it a day.

Click on your user name in the top right corner and on "Sign Out" in the emerging dropdown.