Groups Management

This feature allows you to handle the groups of the application.

When an application contains a lot of users and roles, handling them might become a complex task. Groups are a special feature that allows you to ease the management of a large number of users and roles.

A group can be associated with any number of users and roles. A user can also belong to any number of groups, and a role can belong to any number of groups. With the User Manager AppJar, you can create groups at runtime and associate them with users and roles.

This section of the documentation explains how an administrator can manage the groups of the application.

Groups listing

When you open the view, the application displays a listing of all available groups in the system. You can apply filters to manage large group lists.

The view has two areas: The upper area holds the filter components and the New group button, and the lower area has the groups grid.

Groups Management List View

Filters

This view displays fields for filtering groups by Group ID, Group name, and Registration link status. Once you enter content in any of the filter components, Filter and Clear buttons become available.

Filter actions

1. Clear: Click this button to remove all criteria from the filter fields and restore the groups grid to its default state.

2. Filter: Click this button to apply the current filter criteria. The application filters the grid contents using the supplied information, as follows:

   • Id: Enter a number to see groups whose ID has that numerical sequence.
   • Group name: Enter text to view group names that contain the entered string.
   • Registration link status: This dropdown lists the statuses "-", Active, Success, and Expired, which you use to display groups whose registration link status matches your selection.

Tips

• If you enter 20 in the Group ID filter, you see groups with IDs 20, 1203, and 520.
• If you enter group in the Group name filter, you see groups with names groupb and agroup given that they contain the string "group" in the name.
• If you select Active in the Registration link status filter, you see only groups whose registration link status is active. This filtering logic applies to all available status options.

Groups creation

The New group button appears in the upper area, on the right side of the filter components. Click this button to open the group creation dialog, which supports creating new groups in the system.

Group Creation Dialog

Group name

This required field represents the group's name in the system. You enter the group name when creating a new group.

The group name must be unique, contain only alphanumeric characters and spaces, and be between 4 and 50 characters long. The User Manager AppJar validates that the group name meets these requirements before saving.

Warning

If the group name is already in use or fails validation, the save operation fails and the system displays an error message.

Roles

This section manages the roles you assign to the new group.

Roles are selected through the Roles multi-select combo box. Click the field to open the dropdown of available roles and select one or more; each selected role appears as a chip inside the field. Type in the field to filter the available roles. To remove a role, clear its entry in the dropdown or click the × on its chip.

Users

This section manages the users you assign to this group.

Users are selected through the Users multi-select combo box, which works the same way as the Roles selector: open the dropdown, pick one or more users, and remove any by clearing its entry or clicking the × on its chip.

Summary

This read-only section displays a summary of the application views that users in this group can access based on the group's assigned roles. The list updates automatically as you change the group's configuration.

Action buttons

The dialog provides the following action buttons:

1. Save: The Save button persists the new group in the database. The system executes required validations before saving and displays any errors so you can fix problems before trying the save operation again.

2. Cancel: The Cancel button discards the changes and returns you to the groups listing view.

Groups grid

In the lower area, the groups grid displays the groups in the system. By default, the grid shows all available groups. After applying search criteria, the grid displays only the filtered groups. This grid shows the following columns:

• Id: Displays the unique numerical identifier for the group. The system assigns this value automatically.
• Group name: Displays the group's name assigned during creation.
• Users in this group: Displays the number of users associated with this group.
• Actions: Displays a dropdown menu that shows actions you can execute on the group in the current row. To learn more, see the action menu.

Action menu

Group actions display in the actions column dropdown menu, which appears when you click the three dots in the actions column.

Action Button Dropdown Menu

Edit group

This action displays the group's edit dialog. You can modify the group's name, roles, and users. The dialog includes the same structure as the group creation dialog.

The main difference is that the Delete button appears in the action buttons section, and the Create registration link button appears next to the group name field. To learn more, see the delete group and create registration link sections.

Group Edition Dialog

Action buttons

The dialog provides the following action buttons:

1. Save: The Save button persists the changes you make. The system executes required validations before saving and displays any errors so you can fix problems before trying the save operation again.

2. Cancel: The Cancel button discards the changes and returns you to the groups listing view.

3. Delete: The Delete button appears only when editing an existing group. To learn more, see delete group.

Create registration link

This action opens the registration link creation dialog. The dialog allows you to create a registration link that can be shared with new users. Users who follow the link can register themselves and will be automatically added to this group.

The dialog displays the selected group name and provides you with a component to set the number of days after which the link will expire (defaults to 7 days). Below this part, a text displays the estimated date and time when the link expires. The generated registration link appears in a read-only text field. Finally, the dialog presents two action buttons:

• Cancel, which stops the creation process.
• Save and copy link, which persists the link and copies it to the clipboard so you can share it with new users.

Create Registration Link Dialog

Delete group

This action displays a confirmation dialog before executing a permanent deletion of the group from the database. The dialog shows the group's details. You confirm the deletion process by clicking the Delete button in the dialog.

Group Delete Confirmation Dialog