If you use Zephyr for Jira to organize and manage your tests, you can automate your Zephyr test cases by assigning TestComplete tests to them. Your TestComplete test results will be automatically sent to your Jira project and added to its releases and test cycles.
You assign TestComplete test cases as test automations to Zephyr test cases directly from TestComplete. This topic describes how you can do this.
Note: In Jira, assigning TestComplete tests to test cases is not currently supported.
To learn how to run test automations, see Run Test Automations for Zephyr for Jira.
Jira Server 7.2.x–7.13.x
– or –
Jira Data Center 7.2.x–7.13.x
– or –
Your Jira must have the following plugins installed:
Keep the default Test issue type for Zephyr test cases in Jira. For TestComplete 14.20 and later: If you use a custom issue type name for Zephyr test cases, you will have to configure your TestComplete project to locate them manually. See Link TestComplete Projects to Custom Zephyr Test Case Issue Types.
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.
If your TestComplete project is not bound to a Jira project yet, click Connect to Zephyr for Jira on the TestComplete toolbar.
|Note:||The button is hidden by default. Right-click the TestComplete toolbar and select TMS to make it appear.|
On the resulting Properties > Zephyr for Jira page, specify the credentials you use to connect to your Jira project, Zephyr API keys (if needed) and your Jira project:
Tip: You can set the connection settings as your default project properties. All the projects you will create later will have these properties specified. You can then modify them on the Properties > Zephyr for Jira page of those projects, if needed.
If the TestComplete tests (for example, keyword tests or script routines) you want to use for automation are not added to your project’s Test Items page, add them. To learn how to do this, see the description of the Test Items page.
Mark the test items you want to use for automation as test cases on the Test Items page.
Click the ellipsis button in the Link to external test case column of the added test item.
If your project is already bound to Zephyr for Jira, select the needed Zephyr test case in the resulting Link to external test case wizard:
Otherwise, in the Link to external test case wizard, first, specify the connection settings. If the specified connection settings are valid, TestComplete will retrieve a list of available Zephyr test cases. Select the needed test case:
– or –
Type the needed Zephyr test case key manually using the following format:
Your TestComplete project must be bound to a Jira project. To learn how to do it, see above.
If you use script tests, you can mark script routines or even arbitrary code fragments as test cases and send their results to your Jira project directly from the code:
Your TestComplete test project must be bound to a Jira project as described above.
Open your script units, analyze your code and learn which routines and code fragments match your Zephyr test cases.
To mark the beginning of the code whose results you want to send to Jira, use the
aqTestCase.Begin method. Specify the name that will be used to post the results to the TestComplete test log and specify the Zephyr test case to which you want to assign the results, in the
aqTestCase.Begin("My test", "zfj://PROJ-1")
To mark the end of the needed code, use the
For example, in the code snippet below, the
aqTestCase.End methods mark part of the
Main script routine as a separate “Create an order” test case and send its test results to the
OR-1 test case in a Jira project:
def main(): page = Aliases.browser.page #... # Sets the beginning of the "Create an order" test aqTestCase.Begin("Create an order", "zfj://OR-1"); page.Aspnetform.table.cell1.linkOrder.Click() #... page.Wait() # Sets the end of the "Create order" test aqTestCase.End() table = page.Aspnetform.table.cell.panelContent.panel.table #... Aliases.browser.Close()
When you run the main routine, TestComplete will treat all the code between the
aqTestCase.End methods as a separate test, send its results to Jira, and assign it to the specified Zephyr test case.
In TestComplete, click Reporting to Zephyr for Jira on the TestComplete toolbar.
– or –
If you run your tests by using the command line, use the
/DisableExternalReporting command-line argument.
If the test is assigned to a Zephyr test case on the project’s Test Items page, clear the test’s Link to external test case column.
If the test is assigned to a Zephyr from code using the
aqTestCase.End methods, remove the method calls from your code.
To temporary unbind a TestComplete project from a Jira project, click Reporting to Zephyr for Jira on the TestComplete toolbar.
To unbind the project completely:
Open the Test Items page of your project and remove test item associations (see above).
Open the Properties > Zephyr for Jira page of your project and clear the connection settings.
Save the changes.
TestComplete will stop sending test results to your Jira project.