ℹ️ This plugin is only available for Premium and Enterprise plan.
Now there is no need to switch between two different tools to manage your test cases.
If you are a JIRA user you can now use TestCollab's bi-directional app to manage all your test cases from within JIRA by linking your test cases from TestCollab with issues in JIRA.
Things you can do with our Jira app are:
Link existing test cases of TestCollab with Jira issues
Add new test cases from Jira to TestCollab
Edit linked test cases
Delete test cases
Unlink test cases
Create new test plan from Jira in TestCollab
Installing the app
TestCollab's bi-directional app is now available on Atlassian marketplace with the name "TestCollab - Test management for Jira". Installation is simple and straight forward, click on Get App to let the installation begin
Clicking on configure on installation success message brings up API token entry form.
Configuring the application
Providing Administrator's API Token
You can use the link provided above the API token entry box to get an API token generated.
Remember at the time of configuring the app you can either use API token of either super administrator or of an administrator from your company registered with TestCollab, using API token of a non admin is not allowed to configure the app.
Once API token is verified, you would be asked to select the company / account name.
API Token Entry for All Users
There is one more place where you would enter your TestCollab API token, this is the page where your API token is used to link your TestCollab profile. The option is available under Apps menu, you simply have to select the app name i.e. TestCollab
Note: If you revoke your API token in TestCollab then you need to reconfigure the TestCollab bi-directional integration app in JIRA, failing to this would cause the app to not to work in JIRA.
By this time when you navigate to your JIRA project you would see new link for "TestCollab" on left navigation bar
But before we can use it, we have to configure project specific settings in JIRA for TestCollab app
Project settings for TestCollab app
You select a TestCollab project whose test cases you would like to get managed and linked with issues in current JIRA project.
One more important part of this setting is selection of issue types you want the feature of test cases management to work for.
All the processes discussed above are performed by a user who has provided the API token of a TestCollab super administrator or administrator.
From this point onward the features are common for administrators and non-administrators but in case of non-administrators the availability would depend on the role assigned to user in TestCollab.
Having done the project specific setting the link for "TestCollab" on project's main menu should be usable.
Note: you may be asked to enable third part cookies on your browser
With this you are all set to use the app. Start by exploring the TestCollab project's details
Note: Based on the permissions you have in the selected TestCollab project, you would be able to perform various operations on entities like test suites, test cases and test plans using this interface.
Test cases management through JIRA issues
For the JIRA issue types selected while configuring project specific settings for TestCollab you would get options to perform various operations.
Notice the section titled "Test Cases" below the details of JIRA issue, this is the place from where you would be linking and managing test cases of TestCollab.
Linking test cases
Clicking on "Link test cases" opens up the list of test cases of TestCollab project.. You can shortlist for the test cases that you need to link with JIRA issue to work , as in TestCollab you can filter the test cases on various search criteria.
Once the test cases are shortlisted click on checkbox on title row of grid to select them all (or you can also select individual test cases) and use "Link now" button.
The linked test cases should now be listed on "Test Cases" section and ready for various operations to be performed.
Adding a test case
If your TestCollab role in project allows then you can add new test cases and get those new test cases automatically linked with current JIRA issue.
More details on how to add test case are available here.
Editing a test case
Just like adding, editing of test cases is simple, you have to use the actions menu shown next to the individual test case.
Once "Edit" option is selected, it opens up the edit test case form.
Unlink a test case
If a test case is no longer needed to be linked with JIRA issue, it can be unlinked, again the Unlink option is available on actions menu.
Deleting a test case
If a test case is no more required then use delete action.
Please note this action will not only unlink the test case from JIRA issue but it would also DELETE the test case from your TestCollab instance and this action cannot be reverted, so one needs to be very careful while performing this action.
Creating a test plan
With the linked test cases you can also get a test plan created and assigned to testers.
The process is identical to the one performed in TestCollab.
Automatic linking of failed test cases with defects reported
With the latest version available as on date of writing this, 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 app specific project settings are done in JIRA.