• What is the User Groupware?
• Integrating the User Groupware.
• Configuring the user groupware.
• Testing the User Groupware.

	Estimated time: 20 mn

• Viewing the price list.
• Modifying the price list.
• Entering orders.
• Entering customers.

• administrative assistants can see the price list and create orders.
• salesmen can see the price list, place orders and create new customers.
• managers have access to all the options.

• Open the project you worked on in the previous lesson.
  1. Go to the WINDEV home page (Ctrl + <).
  2. On the home page, click "Tutorial", then in "Part 4 - Full application with data", double-click "Full application - Exercise".
  3. A dialogue box prompts you to open the project you worked on in the previous lesson. You can open the local copy or the original project. Select "Open the local copy".

	Answers	A completed project is available. This project allows you to follow this lesson. To open the completed project, go to the home page and click "Tutorial", then in "Part 4 - Full application with data", double-click "Full application - Answers".

• To include the User Groupware in the "WD Full Application" project:
  1. On the "Project" tab, in the "Project" group, click "User Groupware". The configuration window of the current platform opens on the "GPU" tab.
     

     	Note	The User Groupware can be set up for only one of your project configurations. When testing the project, the User Groupware connection window will only be displayed when testing the platform for which the groupware has been enabled.
  2. In "User Groupware", click "Change".
  3. The User Groupware configuration window is displayed. Enable the User Groupware by clicking "Enabled".
     
  4. The "Standard User Groupware" and "Automatic start" options are selected by default.
     • The "Standard User Groupware" option integrates the User Groupware into the application. This User Groupware will be associated only to your project configuration, and the rights will be defined from the application.
       Remark: It is also possible to use a BaaS (Backend as a Service) User Groupware with rights management via a server. For more details, see the online help: User Groupware.
     • The "Automatic start" option indicates that the User Groupware is started at the same time as the application.
       Remark: the "Manual start (programmatically)" option allows you to define when the User Groupware should be started.
  5. Keep the options selected by default.
  6. Click the "Options" tab.
     
     This tab allows you to specify the different customization options of the User Groupware. Different customization options are available:
     • No customization (default): all elements of the User Groupware are integrated into your application. This allows you to follow future changes in the groupware. In addition, the project skin template can be applied to the groupware windows.
     • Customize login UI (log in, register): this option allows you to integrate the WDGPU_WD component containing only the WIN_GPU_WD_Login window. This window can be customized according to your needs. The other windows of the User Groupware are integrated directly into your application. This allows you to follow future changes in the groupware. In addition, the project skin template can be applied to the groupware windows.
     • Full customization (expert mode): this option allows you to integrate the WDGPU_WD component containing all the elements required to manage the User Groupware. All elements can be customized. However, this option does not allow you to follow future changes in the User Groupware.
  7. Keep the "No customization" option.
  8. Select the "Files" tab.
     
     This tab allows you to define the format and location of the User Groupware data files. In this case, we will use HFSQL Classic data files, in the default directory.
     

     	Note	If you (or the end user) use Windows Vista or a more recent operating system, it is recommended to select "Data directory". To do so, click the "Default directory" link: a popup shows the different options available.
  9. In the "Files" tab, you can also define the user authentication mode:
     • management via the User Groupware.
     • LDAP directory or Active Directory. In this case, when installing the application, the user will be able to enter the parameters of their LDAP directory or Active Directory.
     • Windows authentication.
  10. Select the "OAuth" tab.
      
      This tab allows you to authorize the use of a specific connection service. For the specified service, it is necessary to specify the corresponding identifiers (provided when registering the application with the selected service).
  11. Validate.
  12. A message is displayed, indicating that a Supervisor user is created.
      

      	Note	The supervisor is the default user. The fist time the application is started, log in with the name: "supervisor". You will be able to define the password used by the supervisor.
  13. Validate this message. The User Groupware is included in the application.
  14. Validate the project configuration window. A message appears, indicating that the project must be recompiled. Click "Yes" to recompile the project.

	Note	The users can be configured: 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.

• Let's now test our application to configure the User Groupware:
  1. Test the project (click in the quick access buttons). A login window is displayed.
  2. Log in as supervisor.
  3. Define the password and confirm it. Validate.
  4. A new menu appears, allowing you to either test or configure the application.
     
  5. Select "Configure groupware".

Creating users and groups

• To configure the User Groupware, we will create a user named "Test_1" and associate it with the "Tests" group. Then, we will set the group rights.
  

• To create a user:
  1. Click "New" below the "Users" area. The screen for entering a new user is displayed.
  2. Enter the following information:
     • Username: 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 will remain visible as long as the mouse button is held down.

       
  3. Click "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 "New" below the "Groups" area. The screen for entering a new group is displayed.
  2. Name the group "Tests".
     
  3. Click "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.
     
  3. The association is completed.

Defining rights

• Open the window for sending emails.
• Create or modify a product.

• To define the rights:
  1. Click "Manage rights" on the left of the window.
  2. Select the "Tests" group.
  3. Click "Next".
  4. The window that appears allows you to select each window or report of the application.
     • For each window or report, it is possible to specify whether it can be accessed 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 out.

• To prevent access to "WIN_Sending_an_email":
  1. Select the window in the list.
  2. Click "Forbid access".
     
  3. The window cannot longer be accessed.

• 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 "Next".
  3. The window for configuring the rights on the window controls is displayed.
  4. Switch the "BTN_Modify" and "BTN_New" buttons to "Grayed":
     
  5. Set the "Send an email" menu option to "Invisible":
     
  6. Click "Save".
  7. Close the configuration window.
  8. The WINDEV editor is displayed.

Application test

• We will test the application using the "Test_1" username.
  1. Test the project (click in the quick access buttons). A login window is displayed.
  2. Log in 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 out and that the "Send an email" option is invisible.
     
  4. Exit the application and go back to the editor.

1. On the "Project" tab, in the "Project" group, click "User Groupware".
2. The configuration window of the current platform opens on the "GPU" tab.
3. In "User Groupware", click "Change".
4. In the window that appears, in the "General" tab, in the "Enable User Groupware" section, click "Disabled".
5. Validate the User Groupware configuration window.
6. Validate the project configuration window.

	Note	If you run automated tests in your application, configure the User Groupware to avoid using the login window. Complete the corresponding fields in the "Automatic login for test mode" section, in the "Options" tab of the groupware settings window.