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
