Shai Raiten's Blog : DEV, TFS

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

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 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:

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

The Git Hole

shair — Wed, 25 Jan 2012 14:31:00 GMT

I consider myself a calm person with plenty of tolerance, I believe in productive discussion and love it – Part of my job as a consultant is to talk with Teams and explain them why you should choose a specific product over another, in 99.9% of those meetings there is one guy that don’t like the change (No One Like Changes) and you need in a calm way to explain and show him the benefits of the new tool – Forcing someone to do something is never a good thing.

But sometimes there is no wining side in a discussion, you might say discussion are not about winning is about Accepting and Understanding, but Imagine yourself this scenario - You are a religious man, how about a discussion with a non-religious about “Does God Exists”?

You can throw billion argumentation's but nothing will matter because in this discussion there is not Logic but Faith and Emotions, so you can spend hours but in the end the non-religious will not believe and the religious will.

Even when you talk about Technology there is emotions if you like it or not – If you not believe me you should read some theory's from Lawrence Kohlberg, Carol Gilligan and Sub Judice , (Latin for "under judgment"), I hope in this discussion you’ll understand you are not the first and for sure not the last how think he can control his emotions when you make a choice.

So why I told you all about that? Lately I’ve being asked about why TFS and Not Git?

First I think Git is a wonderful version control system and I even use it for several projects, I use SVN and several other Open Source Version Control Systems.

The reason sometimes I’m using other systems than TFS, is for specific projects:

Project I do by myself and I don’t need work assignment or project management.
Projects that doesn’t have Testers, Product Manager or anyone else besides Developers.
Projects that doesn't care about team collaboration and think that Email is a great solution for tracking the team.
Project that doesn't have the money to buy TFS (Dream Spark)

The question itself implies that the person didn’t understand what is TFS, and just think about saving his praised code.

Team Foundation Server – This is a suite of development tools all within a single platform
The idea of one platform for the entire team is brilliant. Microsoft created tools for each individual position on the team; there are tools for Requirements Management, design tools for Architects, Developer tools and of course testing tools ranging from manual test to automation and load testing. All is this is now under one platform. When the entire team works on the same platform the collaboration and integration become easy and fluent, collecting data to generate reports no longer needs to take a lot of time. The team’s efforts are now integrated as part of the platform. Synchronizing between different tools is no longer necessary because all are working together in one place.

So after I explain what is TFS the person told me –> but TFS doesn’t have distributed version control.

SO WHAT? Git doesn’t have Bug Management, Load Testing, UML Designer, Build Machine and a lot more. It’s not all about Code!

So developers think that everything about the Product is up to them – and they are wrong! the product is something that everyone is part of, the Project Manager, the Business Analysis, the Developers, Tester and more.

Sometimes one less feature is best for the Team than one extra feature just for you!

Now, let’s go back to the discussion, even after I explain TFS the person still want Git (although his company bought TFS) and in that point I understand that this is the same discussion as “Does God Exists” because the person has HMS (Hate Microsoft Syndrome) and this is what he believes.

Is there a cure? I really don’t know. But I do know that Emotions overcome common sense and facts.

I Love Microsoft and I really Love TFS, but TFS is not the only tool at the market today that gives teams the ability to work together under a single platform, there is IBM Jazz or HP ALM Solution, but with not doubt TFS is mature and most popular ALM tool today and I will continue recommend TFS and I’ll not surrender the HMS!!!

God, give me the strength to accept the things I cannot change,
Courage to change the things I can,
and the Wisdom to distinguish the one from the other.

Thanks

TFS API Part 42 – Getting Started With Lab Management API

shair — Thu, 22 Dec 2011 17:12:00 GMT

I did some cool things lately with TFS Lab Management API, from connecting it to TFS Web Access and allow REST access to the lab (if you want to ask why – The customer is always right ).

So this part of TFS API will deal with Lab Management API, although Lab Management API is not public I’ll show some cool things you can do but this will be under your own risk.

Again, this is just the beginning of the Lab Management API, so let’s get started

Download Demo Project

Step 1: Located “Microsoft.TeamFoundation.Lab.Client.dll”

This dll cannot be found under Public, Private or ReferenceAssemblies it can only be found under GAC, so navigate here - C:\Windows\assembly\GAC_MSIL\Microsoft.TeamFoundation.Lab.Client\10.0.0.0__b03f5f7f11d50a3a\
Microsoft.TeamFoundation.Lab.Client.dll

