Steps Database

Testomat.io offers functionality for test steps re-using and autocompletion. This feature helps you save time during test cases creation and make the process faster.

How to Add a New Step to the Steps Database

There are few ways to create steps in the Steps Database from the ‘Steps’ page:

Option 1

1. Open ‘Steps’ page.
2. Enter the step into the empty field.
3. Click ‘Create’ button.

Option 2

1. Open ‘Steps’ page.
2. Сlick ‘Plus’ button.
3. Select ‘Step’ option from the dropdown list to add context to the step.

After the ‘New Step’ screen is displayed:

4. Add the step.
5. Add a step description to describe in which context this step can be used (optional).
6. Click ‘Save’ button.

The new step has been created!

Note

You can create Steps for BDD Projects in the same way as for Classical Projects, following the same rules.

How to Add a New Step in Editor for Classical Tests

Create your steps while writing your classical tests! Testomat.io Editor gives the ability to save your test description as steps directly to the Steps Database.

Open Test Case Editor and create new steps by starting the line with the asterisk sign * or a numbered list (e.g., 1.).

Save the test, and the new steps will be added in the Database.

Note

Only steps created in the Test Editor using * or number list under a step header (e.g., ## Steps) will be created/saved in the Steps Database.

Note

If your recently added steps are not displaying in the autocomplete list, you need to refresh steps in the Steps Database to see them. To do this:

Open ‘Steps’ page (1) -> Click ‘Extra menu’ button (2) -> Select ‘Refresh Steps’ option (3).

How to Reuse Steps from Steps Database

Testomat.io recommends reusing steps instead of creating new ones.

Next time you need to use the same step, start typing the step inside the Editor. Use the asterisk sign * for an unordered list or number with dot (e.g., 1.) for an ordered list. The Editor will display the autocomplete list with matching steps. Select the step from the autocomplete list to add it to your test case.

You can also use the ‘Add Steps (ordered)’ or ‘Add Steps (unordered)’ buttons in the Editor panel to trigger the autocomplete list with all available steps.

Note

When you use the ‘Add Steps (ordered)’ or ‘Add Steps (unordered)’ buttons the ’## Steps’ header will be added automatically if it wasn’t previously added manually or via a template.

How to Add a New Step in Editor for BDD Tests

The Testomat.io BDD Editor automatically creates steps and adds them to the Steps Database once a Scenario or Feature File is saved. You do not need to add BDD steps separately.

Note

Don’t include Given/When/Then in a step. Each step can be used in any of these contexts.

How To Rename A Step

You may need to update existing steps to suit new project requirements. You can rename required steps on the ‘Steps’ page. This action automatically updates all tests containing changed step, so you do not need to change each test individually.

1. Open ‘Steps’ page.
2. Click on the Step you want to update.
3. Click ‘Edit’ button in the displayed window.

4. Update the Step’s name.
5. Click ‘Save’ button.

6. Confirm the action on the displayed pop-up.

7. Check description for related Test Cases after the Step is renamed.

How to Merge Steps

There might be a situation when there are a few similar steps in the Steps Database. You can use ‘Merge’ feature to unite them into one step, to keep your tests clean. This feature is available for Classical and BDD projects.

1. Open ‘Steps’ page.
2. Enable ‘Multi-select’.
3. Select the Steps you want to merge.
4. Select ‘Merge’ option from the bottom menu panel.

5. Enter the Step that you want to keep (the first step will be pre-selected by default, but you can change it manually based on your needs).
6. Click ‘Merge’ button.

Note

After your steps are Merged, the description of all tests where these steps are used will be updated.

How to Delete Unused Steps

It might be the case when you deleted some test cases, and now some steps are unnecessary. To keep your Steps Database clean, you can delete unused steps.

1. Open ‘Steps’ page.
2. Click ‘Extra menu’ button.
3. Select ‘Delete Unused Steps’ option.

4. Confirm action on the displayed menu.

All unused Steps deleted from Steps Database.