Groups are an important organization method within e-PlanREVIEW® (EPR). Groups are used to organize people and when creating plan review assignment tasks. Users must belong to one or more groups within a purpose to access the plan review page, although they only represent one group at a time while marking up plans. A “Group” within EPR usually represents an agency department, sub-department, division, office location (if multiple locations exist), or any other metric chosen by the agency. Because of these uses, it’s important to create/update group information before creating users and/or preparing assignment workflows.

Create a Group

To create a new group within EPR:

1. Navigate within the EPR menu to Settings > Configuration > Groups.

2. Click within the “Purpose” dropdown and select either For Permitting or For Design Review.

   1. The “List Type” value will be pre-selected as “Group.”

   2. Any existing group values will load within a table.

3. To add a group, click the (Add) button in the lower right corner.

4. Type the group name into the “Label” field.

   1. Can use alphanumeric characters, as well as “-”, “_” or “/” characters.

   2. The full label displays in tooltips and in comment report letters if the Group is used as a header value.

5. Type the group abbreviation into the “Item Abbreviation” field.

   1. Can use alphanumeric characters only.

   2. Abbreviation length should be between 1-4 characters at maximum.

   3. Abbreviation is displayed most often throughout EPR, appearing within table columns, in comment tags, and other similar locations where saving space is a priority.

6. Type an “Order” value (if desired).

   1. If all values are left as 0, groups will list alphabetically.

   2. If values are set, order values are only used when sorting comments in the Review page comment pane.

7. Type in a hex color value into the “Item Color” field or click on the circle next to it to select from the color picker.

   1. The selected color is used to represent the group throughout EPR.

   2. When a reviewer adds a comment or sketch to a file, it will reflect their current group color.

   3. Using black, gray, or white tones for group color is not recommended.

8. Click on the List Item is Active toggle to enable or disable the group.

9. Click SAVE to complete.

Groups Page Layout	Add Group Window

Groups Page Layout	Add Group Window
Open Groups Page Layout	Open Add Group Window

Edit a Group

Most group information can be edited as needed, though because of how information is tracked behind the scenes, updating an existing “Label” is not recommended. If a label needs to be changed, it is usually better to create a new group record (with the new label) instead of repurposing an existing group.

To edit an existing group within EPR:

1. Navigate within the EPR menu to Settings > Configuration > Groups.

2. Click within the “Purpose” dropdown and select either For Permitting or For Design Review.

   1. This will load any existing group values within a table.

3. Click (Edit) to open an existing group.

4. Update value(s) as needed.

   1. If necessary, click on the List Item is Active/Inactive toggle to disable or re-enable the group.

5. Click SAVE to complete the update or CANCEL to close the form without making any changes.

Delete a Group

If a group has not been used, it can be safely deleted from EPR. However, deleting should be reserved as a last resort.

To delete a Group:

1. Navigate within the EPR menu to Settings > Configuration > Groups.

2. Click within the “Purpose” dropdown and select either For Permitting or For Design Review.

   1. This will load any existing group values within a table.

3. Click (Delete) to remove the group.

Deleting the group will be successful as long as it has not been used anywhere within EPR. For groups that have been used already, go ahead and inactivate the group instead.

Inactivate Groups that Cannot Be Deleted

If a group has been used but is no longer necessary going forward, edit it to make the group inactive.

Apply Group Color Restrictions

From the Group settings page, the Agency can also control whether users can markup plans using any color they want or if they are restricted to only marking up plans using their group color. By default, this “Apply Group Color Restrictions” is OFF, but can be enabled if preferred.

To change the group color restriction:

1. Navigate within the EPR menu to Settings > Configuration > Groups.

2. Click on the Apply Group Color Restrictions toggle to turn it ON or OFF.

   1. When this is ON, users can only markup plans using their group color. If a user belongs to more than one group, only the current group color can be used. Switching to another group will allow markup in the other group color.

   2. When this is OFF, users can freely change the markup color they are using from the toolbar in the Review page.

Configure Group Status Access

Groups can be further managed by controlling which plan review assignments statuses they can select when conducting plan review. While a newly created group can access any active assignment status by default, this can be restricted if the Agency desires. Refer to Group Status Config for more information.


Related articles