A test case execution on a run-time can include or skip execution of specific step or tasks as per the specified condition is satisfied.

Key Points

• You can add If-Else block to a task and test case much like conditional structures used in programming languages, with a limitation that nested IF blocks are not supported.

• If block has the following structure:

  • IF – ELSE IF –ELSE – ENDIF

  • You can add zero or more occurrences of ELSE-IF and zero or exactly one occurrence of ELSE. Zero or multiple occurrences of IF blocks can be added to a task.

• It is mandatory to add expression to evaluate for IF and ELSE IF steps. You cannot save these tasks with blank expressions.

• Expressions are much like the ones used in programming languages.

• You can form conditions based on the status of previous step, values of environment variables/stored variables and arithmetic, logical and bitwise operators.

• You can avoid adding a task for adding a single step to test case. A step can be directly added to a test case. It is possible to specify object, action, and parameters to a TC step just like a task step.

Adding Conditional Structures

...

On the task editor screen, click the Add Conditional Block button () to select any of the following conditions:

• IF

• Else IF

• Else

Adding Expression for IF Step

• Click the Add Conditional Block button, select IF.

• You can add Else block within an IF block. 

Forming Expression for IF /ELSE IF:

Expressions can be entered for IF and ELSE IF conditional step. User can use stored variables, environment variables as expressions.

1. Ensure that it is part IF/Else is added after an IF statement.

2. You can use Numeric, Boolean comparisons, string values, and arithmetic operators.

3. Environment variables and stored variables should be included in curly braces in expression.

4. User can save the execution status of last executed step as anyone of the following.

   • Using $$_STATUS directly in expression

   • Saving status of step {$$_STATUS} for use as an expression.
     User can save the execution status of a step in variable. This status can later be used as an expression of IF step.

   • Saving execution status for future reference. You need to use StoreVariable Action and in the second parameter column enter as "{$$_Status}".  For more information about $$_Status and similar variables, refer to Qualitia System Variables. 

Examples of Expressions:

The following are some examples of valid/invalid expressions, assuming var1 and var2 as stored variables.

Note

1. The static or dynamic string data used should always be enclosed within double-quotes.

2. The expression, having string as data, should always be enclosed within double-quotes.

3. Boolean values are case-sensitive and should be used in lower case.

Adding the Task Step on the TC Screen

...

The TC step can be added at any position, after or before a task or even as a first step of test case.

To add TC step:

• Focus on task and click the TC Step button. You can then use Up and Down buttons to move the step up or down. 

Adding A TC Step and Task Step

• To add an independent TC step, click  the Test Case Step button (

  Image Modified

  ).

• To add a step into a task, click the Task Step button (

  Image Modified

  ).

Storing Execution Status of TC Step

...

You can add the TC or Task condition using the ELSE-IF button from the Test cases screen.Image Removed

...

To add TC or Task Condition:

1. Select TC Step/Task after which you wish to add TC level conditional block.

2. Click Add Conditional Block >TC Condition > IF.

3. .Select IF step of block, click the TC Step button to add TC step.

4. Select recently added TC Step:

   1. Click Add Condition Block >TC Condition >ELSE IF to add TC level ELSE IF block.

   2. Click Add Condition Block >TC Condition > ELSE to add ELSE block.
      Note: If you want to add an Else-If or Else condition, it must be added after the If condition. 

...

Adding Tasks in Test Case Level ELSE-IF Blocks

...

To add tasks in TC level ELSE-IF blocks:

1. Select TC Step/Task after which you want to add TC level conditional block.

2. Click Condition >TC Condition > IF.

3. Select IF step of block and then click New to add new task or Import to add the existing task to the conditional block.

4. To add Tasks to ELSE-IF or ELSE blocks, select the ELSE-IF or ELSE step of the conditional block.

5. Do one of the following to include  a task:

   • To add a new task, click the New Task button (

     Image Modified

     ). 

   • To add an existing task, click the Import Task button (

     Image Modified

     ).
     

     Note: If you want to add an Else-If or Else condition, it must be added after If condition. 

...

To add conditional blocks to a task from the Test case:

1. Create a new test case and add required tasks to it. 

2. Select the step after which the conditional block needs to be added, or the task row to which the block needs to be added.

3. Click the Add Conditional Block button > Task Condition > IF.

4. Once If block is added to task, ELSE IF or ELSE blocks can be added by selecting proper task step and using the ELSE-IF button. 

5. For adding expression, double-click IF or ELSE IF.

6. Use the syntax of expression is as described earlier.

Execution flow of conditional (ELSE-IF) blocks will be as follows:

1. Qualitia validates expression entered by the user and checks if the expression is empty or contains assignment (for example, if user entered a=b which is invalid). Expressions should not have assignment, users should use "==" operator instead. Hence {a}={b} is invalid expression.

2. Rest of the syntax and semantics is checked during the actual execution of test case.

3. You must enclose stored variables, environment variables in curly braces (for eg: {a}=={b}, or ($$_Status}==0.

4. Consider the following test case level conditional block:

   1. OpenUrl

   2. IF {$$_Status}==0
      Task1
      Task2

   3. ELSE IF {$$_Status}==1
      Task3

   4. ELSE
      Task4

   5. END IF

If during execution, the step OpenUrl is successful, then Task1, Task2 is executed.

...

Qualitia's Behavior in case of Invalid Expression:

• If the expression is invalid, for example, expression has stored variables referred but not declared, or the syntax of expression is invalid then the test case is considered to have an error and Qualitia will stop execution of test case.

• When execution is triggered using the Dry Run button from the Develop tab and if the expression is invalid, Qualitia stops execution of test case.

• When execution is triggered using the Run Now button from the Execute tab and if the expression is invalid, Qualitia executes next test case. If there is only one test case, execution will be stoppped. 

In all such cases, Error log in reports will explain the reason of execution failure so that users can take corrective actions.

...

The steps in conditional block are mentioned in the report only if expression evaluates to "true". Steps of blocks whose expression evaluates to "false" are omitted from report as these steps are not executed.Image Removed

...

Handling Special Characters In Conditional Expression

...

As shown in the screenshot below, if you are using values like single quotes, double quotes or backslash in conditional expression, you need to use escape character (/).Image Removed

...

Limitations

• Nested IF blocks are not allowed

• Task level IF, ELSE IF or ELSE blocks can be moved up or down within the task whereas test case level IF, ELSE IF or ELSE blocks cannot be moved up or down.

• $$_Status can be used only for step's execution status. There is no provision to store or refer Task's execution status.

• A test case level step cannot be moved to task, or multiple test case level steps cannot be moved to new or existing tasks.

Frequently Asked Questions for Conditional Steps

...