Run Test Operation

Description

Use the Run Test operation to run any test (or several tests) in your project from the given keyword test.

Operation Result

If the operation runs a test specified by the test name, it returns the same value that the called test returns. For information on how to obtain the result value, see Checking Operation Result.

If the operation runs a test or several tests by tags, it does not return any value.

Scripting Analogue

The operation is analogue to running a test from a script.

Child Operations

The operation cannot have child operations.

Operation Parameters

Specify operation parameters when adding the operation

When you add the operation to a keyword test, TestComplete shows the Select Test dialog where you select a test or a tag to run, or a [Tag expression].

If the selected test has parameters or if you have selected [Tag expression], TestComplete then shows the Operation Properties dialog, in which you can specify parameter values or the tag expression.

Tag expression syntax

Tag expression syntaxTag expression syntax

• Use @ before tag names, that is, use @tag1 rather than tag1.

• To combine tags, use the and, or and not operations, for example:

  @tag1 or @tag2
  @tag1 and not @tag3
  not @tag5

  These operations don’t depend on the scripting language you use in your TestComplete project. That is, for example, in JavaScript projects you should use and, or and not rather than &&, || and !  —

  @tag1 and not @tag2  ← Correct!
  @tag1 && !@tag1      ← Incorrect!

• If needed, you can use braces to group tags, for example:

  @tag1 and (@tag2 or @tag3)
  (@tag1 or not @tag2) and (not @tag3 or @tag4)

Modify parameters

Remarks

• You can also create the Run Test operation from the Project Explorer. To do this, drag the needed project item (a low-level procedure, network suite job or unit test) from the Project Explorer to the desired location in a keyword test that is open in the Keyword Test Editor.

• Using the Run Test operation, you can implement recursive test execution. However, the recursive test execution may cause a stack overflow error. If the recursive test execution is part of your test plan, to avoid the error, think through your test run sequence ahead and use the If Then operation to allow or forbid recursive runs.

See Also

Test Actions Category
Specifying Operation Parameters
Checking Operation Result
Run Keyword Test Operation
Run Script Routine Operation