Shai Raiten's Blog : TFS

VS/TFS 2012 Update 2 & Update 3 CTP

shair — Wed, 08 May 2013 06:55:20 GMT

Couple of days ago Brian Harry post about the new release of Update 2 for Visual Studio and TFS 2012, and today another release of Update 3 that isn’t big a Update 1 and 2 but contains a set of bug fixes that can ease you work.

Before jumping to Update 3, if for some reason you’re not using Update 2 this is the time to read about it and install it!

Update 2

Update 3 – CTP

Visual Studio 2012.3 (Update 3) “go-live” CTP is now available

Installing it should be relatively straight forward – for both VS and TFS, just run the installer. There should be no compatibility breaks so you need not upgrade all of your components at once, though, over time, you should plan to get them all updated

List Of Improvements – Full List

Technology improvements - Team Foundation Server

Build settings can be preserved when you upgrade a TFS 2012 instance.
Improvements are made in the New Build Definition UI for the Continuous Integration (CI) build in Git-based team projects.

Visual Studio Test

Web test

Microsoft Visual Studio 2010 crashes when you create a Web test on a computer that has both Visual Studio 2010 Service Pack 1 (SP1) and Visual Studio 2012 Update 2 installed.

Coded UI test

You cannot run coded UI together with the cross browser testing feature by using Selenium components.

Load test

When you analyze a load test run, parts of the results are missing from the graph in the default view

Unit test

783438: Mstest.exe fails to execute unit because of missing assemblies

Administration and Operations

The event log does not include stack traces when the administrator console crashes.
You cannot configure TFS proxy on a computer that belongs to a separate domain from a TFS 2012 server.
TFS 2012 backup plan wizard does not report an error when you configure a backup plan by using the Local System account.
A user who does not have read permission on an area path can receive email notifications of changes to work items under the area path.
Slow performance when you open a work item that has many customized fields in TFS Web Access.
Fix adds upload retries for Version Control files that are being checked in or shelved to reduce the number of deceptive errors.
More

Enjoy

איך להגדיר ימי חופש של סבב פיתוח - יום שישי במקום ראשון

shair — Sun, 03 Mar 2013 10:42:00 GMT

אחד השינויים ב – TFS 11 מאפשר לנו להגדיר קבוצות פיתוח והגדרה של סבבי פיתוח עם תאריך התחלה וסיום (Sprint, Iteration וכו).

כאשר מתחילים לתכנן סבב פיתוח נראה חישוב של סה”כ ימי העבודה בסבב הנוכחי, אך סה”כ הימים לא יסתדר לכם כי הוא מחשב שיום ראשון אינו יום עבודה.

זאת שאלה שאני מקבל מהרבה לקוחות – איך אני משנה את תצוגת ה – Backlog שתתאים לימי המנוחה בארץ (שישי ושבת ולא שבת וראשון).

לדוגמא – אם הגדרנו סבב פיתוח מה – 3 לפברואר עד ה – 14 לפברואר – מדובר על 12 ימים סה”כ ו-10 ימי פיתוח אבל אנחנו נראה סה”כ 9 ימי פיתוח. (שני ימי ראשון + יום שבת = שלושה ימי חופש).

על מנת לסגר את TFS 11 שיתמוך בימי החופש בארץ נצטרך להשתמש בפקודת – witadmin שתאפשר לנו לשלוף את קובץ ההגדרות עבור ניהול הפרוייקט.

witadmin exportcommonprocessconfig /collection:http://tfsServer:8080/tfs /f:e:\projectConfig.xml /p:ProjectName

לאחר שהרצנו פקודה זאת ניפתח את הקובץ ונחפש את הטקסט הבא:

  <Weekends>
    <DayOfWeek>Sunday</DayOfWeek>
    <DayOfWeek>Saturday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

נשנה את הערך - Sunday ל – Friday, נשמור את הקובץ.

  <Weekends>
    <DayOfWeek>Friday</DayOfWeek>
    <DayOfWeek>Saturday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

לבסוף יש להריץ את אותה הפקודה אך במקום export נכתוב import:

witadmin importcommonprocessconfig /collection:http://tfsServer:8080/tfs /f:e:\projectConfig.xml /p:ProjectName

