Skip to content

Profiles Management

This feature allows an administrator to manage all user profiles in the application. It provides a full CRUD interface to create, view, update, and delete any profile in the system.

Profiles Listing

When entering the view, a listing is displayed showing all available profiles along with filter controls to narrow down results.

Profiles Listing View

Profiles Listing View

Filters

The following fields are available to filter the profiles displayed in the grid:

  • Username: Filters profiles whose username contains the entered text. For example, entering "john" will display both "john" and "johndoe".
  • First Name: Filters profiles whose first name contains the entered text.
  • Last Name: Filters profiles whose last name contains the entered text.
  • Email: Filters profiles whose email address contains the entered text.
  • From / To: A date and time range filter. Only profiles created within the specified range will be shown. When a date is selected without specifying a time, the start of that day (00:00:00) is used as the default.

The Filter button becomes active as soon as any filter field has a value. Clicking Clear resets all filters and refreshes the grid.

In the filter area, at the right, there is a New profile button. Clicking it opens the profile creation dialog.

Profiles Grid

Below the filter area, a grid displays the matching profiles with the following columns:

  • Avatar: A circular thumbnail of the profile picture. When no picture is set, the first letter of the username is shown.
  • Username: The username associated with the profile.
  • Email: The email address stored in the profile.
  • Created: The date and time when the profile was created.
  • Actions: A menu button that opens the actions available for that row.

The Username, Email and Created columns are sortable, and every column can be resized. When no profile matches the applied filters, the grid is replaced by a No profiles found message.

Actions

The actions that can be performed on each of the rows are the following:

The same two actions are also available by right-clicking anywhere on a row.

Profile Creation

To add a new profile, click the New profile button in the upper right area. This opens the Create profile dialog.

Create Profile Dialog

Create profile dialog

Fill in the profile fields (see Form Fields below) and click Save to create the profile, or Cancel to discard the operation.

Editing Profiles

To modify an existing profile, select Edit in the Actions menu of the corresponding row. This opens the Edit Profile dialog.

Edit Profile Dialog

Edit Profile dialog

The edit dialog allows updating the user's information, including the Username, and provides a Delete button for removing the profile.

Click Save to apply changes, or Cancel to discard them.

Note

Changing the Username re-associates the profile with a different application user. The appjar does not verify that an account with the new username exists.

Deleting Profiles

To delete a profile, select Delete in the Actions menu of the corresponding row. The same operation is available from the Delete button of the edit dialog.

A confirmation dialog is displayed before the profile is permanently removed.

Profile Deletion Confirmation Dialog

Profile deletion confirmation dialog

Click Delete to confirm, or Cancel to go back.

Warning

Profile deletion is a permanent action and cannot be undone.

Form Fields

The following fields are available in both the creation and edition dialogs:

  • Username: Required. Must be between 4 and 50 characters and must not contain spaces. When the username contains an @ character, it must also be a valid email address. Unlike the My Profile view, this field remains editable when updating an existing profile.
  • Email: Required. Must be a valid email address.
  • First Name: Required. Must not be empty.
  • Last Name: Optional.
  • Phone Number: Optional.
  • Address: Optional.
  • Avatar: Optional profile picture. Supported formats are GIF, PNG, JPEG, BMP, and WebP (maximum size: 10 MB). After uploading, a circular crop dialog is displayed to adjust the desired area.