a·gen·tic a·gil·i·ty

Customise the colours in Team Foundation Server 2013 Agile Planning Tools

Learn how to change work item colours in TFS 2013 Agile Planning Tools by editing the Process Configuration XML file and updating hex colour codes for each item type.

Published on
3 minute read
Image
https://nkdagility.com/resources/2kvi44Dp0xl
Subscribe

If you want to customise the colours in Team Foundation Server 2013 Agile Planning Tools you need to download and edit the Process Configuration file that tells TFS how to configure many of the features in the Web Access.

There used to be two files in Team Foundation Server 2012 but this was confusing and the amalgamation to a single configuration file just made sense.

Customise the colours in Team Foundation Server 2013 Agile Planning Tools

Figure: Colour coded Work Item Types are easy to distinguish

The colours that you pick will be displayed wherever a work item is displayed. Wither that is in a list or a card on one of the boards the same coloured bar will be displayed on the left. This really helps distinguish between them and highlights things like Bugs in a list of Product Backlog Items.

To configure this we need to first export (download) the existing processing configuration to a location we can find.

1$TeamProjectName = "teamswithareas"
2$tempFolder = "C:temp"
3$CollectionUrl = "http://kraken:8080/tfs/tfs01"
4$WitAdmin = "${env:ProgramFiles(x86)}Microsoft Visual Studio 12.0Common7IDEwitadmin.exe"
5
6# Export the existing Processing configuration
7& $WitAdmin exportprocessconfig /collection:$CollectionUrl /p:$TeamProjectName /f:"$tempFolderProcessConfiguration.xml"

Once you have that we need to find and edit the colours and Paint as usual does not cut the mustard. You will need to know the hex value of the colours and that can be easily found if you use something like Paint.Net or http://www.colorpicker.com/ where they let you pick colours.

Note These colours are 8 digit HEX as they include transparency. The first two digits are the setting for transparency and “FF” denotes fully visible.

 1<workitemcolors>
 2  <workitemcolor name="Product Backlog Item" secondary="FFD6ECF2" primary="FF009CCC" />
 3  <workitemcolor name="Feature" secondary="FFEEE2F2" primary="FF773B93" />
 4  <workitemcolor name="Task" secondary="FFF6F5D2" primary="FFF2CB1D" />
 5  <workitemcolor name="Bug" secondary="FFFAEAE5" primary="FFCC293D" />
 6  <workitemcolor name="Code Review Request" secondary="FFFCEECF" primary="FFFF9D00" />
 7  <workitemcolor name="Code Review Response" secondary="FFFCEECF" primary="FFFF9D00" />
 8  <workitemcolor name="Feedback Request" secondary="FFFCEECF" primary="FFFF9D00" />
 9  <workitemcolor name="Feedback Response" secondary="FFFCEECF" primary="FFFF9D00" />
10  <workitemcolor name="Impediment" secondary="FFFCEECF" primary="FFFF9D00" />
11  <workitemcolor name="Shared Steps" secondary="FFFCEECF" primary="FFFF9D00" />
12  <workitemcolor name="Test Case" secondary="FFFCEECF" primary="FFFF9D00" />
13</workitemcolors>

If you open the XML and look for the “workitemcolors” element (no idea why they insist on spelling it wrong) you will find an entry for each of the Work Item Types available.

1$TeamProjectName = "teamswithareas"
2$tempFolder = "C:Temp"
3$CollectionUrl = "http://kraken:8080/tfs/tfs01"
4$WitAdmin = "${env:ProgramFiles(x86)}Microsoft Visual Studio 12.0Common7IDEwitadmin.exe"
5
6# Import the new Processing configuration
7& $WitAdmin importprocessconfig /collection:$CollectionUrl /p:$TeamProjectName /f:"$tempFolderProcessConfiguration.xml"

All we need to do is edit the colour codes and then import (upload) the process configuration again. Here I am going to change the PBI to Pink (#FF16D0) which has a value of FFFF16D0 with a secondary (faded) colour of FFFFD1D0.

Customise the colours in Team Foundation Server 2013 Agile Planning Tools

Figure: Lovely pink PBI’s

And voilà you now have just what you always wanted… pink PBI’s.

Install and Configuration System Configuration
Subscribe

Related Blog

No related videos found.

Connect with Martin Hinshelwood

If you've made it this far, it's worth connecting with our principal consultant and coach, Martin Hinshelwood, for a 30-minute 'ask me anything' call.

Our Happy Clients​

We partner with businesses across diverse industries, including finance, insurance, healthcare, pharmaceuticals, technology, engineering, transportation, hospitality, entertainment, legal, government, and military sectors.​

New Signature Logo

New Signature

Teleplan Logo

Teleplan

Microsoft Logo

Microsoft

Sage Logo

Sage

Boeing Logo

Boeing

Cognizant Microsoft Business Group (MBG) Logo

Cognizant Microsoft Business Group (MBG)

Brandes Investment Partners L.P. Logo

Brandes Investment Partners L.P.

Genus Breeding Ltd Logo

Genus Breeding Ltd

Slicedbread Logo

Slicedbread

Boxit Document Solutions Logo

Boxit Document Solutions

Kongsberg Maritime Logo

Kongsberg Maritime

NIT A/S

Graham & Brown Logo

Graham & Brown

YearUp.org Logo

YearUp.org

Schlumberger Logo

Schlumberger

Emerson Process Management Logo

Emerson Process Management

Big Data for Humans Logo

Big Data for Humans

Alignment Healthcare Logo

Alignment Healthcare

Washington Department of Transport Logo

Washington Department of Transport

Royal Air Force Logo

Royal Air Force

Ghana Police Service Logo

Ghana Police Service

Nottingham County Council Logo

Nottingham County Council

New Hampshire Supreme Court Logo

New Hampshire Supreme Court

Washington Department of Enterprise Services Logo

Washington Department of Enterprise Services

Lockheed Martin Logo

Lockheed Martin

DFDS Logo

DFDS

Philips Logo

Philips

Alignment Healthcare Logo

Alignment Healthcare

MacDonald Humfrey (Automation) Ltd. Logo

MacDonald Humfrey (Automation) Ltd.

Ericson Logo

Ericson