Variables Parameters and Scenarios

One of the most important aspect in any framework is how to declare or extract variables and how to pass them as parameters to different functions. Testerum allows you to do this in an easy manner.

Environments and Global Variables

img 1

In the Variables popup (img 2) you can define your Environments and the variables assigned to them.

img 2

Before reaching the production, a particular software version will be deployed on multiple environments like:

For each environment you will probably need to define a set of variables that will be used by you tests. For example: application URL, database URL, database password, etc. Testerum comes with two environments predefined:

• Default - the variables defined in this environment will be shared with your team and will be inherited in all the other environments
• Local - the variables defined in this environment are local only to your computer and will not be shared with the team

How to use variables

A variable can be used with the following pattern: {{variable_name}} Example: Given you have declared the Global or Scenario Variables: URL, USER_NAME and PASSWORD then you can use them like in the following test (img 3)

img 3

Parametrization

In this chapter we will show you how to create Custom Steps with parameters.

Definitions:
    Custom Steps are the steps defined by you that reflects your business model.
    Basic Steps are the pre-built steps that are shipped with Testerum and are technology integrations.

img 4

• by replacing 'admin' with a parameter called <<userName>>
• by replacing 'test123' with <<password>>

img 5

img 6

To define a Parameterized Composed Step you have to use the following pattern: <<parameter_name>> After adding the parameters <<userName>> and <<password>>, these can be accessed from the sub-steps as we access any variable, by enclosing them inside double curly brackets {{userName}}, {{password}} (img 7)

img 7

Now, the step definition should look like this: When I fill in <<userName>> as user name and <<password>> as password It has two parameters which are waiting for some values. (img 8)

img 8

At runtime, the expressions {{userName}}, {{password}} will be evaluated and replace with the values passed to the parent step parameters.

img 9

At this point, basically we are done with the parametrization of this step.
From now on, you can simply reuse it and add different input data.

img 10

Notice: Parametrization merged with Scenarios will make your tests very robust.

Scenarios

Sometimes you want to execute the same test with different parameters. For this, in Testerum, a test can have multiple Scenarios To add a Scenario to your test, press the Add Scenario button.

img 11

When you add a new scenario you can:

• Set a name for this scenario
• Add parameters to this Scenario that will be used in the test

img 12

When you add a parameter you need define the Name, Type and Value (img 13):

img 13

If you define a Test with multiple Scenarios, your Test Steps will be executed once for each Scenario. (img 14)

img 14

There is no need to lose time writing again ang again the same test case which contains different input data. Scenarios provides a cleaner then to copy-paste your Tests with different parameters. Follow this approach and you will reduce significantly the effort in writing and maintaining your automated tests. (img 15)

img 15

Text vs JSON Parameter Type

A Scenario Parameter Type can have two possible values: Text and JSON On how to use the Text Type see the above example. Choosing the Type as JSON gives you some extra flexibility and might be a very good option for complex cases where you have many parameters. (img 16)

img 16

Defining a parameter like in the (img 16) allows you to access the values in a more dynamic way:

1. {{person.firstName}} will return "Robert"
2. {{person.address.city}} will return "Manchester"
3. {{person.address}} will return  { "city": "Manchester", "street": "Buckland Hills", "postCode": "CT 6040", "houseNumber": "420" }