Approve or reject TestCases

Pre-execution approval is an automated process to request and grant approval for TestCases. It's a vital tool to safeguard your test environment, and it speeds up your governance processes.

This topic explains how to approve and reject TestCases, or revise the approval in Tosca.

If you use the integrated version of pre-execution approval with qTest and VERA, you must approve, reject, or revise in qTest/VERA. For detailed information, check out the qTest manual.

Before you start

If you haven't yet, familiarize yourself with the approval process.

And double-check with your Tosca Commander administrator whether you're a member of an approvers user group. Only members of an approvers user group can approve, reject, or revise TestCases.

Find out which TestCases need approval

Every TestCase that's waiting for approval has the TestCaseWorkState IN_WORK. To find out about a specific TestCase, check its TestCaseWorkState in the Properties pane.

In bigger projects, checking TestCases one by one might not be feasible. To speed up the process, we recommend Tosca's TQL search. To find all TestCases with the state IN_WORK, enter =>SUBPARTS:TestCase[TestCaseWorkState=="IN_WORK"]. You can run the search on the entire project or on specific folders.

Approve TestCases

The TestCase looks good and meets all its requirements. To approve it, follow these steps: 

  1. Select one or more TestCases you want to approve, then select Complete approval from the context menu.

  2. In the subsequent dialog, enter the name of the user group that should now own the TestCase.

    The user group you define as owner gets edit rights to the TestCase. We recommend that you keep the approvers user group as owners, so testers can't accidentally modify already approved TestCases.

  3. Check in.

Tosca changes the TestCaseWorkState to COMPLETED. Testers can now execute the TestCase.

Reject TestCases

If the TestCase isn't quite what it needs to be, you can reject it. Rejecting the approval sets the TestCaseWorkState back to PLANNED. Edit rights go back to your testers, so they can fine-tune the TestCase.

To reject a TestCase, follow these steps:

  1. Select one or more TestCases you want to reject, then select Reject approval from the context menu.

  2. Check in.

Revise your approval

If you already approved a TestCase, but there's a change in your application or requirements, you can revise your approval. Revising an approval sets the TestCaseWorkState back to PLANNED. Edit rights go back to your testers, so they can update the TestCase according to these changes.

To revise an approval, follow these steps:

  1. Select one or more TestCases that need to be updated, then select Revise approval from the context menu.

  2. Check in.