{"id":68130,"date":"2023-12-01T06:21:15","date_gmt":"2023-12-01T14:21:15","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/devops\/?p=68130"},"modified":"2023-12-01T06:25:34","modified_gmt":"2023-12-01T14:25:34","slug":"work-items-in-visual-studio","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/work-items-in-visual-studio\/","title":{"rendered":"Work Items in Visual Studio"},"content":{"rendered":"<p>Several years ago, with the introduction of Visual Studio 2019, we launched a completely revamped work item experience. This updated view operates entirely on REST, replacing the deprecated SOAP APIs utilized in the legacy version. Although Visual Studio 2022 still includes the option to revert to the legacy view, the majority of our users have transitioned to the new default view. For those who prefer the legacy experience, here is some guidance to facilitate a smooth transition.<\/p>\n<p><div class=\"alert alert-primary\">\ud83d\udcdd Please be aware that we anticipate removing the legacy option in the upcoming major version of Visual Studio.<\/div><\/p>\n<h2>How do I turn on the new view?<\/h2>\n<p>To enable the new default view, launch Visual Studio and navigate to the <em>Search<\/em> function at the top of the window. In <strong>Feature Search<\/strong>, enter the phrase &#8220;Work items.&#8221; Choose the &#8220;Change how work items are opened&#8221; option from the list, and then set the <strong>Default experience<\/strong> for your landing page.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/setting-work-item-view.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/setting-work-item-view.png\" alt=\"Image setting work item view\" width=\"744\" height=\"433\" class=\"aligncenter size-full wp-image-68137\" srcset=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/setting-work-item-view.png 744w, https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/setting-work-item-view-300x175.png 300w\" sizes=\"(max-width: 744px) 100vw, 744px\" \/><\/a><\/p>\n<h2>How do I link work items to a commit?<\/h2>\n<p>Let&#8217;s begin with the basics, linking a work item to a commit. There are several ways to accomplish this.<\/p>\n<h3>Work items Hub<\/h3>\n<p>Use the Work Items tile from Team Explorer. This is where you find and select the work items that are related to a code change. Select from a number of different views like Assigned To Me, Following, Mentioned, and My Activity. Filter or search can be utilized to find any specific work item. Once you select an item, select the <strong>Relate To Changes<\/strong> option.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/relate-to-changes-1.gif\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/relate-to-changes-1.gif\" alt=\"Image relate to changes 1\" width=\"1420\" height=\"976\" class=\"aligncenter size-full wp-image-68172\" \/><\/a><\/p>\n<h3>#Mention in commit message<\/h3>\n<p>Search and select work items directly from the commit message. Associate as many work items to the commit as you would like.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/mention-commit.gif\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/mention-commit.gif\" alt=\"Image mention commit\" width=\"1256\" height=\"836\" class=\"aligncenter size-full wp-image-68144\" \/><\/a><\/p>\n<h3>Create branch and relate work<\/h3>\n<p>Generate a branch directly from a work item, automatically linking the work item to any ongoing changes. Alternatively, you can relate a work item and an existing set of changes already in progress. Associate multiple work items with a commit as needed.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/branch-from-work-item.gif\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/branch-from-work-item.gif\" alt=\"Image branch from work item\" width=\"1256\" height=\"836\" class=\"aligncenter size-full wp-image-68148\" \/><\/a><\/p>\n<h2>How do I run queries and see counts?<\/h2>\n<p>Over the past decade, we&#8217;ve strategically invested in and transitioned the primary query experiences to our web-based platform. As a result, the new work item view no longer incorporates queries. Creating, editing, and running queries in the web portal is pretty straight forward. Here is some documentation as a refresher:<\/p>\n<ul>\n<li><a href=\"https:\/\/learn.microsoft.com\/en-us\/azure\/devops\/boards\/queries\/using-queries?view=azure-devops&#038;tabs=browser\" rel=\"noopener\" target=\"_blank\">Define a work item query in Azure Boards<\/a><\/li>\n<li><a href=\"https:\/\/learn.microsoft.com\/en-us\/azure\/devops\/boards\/queries\/view-run-query?view=azure-devops&#038;tabs=browser\" rel=\"noopener\" target=\"_blank\">View, run, or email a work item query<\/a><\/li>\n<\/ul>\n<p>If the counts on the queries are important to you, try using a <a href=\"https:\/\/learn.microsoft.com\/en-us\/azure\/devops\/report\/dashboards\/overview?view=azure-devops\" rel=\"noopener\" target=\"_blank\">Dashboard<\/a> with a set of <a href=\"https:\/\/learn.microsoft.com\/en-us\/azure\/devops\/report\/dashboards\/widget-catalog?view=azure-devops#query-tile-widget\" rel=\"noopener\" target=\"_blank\">query tiles<\/a> to get a similar experience. You can even use rules on the tiles to add conditional colors, making it easier to visualize.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tile-widgets-for-query-counts.gif\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tile-widgets-for-query-counts.gif\" alt=\"Image tile widgets for query counts\" width=\"1782\" height=\"1080\" class=\"aligncenter size-full wp-image-68152\" \/><\/a><\/p>\n<p>Here is a comparison side by side.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tiles-queries-side-by-side.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tiles-queries-side-by-side.png\" alt=\"Image tiles queries side by side\" width=\"1782\" height=\"1080\" class=\"aligncenter size-full wp-image-68154\" srcset=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tiles-queries-side-by-side.png 1782w, https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tiles-queries-side-by-side-300x182.png 300w, https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tiles-queries-side-by-side-1024x621.png 1024w, https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tiles-queries-side-by-side-768x465.png 768w, https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/tiles-queries-side-by-side-1536x931.png 1536w\" sizes=\"(max-width: 1782px) 100vw, 1782px\" \/><\/a><\/p>\n<h2>How do I manage queries?<\/h2>\n<p>There are two ways to move queries around when using the web experience.<\/p>\n<h3>Drag and drop<\/h3>\n<p>You can drag and drop a single query or an entire folder into another folder.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/queries-drag-drop.gif\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/queries-drag-drop.gif\" alt=\"Image queries drag drop\" width=\"1782\" height=\"1080\" class=\"aligncenter size-full wp-image-68157\" \/><\/a><\/p>\n<h3>Rename query<\/h3>\n<p>Select the query and choose the <strong>Rename Query<\/strong> option in the context menu. Choose the folder in the drop down you wish to move the query into.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/rename-query.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/rename-query.png\" alt=\"Image rename query\" width=\"624\" height=\"384\" class=\"aligncenter size-full wp-image-68159\" srcset=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/rename-query.png 624w, https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/rename-query-300x185.png 300w\" sizes=\"(max-width: 624px) 100vw, 624px\" \/><\/a><\/p>\n<h2>How do I reparent work items?<\/h2>\n<p>While re-parenting cannot be performed directly when running queries on the web, there are several alternative methods available for re-parenting work items.<\/p>\n<h3>Drag and drop<\/h3>\n<p>From the backlog you can drag and drop child items into another parent. You can do the same with child items between cards on the kanban board and sprint board.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/re-parent-1.gif\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/re-parent-1.gif\" alt=\"Image re parent 1\" width=\"1782\" height=\"1080\" class=\"aligncenter size-full wp-image-68162\" \/><\/a><\/p>\n<h3>Mapping<\/h3>\n<p>The Mapping pane on the backlog screen is a simple way to parent and re-parent items.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/map-unparented-items-agile.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/map-unparented-items-agile.png\" alt=\"Image map unparented items agile\" width=\"731\" height=\"371\" class=\"aligncenter size-full wp-image-68164\" srcset=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/map-unparented-items-agile.png 731w, https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/map-unparented-items-agile-300x152.png 300w\" sizes=\"(max-width: 731px) 100vw, 731px\" \/><\/a><\/p>\n<p><a href=\"https:\/\/learn.microsoft.com\/en-us\/azure\/devops\/boards\/backlogs\/organize-backlog?view=azure-devops\" rel=\"noopener\" target=\"_blank\">Learn more<\/a> about how to organize your backlog and map child work items to parents in Azure Boards.<\/p>\n<h3>Change parent<\/h3>\n<p>From the backlog you can change the parent by selecting the child items and using the **Change parent ** option on the context menu.<\/p>\n<p><a href=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/change-parent-2.png\"><img decoding=\"async\" src=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/change-parent-2.png\" alt=\"Image change parent 2\" width=\"624\" height=\"519\" class=\"aligncenter size-full wp-image-68166\" srcset=\"https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/change-parent-2.png 624w, https:\/\/devblogs.microsoft.com\/devops\/wp-content\/uploads\/sites\/6\/2023\/11\/change-parent-2-300x250.png 300w\" sizes=\"(max-width: 624px) 100vw, 624px\" \/><\/a><\/p>\n<p><a href=\"https:\/\/learn.microsoft.com\/en-us\/azure\/devops\/boards\/backlogs\/organize-backlog?view=azure-devops\" rel=\"noopener\" target=\"_blank\">Learn more<\/a> about how to organize your backlog and map child work items to parents in Azure Boards.<\/p>\n<h2>Summary<\/h2>\n<p>The workflows may differ between the two experiences. While there is an increased reliance on the web, most tasks can be accomplished across the web and the new view, just as they were in the legacy view. As mentioned earlier, the plan is to phase out the legacy experience in the next major version of Visual Studio, but this transition is expected to take place over the next couple of years, providing ample time for users to adapt to the new experience \ud83d\ude0a.<\/p>\n<p>If you have any questions or want to provide some feedback, please <a href=\"mailto:dahellem@microsoft.com\" rel=\"noopener\" target=\"_blank\">email us<\/a> directly.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Several years ago, with the introduction of Visual Studio 2019, we launched a completely revamped work item experience. This updated view operates entirely on REST, replacing the deprecated SOAP APIs utilized in the legacy version. Although Visual Studio 2022 still includes the option to revert to the legacy view, the majority of our users have [&hellip;]<\/p>\n","protected":false},"author":921,"featured_media":65872,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[227,224,229,1,225],"tags":[],"class_list":["post-68130","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-agile","category-azure","category-community","category-devops","category-git"],"acf":[],"blog_post_summary":"<p>Several years ago, with the introduction of Visual Studio 2019, we launched a completely revamped work item experience. This updated view operates entirely on REST, replacing the deprecated SOAP APIs utilized in the legacy version. Although Visual Studio 2022 still includes the option to revert to the legacy view, the majority of our users have [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/68130","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\/921"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=68130"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/68130\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/65872"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=68130"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=68130"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=68130"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}