Add this dll as reference to your project.

Step 2: Connect TFS and Obtain LabService

After connecting to TFS you need to obtain the Lab Service at the same way we did for all other services under TFS.

If created a combo box with all team project for later use.

private void BtnConnectClick(object sender, RoutedEventArgs e)
{
   var tpp = new TeamProjectPicker(TeamProjectPickerMode.NoProject,false);
   tpp.ShowDialog();
 
   if (tpp.SelectedTeamProjectCollection == null) return;
   _tfs = tpp.SelectedTeamProjectCollection;
   _lab = (LabService)_tfs.GetService(typeof(LabService));
  
   var store = (WorkItemStore)_tfs.GetService<WorkItemStore>();
   listProjects.ItemsSource = store.Projects;
}

Step 3: Get Collection Hosts and Library Share

Before we start dealing with Team Projects and their Lab Vm’s and templates the below code will show how to pull the Lab Management Hosts and Library Share from the TFS Collection.

Using the Lab Service and a QuerySpec object (we’ll use those a lot), we need to call QueryTeamProjectCollectionHostGroups method (right now we don’t need to add anything to the Query).

//public class TeamProjectCollectionHostGroupQuerySpec
//{
//  public TeamProjectCollectionHostGroupQuerySpec();
//  public Uri Location { get; set; }
//  public string Name { get; set; }
//}
listHostGroups.ItemsSource = _lab.QueryTeamProjectCollectionHostGroups(
    new TeamProjectCollectionHostGroupQuerySpec());
 
//public class TeamProjectCollectionLibraryShareQuerySpec
//{
//  public TeamProjectCollectionLibraryShareQuerySpec();
//  public Uri Location { get; set; }
//  public string Name { get; set; }
//}
listLibraryShares.ItemsSource = _lab.
          QueryTeamProjectCollectionLibraryShares(
     new TeamProjectCollectionLibraryShareQuerySpec());

Step 4: Get Lab Management Details For Team Project

Now, when you choose a Team Project we’ll call the GetProjectLabDetails method to extract all relevant lab information on that project.

But first we’ll use the LabService.IsLabConfigured method to see if this project has any lab configurations, if it does then using the QuerySpec we can pull all Environments and Templates for that team project.

void GetProjectLabDetails(string projectName)
{
    //Does this Team Project has Lab configure?
    if (!_lab.IsLabConfigured(projectName)) return;
 
    //Creating Query for lab environments under a specific project name.
    var labQuerySpec = new LabEnvironmentQuerySpec{Project = projectName};
    //public class LabEnvironmentQuerySpec
    //{
    //  public LabEnvironmentQuerySpec();
    //  public LabEnvironmentDisposition Disposition { get; set; }
    //  public Uri Location { get; set; }
    //  public string Project { get; set; }
    //}
 
    listEnvironments.ItemsSource =_lab.QueryLabEnvironments(labQuerySpec);
    listTemplates.ItemsSource = _lab.QueryLabTemplates(new 
    LabTemplateQuerySpec() { Project = projectName });
}

Download Demo Project

Enjoy.

TFS API Part 41–Manage Groups and Members

shair — Wed, 07 Dec 2011 21:11:00 GMT

In the past I’ve showed some examples on how to work with TFS IGroupSecurityService for getting users list, but you can do much more, Create new Group, Add or Remove users from group etc…

Download Demo Project

Step 1: Connect To TFS and Get All Users and Projects

As always we need to start with connecting to TFS, but here we’ll also obtain 2 important services for our demo IGroupSecurityService and ICommonStructureService.

Using ICommonStructureService we’ll be able to extract all Team Projects under the collection you choose, this is not the only way to do that.

Using IGroupSecurityService will allow us to get all users under the “Project Collection Valid Users” category.

private void BtnConnectClick(object sender, RoutedEventArgs e)
{
  var tpp = new TeamProjectPicker(TeamProjectPickerMode.NoProject, false);
  tpp.ShowDialog();
  if (tpp.SelectedTeamProjectCollection == null) return;
  
_tfs= tpp.SelectedTeamProjectCollection;
_css= (ICommonStructureService)_tfs.GetService<ICommonStructureService>();
_gss= (IGroupSecurityService)_tfs.GetService<IGroupSecurityService>();
 
  var allSids = _gss.ReadIdentity(SearchFactor.AccountName, 
        "Project Collection Valid Users", QueryMembership.Expanded);
 
  listAllUsers.ItemsSource = _gss.ReadIdentities(SearchFactor.Sid,
  allSids.Members, QueryMembership.None).Where(a=>a.Type == 
  IdentityType.WindowsUser || a.Type == IdentityType.WindowsGroup);
 
  listProjects.ItemsSource = _css.ListAllProjects();
}

