Groups
What are groups?
Groups are collections of people. They can set up several different ways. For example, you can:
- Option 1 - Manually add one or more individuals to a group
- Option 2 - Pull in an existing group. For example, you could include one of the reference groups from the IAMPublic folder
- Option 3 - Set up a “composite” group based on the intersection of two existing groups
You can also combine Options 1 and 2 - you can have a group that is a combination of existing reference groups (e.g. Boston-Staff) and individuals you have added manually (e.g. John Jumbo).
To ensure the accuracy, it is recommended that you enable Attestation on your group and periodically review group membership.
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the folder that you want the new group to live in. Make sure the folder is selected and its name appears toward the top of the page.
- Click Folder actions toward the top right, then select Create new group.
- A form will load.
- Create in this folder – The path to the folder you selected should automatically be displayed. This is where your new group will live.
- Group name – Give your group a short, descriptive name.
- Group ID – This will automatically match your Group Name. (Optional: Check the box next to “Edit the ID” if you want to change the name of the Group ID.
- Description – Provide a more detailed explanation of your group. This description will appear at the top of the group’s page once it is set up.
- When you’re ready, click Save.
- Your new group will be created and is ready to use.
This section describes how to add members to a standard, non-composite group. For information on setting up a composite group, see the section “Creating a Composite Group.”
There are several ways to add members to a group – add an individual, add an existing group, import a list.
Adding an individual
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the group that you want to add members to. Make sure the group is selected and its name appears toward the top of the page.
- Click Add members toward the top right corner of the page.
- In the Member name or ID field, search for an individual by name (e.g. John Jumbo). Suggestions will appear. Click on a person to select them.
- Assign these privileges – Select “Default privileges.”
- Start date – (Optional) Select a date for when the individual will be added to the group. If no date is selected, the individual will be added immediately.
- End date – (Optional) Select a date for when the individual will be automatically removed from the group. If no date is selected, the individual will not have an automatic end date.
- Click Add.
Adding an existing group
Following these steps will add ALL of the members of an existing Grouper group to another group. As membership of the added group changes, so will the membership of your group.
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the group that you want to add members to. Make sure the group is selected and its name appears toward the top of the page.
- Click Add members toward the top right corner of the page.
- In the Member name or ID field, search for the group you want to add. Suggestions will appear. Click on a group to select it.
- Assign these privileges – Select “Default privileges.”
- Start date – (Optional) Select a date for when the individuals will be added to the group. If no date is selected, the individuals will be added immediately.
- End date – (Optional) Select a date for when the individuals will be automatically removed from the group. If no date is selected, the individuals will not have an automatic end date.
- Click Add.
Importing a list of members
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the group that you want to add members to. Make sure the group is selected and its name appears toward the top of the page.
- Click Group actions toward the top right corner of the page and select Import members.
- In the How to specify members? field, select Copy/paste a list of member IDs.
- In the Enter member IDs field, enter a list of members you want to add. Members can be listed in several ways, including Tufts email address (e.g., John.Jumbo@tufts.edu) or username (e.g., jjumbo01).
- Click Validate entities to perform a lookup of the listed individuals.
- Double-check the list of individuals.
- Select Add members.
- (Optional) Set start and end dates for group membership.
- When you’re ready, click Submit.
- Once the import is complete, a message will appear. Click OK to return to the group page.
A composite group is a special kind of group that is based two existing groups and the overlap between them. There are two types of composite groups. An easy way to think about it is as a Venn diagram.
- Intersect – Only includes members who are present in BOTH groups.
- Complement/Minus – Only includes members who are in Group 1, but NOT in Group 2.
Creating a Composite Group
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the folder that you want the new group to live in. Make sure the folder is selected and its name appears toward the top of the page.
- Click Folder actions toward the top right, then select Create new group.
- A form will load.
- Create in this folder – The path to the folder you selected should automatically be displayed. This is where your new group will live.
- Group name – Give your group a short, descriptive name.
- Group ID – This will automatically match your Group Name. (Optional: Check the box next to “Edit the ID” if you want to change the name of the Group ID.
- Description – Provide a more detailed explanation of your group. This description will appear at the top of the group’s page once it is set up.
- When you’re ready, click Save.
- Once the group page loads, click Group actions and select Edit composite.
- In the Composite section, select Yes.
- Fields will appear where you can provide more information about your composite group:
- First factor group – Search for and select the first group you’d like to use for your composite.
- Operation – Select an option.
- And (intersection) – If selected, only members who are present in BOTH factor groups will be included.
- Not (complement) (minus) – If selected, only members who are in Group 1, but NOT in Group 2, will be included.
- Second factor group – Enter the second group you’d like to use for your composite.
- When you’re ready, click Save.
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the group that you want to remove members from. Make sure the group is selected and its name appears toward the top of the page.
- In the Members tab, find the Filter for menu and select Has direct membership.
- Click Apply filter.
- (Optional) You can search for a specific member/group name by entering part of their name in the Member name field and clicking Apply filter.
- When you find the member or group you want to remove, click the Actions button in their row and select Revoke membership.
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the group that you want to remove members from. Make sure the group is selected and its name appears toward the top of the page.
- The Members tab will be displayed by default, with “All members” shown. Next to people’s names, you’ll see their membership described as Indirect or Direct.
- Indirect – This person is part of another existing group that was added to this group.
- Direct – This person/group was manually added to the group.
- Find the Filter for menu and select Has direct membership, then click Apply filter.
- An updated list will appear. This list will include individuals and groups that were added to this group.
Visualization is another way to understand how a group is set up.
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the group you want to visualize. Make sure the group is selected and its name appears toward the top of the page.
- Click Group actions and select Visualization.
- Click Generate.
- A visual of the group will be generated, including a legend that explains it.
Follow the steps below to move a group from one folder to another. This is sometimes required for deployment/publishing of a group to a service when it is ready for use, or can be done for general reorganization.
- Visit grouper.tufts.edu and log in with your Tufts credentials. (If you are not on campus, you will need to use the Tufts VPN for access!)
- Navigate to the group you want to move. Make sure the group is selected and its name appears toward the top of the page.
- Click Group actions in the top right corner and select Move group.
- A form will load. In the Move to this folder, search for and select the name of the desired destination folder.
- When you’re ready, click Move.
- A confirmation message will appear when the move is done. You may need to refresh your browser to see the change reflected in the lefthand folder menu.