Integration With Zephyr Squad

Jira Cloud

– or –

Jira Server 7.2.x–7.13.x

– or –

Jira Data Center 7.2.x–7.13.x

• TestComplete version 14.10 (or later)

• Zephyr Squad Integration Plugin must be enabled in TestComplete. By default, the plugin is installed and enabled automatically when you install TestComplete. If you experience issues with Zephyr integration, make sure the plugin is enabled in the File > Install Extensions dialog (you can find the plugin in the Common group).

• Your TestComplete workstation must have access to your Jira project.

Before linking your TestComplete tests with Zephyr test cases, you need to connect to your Jira project from TestComplete and bind your TestComplete project to it. You can do this by clicking Connect to Zephyr Squad on the TestComplete toolbar:

Click the image to enlarge it.

To learn more, see:

Assign TestComplete Tests as Automations to Zephyr Test Cases

After binding your TestComplete project to a Jira project, you can assign TestComplete tests to Zephyr test cases. You can do this in the Execution Plan editor of your TestComplete project.

Note: TestComplete test cases you assign to Zephyr test cases must have runnable automated tests assigned to them. You can do it in the Execution entity column of the Execution Plan editor of your TestComplete project. Test cases with no automated tests assigned to them will not send any results to Zephyr.

You can also assign TestComplete tests to Zephyr test cases directly from scripts by using the aqTestCase.Begin and aqTestCase.End methods.

Click the image to enlarge it.

To learn more about assigning tests to Zephyr test cases, see:

Assign TestComplete Tests as Automations to Zephyr Test Cases

Note: You cannot assign BDD tests to Zephyr test cases in the Execution Plan editor. To send BDD test results to Zephyr, you can use the aqTestCase.Begin and aqTestCase.End methods.

You run TestComplete tests linked to Zephyr test cases directly from TestComplete. You can do this from the TestComplete UI, or you can run them from your Continuous Integration (CI) system. For details, see:

Run Test Automations for Zephyr Squad

Running TestComplete tests from Jira is not currently supported.

If you run a TestComplete test associated with a Zephyr test case in a Jira project, the test results will be sent to the Jira project automatically after the test run is over.

By default, the test results are sent to the release version and test cycle your TestComplete project properties specify.

If you run your TestComplete tests by using the command line, for example, from your Continuous Integration (CI) system, you can use the ZephyrVersion and ZephyrCycle command line arguments to specify the release version and test cycle to which you want to include the test results. For example, the command below runs the ProjectTestItem1 test item of the MyProj project and sends the results to the Jira project’s release 2.0 and Regression test cycle:

To learn more, see Send Test Results to Jira in the Run Test Automations for Zephyr Squad topic.

You can view test results in the Test Execution section of your test item in Jira:

Click the image to enlarge it.

If a TestComplete test passes (that is, no errors are posted to the test log), the test execution status in Jira will be Pass.

If the TestComplete test fails (there are error messages in the test log), the test execution status in Jira will be Fail. In addition, the comment section will show information on why the test failed (the first error message posted to the TestComplete test log). The screenshot of the testing environment taken when the error occurred will be attached to the execution:

Click the image to enlarge it.

Exporting the entire TestComplete test log to Jira is not currently supported.

Notes:

• If your test item in TestComplete has several iterations (you can set them in the Count column in the Execution Plan editor), the results of all iterations will be sent to Jira one after another. You can view them in the Execution History section of the Zephyr test case in Jira.

• If you have server test items assigned to a single Zephyr test item, the results of all test items will be sent to Jira one after another in the order of their execution. You can view them in the Execution History section of the Zephyr test case in Jira.