Test Lists

Test lists are at the core of test case management. Create test cases and test suites and store them as test lists. Test lists provide a way to save grouped test suites and cases for manual testing. Create as many test lists as you want.

Test lists can be imported into manual test runs. Test lists save testers time by removing the need for repeated manual data entry, a tester can simply modify the result outcome only and upload any appropriate new files as they work their way through a test list.

Lists are stored permanently and are never deleted unless a team member intentionally deletes a list or the project is deleted.

Creating lists

Access lists by going to the results view page and clicking 'lists' from the side bar. Only team members assigned a moderator (level 2) role or above can upload manual test results.

If it is the first time anyone from the project is accessing lists there will be no lists:

Click the 'Create new list' button to create a new test list.

Select a name for the new test list, this is the name that you will later use to look up the test list whenever you want to edit it or import the list into a test run.

The new list will now appear in the dropdown list under 'Selected list', however it will not contain any test cases yet.

Adding cases manually

Ensure the list that you want to modify is selected. Click the 'Add case' button.

When adding test cases manually you can specify the following for each test case:

Click the 'Save case' button to add the case to the list.

Importing cases from targets

Another way to add test cases is to import cases from the latest results from any of the project targets. Ensure the list you want to modify is selected.

Click the 'Import from target' button.

Select a project target from the dropdown list. The latest results will be displayed. Click 'Import' to import the tests to the list.

Importing test cases from csv files

Another way to add test cases is to import them from a csv file. This can be a useful way to add test cases if you already have test cases in a spreadsheet or another system.

Click the 'Import from CSV' button.

Click the 'Choose file' button and to select a csv file. Test cases will be extracted and displayed. Click 'Confirm import' to complete import to the selected list.

You must ensure the csv file is formatted correctly.

The first row must be a header row with the field names:

name
result
suite
desc
reason
_Custom

The name and result fields are required.

Result must be one of: [pass, fail, unknown] and is used to assign a default value to a test case.

The suite field is useful for grouping test cases into test suites, desc is a description of the test case, and reason is a failure reason. You can also have any number of custom fields, these fields must start with an underscore. For example: _customField

If you have any problems importing from a csv file please contact help@tesults.com and we will be happy to assist you.

Importing test cases with CSV files makes it easy to migrate to Tesults if you are coming from a test case management system like TestRail. Simply export your test cases from the other system, and then change the headers in the CSV file to match to what Tesults requires. For TestRail specifically, in the exported CSV from TestRail, change the 'Title' header to 'name', change 'Section' to 'suite', change 'Steps' or 'Preconditions' to 'desc', add a new column called 'result' and set every row to 'pass' and finally add an underscore (_) prefix to every other column so that all other fields are imported as custom fields. Then the updated CSV file can be imported into Tesults from the List interface. Importing from TestRail to Tesults Lists can take just a few minutes.

Editing cases

Edit cases by clicking on them to select them and then clicking the 'Edit' button. You can also choose to remove a case from the test list by clicking the 'Delete' button.

Exporting lists

Click the 'Export to CSV' button to export the selected list as a csv file. This is useful if you want to get test cases out of Tesults for use elsewhere.

Using lists

Test lists can be imported into manual test runs.

By doing this, testers save time because the test plan is clearly laid out and very little manual entry is required. Tests can simply be marked pass or fail (with a failure reason) and necessary files can be added ad hoc.

Deleting lists

Click the 'Delete list' button to delete a test list. There is usually no reason to delete a test list. You can have as many test lists as you want.