Title: Traction Groups

Traction Group Editor

Traction's ACL rules can be defined for users and groups. Groups, in turn, can be defined in terms of users, groups in an external directory system, and groups defined inside Traction.

The Traction Group Editor lets you define groups inside Traction, at the server and project levels. Groups defined at the server level can be referenced in any ACL inside Traction, whereas groups at the project level can only be referenced in that project's ACL.

Creating a New Group

To create a new Group, click the New button at the top of the group editor.

Type the new group's name into the dialog and press OK.

To apply your changes, press the Apply button at the bottom of the screen.

Adding a User to a Group

Click Add User.

The user chooser appears.

You can select as many users as you like. To select a contiguous block of users, press the Shift key while clicking and dragging your mouse pointer from the beginning of the block to the end of the block. To select multiple users individually, press the Control key (Command on the Macintosh) and click on each username individually. Press OK when you're finished selecting users.

You can also type a few characters from a username and press Lookup.

If there is a single result, it will automatically be selected and inserted into the group member list. Otherwise, the lookup window will appear with a list of matching names. You can select one from the list of matching names.

When you press OK, the user you selected will be added to the list.

If your server is connected to Active Directory or LDAP, the lookup also lets you select users from those directories. The users presented are grouped by directory.

Adding a Group to a Group

You can also add groups to other groups.

Let's say we want to add the Engineers group to the Server Administrators group. We first create the Server Administrators group, then click Add Group.

As with the user chooser, you can choose one or more groups using this form.

You can also type part of a group name and press Lookup.

The matching groups will be displayed.

If your Server is connected to Active Directory or LDAP, your group lookup will also return groups defined in your directory. Groups are organized by the directory in which they are defined.

In the members pane, other groups appear in blue, while users appear in black.

Showing User or Group Details

You can select a user or group and click Show Details to see detailed information about the selected principal.

Clicking Show Details for the Geniuses group shows that it is the member of another group, lists the users of the group, and shows the effective ACL permissions for the group at both the server level and for each project.

Similarly, Show Details for a user gives the details for that user.

This shows the details, group membership, and the effective permissions for the user.

Removing Users or Groups from a Group

To remove a group our user, select who you want to remove and press the remove button.

Notice that when you do this, the Apply button becomes enabled.

To complete the remove, you must press Apply.

If you try to close the window or switch to another group, Traction will warn you. Pressing OK will apply your changes; Cancel will discard them.

Renaming Groups

To rename a group, select a group and click the Rename button.

Choose a new name, and press OK.

Notice that when you do this, the Apply button becomes enabled.

To complete the rename, you must press Apply.

Deleting Groups

To delete a group, select the group and press the delete button:

You will be asked to confirm this change:

Note: this change takes place immediately, and any references in ACLs to this group will become references to the group's former internal identifier.

Related Articles
Article: Doc297 (permalink)
Date: March 22, 2008; 4:22:45 PM Eastern Daylight Time

Author Name: Documentation Importer
Author ID: importer