Icon

You are viewing the documentation of TeamCity 10.x and 2017.x, which is not the most recently released version of TeamCity.
View this page in TeamCity 2018.1 documentation or refer to the listing to choose the documentation corresponding to your TeamCity version.

 
Skip to end of metadata
Go to start of metadata

Since TeamCity 10.0, Team Foundation Work Items tracking is integrated with TeamCity. Supported versions are Microsoft Visual Studio Team Foundation Server 2010-2017, and Visual Studio Team Services.

TFS work items support can be configured on the Issue trackers page for a project. If a project has a TFVC root configured, TeamCity will suggest configuring the issue tracker as well.

Integration

By default, the integration works the same way as the other issue tracker integrations: you need to mention the work item ID in the comment message, so the work items can be linked to builds and the links will be displayed in various places in the TeamCity Web UI. 

Additionally, if your changeset has related work items, TeamCity can retrieve information about them even if no comment is added to the changeset. Besides, custom states for resolved work items are supported by TeamCity.

Settings

OptionDescription
Display NameSpecify the tracker connection name
Server URL

Team Foundation Server URL in the following format:

TFS 2010+: http[s]://<host>:<port>/tfs/<collection>/<project>
Visual Studio Team Services: https://<account>.visualstudio.com/<project>

Username

Specify a user to access Team Foundation Server. This can be a user name or DOMAIN\UserName string.
Use blank to let TFS select a user account that is used to run the TeamCity Server. For VSTS use alternate credentials or tokens.

PasswordEnter the password of the user entered above
PatternSpecify the work item id format in changeset comments in the form of regexp.

Learn more about authentication in Visual Studio Team Services.

Custom Resolved States

In addition, resolved states in TeamCity can be customized by using the teamcity.tfs.workItems.resolvedStates internal property set to "Closed?|Done|Fixed|Resolved?|Removed?" by default.

  • No labels