Urban Turtle users often ask about why they do not have access to the real-time hour burndown introduced in version 3.5. While somewhat technical, the reason is actually pretty simple. Urban Turtle relies entirely upon Team Foundation Server to store any information regarding your project. As you probably know, classification in TFS is based on iterations and areas. Besides the name of the classification node itself, there is no other way to store iteration and/or area metadata. To work around this limitation, popular process templates such as Visual Studio Scrum 1.0 and Scrum for Team System have introduced the Sprint work item type definition. The sole purpose of this work item is to store information regarding your team sprints. Among other things, it lets you specify start and end dates, which are obviously a prerequisite to create a hour burndown chart.
The MSF Agile 5.0 process template does not specify such a work item type. Fortunately, Team Foundation Server is designed to let you customize your project’s template to better reflect your business process. It is therefore rather easy to add a Sprint work item type to an existing MSF Agile 5.0 project. In this blog entry, I will show you how to import the Sprint work item type definition from Visual Studio Scrum 1.0 into an existing MSF Agile 5.0 project.
Prerequisites
Sprint work item type definition
You will need to know the location of the Sprint work item type definition from the Visual Studio Scrum 1.0 process template. If you haven’t done so already, you can download this process template from the Visual Studio Gallery on MSDN. If you install the process template in the default path, you will find the Sprint definition file (Sprint.xml) under ‘C:\Program Files (x86)\Microsoft\Microsoft Visual Studio Scrum 1.0\Process Template\WorkItem Tracking\TypeDefinitions’.
witadmin.exe
Importing a work item type is done through the use of a command-line utility known as witadmin. You must first locate this utility on your computer, preferably on your server hosting Team Foundation Server. If you have Visual Studio 2010 installed, you should be able to launch a Visual Studio Command Prompt from the Start menu, which will allow you to skip searching for the executable file itself. Otherwise, the file can be found by default (on an x64 installation) under ‘C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\witadmin.exe’.
While this article describes how to use the witadmin utility, you could choose to use the Team Foundation Server Power Tools which Mathieu refers to in his Approval feature with MSF Agile 5.0 article.
Importing the Sprint work item type
- Start by launching a Visual Studio command prompt (if available) or a standard command prompt. If the former is unavailable to you, make sure to navigate to the location of the witadmin utility. Check the prerequisites above to help you locate it.
- Launch the witadmin utility by specifying the following arguments:
/collection: The URL of the Team Foundation Server collection that contains the MSF Agile 5.0 project.
/p: The name of the MSF Agile 5.0 project
/f: The path of the Sprint.xml file, enclosed in double quotes.For example, using the arguments that match your environment, type the following command and press ENTER:
witadmin importwitd /collection:http://localhost:8080/tfs/DefaultCollection /p:Agile /f:"C:\Program Files (x86)\Microsoft\Microsoft Visual Studio Scrum 1.0\Process Template\WorkItem Tracking\TypeDefinitions\Sprint.xml"
- If all goes as expected, the following message will appear: “The work item type import has completed”.
Configuring Urban Turtle to recognize the Sprint work item type
Urban Turtle uses what we call Configuration Mapping Files to deal with differences between process templates. You can create your own mapping file and configure your project to use it. By default, the mapping files can be found under ‘C:\Program Files\Microsoft Team Foundation Server 2010\Application Tier\Web Access\Web\UrbanTurtle\configuration\project’. We must advise against editing one of the default files as these get removed when uninstalling the application.
- Start by copying the MSF Agile 5.0.xml file, and open the copy using any text editor. Locate the
TemplateConfiguration element at the top of the document and change the Name attribute to something like “MSF Agile 5.0 – Burndown”.
- For Urban Turtle to recognize the new Sprint work item type, you must add an entry in the mapping file, telling it exactly what work item type represents a Sprint. It could be any type, but it must have fields to contain the start date, end date and a description (or sprint goal). Since we are using the Sprint work item type definition from Visual Studio Scrum 1.0, you can copy the required configuration from the default mapping file for this process template and append it to the Features element.

- The last step required is to configure your project to use the new mapping file. This is done through the Configuration page in Urban Turtle, accessible from the Configuration option under the Project menu.

- Simply select the new “MSF Agile 5.0 – Burndown” and then click the Apply button to save your selection.

Using the Hour Burndown
Displaying the Hour Burndown requires you to create a Sprint work item in the selected iteration. This is made very simple by Urban Turtle just by clicking the Sprint Details icon on the iteration box.
Once you have specified start and end dates for your sprint, you can display the Hour Burndown. First, make sure the iteration is selected in the iteration panel and then click on the Burndown button on the toolbar.
![]()
Voilà, a real-time Hour Burndown with MSF Agile 5.0!

As you can see, just about any feature that is not available out of the box with your process template may be enabled by customizing your project and creating a custom configuration mapping file. Some of you may recall that we had already shown how to enable the Recycle bin functionality for MSF Agile 5.0 projects. With these features enabled, MSF Agile 5.0 users have no reason to feel left out when using Urban Turtle!















