Integration With Zephyr for Jira

• Jira Server 7.2.x–7.13.x

  – or –

  Jira Data Center 7.2.x–7.13.x

  – or –

  Jira Cloud

• TestComplete version 14.10 (or later)

• Zephyr for Jira 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 for Jira 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 on the Test Items page of your TestComplete project or 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 on the Test Items page. 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 for Jira

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 for Jira 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 on the Test Items page), 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.