Jamie Kurtz

Promoting architectural simplicty

  Home  |   Contact  |   Syndication    |   Login
  27 Posts | 0 Stories | 54 Comments | 5 Trackbacks

News



Archives

As a follow-up to the TFS Work Item Tracking presentation I gave last night at IndyTFS, I want to provide some tips for getting started with editing work item types in TFS.

First and foremost, make sure you have downloaded and installed the latest Team Foundation Power Tools. The Process Template Editor is included in that tool set. The downloads and instructions for TFS 2005 are slightly different from those of TFS 2008. So I'll cover those separately below.

 

Version 2005

To download and install the Power Tools:

1. Download the 2005 Power Tools here. Note that you first need to install the DSL tools redistributable; just look further down on the page for its download

2. Install the DSL tools redistributable first, then the Power Tools itself

Once the Power Tools are installed:

1. Open the TFS client (i.e. Visual Studio 2005)

2. Make sure you have the Team Explorer window showing and a Team Project selected

3. Select Process Editor from the Team menu

clip_image002

4. Select Work Item Types -> Open WIT from Server

clip_image004

5. Enter the name of your TFS server in the dialog that pops up

clip_image006

6. In the next dialog, find and select the Work Item Type you want to edit

7. Click OK

At this point you are ready to edit and save the Work Item Type. Remember that saving it to the TFS server will immediately affect all users using that particular Work Item Type - so be careful!! Read below for some quick pointers on editing the Work Item Type.

 

Version 2008

To download and install the Power Tools:

1. Download the 2008 Power Tools here

2. Install the Power Tools

Once the Power Tools are installed:

1. Open the TFS client (i.e. Visual Studio 2008)

2. Make sure you have the Team Explorer window showing and a Team Project selected

3. Select Process Editor from the Tools menu (yes, they moved it from the Team menu to the Tools menu in going to 2008)

image

4. Select Work Item Types -> Open WIT from Server

image

5. Enter the name of your TFS server in the dialog that pops up (if it pops up)

clip_image006

6. In the next dialog, find and select the Work Item Type you want to edit

7. Click OK

At this point you are ready to edit and save the Work Item Type. Remember that saving it to the TFS server will immediately affect all users using that particular Work Item Type - so be careful!! Read below for some quick pointers on editing the Work Item Type.

 

Tips to edit your Work Item Type

This section simply throws out some simple tips for making changes to the Work Item Type. It is important to understand that the Work Item tracking capability within TFS, and the power of using the Process Editor to alter your development workflow, goes far beyond these few tips.

Making a field required - all the time

To make a field required, regardless of state or transition, open the field on the Fields tab. Then click the Rules tab on the Fields Definition dialog. Click the Add button to add a new rule. Then select the REQUIRED rule type. Click Ok. When the dialog pops up that prompts you to enter the "FOR" and "NOT FOR" permissions, just click OK. Click OK again to finish editing the field.

Making a field required - only when transitioning to a certain state

To make a field required when moving from state A to state B, you need to edit the field from within the Workflow designer. So first select the Workflow tab in the Work Item Type editor. Then looking at the visual workflow diagram, find the state on which you want to make a field required. For example, if you want to make the "Assigned To" required when moving a work item from Active to Resolved, find the little blue transition element that has a dot on the Active state, and an arrow on the Resolved state. Right-click on it, and select Open Details. On the dialog tha tpops up, select the Fields tab. If the fields you want to add the REQUIRED rule to is not already in the list, click the Add button. Otherwise, select the field and click the Open button. On the first tab of the Field Reference dialog, select your desired field from the dropdown. Then click the Rules tab, and click the Add button. This will pop the dialog allowing you to select your desired rule - in this example, the REQUIRED rule. Click Ok a few times, and now your field is required only in the given transition.

Adding dropdown list options to a field

Sometimes you have a text field, and you want to provide a list of options to the user. So, assuming you already have a text field on which you want to add or update a list, select the field form the Fields tab and click the open button. Then click on the Rules tab. Click the Add button. This time, instead of REQUIRED, we're going to select the ALLOWEDVALUES rule. After clicking OK, you are presented with a dialog that allows you to enter a list of strings for the dropdown options. Use the Add button, entering the option value and clicking OK, as many times as needed. Then click OK a few times. Your field will now be shown with a dropdown list of options.

 

