ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / User Groupware
  • Overview
  • Configuring users and groups
  • Configuring rights
  • Statistics
  • Retrieving data
  • Encrypt the passwords
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Overview
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 users and 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.
    Remarks:
    • During input, the password will be 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 user can be set as "supervisor". 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
You can set rights for groups and users.
Tip: To easily set access rights, start by setting the rights of "parent" groups, then sub-groups, and finally the users.
To set 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.
      Remarks:
      • If access to an element is explicitly authorized ("Allow access") for a group, it can be denied for a sub-group or 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 state 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 two different states for the same control, then the least restrictive state is applied. From least to most restrictive, the states are:
      • "Default" (value set in the UI 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.
Statistics
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: Once passwords have been encrypted, the "Enable password encryption" button is no longer available.
For more details, see User Groupware: Encrypting passwords.
Minimum version required
  • Version 18
Comments
Click [Add] to post a comment

Last update: 05/29/2024

Send a report | Local help