Skip to main content

Creating the steps bank

A very handy feature of Dentest is its steps bank. With it, no more pain when it comes to find the right existing steps for your scenario.

Displaying the steps drawer#

To see the steps bank, your feature must be in "draft" mode.

The drawer is divided in three parts : a button to create a new step, a filters subdivision, and finally the list of existing steps, sorted by adverb (Givens, Whens and Thens). Each step item is prefixed by an icon representing the extra param it needs (none, multiline or table).

Creating a new step#

In Gherkin, a step is divided in three parts:

  • An adverb.
    • Given: the step will define an initial situation
    • When: the step will define an action
    • Then: the step will define an expected result
  • A sentence. A sentence can contain parameters within it.
  • An optional extra parameter.
    • A paragraph
    • A table

The adverb#

Just pick the accurate adverb in the dedicated select box

The sentence#

Type the sentence in the input.

To declare inline parameters, highlight part you want to make variable. A button to extract the param will show up.

Click it, and the input will be split to welcome the newly created param. To remove it, just click the cross within the corresponding input.

Under the param input, you can decide if you prefer having a free-text param, or a constrained one, with a list of predefined values.

The extra parameter#

Then, select the extra parameter type this step will welcome. When choosing this step in your scenarios, an extra field will be created if you don't select the "none" type.

If you chose the table type, you'll be able to define, like in inline params, a data template. This will allow you to choose the headers of the table, and for each cell, if it should be a free text or a set of predefined options. Use options as much as you can, as it helps a lot your pairs when they will need to write new scenarios.

Tags#

You can add tags to your step. Tags will help you retrieve easily your steps in the steps bank. Choose them wisely

Updating an existing step#

To update an existing step, just click on it in the steps bank. A dialog will open, and you'll be able to edit some parts, but not to resplit the step.

Removing a step#

Same, click on it in the bank, and hit the "Delete step" button. A step can not be deleted if it is used somewhere.