Step 2: Get All Application Groups Under a Team Project

Once you choose a project we’ll use Project Uri and ListApplicationGroups method under IGroupSecurityService to get all Groups under that project.

private void ListProjectsSelectionChanged(object sender,
 SelectionChangedEventArgs e)
{
    if (listProjects.SelectedItem == null) return;
    var project = listProjects.SelectedItem as ProjectInfo;
    listGroups.ItemsSource = _gss.ListApplicationGroups(project.Uri);
}

Step 3: Get Users From Specific Group

When you select a specific group we’ll use the group SID to get all members under that group.

Make sure to change the SearchFactor to SID instead on AccountName, this will prevent getting users from another Project where the Group Name is not unique.

private void ListGroupsSelectionChanged(object sender, 
SelectionChangedEventArgs e)
{
    if (listGroups.SelectedItem == null) return;
 
    var group = listGroups.SelectedItem as Identity;
 
    var sids = _gss.ReadIdentity(SearchFactor.Sid, group.Sid, 
               QueryMembership.Expanded);
    if (sids == null || sids.Members.Length == 0)
    {
        listUsers.ItemsSource = null;
        return;
    }
 
    listUsers.ItemsSource = _gss.ReadIdentities(SearchFactor.Sid, 
                                 sids.Members, QueryMembership.None);
}

Step 4: Add New Application Group

This part is very simple, you just need to obtain the Project Uri and call CreateApplicationGroup under IGroupSecurityService with the Project Uri and the new Group Name.

private void BtnAddGroupClick(object sender, RoutedEventArgs e)
{
    if (string.IsNullOrEmpty(txtGroupName.Text) || 
               listProjects.SelectedItem == null) return;
            
    var project = listProjects.SelectedItem as ProjectInfo;
    var groupname = txtGroupName.Text;
    try
    {
        var result = _gss.CreateApplicationGroup(project.Uri, groupname,
                      "Your Group Description");
        ListProjectsSelectionChanged(sender, null);
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.Message);
    }
}

Step 5: Remove Application Group

This part is also very simple, you need to call DeleteApplicationGroup method under IGroupSecurityService with the Group sid you want to delete.

private void BtnRemoveGroupClick(object sender, RoutedEventArgs e)
{
    if (listGroups.SelectedItem == null) return;
 
    var result = MessageBox.Show("You are about to remove application 
    group from TFS, press yes to continue",
    "Remove Group", MessageBoxButton.YesNo, MessageBoxImage.Question);            


    
    if (result == MessageBoxResult.No) return;
 
    var group = listGroups.SelectedItem as Identity;
    _gss.DeleteApplicationGroup(group.Sid);
    ListProjectsSelectionChanged(sender, null);
}

Step 6: Add User To Application Group

For this you need to obtain the User sid and Group sid and again using the IGroupSecurityService add call AddMemberToApplicationGroup method passing those values.

If the User already exists in that Group you will receive a soap exception.

private void BtnAddUserToGroupClick(object sender, RoutedEventArgs e)
{
    if (listAllUsers.SelectedItem == null 
     || listGroups.SelectedItem == null) return;
 
    var group = listGroups.SelectedItem as Identity;
    var user = listAllUsers.SelectedItem as Identity;
 
    try
    {
        _gss.AddMemberToApplicationGroup(group.Sid, user.Sid);
        ListGroupsSelectionChanged(sender, null);
    }
    catch (Exception ex)
    {//TF50235: The group Test Group already has a member Administrators.
        MessageBox.Show(ex.Message);
    }
}

Step 7: Remove User From Application Group

It’s the same as Adding a user to a group, just call RemoveMemberFromApplicationGroup method.

private void BtnRemoveUserFromGroupClick(object sender, RoutedEventArgs e)
{
    if (listUsers.SelectedItem == null || 
       listGroups.SelectedItem == null) return;
 
    var group = listGroups.SelectedItem as Identity;
    var user = listUsers.SelectedItem as Identity;
 
    _gss.RemoveMemberFromApplicationGroup(group.Sid,user.Sid);
    ListGroupsSelectionChanged(sender, null);
}

Download Demo Project

Enjoy.