Tip: Team Member Management with Sub-teams in TFS2012 & TFS2013

by

Do you work on a project that has multiple teams (aka. “subteams”)?  If you’re using Team Foundation Server 2012 (TFS2012) or Team Foundation Server 2013 (TFS2013), you probably have those subteams all inside of a single TFS Team Project.  If you go to the Team administration page for your Team Project, it might look something like the screenshot below.  There’s the “default project team” that gets created when you create a Team Project and then someone went in and created the TFS Teams for the subteams. 

SNAGHTML814dc4

When you create those subteams, you’ll need to add members so that the Agile/Scrum planning boards are populated properly.  You do that by visiting the Web Access website for the team project, choosing the Subteam from the menu, and then clicking the Manage all members link.

SNAGHTML884efc

That’ll bring up a dialog that says something like “Manage Members of Subteam 1”.  Click on the Add… button and then choose Add Windows user or group. 

SNAGHTML8c97fd

You’ll then see a dialog that prompts you to add a Windows user or group to this Team.  Now, you can either type the name of the users individually one-by-one OR you can click the browse link and you’ll get a nice checkbox-based interface that you can just quickly choose who’s on the team. 

SNAGHTML8d8a95

image

A lot of times, when you get to the checkbox-based UI, the users you want aren’t in the list.  At that point you start weeping because you don’t want to type everyone’s Windows username from memory and you just drop the whole effort our of a sense of hopelessness combined with rampant laziness.  Smile

A lot of organizations have Active Directory (AD) user groups at the domain-level that contain all the developers/testers in the organization.  You could add this AD group to be a membership of the Subteam and be done with it but this would give you way too many team members in all of TFS’s screens and dropdowns.  The whole reason that you’re creating these subteams is so that you can subdivide the work into manageable chunks, right? 

The Essence of the Problem

How do you populate these subteams 1) without having a bunch of extra, unwanted people in the Teams, and 2) without having to type each team member’s username into the search box?

The Cause

The users you want are missing because they aren’t known to either TFS or to the Team Project. 

The Fix

Before populating the membership of the subteams, add that Active Directory group as a member of the Team Project’s Default Team. 

To do this, change the team context for Web Access to be the default team.  You’ll do this by clicking on the team project name (as shown below) and then choosing the entry in the list that is the same name as the team project.  In the screenshot below, that’s “scrum-20130920” and not “scrum-20130920 / Subteam 1”. 

SNAGHTML9ba64f

Next you’ll modify the membership of the default team by clicking the Manage all members link.

SNAGHTML9d7428

Click the Add… button and choose Add Windows user.  Now you’ll type in the name of that Active Directory group that has the huge list of possible users into the search box, hit Enter, and then click the Save Changes button. 

SNAGHTML9f8f85

At this point, you’ve just added a lot of users into the default team and now the Members list should show a lot of users. 

SNAGHTMLa322bf

 

Now you’ll change the context back to the Subteam and then modify the membership for that subteam.  As shown below, click on the team project name to bring up the list, and then either click the name of your subteam or choose Browse All.

 

SNAGHTMLa4592a

The Web Access screen should now be showing that you’re working in the context of your subteam again and the Members list should not show the same list of users that you have for the Default Team.  The Default Team showed all the users and the subteam basically hasn’t been populated yet so the list should be much shorter. 

SNAGHTMLa7a3ff

Click on the Manage all members link to bring up the dialog to manage the members of the subteam.  Click on the Add… button and then choose Add Windows user or group.

SNAGHTMLaa3111

Click the browse button to bring up the checkbox-based list of users.

SNAGHTMLab121c

You should now see the list of users and it should have A LOT more users in it.  Choose the users that you want to add to this subteam by checking the checkbox next to their name and then click the Add button. 

SNAGHTMLaea038

You’ll be back on the Add a Windows User or Group dialog and you should see the users you just chose.  Click the Save Changes button.

SNAGHTMLaf56ca

You should be back on the Manage Members dialog for the subteam.  The new users should be visible and you should see a message saying that you “Successfully added x members to this group.”  Click the Close button to exit the dialog.

SNAGHTMLb083b3

Now back on the main screen for the subteam, you should see the populated Members list. 

SNAGHTMLb23f73

And there you are.  You’ve just populated the subteam’s members without having to type a Windows username. 

I hope this helped.

-Ben

 

 

— Looking for more tips on managing Team Foundation Server 2012?  Want to roll out Team Foundation Server 2013?  Need some guidance on how to get multiple Scrum teams working together via TFS?  We can help.  Drop us a line at info@benday.com.


2 Responses to "Tip: Team Member Management with Sub-teams in TFS2012 & TFS2013"
  1. Hi,
    I have tested the implementation of subteams and feel pretty confident about it. The one major gap remaining is the scenario where a developer is on multiple sub-teams in a sprint. The only official pattern I could find from MS is to have that person be a member of each sub-team, and manually manage the distribution of their capacity between the teams. Do you know if there is a way to manage this more efficiently or differently, a way of rolling up their capacity in a single place? Any hints will be appreciated.

    Thanks
    Max

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.