Groups

Groups are a feature of Helix Server that makes it easier to manage permissions for users.

It is important to be aware of certain aspects of Helix Server groups:

• Groups can have both users and sub-groups. A user that is a member of a sub-group is also a member of the parent group.
• Groups have owners, but owners are not members of their groups. A group owner can be added as a member of a group.
• Groups can be created by users with super privileges in Helix Server (p4d). If p4d is at version 2012.1 or newer, users with admin privileges can also add groups.
• Groups can be edited by their owners, or by users with super privileges in Helix Server.
• Groups have a separate namespace from users; you can have a user named fish that is a member of a group named fish.
• Groups can be project moderators
• Groups can be reviewers, see Review display and @@mention for details.
• You can @@mention a group in a code review comment to ensure the mentioned group receives notifications of code review events. This also creates a link that displays the group's details when clicked. See @@mention for details.
• Groups cannot be project owners.

More information on adding, editing, and removing groups is included in the Groups chapter.

Listing groups

Begin browsing groups by clicking the Groups link in the main toolbar.

For each group, the group's name, description, list of owner avatars, and a membership count (which has a darker background when you are a member). Click on a group name to display details for that group.

The groups listing is sorted by multiple criteria:

• Groups that you own, or belong to, are listed first. A thicker row border indicates where your group ownership/membership ends; you are not an owner/member of any group below the thicker border.
• Groups are then sorted by name.

You can search available groups by entering some text in the Search field and clicking Search. Any group names or descriptions that match the entered text are displayed.

If you have super privileges in Helix Server (P4D), or have admin privileges in P4D version 2012.1 or newer, Swarm displays the Add Group button. Click Add Group to add a new group.

Viewing a group

View a specific group by clicking on a linked group name, or by visiting the URL: https://myswarm.url/groups/group-id

When Swarm displays a group, the presentation is similar to:

The information presented in the group display includes:

• In the left sidebar:

  • The group's name.
  • The group's avatar, if it has one.
  • The group's description, if it has one.
  • The count of the group's owners and members.
  • The group's email address, if it has one
  • The avatars of the group's owners.
  • The avatars of the group's members.
• Any events generated by a group member is associated with the group, and appears in the right-hand area as an activity stream.

Click the Reviews link in the group toolbar to display the review list associated with the group, which includes all reviews authored by any of the group's members.