TFS 2017 Update 2 RC2 and work item type icons

Hello,

Thanks for visiting.  If you have installed Update 2 RC1 or RC2 for TFS 2017 you may have noticed that all of your work item icons are different colored clip boards with a checkmark.  It doesn’t have to be this way 🙂

If you would like to use the new icons that are included with Update 2 you just need to update your ProcessConfiguration file for your Team Project.

Here are the icons that are included with Update 2 (image from Microsoft)

It is very easy to update your ProcessConfiguration file, you use the witadmin utility to export the ProcessConfiguration file make the change and then import it.

The witadmin tool installs with any version of Visual Studio (even the free version Visual Studio Community)

cd C:\Program Files (x86)\Microsoft Visual Studio 15.0\Common7\IDE
witadmin exportprocessconfig /p:DemoProject /collection:https://tfs.ec.local/tfs/DefaultProjectCollection /f:"C:\Users\wes.macdonald\Documents\Agile\processconfig.xml"

Now open the processconfig.xml with notepad or your favorite text editor and locate the following XML tag <Properties> as shown below (left side):

 All you need to do is add a new Property tag with the following attributes and values (right side)

<Property name=”WorkItemTypeIcons” value=”Epic=Icon_Crown,Feature=Icon_Trophy,User Story=icon_book, Task=icon_clipboard,Bug=icon_insect,Issue=icon_traffic_cone, Test Plan=icon_test_plan,Test Suite=icon_test_suite,Test Case=icon_test_case,Shared Steps=icon_test_step, Shared Parameter=icon_test_parameter” />

Save the new processconfig.xml and import it using the witadmin utility

witadmin importprocessconfig /p:DemoProject /collection:https://tfs.ec.local/tfs/DefaultProjectCollection /f:"C:\Users\wes.macdonald\Documents\Agile\processconfig.xml"

You should now see the new icons displayed after refreshing your browser.

If you wish to read more about the various properties and behaviors see the documentation located here.