Shai Raiten's Blog : .NET 4.5, TFS 11, DEV

TFS API Part 47 (VS11) – Manage Iterations Dates

shair — Mon, 28 May 2012 15:26:00 GMT

Over the last posts I talked about “TFS API Part 46 (VS11) – Team Settings”, in this post I’ll show how to get and change Iteration Dates from TFS API.

We’ll show all Teams under a specific Team Project and once you click on a Team you will see its Iterations and Dates.

Download Demo Project

Step 1: Create Project and Add Reference

Create an WPF application and add the following references:

First add reference for:

Microsoft.TeamFoundation.Build.Client (11.0.0.0)
Microsoft.TeamFoundation.Build.Common.dll (11.0.0.0)
System.Windows.Forms.dll

(C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\ReferenceAssemblies\v2.0\)

Step 2: Connect and Get Teams

We need to get the TeamSettingsConfigurationService so we’ll have all teams settings and also we need to obtain the ICommonStructureService4 service - Defines methods for working with the common structures Areas and Iterations.

private void btnConnect_Click(object sender, RoutedEventArgs e)

{

var tpp = new TeamProjectPicker(TeamProjectPickerMode.SingleProject, false);

tpp.ShowDialog();

if (tpp.SelectedTeamProjectCollection == null) return;

tfs = tpp.SelectedTeamProjectCollection;

projectInfo = tpp.SelectedProjects[0];

teamConfig = tfs.GetService<TeamSettingsConfigurationService>();

css = tfs.GetService<ICommonStructureService4>();

GetTeams();

}

The GetTeams method use the GetTeamConfigurationsForUser method from TeamSettingsConfigurationService to get all teams settings.

void GetTeams()

{

var configs = teamConfig.GetTeamConfigurationsForUser(new[] { projectInfo.Uri });

listTeams.ItemsSource = configs;

}

Step 3: Get Team Iterations

Step 4: Get All Iteration Tree

So as we took the Iterations from specific Team we can take all Iterations under Team Project and build the full tree includes Iteration dates.

I’ve add a button on the top right corner of the application, when you click on that button we using the ICommonStructureService4 ListStructures method to get the iteration tree and then export the nodes under the iteration (the list structure has Area and Iteration inside it)

private void btnFullTree_Click(object sender, RoutedEventArgs e)

{

treeIterations.Items.Clear();

NodeInfo[] structures = css.ListStructures(projectInfo.Uri);

NodeInfo iterations = structures.FirstOrDefault(n => n.StructureType.Equals("ProjectLifecycle"));

XmlElement iterationsTree = css.GetNodesXml(new[] { iterations.Uri }, true);

var root = new TreeViewItem();

root.Header = projectInfo.Name;

BuildIterationTree(iterationsTree.ChildNodes, root);

treeIterations.Items.Add(root);

}

Now as we did for the Team Iterations (there we passed string[]) now we’re passing list of nodes.

The easiest way here to obtain the NodeInfo object is using GetNode method (by id), so I extract the Node Id from the Node Xml and using that ID I can get the NodeInfo.

void BuildIterationTree(XmlNodeList subItems, TreeViewItem item)