עכשיו אפשר להתחיל לעבוד!

תהנו!

TFS API Part 49 – Delete Team Project

shair — Wed, 20 Feb 2013 19:08:00 GMT

There are many improvements in TFS API for 2012 version, in my previous post I’ve talked about TFS API Part 48 – WorkItemControl And Bypass Work Item Rules that allow work item creation with bypass rule mode in WorkItemStore that allow you to create and change any field value without applying the WorkItem template rules.

in this post I’ll show how to delete Team Project using TFS API, be aware Delete Team Project is unrecoverable!

Download Demo Project

Step 1: Connect TFS and Getting Team Projects

Create WPF Application, and add the basic code for connecting TFS and collecting all Team Projects under that collection.

private TfsTeamProjectCollection _tfs;
private WorkItemStore _store;
private void btnConnect_Click(object sender, RoutedEventArgs e)
{
    var tpp = new TeamProjectPicker(TeamProjectPickerMode.NoProject, false);
    tpp.ShowDialog();

    if (tpp.SelectedTeamProjectCollection != null)
    {
        _tfs = tpp.SelectedTeamProjectCollection;
        _store = new WorkItemStore(_tfs);
        GetTeamProjects();
    }
}

private void GetTeamProjects()
{
    projectsList.ItemsSource = _store.Projects;
}

Step 2: Using TeamProjectDeleter

To delete Team Project we need to use a new API called – TeamProjectDeleter, you can find this dll here - C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\ReferenceAssemblies\v4.5\Microsoft.TeamFoundation.DeleteTeamProject.dll..

First create new TeamProjectDeleter object and pass the TfsCollection, Team Project name and force property.

You can also specify if you want to delete the Team Project WSS and finally calling the delete method to perform the Team Project delete operation.

