Table of Contents

Tools: Visual Studio Online

This topic explains how to integrate TestRail with Microsoft Visual Studio Online. There are currently two ways to integrate TestRail with Visual Studio Online, 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 Visual Studio Online 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 Visual Studio Online's New Bug form to report a new bug. Additionally, entered issue IDs are linked to your Visual Studio Online instance to make it easier to track the status of your issues.

To configure Visual Studio Online'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:

Visual Studio Online
Defect View Url: http://name.visualstudio.com/DefaultCollection/<project>/_workitems/edit/%id%
Defect Add Url:  http://name.visualstudio.com/DefaultCollection/<project>/_workItems#_a=new&witd=Bug

Reference URLs

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

To configure Visual Studio Online'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 Visual Studio Online:

Visual Studio Online
Reference View Url: http://name.visualstudio.com/DefaultCollection/<project>/_workitems/edit/%id%
Reference Add Url:  http://name.visualstudio.com/DefaultCollection/<project>/_workItems#_a=new&witd=Bug