Applies to ReadyAPI 2.6, last modified on January 15, 2019

About Run TestCase test step

Use this test step to run an existing test case from your test project. It is similar to a method call in programming languages like Java or C++. When executing this test step, ReadyAPI goes directly to the called test case. After the called test case is over, ReadyAPI returns back to the original test case.

Editing Run TestCase test step

You can modify settings of the test step in its editor:

Run TestCase test step editor

Click the image to enlarge it.

Here is a brief description of available panels in the request editor:

Name Description
Test step properties The list of properties from the specified test case. You can modify its values by using the following commands:
  • – clears all parameter values.

  • – loads values of the specified parameters from a file.

    If a file contains properties that are not declared in the test case, ReadyAPI ignores them.
  • – saves values of the specified parameters to a file.

TestCase Log A log of the last test case run.

The toolbar of the panel has the following commands:

  • – Clears the log.

  • – Opens the TestCase Log dialog to modify the log options:

    • Max Rows – Specifies the maximum number of rows to log.

    • Errors Only – Specifies if ReadyAPI should log only error messages.

    • Follow – Specifies whether ReadyAPI automatically scrolls the log.

  • – Exports the log.

Customizing Run TestCase test step

You can modify the test case options during its creation, or later in the Run TestCase Options dialog. To call the dialog, click Test Step Options on the test step toolbar.

Run TestCase Options dialog
  • Target TestCase - Specifies the test case to be called. The drop-down list contains the test cases of the test suite that is selected in Target TestSuite.

  • Target TestSuite – Specifies the test suite that contains the desired test case.

  • Return Properties – Use this text box to specify the properties, to which the target test case will save resulting values. If needed, modify the target test case so that it saves resulting values to the selected properties.

    Note: You can use the rest of the properties to pass values to the target test case.
  • Run mode – Specifies how ReadyAPI calls the target test case:

    • Create isolated copy for each run – ReadyAPI creates a copy of the target test case in the memory and runs it. This way, the run will not affect other concurrent runs of the test case. With this mode, several copies of the target test case can run in parallel.

      Notes:

      • Any property changes are lost after the execution.

      • The mode requires more memory.

    • Run primary TestCase (fail if already running) – ReadyAPI will run the target test case only if it is not already running. If the target test case is running, the test step will fail. Use this run mode if the test case contains steps that cannot work in parallel (like writing to the same file) and you do not want the target test case to overwrite the data produced by another run.

    • Run primary TestCase (wait for running to finish, Thread-Safe) – If the target test case is already running, ReadyAPI waits until that run is over, and then runs the target test case again. Use this mode if the test case contains steps that cannot work in parallel, but you want the target test case to run with the specified property values.

    The run mode is especially important when running test cases containing the Run TestCase test step as a load test. In this case, the first option runs more smoothly but requires more memory. If you use other options, your load test will call the same instance of the test case which will either cause an error or block the execution of the load test.

  • Copy LoadTest Properties – Select it to use the same load test properties as in the original test case when running the target test case during a load test.

  • Copy HTTP Session – If this option is enabled, the target test step will send requests to the tested server within the HTTP session used by the original test case. If this option is disabled, the target test case will set up a new session for requests.

  • Ignore Empty Properties – If this property is enabled, ReadyAPI does not pass empty values to the target test case. In this case, ReadyAPI will use the values that are specified for these properties in the target test case’s editor.

Property list

Besides the test step editor, you can adjust test step behavior by using its properties in the RunTestCase Properties and Custom Properties tabs.

Name Description
Name

The test step’s name.

Description

Text describing the test step.

This page contains properties that are declared in the target test case. You can check the tab’s toolbar items to clear values, save them to or load them from a file. To learn more, see About Properties.

Test step toolbar

The test step toolbar contains commands that allow you to modify the test step or appearance of the test step editor.

Run TestCase test step toolbar

Click the image to enlarge it.

See Also

Test Steps

Highlight search results