PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • This lesson will teach you the following concepts
  • Overview
  • Integrating the user groupware
  • Configuring the user groupware
  • Creating users and groups
  • Defining the rights
  • Application test
  • Disabling the management of user groupware
Lesson 4.10. Identifying the user: the user groupware
This lesson will teach you the following concepts
  • What is the user groupware?
  • Integrating the user groupware.
  • Configuring the user groupware.
  • Checking the user groupware.

Estimated time: 20 mn
Previous LessonTable of contentsNext Lesson
Overview
An application can be used by several contributors with different profiles. It is often necessary to define several access levels according to the user.
Let's take a simple example: an application for sales management proposes the following features:
  • Viewing the price list.
  • Modifying the price list.
  • Entering orders.
  • Entering customers.
The accesses differ according to the user. Some examples:
  • the administrative assistants can see the price list and create orders.
  • the sales people can see the price list, place orders and create new customers.
  • the sales directors have access to all options.
WINDEV allows you to easily manage these access levels in your applications via the user groupware.
We are going to include the user groupware in our "WD Full Application" application and to configure it.

Answer

If you did not create the windows in the previous lessons, you can follow this lesson by opening a corrected project: in the WINDEV home page (Ctrl + <), click "Tutorial" and select "Full application (Answer)".
Integrating the user groupware
  • To include the user groupware in the "WD Full Application" project:
    1. On the "Project" pane, in the "Project" group, click "User groupware". The window for configuring the user groupware is displayed.
      Configuring the user groupware
    2. In the "Integration" tab, two integration modes are available:
      • Automatic user groupware: all elements of user groupware are included in your application. This allows you to benefit from all groupware evolutions. Furthermore, the skin template of project can be applied to the groupware windows.
      • Custom user groupware: all groupware elements are included in your application via an internal component. You have the ability to customize the different elements of user groupware. However, the evolutions will not be taken into account.
    3. Select "Automatic user groupware".
    4. Select the "Runtime" tab. Two start modes are available:
      • Auto run: the groupware is started as soon as the application is started.
      • Manual start: the groupware will be started by programming.
        Configuring the user groupware
    5. Keep the "Auto run" option.
    6. Select the "Files" tab. This tab is used to define the format and location of the data files found in the user groupware. In our case, we will be using HFSQL Classic data files, in the location specified by default.

      Note

      If you (or the end user) is using Windows Vista (or a more recent operating system), we advise you to use the "Data directory" option.
    7. In the "Files" tab, select "Enable the history of connections". This option allows the supervisor to get information about the connected users.
      Configuring the user groupware
    8. Select the "Options" tab. This tab is used to define the identification mode of user:
      • management by the user groupware.
      • using an LDAP directory or Active Directory. In this case, when installing the application, the user will be able to enter the parameters of his LDAP directory or Active Directory.
      • using the Windows authentication.
        Configuring the user groupware
    9. Validate. A message is displayed, indicating that a Supervisor user is created.

      Note

      A single user exists by default, the supervisor. During the first application start, connect yourself by using the name: "supervisor". You will have the ability to define the password used by the supervisor.
      Identification of groupware
    10. Validate this message. The user groupware is included in the application.
  • Let's now run the test of our application:
    1. Run the project test ( Project Go among the quick access buttons). A login window is displayed.
    2. Connect yourself as supervisor.
    3. Define the password and confirm it. Validate.
    4. A new menu is displayed, allowing you to run the application test or to configure the application.
      Menu of User Groupware
    5. Select "Configure the groupware".
Configuring the user groupware
Configuring the groupware consists in defining the different application users as well as their rights on the different windows and controls.

Note

The configuration of users can be performed:
  • when developing the application. The necessary data files (regarding the users and their rights) can be installed along with the application.
  • when the application is installed, by the administrator of the application.

Creating users and groups

  • To configure the user groupware, we are going to create a "Test_1" user and associate this user with the "Tests" group. Then, we are going to configure the management of rights for the group.
    Configuring the groupware
  • To create a user:
    1. Click the "New" button found below the "Users" area. The screen for entering a new user is displayed.
    2. Type the following information:
      • Login: Test_1
      • Name: Test_1
      • Password: Test_1

        Note

        By default, the password is hidden during the input. To check the password, click on the eye icon: the password appears in clear as long as the mouse button is pressed.
        Configuring the groupware
    3. Click on "Save". The "Test_1" user appears in the list of users defined for the user groupware.
  • To create a new group of users:
    1. Click the "New" button found below the "Groups" area. The screen for entering a new group is displayed.
    2. Enter the name of the group: "Tests".
      Configuring the groupware
    3. Click on "Save". The "Tests" group appears in the list of groups defined for the user groupware.
  • To associate the user with the group:
    1. Select the "Test_1" user in the window.
    2. Drag and Drop the "Test_1" user to the "Tests" group.
      Configuring the groupware
    3. The association is performed.

Defining the rights

We are now going to define rights for the "Tests" group. These rights will be granted to all users found in the group. In our example, the users found in the "Tests" group will not be allowed to:
  • Display the window for sending emails.
  • Create or modify a product.
  • To define the rights:
    1. Click "Rights management" on the left of the window.
    2. Select the "Tests" group.
    3. Click "Next".
    4. The window that is displayed allows you to select each window or report of the application.
      • For each window or report, it is possible to specify whether or not the element will be accessible by the group.
      • For each window, you can define whether the window controls will behave like the application (default mode) or whether they will be disabled, invisible or grayed.
  • To forbid the access to the "WIN_Sending_an_email" window:
    1. Select the window in the list.
    2. Click the "Forbid the access" button.
      Defining the rights
    3. The window is forbidden.
  • Define the rights on the "WIN_Menu" window. This window contains a menu option used to display the window for email management as well as the "New" and "Modify" buttons.
    1. Select the "WIN_Menu" window.
    2. Click the "Next" button.
    3. The window for configuring the rights on the window controls is displayed.
    4. Switch the "BTN_Modify" and "BTN_New" buttons to "Grayed":
      Defining the rights
    5. Switch the "Send an email" option to invisible:
      Defining the rights
    6. Click the "Save" button.
    7. Close the configuration window.
    8. The WINDEV editor is displayed.

Application test

  • We are now going to run the application test by using the "Test_1" login.
    1. Run the project test ( Project Go among the quick access buttons). A login window is displayed.
    2. Connect yourself as "Test_1" with the "Test_1" password. Validate.
    3. The application starts. If necessary, select the tab "List of products". You will notice that the "New" and "Modify" buttons are grayed and that the "Send an email" option is invisible.
      Application test
    4. Exit from the application and go back to the editor.
Disabling the management of user groupware
The user groupware will no longer be used in the rest of this tutorial. Therefore, it can be disabled.
  1. On the "Project" pane, in the "Project" group, click "User groupware".
  2. In the window that is displayed, in the "Integration" tab, select "No user groupware".
  3. Validate.

Note

If automatic tests are performed in your application, the user groupware must be configured in order not to use the login window. To do so, fill the "Automatic login in test mode" option in the "Runtime" tab of the window for configuring the groupware.
Previous LessonTable of contentsNext Lesson
Minimum version required
  • Version 24
Comments
Click [Add] to post a comment