{

foreach (XmlNode node in subItems)

{

var nodeId = GetNodeID(node.OuterXml);

var nodeInfo = css.GetNode(nodeId);

var subTreeItem = new TreeViewItem();

subTreeItem.Header = string.Format("{0} - Start: {1} - Finish: {2}", nodeInfo.Name, nodeInfo.StartDate, nodeInfo.FinishDate);

item.Items.Add(subTreeItem);

if (node.ChildNodes.Count > 0)

{

BuildIterationTree(node.ChildNodes, subTreeItem);

}

Download Demo Project

Enjoy.

TFS API Part 46 (VS11) – Team Settings

shair — Wed, 23 May 2012 16:35:00 GMT

In the previous posts “TFS API Part 45 (VS11) – Modify Teams and Team Members” I talked about Teams, from getting all team to modify and creating new Team using TFS API.

Now, Teams are more than just a “Security Group”, they hold specific settings such as relevant Areas/Iteration for that Team.

The “Team” can be assigned to Backlog Iteration (Set as Team’s backlog Iteration), this takes all paths under that iteration and add them to the team backlog. You can also change the Iteration backlog to another path (not just the root), you just need at least one child below.

And from TFS 11 you can define Start Date and End Date for Iterations, and there is a cool fact – those dates are not just for beauty – TFS takes those iterations and automatically show you what is the current Iteration that you working on, what iterations you completed (past) and what iterations are next. you might have overlap iterations but for some reason you can only have one “Current” iteration.

The “Current” iteration is defined by the iteration for which the start date is less than or equal to today’s date and the end date is greater than or equal to today and than is just sorted by Name.

After you define the Iterations for the Project and for each Team you might want to define the Areas for the Team, you can also define a Default Area – Means that each work item you open under that Team.

When you define “Area\s” for Team this means that when you enter your Product Backlog (not query) you will only see work items under that “Area” (you choose if to include sub-areas)

Now, after we understand what and why let’s talk about How using TFS API.

Download Demo Project

Step 1: Create Project and Add Reference

Create an WPF application and add the following references:

First add reference for:

Microsoft.TeamFoundation.Build.Client (11.0.0.0)
Microsoft.TeamFoundation.Build.Common.dll (11.0.0.0)
System.Windows.Forms.dll

(C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\ReferenceAssemblies\v2.0\)

Step 2: Connect and Get Teams Settings

In the previous posts we used TfsTeamService to get all teams under the Team Project. another way is to use the TeamSettingsConfigurationService.

The TeamSettingsConfigurationService has two methods:

GetTeamConfigurationsForUser
SetTeamSettings

We’ll use the GetTeamConfigurationsForUser passing the Project Uri, this will return all Teams under that project.

private void btnConnect_Click(object sender, RoutedEventArgs e)

{

var tpp = new TeamProjectPicker(TeamProjectPickerMode.SingleProject, false);

tpp.ShowDialog();

if (tpp.SelectedTeamProjectCollection == null) return;

tfs = tpp.SelectedTeamProjectCollection;

projectInfo = tpp.SelectedProjects[0];

teamConfig = tfs.GetService<TeamSettingsConfigurationService>();

GetTeams();

}

void GetTeams()

{

var configs = teamConfig.GetTeamConfigurationsForUser(new[] { projectInfo.Uri });

listTeams.ItemsSource = configs;

}

Step 3: Get Team Settings

Now when you select a Team from the Teams list we’ll use the TeamSettings object to pull the Areas + Iterations for that Team. You will also have the BacklogIterationPath and CurrentiterationPath properties (as we talked above).

private void listTeams_SelectionChanged(object sender, SelectionChangedEventArgs e)

{

if (listTeams.SelectedItem == null) return;

var teamConfig = listTeams.SelectedItem as TeamConfiguration;

txtBacklogIteration.Text = teamConfig.TeamSettings.BacklogIterationPath;

txtCurrentIteration.Text = teamConfig.TeamSettings.CurrentIterationPath;

listIterations.ItemsSource = teamConfig.TeamSettings.IterationPaths;

listAreas.ItemsSource = teamConfig.TeamSettings.TeamFieldValues;

}

Download Demo Project

Enjoy

TFS API Part 45 (VS11) – Modify Teams and Team Members

shair — Mon, 21 May 2012 12:42:00 GMT

In my previous post “Teams and Team Members” I talked about new Service in TFS API called – TfsTeamService. Using this service we can control Teams and Team Members under TFS.

We can create and remove Teams and Team Members using TFS API. I know this can be quite confusing but Teams in TFS are simply Group (Security Group), same as Contributors, Administrators etc.

If you open Security tab under TFS Web Management you can see that there is two separate lists of Groups – Teams and TFS Groups, I’ll show how to separate between Teams and Groups.

In order to add members or remove them from specific Team we need to use the IGroupSecurityService. You can read more here:

The application below will show you two lists: Groups and Teams.
Then you will be able to Remove the Team or Group and for each you can get the members under it.
You can also create new Team.

Download Demo Project

Step 1: Create Project and Add Reference

Create an WPF application and add the following references:

First add reference for:

Microsoft.TeamFoundation.Build.Client (11.0.0.0)
Microsoft.TeamFoundation.Build.Common.dll (11.0.0.0)
System.Windows.Forms.dll

(C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\ReferenceAssemblies\v2.0\)

Step 2: Connect Team Foundation Server

Connect to TFS and obtain the TfsTeamService so we get the Team list and we need the IGroupSecurityService so we can add / remove Members and Groups.

private void btnConnect_Click(object sender, RoutedEventArgs e)

{

var tpp = new TeamProjectPicker(TeamProjectPickerMode.SingleProject, false);

tpp.ShowDialog();

if (tpp.SelectedTeamProjectCollection == null) return;

tfs = tpp.SelectedTeamProjectCollection;

teamService = tfs.GetService<TfsTeamService>();

projectInfo = tpp.SelectedProjects[0];

gss = (IGroupSecurityService)tfs.GetService(typeof(IGroupSecurityService));

GetTeams();

GetGroups();

}

To get the Teams list you only need to use the TFSTeamService and call the QueryTeams method.

For getting the Project Groups we’ll use the IGroupSecurityService calling ListApplicationGroups passing the project uri, this will return all groups under that Team Project (also the teams), in order to exclude teams from that list I did a query to verify for each item that his Sig doesn't exists in the TeamsList.

void GetTeams()

{

_teams = teamService.QueryTeams(projectInfo.Uri).ToList();

listTeams.ItemsSource = _teams;

}

void GetGroups()

{

Identity[] groups = gss.ListApplicationGroups(projectInfo.Uri);

var query = from _group in groups

where _group.Type == IdentityType.ApplicationGroup

&& !_teams.Any(t => t.Identity.Descriptor.Identifier.Equals(_group.Sid))

select _group;

listGroups.ItemsSource = query;

}

Step 3: Add And Remove

Now to the easy part, to Create new Team just use the TfsTeamService and use the CreateTeam method.

Use the IGroupSecurityService to Add members to Team or Group (The Same…) remove team/groups – you can ream more here - TFS API Part 41–Manage Groups and Members

teamService.CreateTeam(projectInfo.Uri, txtTitle.Text, txtDescription.Text, null);

gss.DeleteApplicationGroup(teamSid);

TfsTeamService

namespace Microsoft.TeamFoundation.Client

{

public class TfsTeamService

{

public TfsTeamService();

public TeamFoundationTeam CreateTeam(string projectId, string name, string description, IDictionary<string, object> properties);

public TeamFoundationTeam GetDefaultTeam(string projectUri, List<string> propertyNameFilters);

public Guid GetDefaultTeamId(string projectUri);

public void Initialize(TfsConnection tfsConnection);

public IEnumerable<TeamFoundationTeam> QueryTeams(IdentityDescriptor descriptor);

public IEnumerable<TeamFoundationTeam> QueryTeams(string projectId);

public IEnumerable<TeamFoundationTeam> QueryTeams(IdentityDescriptor descriptor, List<string> propertyNameFilters);

public TeamFoundationTeam ReadTeam(Guid teamId, List<string> propertyNameFilters);

public TeamFoundationTeam ReadTeam(IdentityDescriptor descriptor, List<string> propertyNameFilters);

public TeamFoundationTeam ReadTeam(string projectId, string teamName, List<string> propertyNameFilters);

public void SetDefaultTeam(TeamFoundationTeam team);

public void SetDefaultTeamId(string projectUri, Guid teamId);

public void UpdateTeam(TeamFoundationTeam team);

}

Download Demo Project

אז מה חדש ב–TFS 11

shair — Tue, 27 Sep 2011 21:08:00 GMT

HTML + Images - זה לא כלי חדש בגרסה הבאה אבל ללא ספק אחד הדברים המרגשים ביותר –> סוף סוף הכניסו את היכולת להוסיף תמונות בשדות HTML זה כבר שווה את המעבר!!!

Scrum – ב – TFS 11 הינה מילת מפתח חשובה וחלק כמעט בלתי נפרד מהמערכת, מגוון כלים והתאמות שנאלצנו לבצע על מנת להפוך את TFS לסביבת Scrum נוחה, עכשיו מגיע Scrum עם TFS 11 כחלק מהחבילה ומאפשר לנו לעבוד עם איטרציות, הגדרת תאריך סיום והתחלה לאינטרציה, ניהול משימות נוח, חלוקת עדיפויות ועוד דברים בסיסים בניהול תהליך Scrum.
* כמובן שלא חייבים לעבוד Scrum או Agile ועדיין המערכת תעבוד ותתן לנו את יכולות הניהול על כל מתודולוגיה שנבחר.

עיצוב \ ביצועים – המראה החדש שמגיע עם ממשק האינטרנטי של TFS הוא דבר יפה ונוח אבל חשוב מכך הם הביצועים והיכולות שניתנים לנו.
יכולות גרירה של משימות לאיטרציות, לאנשים וכמובן העברה של משימה לסטאטוס שונה והכל מבוסס על פעולות אסיכרוניות – כלומר לא צריך לחכות עד שהשמירה תסתיים והכל קורה ברקע בלי שאנחנו נצטרך להמתין.

TFS עובר לענן – רעיון הענן לא חדש ותופס תאוצה רבה במיקרוסופט העולמית, גם TFS נכנס לתמונה, עדיין לא ידע בדיוק מה המחיר או שיטת העבודה מול מיקרוסופט בנושא אבל סביר להניח שתוכלו לרכוש שרת TFS בענן ובכך לא תצטרכו לרכוש חומרה מיוחדת או לדאוג לתחזוקה שותפת של השרת – הכל שמור ומטופל בענן!

שיפור חווית מפתח - Code Review מובנה ב – Team Explorer וממשק ניהול עבודה נוח במיוחד.
כמפתח אוכל להעביר את הקוד שכתבתי לחבר אחר בצוות בשביל לקבל חוות דעת והמלצות, וכמובן להעביר את הקוד שלי לבדיקה ע”י ראש צוות וכו.
כלים לבדיקת קוד משוכפל (הרי רוב הבעיות מגיעות שאנחנו עושים Copy Paste ), כמובן שהם לא בודקים טקסט משוכפל אלא לוגיקה זהה ומאפשרות לנו לאתר נוקודות בעייתיות.

בדיקות – מעבר לשיפורים בביצועים תמיכה במגוון לפטפורמות לבדיקות Unit Test נוספה יכולת חשובה מאוד לעולם הבדיקות הידניות - Exploratory Testing – בהרבה מקרים אנשי בדיקות לא פועלים לפי תסריט בדיקות מוכן אלא כמו שאומרים “זורמים” ומבצעים בדיקה חופשית על המערכת, במהלך בדיקה חופשית יכול להיות שנגלה באג חדש במערכת ואז נצטרך לתאר מה עשינו בשביל למצוא אותו וכמובן לכתוב תסריט בדיקה מתאים, ב – Microsoft Test Manager 11 תוכלו להשתמש ביכולת ה - Exploratory Testing בשביל לבצע בדיקה חופשית ובמקרה של מציאת באג הכלי יודע לפתוח באג ובו הצעדים המדוייקים לפעולות שבוצעו ובנוסף ניתן יהיה ליצור תסריט מאותם צעדים.

זאת היה טעימה מהגרסה הבאה של Visual Studio 11 ו – TFS 11.

התרשמתם? רוצים להתרשם בעצמכם?

בריאן קלר (Brian Keller) בנה מכונה וירטואלית עם סביבת TFS 11 ו – Visual Studio 11 אז נסו בעצמכם - http://aka.ms/VS11ALMVM

בהצלחה!