private void btnDelete_Click(object sender, RoutedEventArgs e)
{
    if (projectsList.SelectedItem == null) return;

    var project = (Project)projectsList.SelectedItem;

    var force = chxForce.IsChecked == true ? true : false;
    try
    {
        var deleter = new TeamProjectDeleter(_tfs, project.Name, force);
        deleter.StatusEvent += deleter_StatusEvent;

        if (deleter.HasWssToDelete)
            deleter.ExcludeWss = chxExcludeWss.IsChecked == true ? true : false;

        var result = MessageBox.Show(string.Format("You are about to delete \"{0}\" project, are you sure you want to continue?",
            project.Name), "Delete Team Project", MessageBoxButton.OKCancel, MessageBoxImage.Warning);
        if (result == MessageBoxResult.OK)
        {
            var t = new Thread(new ThreadStart(deleter.Delete));
            t.Start();
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

void deleter_StatusEvent(object sender, TeamProjectDeleter.StatusEventArgs e)
{
    Execute ex = delegate()
    {
        txtLog.Text = e.message + Environment.NewLine + txtLog.Text;
    };
    this.Dispatcher.Invoke(ex);
}

Download Demo Project

TFS API Part 48 – WorkItemControl And Bypass Work Item Rules

shair — Wed, 20 Feb 2013 17:28:30 GMT

It’s been a while since I wrote about TFS API, not because there is no more about it is because I worked on Windows Store for the past couple of months so I didn’t had the time.

More About TFS API

So today post will be about two changes in TFS 2012, the first one is WorkItemControl based on WPF that replaced the WorkItemFormControl based on WinForms, the second will be about WorkItemStore bypass rule – Allowing you to save and change work item values without obeying the work item rules.

Download Demo Project

Step 1: Connect TFS

First create WPF application using Visual Studio 2012 and connect TFS using TeamProjectPicker API.

private void btnConnect_Click(object sender, RoutedEventArgs e)
{
    var pick = new TeamProjectPicker(TeamProjectPickerMode.NoProject, false);
    pick.AcceptButtonText = "I want this Team Project!";
    pick.ShowDialog();

    if (pick.SelectedTeamProjectCollection != null)
    {
        _tfs = pick.SelectedTeamProjectCollection;
        //WorkItemStoreFlags - Enum used to determine behavior of work item store object
        _store = new WorkItemStore(_tfs, WorkItemStoreFlags.BypassRules);
        btnShowWits.IsEnabled = true;
    }
    else
    {
        MessageBox.Show("Please select Team Project");
    }
}

Step 2: Query Work Items

No just for demo purpose I using the Store object to query all items in the collection.

private void btnShowWits_Click(object sender, RoutedEventArgs e)
{
    var workItems = _store.Query("SELECT [System.Id] FROM WorkItems");

    if (workItems.Count > 0)
    {
        btnShowWit.IsEnabled = true;
        workItemsList.ItemsSource = workItems;
    }
}

Step 3: Bypass WorkItemStore Rules

The interesting part in TFS 2012 that you can create the WorkItemStore object and specify if you want to work in BypassRule mode.

The Bypass Rule allow you to modify the work item fields without any restrictions, for example you can change “Created Date”, or “Created By” – that normally are blocked for changes.

private void chxBypassRules_Checked(object sender, RoutedEventArgs e)
{
    if (_tfs == null) return;
    _store = new WorkItemStore(_tfs, WorkItemStoreFlags.BypassRules);
}

private void chxBypassRules_Unchecked(object sender, RoutedEventArgs e)
{
    if (_tfs == null) return;
    _store = new WorkItemStore(_tfs, WorkItemStoreFlags.None);
}

Step 4: Show Work Item Control

After we specify the WorkItemStore mode we want to work with and have selected a Work Item from the list we want to display him outside Visual Studio using WorkItemControl.

The WorkItemControl needs the Item property set to the work item you want to display (or new work item), then create new Window object and set the WorkItemControl as the new Windows Content.

private void btnShowWit_Click(object sender, RoutedEventArgs e)
{
    if (workItemsList.SelectedItem == null) return;

    _witControl = new WorkItemControl();
    _witControl.Item = (WorkItem)workItemsList.SelectedItem;


    _container = new Window();
    _container.Content = _witControl;

    _container.Show();

    btnShowErrors.IsEnabled = true;
}

private void btnShowErrors_Click(object sender, RoutedEventArgs e)
{
    _witControl.ShowAllFieldErrors("Error Title", 99);
}

Download Demo Project

Enjoy

Getting Started With Git-TF Tool

shair — Mon, 31 Dec 2012 11:12:17 GMT

Git-TF tool release by Microsoft allowing developers to work locally using Git repository without any connection to TFS, if you wanted to work on your files locally (In case you don’t have internet connection) you had reopen the solution and work offline. TFS 2012 comes with new feature called – Local Workspace allowing developers to work locally on their files but without tracking the changes history – here comes Git-TF tool.

Brian Harry’s Blog

Distributed Version Control (DVCS) has a growing following. It enables a set of workflows that can be very handy and Git is an increasingly popular DVCS solution. Today, we are announcing Git-tf, a solution that enables you to work locally with a Git repo – edit, commit, revert, branch, merge, etc. and then “sync up” with a central TFS repository. In this way, you can have the best of both DVCS and TFS.

Getting Started with Git-TF Tool

Prerequisites

Download Microsoft Git-TF for Visual Studio Team Foundation Server 2012
Extract the zip content to C:\git-tf (or any other place)
Add the path where you extracted Git-TF (i.e. C:\git-tf) to your PATH environment variable.
Download Java from http://www.java.com and add the Java path to your PATH environment variable. (Step 2)
Download Git for Windows, and install it.

Setup Git User Information

Open PowerShell and execute the following commands:

PS C:\> git config --global user.email "shai.raiten[at]mail.com"
PS C:\> git config --global user.name "Shai Raiten"

TFS Source Control

I’ve create new Team Project called – Agile, and added new console application under Main folder.

The first thing before we can start using Git-TF tool is initializes a new git repo from an existing path in a TFS server using the clone command.

Run: git-tf clone http://TFSServerName:8080/tfs "$/Agile/Main”

Result:

PS C:\Users\Shai\Dev> git-tf clone http://lucy:8080/tfs "$/Agile/Main"
Connecting to TFS...
Cloning $/Agile/Main into C:\Users\Shai\Dev\Main: 100%, done.
Cloned changeset 19 as 6195f2e
PS C:\Users\Shai\Dev>

Change some files under your new Git repository.

I’ve also create new file (Program – Duplicate.cs)

To apply new change we’ll use the commit command:

Run: git commit -a -m "Add new file and new comment..."

Result:

PS C:\Users\Shai\Main> git commit -a -m "Add new file and new comment..."
[master 2feccf1] Add new file and new comment...
1 file changed, 1 insertion(+)
PS C:\Users\Shai\Main>

Now, let’s make things more complicated, I’ve checked in new change from TFS (Adding new comment)

Before you checked in your local git repository changes to TFS you want to fetches changes made in TFS as a new commit in Git, and merges the commit with the latest commit in the current branch.

Run: git-tf pull –rebase

Result:

PS C:\Users\Shai\Main> git-tf pull --rebase
Connecting to TFS...
jgit : Obtaining commits that need to be cherry-picked
jgit : Rewinding to commit Add new Comment - TFS
jgit : Applying Add new file and new comment...
Fetching and merging changes in $/Agile/Main at latest changeset: 100%, done.
All files were fetched to commit 1f59bb6. The rebase operation was stopped, please fix the issues and run "git rebase --
continue" to complete the operation.
PS C:\Users\Shai\Main>

We can see we have a conflict with TFS, if you open the the conflicted file you’ll see TFS and Git changes separated by OURS and THIERS comments.

Modify the file to resolve the conflict, and run git rebase –continue command to fix the conflict.

After we make sure there is no more conflict we can check in the Git repository changes to TFS by running the following command:

Run: git-tf checkin

Result:

PS C:\Users\Shai\main> git-tf checkin
Connecting to TFS...
Checking in to $/Agile/Main: 100%, done.
Checked commit de1ca4c in as changeset 21

Now we can see Git changes in TFS Source Control.

Enjoy.

Visual Studio\TFS 2012 Update 1 is available

shair — Wed, 28 Nov 2012 13:37:00 GMT

In previous post “Visual Studio 2012–News (iPhone, Web Test Management, 260 Limit and more)” I talked about the new Visual Studio 2012 Update 1 and what’s new for Visual Studio and TFS 2012.

So today Microsoft release :

Visual Studio 2012 Update 1 – Download
TFS 2012 Update 1 – Download

Update:

Error when installing TFS 2012 Update 1 - dbo.typ_BuildControllerTableV2 is incompatible with dbo.typ_BuildControllerTable

260 Character Path Limit

Some call this Microsoft “Achilles’ heel” but I’ll not do so far, this is with no doubt a very annoying bug that not once cause me to change and modify entire environments.

This will allow us more flexibility in Source Control usage.

Windows Development

Somasegar’s blog - A big focus area for us when designing Visual Studio 2012 was in enabling developers to build stellar apps for Windows, and that trend continues with Update 1, with which we’ve improved Windows development in a variety of areas. Back in June, we announced we would enable C++ applications to target Windows XP from Visual Studio 2012, and that support is now available as part of Update 1. For Windows Store applications for Windows 8, Visual Studio 2012 Update 1 includes support for both mixed-mode managed/native debugging and for native ARM dump debugging. Update 1 also includes improved diagnostics and testing support for Windows Store apps, such as with a JavaScript memory analysis tool, support for data-driven unit tests, and C++ unit testing enhancements. Additionally, for developers building apps for Windows Phone 8, we’ve enabled code analysis to help improve the quality of their phone apps.

Developer Productivity

Brian Harry - Code Map – Code Map is a super cool new feature in the architecture tools that allows me to incrementally build up an architecture/dependency diagram as I explore code. It makes walking into an existing code base and exploring it WAY easier than it ever has been before. You can incrementally lay out a diagram one element at a time (class, method, etc) as you explore the code. You can “query” to expand the diagram – like adding all derived classes or all referencing methods, etc to incrementally understand the code dependencies.

Additional Reading:

Visual Source Safe Upgrade Tool for Team Foundation Server

shair — Sun, 11 Nov 2012 13:54:04 GMT

If for some reason you or your company is still using VSS it’s time to move forward!

Team Foundation server supports VSS Migration, until today there were a command line tool allowing you to migrate VSS repository to TFS Source Control – this tool is called – VSSConverter.

VSSConverter command line tool requires configuration file that need manual authoring, but no More!

Microsoft has announce a new wizard based UI tool for upgrading VSS repositories to Team Foundation Server 2012/2010.

Open the tool and start the upgrade, choose VSS local repository.

Specify TFS Team Project destination.

Upgrade type, some VSS are very old and sometimes you don’t want to upgrade the entire VSS history.

Result

Download - Visual Source Safe Upgrade Tool for Team Foundation Server

Enjoy

Visual Studio 2012–News (iPhone, Web Test Management, 260 Limit and more)

shair — Tue, 25 Sep 2012 15:19:42 GMT

With Visual Studio 2012 and TFS 2012 we have a lot of new stuff for Developers, Testers, Managers customers and more, and this is not the end….

Microsoft continues to develop new features for 2012 version.

Test Case Management On The Web

Brian Harry - We’ve heard from a number of customers that in final acceptance testing, they don’t want to install anything on the test environment that’s not going to be in the production environment. That’s understandable. In our first update, we will be shipping a basic web based test case management and manual testing experience that will enable this scenario from a browser. This won’t be in the first CTP but should appear in the next.

260 Character Path Limit

Some call this Microsoft “Achilles’ heel” but I’ll not do so far, this is with no doubt a very annoying bug that not once cause me to change and modify entire environments.

Brian Harry wrote that after “CTP 1” there will be a fix that will increase the 260 characters limit to 400 characters.

This will allow us more flexibility in Source Control usage.

Project Management Improvements

Brian Harry - Kanban support – You may have seen the new kanban feature we introduced on our cloud service recently. In our first update, we’ll be bringing that and some additional improvements. This will give you an even broader set of choices for managing your project. You can use our Scrum based Agile Project Management tools, Kanban or Project and Project Server – or a combination of them.

iOS, iPhone and iPad Shapes

Microsoft released new icons and shapes for PowerPoint StoryBoarding tool available in Visual Studio 2012.

To use:

Download Packs:
Open PowerPoint.
Navigate to the Storyboarding tab.
Click the 'Import Shapes' button and select this file.
Now your shapes will be imported into your Storyboard Shapes library for you to use.

Learn more about PowerPoint Storyboarding.

More Storyboard Shapes

Developer Productivity

Brian Harry - Code Map – Code Map is a super cool new feature in the architecture tools that allows me to incrementally build up an architecture/dependency diagram as I explore code. It makes walking into an existing code base and exploring it WAY easier than it ever has been before. You can incrementally lay out a diagram one element at a time (class, method, etc) as you explore the code. You can “query” to expand the diagram – like adding all derived classes or all referencing methods, etc to incrementally understand the code dependencies.

Microsoft Visual Studio Team Foundation Server 2012 Power Tools

Download from here

You can read more at the following blogs:

Quality Center Migration To TFS 2012 RC

shair — Tue, 10 Jul 2012 17:00:00 GMT

As Sela Group continues to move hundreds of customers from Quality Center to TFS we have upgrade our migration tool called – Scrat to support migration to TFS 2012 RC.

The migration process is Easy, Fast and doesn't required any special customization it’s just a simple wizard application that will allow you to migrate everything from Quality Center to TFS.

Requirements, Bugs, Test Cases, Attachments, Links between items and more.

Just download the trial version and follow my steps:

Step 1: Define Migration Plan

After installing Scrat the first page will ask you for two things, a configuration file that will save all completed items and migration settings and the second is defining what items would you like to migrate from Quality Center to TFS (Requirements, Bugs and Test Cases).

The configuration file will also allow you to repeat the migration process for Failed items and will skip the work items that previously migrate successfully.

Step 2: Connecting Quality Center and TFS

The connections page will ask you to connect to a specific Team Project under TFS 2010 or 2012 and connect to specific Project in Quality Center.

Step 3: User Mapping

Quality Center allow users to work without LDAP users this means that we need to create a mapping between Quality Center users to TFS Users, you will use this page to define which user from Quality Center will be translate to LDAP user in TFS.

Step 4: Area Mapping

Area Mapping is one of the important steps in Scrat, Areas will allow you to keep Quality Center folders hierarchy as Areas in TFS.

At the picture below you can see Scrat presenting the folders hierarchy, you can also modify and add new values before creating those areas in TFS.

After Scrat will finish Area creation you will see the same folders hierarchy in TFS but as Areas.

Step 5: Fields Mapping

In this steps you’ll map Quality Center fields to TFS Fields, this page will show also Customize fields in Quality Center and TFS.

Fields that you’ll not choose will not be copied during the migration.

Step 6: Data Mapping

After you choose fields for the migration you might have to define new values for those fields, it’s more than possible that the field values will be different from Quality Center and TFS.

You can also prepare for the migration by defining the proper values and fields before you start migrating.

Step 7: State Mapping

Just before you’ll start the migration we need to define one more thing, the States.

As you know TFS doesn't allow you to open Work Item and change the State field to any field that you like, you have to save the work item and than change the state again, furthermore State field in TFS works on Work Flow mechanism that force the user to work based on the state flow.

This means that we also need to define the flow for each state from Quality Center.

Step 8: Migration

In this page all you need to to is click “Start” to begin the migration, but you can also choose to migrate based on a specific filter, expend the advanced option and choose as many fields as you like to help you filtering the items for the migration.

When the migration is completed you can see those items in TFS:

Step 9: Test Suites Hierarchy – Just for Test Cases

The migration process is the same for all items except Test Case, there you will have additional Page allowing you to build the Test Suites hierarchy for Microsoft Test Manager.

First you need to create a plan or select an existing one, this will create new Test Plan in Microsoft Test Manager.

Then select the desire Test Suites to create(you don’t need to create all just those you want) and click start.

After the process is done you can enter Microsoft Test Manager and you’ll see the same Suites hierarchy as in Quality Center, and each suite has his Test Cases assigned to it.

Test Case after the migration:

Enjoy.

Visual Studio/TFS 2012 Release Candidate Available

shair — Fri, 01 Jun 2012 13:39:00 GMT

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 API Part 44 (VS11) – Teams and Team Members

shair — Sun, 20 May 2012 12:31:00 GMT

TFS 11 comes with many great changes for software development, the first and super important is Teams, until TFS 11 Task work item or any other work item has to be assign to individual, means that you can’t assign a Task to a Scrum Team etc…

So many people has built customize solution to handle this but no need! because TFS 11 comes with this great Feature! In TFS Web Management site you can add as many teams as you want under One Team Project.

If your team works with Scrum then you should have a product backlog, but how you can manage two or more backlogs for each team? Working without backlog for teams will make it very difficult to keep track on what our team already completed and the progress on each other Task.

To Solve this you need to Assign Working Area and/or Iteration for Teams.

Now when you create a new Team there is a new Area created with the Team Name, this allow you to assign stuff for that Area path so the team can easily the relevant tasks for her. You can also define a different Area for Each team.

Now to the coding Part….. How to control teams from 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 Team Foundation Server

Now, this part should be familiar, connecting to TFS server, there is plenty but the once I love the most if using TeamProjectPicker. After connect TFS we need to get a new service called – TfsTeamService – as you can understand from the name it has relation to Teams…

Using the Team Service we can query, add, remove and more but for now we’ll see how to get the full teams list and get team members.

After I receive the teamservice I used QueryTeams method with the Team Project Uri (the team project you picked using TeamProjectPicker)

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>();

listTeams.ItemsSource = teamService.QueryTeams(tpp.SelectedProjects[0].Uri);

}

Step 3: Get Members For Team

Now when you click on one team this will get the Team object we call GetMembers method to get all Team Members for that Team.

GetMembers method will return array of TeamFoundationIdentity, you can also change the MemberShipQuery enum to Extended in order to get Groups & Users.

private void listTeams_SelectionChanged(object sender, SelectionChangedEventArgs e)

{

if (listTeams.SelectedItem == null) return;

var team = listTeams.SelectedItem as TeamFoundationTeam;

listMembers.ItemsSource = team.GetMembers(tfs, MembershipQuery.Direct);

}

Download Demo Project

Enjoy

TFS API Part 43–Delete Work Item Tool

shair — Fri, 06 Apr 2012 17:28:00 GMT