PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Configuring the users and the groups
  • Handling the users and the groups
  • Special case: the "Visitor" user
  • Configuring rights
  • Statistics
  • Retrieving data
  • Configuring the integrated mode
  • Encrypt the passwords
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
Once the user groupware is configured, the configuration of users and accesses is performed at run time, 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

Handling 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. In the right section of the screen, click "Users and groups".
  2. Click the "New" button found below the list of users.
  3. In the screen that is displayed, enter the information about the user.
    Notes:
    • Type the password, this one appears hidden.
    • The new created user can be a "supervisor" user. In this case, he can also create users and configure their rights.
    • The new created user can be an enabled user. This option is taken into account for the user groupware in integrated mode. See "Configuring the integrated mode" for more details.
  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. In the right section of the screen, click "Users and groups".
  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", "Delete" and "Move" 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. Select the group in the list of groups.
  3. Click the arrow button found below the list of of users and the list of groups.
To position a group as sub-group of another group:
  1. Select the group in the list of groups.
  2. Click the "Move" button.
  3. In the popup page that is displayed, select the destination group and validate.
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 user named "Louise" will benefit from the access rights granted to the "Assistant" group.

Special case: the "Visitor" user

If the site is using the integrated user groupware, a specific user is created beside the supervisor. This user is named "Visitor (not connected)".
This user is used to manage the rights of the unidentified users. Indeed, on a public Internet site (in AWP mode in most cases), it may be interesting to restrict the rights granted to the unidentified users. The rights of this account are used as long as the Web user does not identify himself (via a specific connection link for example).
The user groupware of WEBDEV is used to associate this user with one or more groups and to grant rights to him.
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 pages and reports found in the site:
    The pages and reports of the components used by the site are also displayed in this list.
  4. You must:
    • Select the element.
    • Click the "Allow the access" and "Deny the access" buttons.
      Important: if you deny the access to a page, don't forget to lock all the access means to this page (by graying the relevant buttons, menu options, ...). A fatal error will occur if a user has the ability to open a page for which he does not have access.
    • A symbol indicates the access rights for the current page or report.
      Notes:
      • 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 page 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 element status can be the one defined in the GUI or it can be 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 one to the most restrictive one, 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 ("Save" button) when the setting is performed.
Note: If your project corresponds to a mixed AWP/Standard site, rights can be defined for the AWP pages and for the standard pages. In this case, the connection from an AWP page will be automatically transmitted to the standard section.
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 the versions 19, you have two possibilities:
  • you want to keep the user groupware as is. All you have to do is check "Mode compatible with versions 18 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 page 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 the data 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.
Configuring the integrated mode
The "Configure the integrated mode" option is used to configure the management of the new users for the integrated groupware.
Note: In order for this setting to be taken into account, the user groupware in integrated mode must have been defined in the project corresponding to the site. A specific link used to manage the identification of users must have been included in one of the site pages. See Options of user groupware for more details.
Configuring the integrated mode consists in:
  • Choosing the activation rule for the new users. This activation can be:
    • automatic: the users will be automatically enabled after their subscription.
    • performed by email: the users will receive an email containing an activation link. In this case, you must:
      1. configure the outgoing and incoming email addresses (the incoming address is used to send a copy of the email).
      2. configure the SMTP server used to send the emails
  • Enabling the secure mode for the different identification forms. The secure mode is using an SSL certificate. This certificate must be enabled on the Web server.
Encrypt the passwords
Versions 20 and later
If the site was deployed with version 200057 (or later), the "Enable the encryption of passwords" button is displayed in the management page (top 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 or sites, all the sites and applications must be updated with version 200057 (or later). Otherwise, you will not be able to connect to the application or to the site.
Click the "Enable the encryption of passwords" button to encrypt the passwords.
A warning message is displayed before performing the encryption of users. Validate.
Note: When the passwords have been encrypted, the "Enable the encryption of passwords" button is not available anymore.
New in version 20
If the site was deployed with version 200057 (or later), the "Enable the encryption of passwords" button is displayed in the management page (top 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 or sites, all the sites and applications must be updated with version 200057 (or later). Otherwise, you will not be able to connect to the application or to the site.
Click the "Enable the encryption of passwords" button to encrypt the passwords.
A warning message is displayed before performing the encryption of users. Validate.
Note: When the passwords have been encrypted, the "Enable the encryption of passwords" button is not available anymore.
If the site was deployed with version 200057 (or later), the "Enable the encryption of passwords" button is displayed in the management page (top 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 or sites, all the sites and applications must be updated with version 200057 (or later). Otherwise, you will not be able to connect to the application or to the site.
Click the "Enable the encryption of passwords" button to encrypt the passwords.
A warning message is displayed before performing the encryption of users. Validate.
Note: When the passwords have been encrypted, the "Enable the encryption of passwords" button is not available anymore.
Minimum required version
  • Version 19
Comments
Click [Add] to post a comment