Download Demo Solution - here In this blog post I’ll show you how to use the TFS API to get the name of the
Process Template that is currently applied to the Team Project. You can also download the demo solution attached, I’ve tested this solution against TFS 2010
and TFS 2011. 1. Connecting to TFS Programmatically I have a blog post that shows you from where to download the VS 2010 SP1 SDK
and how to connect to TFS programmatically. private TfsTeamProjectCollection _tfs;
private string _selectedTeamProject;
TeamProjectPicker tfsPP = new TeamProjectPicker(TeamProjectPickerMode.SingleProject, false);
tfsPP.ShowDialog();
this._tfs = tfsPP.SelectedTeamProjectCollection;
this._selectedTeamProject = tfsPP.SelectedProjects[0].Name;
2. Programmatically get the
Process Template details of the selected Team Project
I’ll be making use of the VersionControlServer service to get the Team Project details
and the ICommonStructureService to get the Project Properties.
private ProjectProperty[] GetProcessTemplateDetailsForTheSelectedProject()
{
var vcs = _tfs.GetService<VersionControlServer>();
var ics = _tfs.GetService<ICommonStructureService>();
ProjectProperty[] ProjectProperties = null;
var p = vcs.GetTeamProject(_selectedTeamProject);
string ProjectName = string.Empty;
string ProjectState = String.Empty;
int templateId = 0;
ProjectProperties = null;
ics.GetProjectProperties(p.ArtifactUri.AbsoluteUri, out ProjectName, out ProjectState, out templateId, out ProjectProperties);
return ProjectProperties;
}
3. What’s the catch?
The ProjectProperties will contain a property “Process Template” which as a value has the name of the
process template. So, you will be able to use the below line of code to get the name of the
process template.
var processTemplateName = processTemplateDetails.Where(pt => pt.Name == "
Process Template").Select(pt => pt.Value).FirstOrDefault();
However, if the
process template does not contain the property “Process Template” then you will need to add it. So, the question becomes how do i add the Name property to the
Process Template.
Download the
Process Template from the
Process Template Manager on your local
Once you have downloaded the
Process Template to your local machine, navigate to the Classification folder with in the template
From the classification folder open Classification.xml
Add a new property <property name=”Process Template” value=”MSF for CMMI
Process Improvement v5.0” />
4. Putting it all together…
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using Microsoft.TeamFoundation.Client;
using Microsoft.TeamFoundation.VersionControl.Client;
using Microsoft.TeamFoundation.Server;
using System.Diagnostics;
using Microsoft.TeamFoundation.WorkItemTracking.Client;
namespace TfsAPIDemoProcessTemplate
{
public partial class Form1 : Form
{
public Form1()
{
InitializeComponent();
}
private TfsTeamProjectCollection _tfs;
private string _selectedTeamProject;
private void btnConnect_Click(object sender, EventArgs e)
{
TeamProjectPicker tfsPP = new TeamProjectPicker(TeamProjectPickerMode.SingleProject, false);
tfsPP.ShowDialog();
this._tfs = tfsPP.SelectedTeamProjectCollection;
this._selectedTeamProject = tfsPP.SelectedProjects[0].Name;
var processTemplateDetails = GetProcessTemplateDetailsForTheSelectedProject();
listBox1.Items.Clear();
listBox1.Items.Add(String.Format("Team Project Selected => '{0}'", _selectedTeamProject));
listBox1.Items.Add(Environment.NewLine);
var processTemplateName = processTemplateDetails.Where(pt => pt.Name == "
Process Template")
.Select(pt => pt.Value).FirstOrDefault();
if (!string.IsNullOrEmpty(processTemplateName))
{
listBox1.Items.Add(Environment.NewLine);
listBox1.Items.Add(String.Format("
Process Template Name: {0}", processTemplateName));
}
else
{
listBox1.Items.Add(String.Format("The
Process Template does not have the 'Name' property set up"));
listBox1.Items.Add(String.Format("***TIP: Download the
Process Template
and in Classification.xml
add a new property Name, update the template then you will be able to see the
Process Template Name***"));
listBox1.Items.Add(String.Format(" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -"));
}
}
private ProjectProperty[] GetProcessTemplateDetailsForTheSelectedProject()
{
var vcs = _tfs.GetService<VersionControlServer>();
var ics = _tfs.GetService<ICommonStructureService>();
ProjectProperty[] ProjectProperties = null;
var p = vcs.GetTeamProject(_selectedTeamProject);
string ProjectName = string.Empty;
string ProjectState = String.Empty;
int templateId = 0;
ProjectProperties = null;
ics.GetProjectProperties(p.ArtifactUri.AbsoluteUri, out ProjectName, out ProjectState, out templateId, out ProjectProperties);
return ProjectProperties;
}
}
}
Thank you for taking the time out
and reading this blog post. If you enjoyed the post, remember to subscribe to http://feeds.feedburner.com/TarunArora. Have you come across a better way of doing this, please share your experience here. Questions/Feedback/Suggestions, etc please leave a comment.
Thank You!
Share this post :
CodeProject
