Tutorial - User Groupware

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

Opening the example project

1. Go to the WINDEV home page (Ctrl + <).
2. On the home page, click on "Tutorial", then in the "Tutorial - User Groupware" area, click on the "Open exercise project" link.

Integrating the User Groupware into the 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.
   
   

   If you have multiple project configurations, the User Groupware can be configured for just one of them. The User Groupware login prompt will only appear when testing this configuration.
2. In "User Groupware", click "Change". The User Groupware configuration window appears.
3. Enable the User Groupware by selecting "Enabled".
   

1. On the "General" tab, the "Standard User Groupware" option is selected by default. This option allows authenticating users directly from the website. That is the desired method in this tutorial. We will therefore keep this option.
2. Select "Manual launch by field template": this option allows you to obtain a specific Link control field.. This link will allow users to access pages where authentication is required.
   
   

   We will choose this option, since it is easy to use and adapt. For more details on the different options, see User Groupware: Options and settings
3. Confirm and close the User Groupware settings window.
4. A message appears indicating that an administrator account will be created the first time the application is run.
   
   

   The supervisor is the default user. The first time you launch the application, you'll be able to set the password used by the supervisor.
5. Validate this message.
6. Validate the project configuration window. The User Groupware has been enabled in the project. Various style errors appear. Let's fix them right away.
7. First, update the skins used by the project: in the "Project" pane, in the "Project" group, pull down "Recompile and synchronize" and select "Update skins".
8. Next, update the project styles: in the "Project" pane, in the "Project" group, pull down "Recompile and synchronize" and select "Update page styles".
9. Update models: in the "Project" pane, in the "Project" group, pull down "Recompile and synchronize" and select "Model synchronization".

Integrating user authentication into the website

Definition:
A control template is a specific page containing several controls. A control template can be reused in any page of the project. You only need to make changes once and WEBDEV automatically applies them on all the pages that use the control template.
For more details, see Control template.

1. Open the "PAGE_List_of_products" page in the editor. You can press Ctrl + E and enter the name of the page.
2. Go to the "Project explorer" pane, "Internal components", and expand "WDGPU_WB_CNT".
   
   

   This internal component was included in the project when the User Groupware was enabled. It contains all the necessary elements, especially the control template used to log in.
3. Then, expand "WEBDEV control templates".
   
4. Select the TPLC_GPU_WB_Login control template and drop it onto PAGE_List_of_products. Drop the control to the right of the Company logo.
   
5. The control template is successfully included. The "Log in" link appears.

Users can be configured:

• when developing the application. The necessary data files (regarding the users and their rights) can be installed with the website.
• when the administrator installs the website.

1. Test the page (click in the quick access buttons).
2. The page with the list of products is displayed.
3. Click the "Log in" link. The login page is displayed.
4. Log in as supervisor:
   • Login: supervisor
   • Password: supervisor
5. Validate.
6. On the page that appears, select "Configure groupware".
   
7. The User Groupware configuration page appears.
   

Creating users and groups

1. Click the "Groups" tab.
2. Click "Add a group". The group creation window appears.
3. Type the group name: "Product Management"
   
4. Click "Save". The "Product Management" group appears in the list of groups defined in the User Groupware.

1. Click on the "Users" tab.
2. Click "Add a user". The screen for entering a new user is displayed.
3. Enter the following information:
   • Login: Alice
   • First name: Alice
   • Select the "Force next password" option and enter the password: Alice.
     Note: It is also possible to let the user choose a password on first login..
     
     

     User information:

     • In the user information, only the username is mandatory.
     • You can also set a user as Groupware supervisor. In this case, the supervisor will be able to modify users, groups and rights.
     
4. Click "Save". "Alison" appears in the list of users defined in the User Groupware.

1. Select "Alison" in the page.
2. Check the box at the beginning of the line: the "User groups" and "Delete user" buttons appear..
3. Click "User groups".
4. In the popup that appears, check "Product Management" and click "OK".
5. The association is completed. The name of the group to which "Alison" is associated appears in the list of users.

Defining rights

1. To prevent all users from accessing the page used to add products, select the "Visitor (not connected)" user. Any user who is not logged in is automatically associated with this user.
   
2. Click to set the rights.
3. The page that appears allows you to select each page, page template or report of the application.
   
   • For each page, page template or report, it is possible to specify whether or not the element will be accessible to the user or group previously selected.
   • For each page or page template, you can define whether the controls will have the behavior defined by the website (default) or whether they will be inactive, invisible or grayed.

1. Select the "PAGETPL_Menu" page template from the list. The rights defined on the page template will be applied to all the pages that use the template.
2. The names of the different page controls appear on the right.
3. For "Menu option OPT_AddProduct", select "Grayed out" in the "State" combo box.
   
4. Close the browser.

Testing the page with a specific user

1. Click in the quick access buttons.
2. By default, the "Product form" option is grayed out.
   
3. Click "Log in" and enter "Alison" in the username and password fields. Validate.
4. The "Product form" option is no longer grayed out.
   
5. Close the browser.

1. On the "Project" tab, in the "Project" group, click "User Groupware".
2. The platform configuration window appears.
3. In "User Groupware", click "Change".
4. In the window that appears, click "Disabled".
5. Validate.
6. If necessary, open "PAGE_List_of_products".
7. Delete the "Log in" control template we added previously.
8. Save and close the page.
9. Recompile the project: under the "Project" pane, in the "Project" group, pull down "Recompile and synchronize" and select "Recompile project and generate HTML pages".
10. Go to the "Project explorer" pane, expand "Internal components" and select "WDGPU_WB_CNT". Right-click to open the context menu and select "Remove and delete from disk".
11. Validate the message that appears.