HomeUser GuideTwo-way IntegrationTwo-way Integration with Redmine

11.2. Two-way Integration with Redmine

Plugin Installation

If you have a running instance of Redmine ready with you and you have access to its files, you can easily add Test Collab plug-in to it.

Compressed Test Collab plug-in files for Redmine can be downloaded from Downloads page.

1. Once you have the plugin archive, then depending on the version of Redmine being used, you can extract the plug-in into :

For Redmine 1.x - /apps/redmine/htdocs/vendor/plugins

For Redmine 2.x - /apps/redmine/htdocs/plugins 

2. Restart Redmine.

Make sure your Redmine's hostname and path are correctly configured to the same URL which you type in your browser to access it.

Setting Host name and path

For this :

 

For example, if you access your Redmine application at redmine.abc.com
then the value for "Host name and path" should be like redmine.abc.com/redmine

Configuring Test Collab plugin

Next is to setup the Test Collab plugin, for this :

 

Non Administrative Tasks

The tasks that can be performed by a Redmine user, who need not be an application administrator

Setting up Test Collab API key

To set up key to make calls to Test Collab API, select "My Account" from top menu.

On "My Account" page, enter the API key for the Test Collab application user whose credentials you want to use to perform test case management tasks on Test Collab from Redmine, you may like to refer "How to know Test Collab user's API Key".

 

 

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.

 

Performing Test Case Management tasks

After setting up Test Collab plug-in and API key, you can start performing test case management related tasks.

If you are logged in as an administrator of Redmine application and also you have provided the API key for a Test Collab user who can act as an administrator, then you can either add a new Redmine project or use an existing project to "Enable" Test Collab for it.

Adding a Project in Test Collab

As an administrator, you also have an option to introduce a new project in Test Collab, that will have the same name as that of the Redmine Project. For this you can select "Create New" from the drop down next to "Linked Project".

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 into the current Redmine project.

Once Test Collab is enabled for a Redmine project, you will be able to perform all other test case management tasks. For this you can either use an existing Redmine issue or create a new one.

Once an issue is created or selected, you will see a new section at the bottom 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 Redmine 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 Redmine 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 Redmine issue.

When one or more cases are linked with the Redmine 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 Redmine, will delete the test case from Test Collab as well.

Assigning Test Cases to Testers for Execution

Opting to "Execute Selected Tests", 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.

Known Bugs

Test Collab user's API key can only be updated from My account page, this is not possible from user add or edit forms.

Knowledge Tags

This page was: Helpful | Not Helpful
Test Case Management
Test Collab Support
Product Tour