Help / Developing an application or site / User Groupware
  • Overview
  • Configuring the users and the groups
  • Configuring rights
  • Statistics
  • Retrieving data
  • Encrypt the passwords
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Once the User Groupware is configured, the configuration of users and accesses is performed at runtime, by connecting with a "supervisor" account.
During the first start, you must use the "Supervisor" user and choose a password for this user.
After identification, a user who is the groupware supervisor will have the ability to start the application or to configure the groupware.
The "Configure the groupware" option is used to access the options for managing the User Groupware. You can:
Configuring the users and the groups
The User Groupware allows you to define groups and users according to simple rules:
  • a user can belong to several groups (or to no group).
  • a group can have several sub-groups,
  • a group has a single "parent" group.
To create a user:
  1. On the right section of the screen, click "Users and groups". Only the "SUPERVISOR" user appears in the table.
  2. Click the "New" button found below the list of users.
  3. In the screen that is displayed, enter the information about the user.
    • Type the password, this one appears hidden. To check the password, simply click the eye icon: the password will remain visible as long as the mouse button is held down.
    • The new created user can be a "supervisor" user. In this case, he can also create users and configure their rights.
  4. Click "Save". The new user is automatically added to the list of users.
The "Modify" and "Delete" buttons are used to handle the different users found in the list.
To create a group:
  1. On the right section of the screen, click "Users and groups". Only the "SUPERVISOR" user appears in the table.
  2. Click the "New" button found below the list of groups.
  3. Enter the name of the group.
  4. Click "Save". The new group is automatically added to the list of groups.
The "Modify" and "Delete" buttons are used to handle the different groups found in the list.
To associate a user with a group:
  1. Select the user in the list of users.
  2. Move the user line toward the requested group by Drag and Drop.
To position a group as sub-group of another group:
  1. Select the group in the list of groups.
  2. Move the group to the line of the "parent" group by Drag and Drop.
Creating a "groups/users" hierarchy allows you to define an inheritance in the access rights. For example, in this configuration:
  • the "Assistant" group will inherit from the rights granted to the "Sales" group,
  • the usernamed "Louise" will benefit from the access rights granted to the "Assistant" group.
Configuring rights
The rights can be defined for the the groups and for the users.
Tip: To easily define the access rights, start to define the rights granted to the "parent" groups, then the rights granted to the sub-groups, and finally the rights granted to the users.
To define the rights:
  1. In the left section of the screen, click "Manage the rights". The list of groups, sub-groups and users is displayed.
  2. Select the user or the group whose rights must be configured and click "Next".
  3. The definition of rights starts by allowing or denying the access to the windows and reports found in the application:
    The windows and reports of the components used by the application are also displayed in this list.
  4. Simply:
    • Select the element.
    • Click the "Allow the access" and "Deny the access" buttons.
      Important: if you deny the access to a window, don't forget to lock all the access means to this window (by graying the relevant buttons, menu options, ...). A fatal error will occur if a user has the ability to open a window for which he does not have access.
    • A icon (displayed in the upper-right corner of each window and report) indicates the access rights for the current window or report.
      • If the access to an element is explicitly allowed ("Allow the access") for a group, it may be denied for a sub-group or for a user of the group.
      • You have the ability to allow an element that is denied in the "parent" group.
  5. If a window or a report is allowed for the group or for the user, you have the ability to define the status of each control, button, menu, menu option, ... via the "Next" button.
    • The status of the element can be the one defined by default in the GUI or a specific status:
      • inactive,
      • grayed
      • invisible.
    • The status of a control defined in a group is automatically applied to the sub-groups and to the users of the group.
      Important: if a user belongs to two groups that have define two different states for the same control, then the least restrictive status is applied. The order of the states, from the least restrictive to the most restrictive, is:
      • "Default" (value defined in the GUI or in the parent group),
      • "Disabled",
      • "Grayed",
      • "Invisible".
        For example, a control defined as "Grayed" (in group 1) and as "Invisible" (in group 2) will be "Grayed".
  6. Validate when the setting is performed.
The "Statistics" option is used to get statistics about the connection to one of the applications using the database of user groupware, for a given period.
Retrieving data
If the user groupware was already included in a project before versions 18, you have two possibilities:
  • you want to keep the user groupware as is. To do so, check "Mode compatible with versions 17 and earlier" in the "Integration" tab of the groupware description.
  • you want to benefit from the new features of the new groupware, without losing your existing data. All you have to do is retrieve the data.
To import existing data:
  1. Connect with a user who is supervisor (the "SUPERVISOR" user for example).
  2. In the window for groupware management, click "Retrieve the data".
  3. Select the type of the database that contains the groupware information to import.
  4. Specify:
    • the password of groupware files to import. The password is "PCSGPW2001" if it was not modified.
    • the information for file location (the directories for the files in HFSQL Classic format or the parameters for connecting to the server in the other cases).
  5. Validate.
Encrypt the passwords
If the application was deployed with version 200057 (or later), the "Enable the encryption of passwords" button is displayed in the management window (upper-right corner).
Pay great attention when enabling the encryption of paswords:
  • The existing passwords will be migrated.
  • This operation cannot be undone.
  • If the files of user accounts are shared with other applications, all the applications must be updated with version 200057 (or later). Otherwise, you will not be able to connect to the application.
Click the "Enable the encryption of passwords" button to encrypt the passwords.
A warning message is displayed before performing the encryption of users. Validate.
Remark: When the passwords have been encrypted, the "Enable the encryption of passwords" button is not available anymore.
For more details, see User Groupware: Encrypting passwords.
Minimum version required
  • Version 18
Click [Add] to post a comment

Last update: 05/02/2023

Send a report | Local help