The term two-way integration or bi-directional integration here relates to the use of issue managers to perform test case management operations on Test Collab without requiring you to login to Test Collab application.
Supported operations that can be performed from within the issue manager, include :
- Operations possible when you use a TestCollab administrator's API keyLinking existing TestCollab project with current issue manager's ProjectCreating new TestCollab project being in issue manager to link it with current projectLinking Existing test cases defined in TestCollab to an issue defined in issue manager
- Operations available for all Test Collab users, provided their respective roles permit them to do so:Adding a new test case and get it automatically linked with the current issue defined in issue managerEditing an already linked test caseViewing a test case detailsUnlinking a linked test case from the current issueDeleting a linked test caseAssign test cases to users who have permissions to execute test cases in TestCollab
Test Collab's Jira bidirectional integration addon video
Let us start with the installation of Test Collab two-way integration addon on your JIRA OnDemand instance, please follow these steps :
- When logged into JIRA as an administrator, select "Add-ons" option under "Settings"
- Key in "Test Collab" to "Search the Marketplace" textbox
- Clicking on "Install" button you would be asked to confirm the installation
- Installation should then begin
- Once installation is done you will be shown a confirmation message
- Click on "Manage" button so that the installed add-on can then be configured
- For "Test Collab URL", you simply are required to enter the URL that is to be used to access the Test Collab instance for bidirectional integration from JIRA
Setting up Test Collab API key
To set up the key that will be required to make calls to Test Collab API, follow these steps:
- Use "Test Collab" option available on dashboard
- Enter Test Collab user API Key in the box provided.
How to know Test Collab user's API Key
Being logged into Test Collab, navigate to your profile. On profile page, you will find your API key, that can be used to access Test Collab.
Please note that every JIRA user who wants to perform test case management tasks would be required to provide his own Test Collab API key in JIRA.
Linking Test Collab Project
After setting up Test Collab add-on and user API key, the next step is linking the Test Collab project with your JIRA project.
If you are logged in as an administrator of JIRA application and also you have provided the API key for a Test Collab user who can act as an administrator, then you can enable "Test Collab" integration for a JIRA project and use an existing Test Collab project, for this switch to project settings page and select "Test Collab" option.
Non Administrative Tasks
Please note that all the tasks that have been described below can be performed on the basis of role that has been assigned to the user whose API key is used, for the Test Collab project linked with the current JIRA project.
Once Test Collab is enabled for a JIRA project, you will be able to perform all other test case management tasks. For this you can either use an existing JIRA issue or create a new one.
Once an issue is created or selected, you will see a new section (tab) with title "Test Cases" below issue details that will allow you to manage the linked Test Collab test cases, this section gives you option to either add new test case in Test Collab and link it automatically to JIRA issue, or link existing test cases.
If you are a Test Collab user who is assigned a role that permits to edit test cases in a project, then you can link existing testcases under that Test Collab project.
When you click on "Link Existing", a popup would come up and that will list all test suites that are present in linked Test Collab project.
You can expand individual test suite to select specific test cases
If you have selected the entire suite(s), all their related test cases will automatically get linked with JIRA issue.Otherwise individually selected test cases will be linked.
If you opt to add a new test case then you will get a popup to enter the details of new test case, the interface would be similar to the add page you see in Test Collab.
After saving, the new test case will be introduced in Test Collab application and will be automatically linked with the JIRA issue.
When one or more cases are linked with the JIRA issue, for each linked case you will get options like edit, unlink and delete.
Opting to edit will popup the related form. Unlink will remove the test case from the list of linked test cases.
Deleting apart from unlinking from JIRA, will delete the test case from Test Collab instance too.
Assigning Test Cases to Testers for Execution
Opting to "Create Execution", after selecting one or more linked test cases, will popup a window to first let you create a new Test Collab test execution and then assign the execution to the users who have the role in Test Collab project that allows them to execute a test.
Creating a New Test Execution
Please note that two-way integration is supported only on Test Collab version 1.3.4 and higher.