Chapter 8. User Management

8.1. Overview

From the main application actions bar choose Application->Users to open the User Management View. After the view is loaded a list of Users appears on the left-hand side. In the right panel all details of a selected User are shown. In a completely new installation no Users are defined, hence the list and the detail form are both empty. The User Management is used to add new Users and to modify or delete existing ones. Furthermore you can set User details (UserDetails), change a User's password, or add an image to an User.

User Management View

Figure 8.1. User Management View


Table 8.1. Actions bar of the User Management View

IconDescription
Add a new User.
Delete an existing User, or an User entry that was created but not saved before.
After changing an User's data you can save your changes by pressing the save button.
Reload and refresh all Users from the persistent storage.
Change the password of an existing User. The operation cannot be done on an unsaved User.
Change the image of an existing User.

8.2. User Details

By default some detail information can be attached to each User profile. Required fields are marked with a red asterisk and must be set to successfully save the changes in the persistent storage. The Username is a system-wide unique identifier that can be changed at any time but must be set initially.

Table 8.2. Description of User Details input fields

Input fieldDescription
UsernameUnique identifier of the User.
FullnameFullname of the User.
DescriptionDescription text of the User.
PhoneThe Users phone number.
IMThe Users IM adress.
DepartmentThe department the User is working for.
OfficeThe office the User is working in.
SexMale or female.
CommentSome comment stored with the User.
EnabledThe User is only able to login when he or she is enabled. This way it is possible for a System Operator to forbid an User to login.
LockedAn User is being locked by the application automatically after he or she tries to login with an invalid password several times. The number of invalid retries is set in the system properties.
Expiration DateA System Operator can define an expiration date for an User to allow login for a defined period of time. When this field is left empty the account never expires.
RolesUsually an User is assigned to Roles. Assigned Roles are listed in this list but cannot be changed here. Changing an User's Roles is done with the Role Management Screen.

8.3. Change User's Image

After clicking the Change Button () a popup window appears and your are prompted to enter a valid path to an image file, that is uploaded to the server afterwards. When the upload succeeds the new image file is directly assigned to the selected User, there is no need to save the User anymore. The width of the image is resized to max. 100 pixel and a height to max. 150 pixel.

Changing the Users image

Figure 8.2. Changing the Users image


8.4. Change User's Password

To change the Users password, select an User and choose Change Password () from the actions bar. In the dialogue Figure 8.3, “Changing the Users password” reset the password and click on Change.

Changing the Users password

Figure 8.3. Changing the Users password


8.5. System User Account

A System User account exists by default. This particular User profile is especially dedicated to Project Engineers and shall only be used for installation and maintenance purpose. The System User has full access to the application without any security restrictions. By default Username and password of the System User are both set to OPENWMS. How to change these credentials is described in the Developer Manual.

8.6. User Preferences

Once you have logged in the application, your username is displayed in the upper right corner of the application header. Click on your username to open a dialogue with your personal user settings (Figure 8.4, “Change User Preferences”). All Users, beside the SystemUser, can manage their own settings, like setting a default language or change the UserDetails. Changing the current password to login is possible as well.

Change User Preferences

Figure 8.4. Change User Preferences