Using JIRA’s WebHooks technology it is possible to push issues (Stories, Tasks, etc) from JIRA to Testlab project as requirements. This is especially handy if a set of requirements (for example user stories) are managed in JIRA Agile and one wants to plan the testing for them in Testlab.
This integration method requires no plugins, so this integration method is available for both JIRA ondemand/cloud and for on-premise installed JIRA setups.
When set up as instructed, when an issue in JIRA is created, edited or commented the changes are automatically propagated to Testlab and a new requirement is created to your project. Testlab maintains links between Testlab’s requirements and JIRA’s issues. For all requirements linked to JIRA, JIRA becomes the master of these requirements meaning, that the details of these requirements cannot be edited in Testlab.
When configured for this requirements management integration, the behaviour of Testlab’s user interface is changed as follows:
To get started with integration follow the steps described below. If you have questions about these instructions or any problems with the set up please feel free to open up a support ticket in Testlab. We are happy to help you in your setup!
Add technical user account
If you already have created such account when setting up JIRA integration with issues, the same user account can be used here and there is no need to create an another.
This concludes the one-time setup of the integration. Continue on to instructions how to set up the Testlab project to use the above integration setup and how to pick the synchronized requirements from your JIRA by configuring the needed WebHooks.
For all Testlab projects which you prefer to integrate with your JIRA some configuration steps need to be taken.
When the preliminary set up is done and the Testlab project is configured for requirement management with your JIRA, you can configure the needed WebHooks to pick the relevant issues from the JIRA to be synchronized with the Testlab project. To do this,
JQL: project = MYPROJECT and issueType in ('Story')
Make sure to include the issue types from the project you want to synchronize to Testlab – if you are using different project schemes or you have customized your issues types make sure to include all issue types you wish to synchronize from your JIRA.
The example above will
If everything is set up correctly, creating a new Story to your JIRA project MYPROJECT should create the Story as an user story to your Testlab project.
Keep in mind, that you can configure multiple WebHooks to your JIRA if needed. This way, you can pick the relevant issues and push them to the Testlab’s requirement hierarchy to folders you prefer.
When configured, Testlab will map the fields from JIRA to Testlab.
If you prefer to have these mappings configured for your project please open up a support ticket and we’ll customize them for you.
|JIRA Field||JIRA value||Testlab Field||Testlab value|
|Type||New Feature, Improvement, Task, Sub-task, Bug||Class||Requirement|
|Story, Epic||User story|
|Status||To Do, Open||Status *||To Do (Ready if missing) *|
|In Progress||in Progress (Ready if missing) *|
|Done||Done (Ready if missing) *|
* When mapping the workflow status we always try to map to a status value from your requirement workflow as described above. Default workflows of Testlab do not have the statuses To Do, In Progress or Done and you have to configure them yourself if you prefer to track requirement progress from your JIRA. If workflow statuses are missing in Testlab, we automatically map them to the “Ready” status. Reason for this is that for example in JIRA Agile, workflow statuses are used for tracking the progress of story’s implementation, not it’s design for which the workflow statuses are used in Testlab.
You can integrate your JIRA issue tracker in a way, in which JIRA’s issues (Stories for example) can be pushed to your Testlab project as requirements to be a part of your specification to be tested. Requirement assets created to Testlab work normally – JIRA pushed requirements are only a part of your specification.
Yes. The integration works via JIRA’s WebHooks which can be set up in JIRA On-demand and in addition, in JIRA instance installed on your own servers.
Log in to your Testlab project, select Testlab > Manage project(s)… and choose the Integrations tab. All integrations which can be taken in use by yourself are configured per project from this view. Check the prerequisities and follow the instructions above in this document to set up the integration at JIRA side.
As said, just drop us a line by contacting support from your Testlab (found in Testlab’s help menu). The default mappings for workflows and fields should work with default workflows out of box, but we can easily make changes for you if requested.