TestCollab lets you create new Jira issues from inside TestCollab!
Before proceeding- Make sure you have enabled defect management and connected your issue manager
The real action is at the time of running a test case when a tester gets option to report defect for a failed test case.
When you click on report bug icon on run panel, you will see a preview of bug to be posted in Jira, if needed you can modify the issue details before it is posted in Jira.
Formatting the content of defect being reported
As on date of writing this article, JIRA accepts text in markdown format as value for relevant fields, if you want to apply formatting options to text fields then you may please refer this article.
Link existing JIRA issues with failed test case
If you want you can also link an existing Jira bug instead of creating a new one.
Who will be considered as reporter for the issue?
Scenario 1: Tests are being run by the administrator who has configured the defects management for project:
The issues would be shown to have been reported by the the user whose credentials were used to configure defects management settings in TestCollab project.
Scenario 2: Tests are being run by a user other than the administrator who has configured defects management for project
Scenario 2.1 : The tester has connected his/her own defects manager account with TestCollab profile for the same defects manager app instance
The issues in defects manager app would be shown to have been reported by the user whose credentials have been used to link defects manager app account with current user's TestCollab user profile.
Scenario 2.2 : The tester has connected his/her own defects manager account with TestCollab profile but for a different defects manager app instance
Since the defects manager app instances selected by user is different from the one that administrator has configured for the project, the issue in defects manager app would be shown to have been reported by the user whose credentials were used by administrator while configuring defects management for the project.
Scenario 2.3 : The tester has not connected his/her own defects manager account with TestCollab profile
In this case all the issues would be shown to have been reported by the user whose credentials were used by administrator while configuring defects management for the project.
Note: If you encounter an error that is not specific to the defect being reported then please consider checking the project specific defects management settings to see if the connection you configured is still valid, cause sometimes change in JIRA profile may invalidate the connection.
Before reporting a defect
The user who is getting an option to report a bug can also check the status and validity of access token linked on defects settings page for current project, this is done by hovering the mouse over the "Fail and report bug" button on test case run page.
Here are the various status :
Fail and report bug
The user has linked his account and the access token is still valid so a defect can be reported.
User not linked
User has not linked his/her account on defects settings page, in this case default account will be used to report the defect.
User does not have access to the requested resource
User may or may not have linked his/her account on defects settings page, but the credentials are no more valid and they need to disconnect and reconnect their JIRA account.
... Here are the common informative messages shown when defect details are being submitted but the either the current user's account or the account of administrator who configured defects management settings for project is not linked properly.
The above message is shown when logged-in user has not linked his/her account on defects settings page correctly. As mentioned the default reporter would be used while reporting defect.
The above message is shown when the default account needs to be relinked due to expiry of token.
Automatic linking of failed test cases with defects reported
The defects reported from TestCollab as a result of test case failure will automatically link of the test cases with issue thus reported in JIRA, provided the TestCollab bi-directional integration app is installed and app specific project settings are done in JIRA.