How to: Modify the Team Project Areas

You can change the number of areas a team project has, and the hierarchical relationship among them. As the needs of the project change, you can change the project structure by adding, deleting, or reordering individual areas.

Contact your Team Foundation Server administrator or your team project administrator to make sure that your user account has the permissions described in the Required Permissions section below.

The name of an area node cannot:

  • Contain more than 255 characters.

  • Contain Unicode control characters.

  • Contain any one of the following characters: \ / $ ? * : " & > < # % |

  • Be a system reserve name such as prn, com1, com2, com3, com4, com5, com6, com7, com8, com9, com10, lpt1, lpt2, lpt3, lpt4, lpt5, lpt6, lpt7, lpt8, lpt9, nul, con, aux.

  • Be one of the following characters: “.” or “..

  • Be characters considered invalid by the local file system. For example, Windows-based desktop operating systems might consider the following characters to be invalid if used in the path name: ASCII/Unicode characters 1 through 31, quotation mark ("), less than (<), greater than (>), pipe (|), backspace (\b), null (\0) and tab (\t).

  • Have a total path length greater than 4000 characters.

  • Have a total hierarchy depth of more than 14 levels.

Required Permissions

To perform this procedure, you must be a member of the Project Administrators security group for the team project. If the necessary security permissions are set explicitly, you must have the Create and order child nodes permission and the Delete nodes permission set to Allow on the node where the child is to be added and on the parent node of the sibling nodes. For more information, see Team Foundation Server Permissions.

To modify the team project areas

  1. In Team Explorer, select the team project to be modified.

  2. On the Team menu, point to Team Project Settings, and then click Areas and Iterations.

  3. On the Areas and Iterations dialog box, click the Area tab.

  4. Use the toolbar buttons to change the current structure:

    • Click Add a child node to add a new node under the currently selected node.

    • Click Delete node to delete the currently selected node. In the Delete Nodes dialog box, select the new path for the items to reference, and then click OK.

    • Click Move a node up amongst its siblings to promote the currently selected node higher in the tree.

    • Click Move a node down amongst its siblings to demote the currently selected node lower in the tree.

    • Click Make the selected node a sibling of its parent to make the currently selected node a child of the node immediately above it.

    • Click Make the selected node a child of its preceding sibling to make the currently selected node a peer of the node immediately above it.

  5. Click Close.

See Also

Concepts

Setting Initial Project Areas or Iterations
Changing the Project Structure and Iterations from Microsoft Excel or Microsoft Project

Other Resources

Managing Team Projects in Team Explorer