Archive

Archive for May 27, 2012

TFS SDK: List the states transitions available for a WorkItemType

Go to the TFS Content Page


When a WorkItem is in a specific state, only states that have transition from the current state are availalbe.

The following code access the WoirkItemType XML definition and extract all transitions defined. The list returned contains the from and to state transition available.

private static IList<Transition> LoadTransitions(WorkItemType workItemType)
{
   XmlDocument workItemTypeXml = workItemType.Export(false);
            
   XmlNodeList transitionsList = workItemTypeXml.GetElementsByTagName("TRANSITIONS");
   XmlNode transitionsNode = transitionsList[0];

   var transistions = new List<Transition>();
   foreach (XmlNode transition in transitionsNode)
      transistions.Add(new Transition(transition.Attributes["from"].Value, transition.Attributes["to"].Value));
   return transistions;
}
Categories: C#, TFS

TFS SDK: List the iterations

Go to the TFS Content Page


You access the iterations via the Project’s IterationRootNodes properties.
The iterations are hierachical, you have a collection of nodes that have children.

A example that return a flat list of all iterations hierarchy:

public IList<string> GetIterationPaths(Project project)
{
   List<string> iterations = new List<string>();
   foreach (Node node in project.IterationRootNodes)
      AddChildren(string.Empty, node, iterations);
   return iterations;
}

private void AddChildren(string prefix, Node node, List<string> items)
{
   items.Add(node.Path);
   foreach (Node item in node.ChildNodes)
      AddChildren(prefix + node.Name + "/", item, items);
}
Categories: C#, TFS

TFS SDK: List the areas

Go to the TFS Content Page


You access the areas via the Project’s AreaRootNodes properties.
The areas are hierachical, you have a collection of nodes that have children.

A example that return a flat list of all areas hierarchy:

public IList<string> GetAreaPaths(Project project)
{
   List<string> areas = new List<string>();
   foreach (Node node in project.AreaRootNodes)
      AddChildren(string.Empty, node, this.areas);
   return areas;
}

private void AddChildren(string prefix, Node node, List<string> items)
{
   items.Add(node.Path);
   foreach (Node item in node.ChildNodes)
      AddChildren(prefix + node.Name + "/", item, items);
}
Categories: C#, TFS

TFS SDK: List the states of a WorkItemType

Go to the TFS Content Page


The state of a WorkItemType are stored in the WorkItemType xml definition. You need to export it using the Export method as follow:

public static IList<string> GetStates(WorkItemType wit)
{
   XmlDocument doc = wit.Export(false);

   XmlNodeList nodes = doc.DocumentElement.SelectNodes("WORKITEMTYPE/WORKFLOW/STATES/STATE");
   List<string> list = new List<string>();
   foreach (XmlNode node in nodes)
   {
      string name = node.Attributes["value"].Value;
      if (!string.IsNullOrEmpty(name) && !list.Contains(name))
         list.Add(name);
   }
   return list;
}
Categories: C#, TFS

TFS SDK: WorkItemFormControl, a TFS control to view and edit a WorkItem

Go to the TFS Content Page


The TFS SDK come with a WinForm control named WorkItemFormControl that display the informations related to a WorkItem. The control allow edition.

The WorkItemFormControl is in the library Microsoft.TeamFoundation.WorkItemTracking.Controls.dll that is located under C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies.

You will need to add a reference to this library and a using on the namespace Microsoft.TeamFoundation.WorkItemTracking.Controls.

Note: You need to target the framework .NET Framework 4 not the .NET Framework 4 Client Profile. (Project properties, tab application)

Let’s create a Form named FormWorkItem:

using Microsoft.TeamFoundation.WorkItemTracking.Client;

public partial class FormWorkItem : Form
{
 public FormWorkItem(WorkItem workItem)
 {
 InitializeComponent();
 }
}

Add the namespace for the control:

using Microsoft.TeamFoundation.WorkItemTracking.Controls;

Create and bind the WorkItemFormControl:

using Microsoft.TeamFoundation.WorkItemTracking.Controls;

public partial class FormWorkItem : Form
{
 private WorkItem workItem;

 public FormWorkItem(WorkItem workItem)
 {
 this.workItem = workItem;

 InitializeComponent();

 WorkItemFormControl control = new WorkItemFormControl();
 control.Item = workItem;
 control.ReadOnly = false;
 control.Dock = DockStyle.Fill;
 this.Controls.Add(control);

 this.Text = workItem.Type.Name + ": " + workItem.Id + " - " + workItem.Title;
 }
}

Let’s add a FormClosing event to save the WorkItem:

if (this.workItem.IsDirty)
{
 DialogResult result = MessageBox.Show("Do you want to save changes?", "Save", MessageBoxButtons.YesNoCancel, MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);
 if (result == System.Windows.Forms.DialogResult.Yes)
 {
 try
 {
 this.workItem.Save();
 }
 catch (Exception ex)
 {
 MessageBox.Show(ex.Message);
 }
 }
 else if (result == System.Windows.Forms.DialogResult.No)
 this.workItem.Reset();
 else
 e.Cancel = true;
}
Categories: C#, TFS