Tools: Assembla

This topic explains how to integrate TestRail with Assembla. There are currently three ways to integrate TestRail with Assembla, namely:

You don't have to use all listed integration options and you can mix and match the integration with other tools. Configuring the integration usually only takes a few minutes and this guide explains how to configure the integration and how it works.

Defect URLs

The defect URLs are used to let TestRail know how to access your Assembla instance. Once the URLs have been configured, a new Add link appears next to the Defects field in the Add Test Result dialog. This link allows you to jump to Assembla's New Ticket form to report a new bug. Additionally, entered ticket IDs are linked to your Assembla instance to make it easier to track the status of your tickets.

To configure Assembla's URLs in TestRail, select Administration > Integration. You can alternatively enter separate bug tracker URLs for each project under Administration > Projects. Use the following example URLs to configure the addresses:

Assembla installation
Defect View Url: https://<portfolio>.assembla.com/spaces/<space>/tickets/%id%
Defect Add Url:  https://<portfolio>.assembla.com/spaces/<space>/tickets/new

Please make sure to replace <portfolio> and <space> with the actual names of the portfolio/space in Assembla you want to integrate with.

Defect plugins

Defect plugins can be used to implement a deeper bug tracker integration and TestRail comes with a ready-to-use Assembla defect plugin. To configure the defect plugin, select Administration > Integration and select Assembla in the Defect Plugin dropdown list. The next step is to configure all the necessary connection settings in the Configuration field. Project specific plugins and configuration settings can optionally be specified under Administration > Projects.

In order to use the defect plugin features for Assembla, you will need to create an API key and secret in your Assembla account. You can do this under Account > API Applications & Session. Please ensure to check the boxes for API access and Repository access.

Once you save, the API key and secret will be available.

Add the secret and key in their respective place along with the name of your Assembla space as shown below.

When the defect plugin has been configured, a new Push link is shown next to the Defects field in the Add Test Result dialog. Clicking the link will open a popup dialog that enables you to push a bug report to Assembla without leaving TestRail. Once the test result was added, hovering the mouse cursor over a ticket ID will open a window with useful information and status details about the ticket in Assembla.

Please note: The Assembla defect plugin was introduced with TestRail 3.0 but is also available for older TestRail versions on request.

Customizations

The Assembla defect plugin was built to work with a standard Assembla configuration. TestRail allows you to customize the integration to work with your own custom fields or to map users between TestRail and Assembla. Please see the following articles for details on how to customize the integration:

Reference URLs

The reference URLs are used to link test cases to tickets stored in Assembla via the References field. Once the URLs have been configured, ticket IDs entered in the References field are linked to your Assembla instance to make it easier to jump to related tickets, feature specifications or requirements.

To configure Assembla's URLs for the References field, select Administration > Integration. You can alternatively enter separate reference URLs for each project under Administration > Projects. Use the following example URLs to integrate TestRail with Assembla:

Assembla installation
Reference View Url: https://<portfolio>.assembla.com/spaces/<space>/tickets/%id%
Reference Add Url:  https://<portfolio>.assembla.com/spaces/<space>/tickets/new

Please make sure to replace <portfolio> and <space> with the actual name of the portfolio and space in Assembla you want to integrate with.