Managing Test Cases

Applies to ReadyAPI 3.56, last modified on November 21, 2024

This topic contains a detailed description of how to perform basic actions upon test cases.

Note: It is recommended to avoid using special characters like {, } in Test Suite, Test Case, and Test Step names to prevent compatibility issues with Groovy scripts.

Disable Test Cases

If you need one or more test cases to be skipped during a test run, you can disable them. To do this:

  • Right-click the desired test cases and select Disable Test Case.

– or –

  • Select the desired test cases.

  • Click Case  > Disable Test Case.

Enable Test Cases

To enable disabled test cases, perform the following steps:

  • Right-click the desired test cases and select Enable Test Case.

– or –

  • Select the desired test cases.

  • Click Case  > Enable Test Case.

Clone/move individual Test Case

To copy a single test case, perform the following steps:

  • Right-click the desired test case and select Clone Test Case.

– or –

  • Select the desired test case.

  • Click Case  > Clone Test Case.

Clone Test Case dialog

In the subsequent dialog, specify the following options:

  • Test Case Name – The name of the new test case.

    Special characters in the name, including (but not limited to) &, -, /, (, and ), may cause issues with reporting.
  • Target Project – The project to which you want to place a new test case.

  • Target Test Suite – The test suite to which you want to place a new test case.

  • Clone Security Tests – Select this option to clone a security test related to the selected test case.

  • Move instead – Select this option to delete a source test case.

  • Clone description – Select this option to clone a test case with the existing description.

  • Description – Specify the description of the cloned test case if you disable the Clone description option.

  • Clone requirements – Select this option to clone a test case with the existing requirements.

  • Requirements – Specify requirements of a cloned test case if you disable the Clone requirements option.

Clone several Test Cases

You can create clones of existing test cases to use them in a different place. The cloned cases will be the exact copies at the time of cloning. If you later change the original, the cloned copy will not be affected. ReadyAPI automatically copies corresponding APIs to the destination project if needed.

To clone multiple test cases:

  • Select test cases you want to clone:

  • Open the context menu and select Clone Test Cases:

  • In the subsequent Clone Test Cases dialog, you can configure the cloning process. Click Clone to complete the process:

    Clone Test Cases dialog

    The dialog has the following options:

    • A list of test cases to be cloned – The names of the selected test cases, projects and test suites that contain them.

    • Project – The project to which the test cases will be cloned. You can select the existing project or create a new one by selecting <Create New>.

    • Test Suite – The destination test suite to which the test case will be cloned. You can select the existing suite from the specified destination project or create a new one by selecting <Create New>.

    • Clone Security Tests – Enable this option to clone the related security tests to the destination project.

Move several Test Cases

You can move multiple test cases simultaneously. You can select cases from different test suites and projects. ReadyAPI automatically copies corresponding APIs to the destination project if needed. To move test cases:

  • Select cases you want to move.

  • Open the context menu and select Move Test Cases.

  • In the subsequent Move Test Cases dialog, configure the moving process. Click Move to complete the process:

    Move Test Cases dialog

    The dialog has the following options:

    • A list of test cases to be moved – The names of the selected test cases, projects and test suites that contain them.

    • Project – The project to which the test cases will be moved. You can select the existing project or create a new one by selecting <Create New>.

    • Test Suite – The destination test suite to which the test case will be moved. You can select the existing suite from the specified destination project or create a new one by selecting <Create New>.

Validate Test Cases

When you clone a test case, ReadyAPI validates all necessary external dependencies. If there are any errors, it shows the Validate Test Case dialog. By using this dialog, you can examine all errors and resolve them as needed.

Validate case

To resolve a potential problem:

  • Select an appropriate action from the drop-down menu in the Action column.

  • Enter parameters or values if needed.

  • Click OK.

Remove Test Cases

To delete test cases:

  • Right-click the desired test cases and select Remove.

– or –

  • Select the desired test cases.

  • Click Case  > Remove.

In the subsequent dialog confirm the operation to finish removing.

Rename Test Case

To rename a test case:

  • Right-click the desired test case and select Rename.

– or –

  • Select the desired test case.

  • Select Case  > Rename from the main menu.

Enter the desired name in the subsequent dialog and click Ok.

Special characters in the name, including (but not limited to) &, -, /, (, and ), may cause issues with reporting.
Renaming a test case of a composite project will change the file name of the matching test case.

Change Test Case order

If you want to change the order of the test case execution:

  • Right-click the desired test case and select Move Up or Move Down.

– or –

  • Select the desired test case.

  • Click Case  > Move Up or Case  > Move Down.

Save Test Case

You can save composite project at the test case level to prevent saving individual test cases. This also helps to save a test case without the need to save an entire project.

To save a test case -

The Project needs to be a Composite Project.
  • Go to the context menu.
  • Right-click the desired test case and select Composite Actions > Save Test Case.
    Save Test Case

See Also

Test Case Editor
Running Tests
Managing Test Suites
Managing Test Steps

Highlight search results