More Information

To really learn how to edit Work Item Types, and also how to edit and create your own complete process templates, read the PEUserGuide Word document found in the "C:\Program Files\Microsoft Team Foundation Server Power Tools\Process Template Editor" after you install the 2005 Power Tools, and "C:\Program Files\Microsoft Team Foundation Server 2008 Power Tools\Process Template Editor" after you install the 2008 version of the Power Tools.

You can also find lots of information on utilizing the TFS Process Templates here. This site does a great job covering all the facets of implementing TFS Process Templates, and using the Power Tools to help you along the way. You will also find links to other process templates in the community - some free, and some not.

posted on Thursday, January 24, 2008 11:06 AM

Feedback

# re: TFS Process Template Editor 5/14/2008 4:52 AM Johan Bergens
I have VS2008 and installed the Power Tools for 2008 but I still can't see the process editor in the tools menu. The Power tools seems to be installed in a directory and I can run tfpt.exe from the command line.
Any ideas what is stopping the process editor from being included in the menu?

# re: TFS Process Template Editor 5/14/2008 9:27 AM Jamie Kurtz
I would make sure you have installed the 2008 Team Explorer - found here: http://www.microsoft.com/downloads/details.aspx?familyid=0ed12659-3d41-4420-bbb0-a46e51bfca86&displaylang=en.

Remember that the TFS client (i.e. Team Explorer) is shipped seperate from VS.

# re: TFS Process Template Editor 8/13/2008 5:50 AM Chris Hearson
I have installed the 2005 version and have a strange problem. When viewing a work item type the Transition control is missing from the WITDesigner toolbox - I only have the State control.

# re: TFS Process Template Editor 8/13/2008 6:16 AM Chris Hearson
This worked for me:

http://forums.microsoft.com/msdn/ShowPost.aspx?PostID=3396080&SiteID=1



# re: TFS Process Template Editor 1/20/2009 12:37 AM sohail sayed
Hi,
I could find the process editor as indicated above after i installed power tools for vs 2008 (i am using VS 2008). However once i installed Team System Management Model Designer Tool i can see the process editor in Tools Menu. Could this be because i have my tfs server on my same machine where i have installed the power tools (i am using a VPC)



# re: TFS Process Template Editor 1/20/2009 12:38 AM sohail sayed
In above i mean i couldnot find the process editor :-)

# re: TFS Process Template Editor 1/20/2009 1:12 AM sohail sayed
Ok. Looked like an installation issue. The process template editor was not working and when checked in my add remove programs i saw a lot of stuff installed which include power tools for vs 2005 and also for VS 2008 (I have both versions of VS installed). I just cleaned up by uninstalling the powertools and the d Team System Management Model Designer Tool and then reinstalled the power tools for vs 2008 and things work as described. Thanks.

# re: TFS Process Template Editor 1/14/2010 2:16 PM reader
Why is this page called "Process Template Editor" when it only talks about editing Work Items.

# re: TFS Process Template Editor 1/15/2010 9:25 AM M'Hammed
Hi,

I have a created a new work item type but I cannot see it when I wand to add a new work item.
I can see it through the process editor but nit in the project.

Any idea?

Thank you

# re: TFS Process Template Editor 1/17/2010 9:40 PM Jamie
Have you imported the new WIT into TFS? Using the Process Template Editor you can either open WITs from a file or you can open them from the TFS server. When saving WITs that were opened from or created on disk you need to then Import the file.

# re: TFS Process Template Editor 5/25/2010 1:04 PM Albert JP
In Visual Studio 2008 process editor is showed in "Tools/Process Editor"

# re: TFS Process Template Editor 5/25/2010 1:11 PM Albert JP
Correcting myself: "In visual studio 2008 the "Process Editor" is shown in "Tools/Process Editor.

# re: TFS Process Template Editor 4/19/2011 8:19 AM Mike Cheel
Thanks for this post! I know its around 3 years later but I found it very helpful.

# re: TFS Process Template Editor 4/9/2013 10:57 PM punit kumar
no comment

Post A Comment
Title:
Name:
Email:
Comment:
Verification: