Hub 2.5 Help

Manage the Project Team

The project profile page displays a list of users who are assigned team roles in the project. The project team represents the users who actually work together on a project. The project team does not include other users, like administrators or supervisors, who have access to the project but do not take part in day-to-day development efforts.

/help/img/hub/2.5/projectTeam.png

What is a Project Team?

The project team is a collection of users and members of groups who are assigned a team role in a specific project plus the users and members of groups who are assigned a team role in the Global project. Each user has access to the resources that are connected to the project. The level of access is determined by the role that is assigned to each user or group.

When you create a project, Hub automatically creates a group with the name <project>-team. This group is granted the Developer role in the new project. This group contains:

  • Individual users that you manually add to the team on the project profile page. These users are added as members to the <project>-team group. If the <project>-team group has been deleted, each user who is added to the team is granted the Developer role directly in the project.
  • Each user that you add to the group on the Members tab of the Groups > <project>-team page. These users are also granted the Developer role in the project.

The following example shows the list of users who are members of the Team Tools-team group. As you can see, the list only shows users who have been added to the group.

/help/img/hub/2.5/projectTeamGroup.png

The project team, however, isn't just a group in Hub. The team includes all other users who are assigned a team role that grants them access to the project. In addition to the members of the <project>-team group, the project team displays:

  • The project lead. This user is assigned the Project Admin role directly in the project.
  • Members of groups who are added to the project team. When you add a group to the project team, the group is granted the Developer role in the project. Members of this group inherit access to the project based on their membership in the group.
  • Members of any group that is granted a team role in this project or in the Global project.
  • Users with a team role in this project or in the Global project that is granted directly and not inherited from a group.

This example illustrates how the project team assembles the collection of users who have access to the project through various team role assignments.

/help/img/hub/2.5/projectTeamAnnotated.png

The project team doesn't show every user who has access to the project. The following users are not shown on the list:

  • Members of groups that are granted a role in this project or the Global project that is not marked as a team role.
  • Users who are granted a role in this project or the Global project directly that is not marked as a team role.

The key factor that determines whether a user is shown as a member of the project team is the team flag that is used to mark a team role. For more information, see Team Roles.

Add Users to the Project Team

You can add users to the project team directly on the project profile page.

To add users to the group and grant this role successfully, you must also have access to all of the permissions that are granted to this role. The easiest way to meet this requirement is when the Developer role is also assigned to your user account.

For a list of the permissions that are assigned to the Developer role by default, see Default Roles.

To add users to the project team:

  1. Click the + icon in the Team section of the project profile page.
  2. From the drop-down list, select a user or group.
    • If you select a user, this user is added to the <project>-team group, if it exists. If this group has been deleted, the selected user is granted the Developer role directly in the project.
    • If you select a group, this group is granted the Developer role in the project. Members of this group inherit access to the project based on their membership in the group.
    • A profile for each user that is added to the project team is created in each service that is connected to the project.

When you have added all of the users that belong to your project team, you can fine-tune the settings for your project..

Remove Users from the Project Team

Removing users from the project team can be tricky. Each member of the project team can have access to a project directly, indirectly, or both. To remove a user from the project team, you need to remove any group membership or role assignment that grants access to the project.

Removing users from the project team almost always results in a permission loss. When you remove a team role from a user or group, you may need to restore vital permissions by replacing the team role assignment with another role that is not marked as a team role.

First, check the list of memberships in the Groups column. If the user in question is a member of the <project>-team group, start by removing the user from the group.

To remove a user from the group:

  1. Click the link to access the user profile.
  2. Select the Groups tab.
  3. Select the <project>-team group.
  4. Click the Remove button.

Return to the project profile page. If the user still appears in the project team, make a note of the remaining Role assignments for this user. Use the following table to investigate possible options for removing the user from the project team. If you are unable to perform any of these actions yourself, contact an administrator.

ConditionThe user is a member of another group that is assigned the Developer role in your project.
SolutionHere you have two options. You can:
  • Remove the user from the group that is assigned the Developer role in your project.
  • Remove the role that is assigned to this group in your project. This action removes all members of the selected group from the project team.
ConditionThe user is a member of a group that is assigned a team role in the Global project.
SolutionChoose one of the following options:
  • If this user no longer requires the access that is defined by this role in all projects, remove the user from the group.
  • If none of the members of the group require the access that is defined by this role in all projects, delete the group.
  • If this user and other members of the group still require access to all projects, but are not considered as actual members of each project team, remove the team flag from this role.
ConditionThe user is assigned a team role directly in the project.
SolutionRemove the role that is assigned to this user in your project.
ConditionThe user is assigned a team role in the Global project.
SolutionChoose one of the following options:
  • If this user no longer requires the access that is defined by this role in all projects, remove the role from the user.
  • If this user and other users or groups who are assigned this role still require access to all projects, but are not considered as actual members of each project team, remove the team flag from this role.
Last modified: 13 December 2016