TeamCity 2017.1 Help

Team Foundation Work Items

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

Option

Description

Display Name

Specify 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.

Password

Enter the password of the user entered above

Pattern

Specify 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.

Last modified: 20 April 2023