{"id":35476,"date":"2017-08-25T22:33:39","date_gmt":"2017-08-25T22:33:39","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/devops\/?p=35476"},"modified":"2019-02-14T15:51:19","modified_gmt":"2019-02-14T23:51:19","slug":"automatic-linking-work-items-to-builds","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/automatic-linking-work-items-to-builds\/","title":{"rendered":"Automatic linking work items to builds"},"content":{"rendered":"<p>The \u201c<strong>Automatic linking of a build with associated work items<\/strong>\u201d feature was released in TFS 2017 Update 2 (see the <a href=\"https:\/\/www.visualstudio.com\/en-us\/news\/releasenotes\/tfs2017-update2#a-idwit-a-work-item-tracking-improvements\">Release Notes<\/a>). In a nutshell, this feature allows users to track builds that have incorporated their work without having to manually search through a large set of builds.<\/p>\n<p>For a richer, more first-class experience, we decided to leverage links instead of the existing build-related fields and introduced 2 new link types:<\/p>\n<ol>\n<li style=\"text-align: left\"><strong>Integrated in build<\/strong> (Used by builds to link the associated work items)<\/li>\n<li style=\"text-align: left\"><strong>Found in build<\/strong> (Used by test tools to create new issues found in the build)<\/li>\n<\/ol>\n<p>Below is a sample of the development links control with the new \u201cIntegrated in build\u201d link that was added to the associated work item when the build completed. As always, these links are also available on the Links tab of the work item form.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/08\/Dev-Control1-300x145.png\" alt=\"\" width=\"300\" height=\"145\" class=\"alignnone size-medium wp-image-35525\" \/><\/p>\n<p>Follow the steps below to enable this feature on an existing build definition:<\/p>\n<p>Step 1: \u00a0Toggle the setting to \u201cEnabled\u201d under\u00a0<strong>Options<\/strong>\u00a0in your build definition<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2017\/08\/Build-link-work-option-300x101.png\" alt=\"\" width=\"300\" height=\"101\" class=\"alignnone size-medium wp-image-35527\" \/><\/p>\n<p>Step 2: Update the <strong>Work item type definition xml<\/strong> to include the new link types in the development link control<\/p>\n<p>Sample from Agile process bug work item type xml:<\/p>\n<p>&lt;Group Label=&#8221;Development&#8221;&gt;\n&lt;Control Type=&#8221;LinksControl&#8221; Name=&#8221;Development&#8221;&gt;\n&lt;LinksControlOptions ViewMode=&#8221;Dynamic&#8221; ZeroDataExperience=&#8221;Development&#8221; ShowCallToAction=&#8221;true&#8221;&gt;\n&lt;ListViewOptions GroupLinks=&#8221;false&#8221;&gt;&lt;\/ListViewOptions&gt;\n&lt;LinkFilters&gt;\n&lt;ExternalLinkFilter Type=&#8221;Build&#8221; \/&gt;\n<strong>&lt;ExternalLinkFilter Type=&#8221;Integrated in build&#8221; \/&gt;<\/strong>\n&lt;ExternalLinkFilter Type=&#8221;Pull Request&#8221; \/&gt;\n&lt;ExternalLinkFilter Type=&#8221;Branch&#8221; \/&gt;\n&lt;ExternalLinkFilter Type=&#8221;Fixed in Commit&#8221; \/&gt;\n&lt;ExternalLinkFilter Type=&#8221;Fixed in Changeset&#8221; \/&gt;\n&lt;ExternalLinkFilter Type=&#8221;Source Code File&#8221; \/&gt;\n<strong>&lt;ExternalLinkFilter Type=&#8221;Found in build&#8221; \/&gt;<\/strong>\n&lt;\/LinkFilters&gt;\n&lt;\/LinksControlOptions&gt;\n&lt;\/Control&gt;\n&lt;\/Group&gt;<\/p>\n<p>Thanks for trying out our feature and please share your feedback and questions below.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The \u201cAutomatic linking of a build with associated work items\u201d feature was released in TFS 2017 Update 2 (see the Release Notes). In a nutshell, this feature allows users to track builds that have incorporated their work without having to manually search through a large set of builds. For a richer, more first-class experience, we [&hellip;]<\/p>\n","protected":false},"author":240,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-35476","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops"],"acf":[],"blog_post_summary":"<p>The \u201cAutomatic linking of a build with associated work items\u201d feature was released in TFS 2017 Update 2 (see the Release Notes). In a nutshell, this feature allows users to track builds that have incorporated their work without having to manually search through a large set of builds. For a richer, more first-class experience, we [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/35476","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/240"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=35476"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/35476\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=35476"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=35476"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=35476"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}