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

	Estimated time: 20 mn

• View prices,
• Modify prices,
• Enter orders,
• Manage customers.

• 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.

• Open the project you worked on in the previous lesson.
  1. Go to the WEBDEV home page (Ctrl + <).
  2. On the home page, click "Tutorial", then in "Parts 3 to 6", double-click "Full WEBDEV Site (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 "Parts 3 to 6", double-click "Full WEBDEV Site (Answers)".

• To enable the User Groupware in the "Full_WEBDEV_Site" project:
  1. On the "Project" tab, in the "Project" group, click "User Groupware". The configuration window of the current platform opens on the "GPU / Private Store" 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. Select "Standard User Groupware" and "Manual start via a control template".
     
     
     

     	Note	When the User Groupware is in "Automatic start" mode, a standard log in page appears. If users enter their usernames and passwords, they are allowed to access the site. When the User Groupware is in "Manual start via a control template" mode, the developer can use a specific control template. This control template can be used to insert a link into the page to allow users to log in. We will present this solution in this lesson since it is easy to use and adapt.
  5. Validate. A message is displayed, indicating that an administrator account is created by default.
     

     	Note	The supervisor is the default user. The first time you log in to the site, enter: "supervisor" as username and password.
  6. Validate this message.
  7. Validate the project configuration window. The User Groupware has been enabled in the project.
     

     	Note	In this example, we will keep all the default options. Several options can also be configured. For more details, see User Groupware: Options and settings.

Including the customer section in the site

	Note	A control template is a specific page containing several controls. This page can contain all types of controls. Control templates use the "WDT" file extension. The main advantage of using a control template is that it can be easily reused. 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. Control templates can be overridden: code can be added, the controls can be moved in the page that uses the control template. Controls can also be modified.

• To add the log in link:
  1. Open the "PAGE_List_of_products" page in the editor.
  2. Go to the "Project explorer" pane, "Internal components", and expand "WDGPU_WB_CNT". This internal component was included in the project when enabling the Groupware. 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 template above the menu bar.
     
  5. The control template is successfully included. The "Log in" link appears.

Site test

• Let's test our site:
  1. Test the project (click in the quick access buttons).
  2. The page corresponding to the list of products is displayed.
  3. Click the "Log in" link. The log in page is displayed.
  4. Log in as supervisor:
     • Username: supervisor
     • Password: supervisor
  5. Validate.
  6. The Groupware configuration page appears.
     

Creating users and groups

• To create a new group of users:
  1. Click the "Groups" tab.
  2. Click "Add a group". The screen for entering a new group is displayed.
  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.

• To create a user:
  1. Click on the "Users" tab.
  2. Click on "Add a user". The screen for entering a new user is displayed.
  3. Enter the following information:
     • Username: Alison
     • First name: Alison
     • Select "Force the following password" and enter the password: Alison.
       Remark: You can also let users choose their passwords the first time they log in.
       

       	Note	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.

• To associate "Alison" with the "Product Management" group:
  1. Select "Alison" in the page.
  2. Check the box at the beginning of the row: the buttons "User groups" and "Delete user" 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

• We will define the rights for users who haven't logged in (i.e., not identified by the Groupware). These rights will be used by default when starting the site, as long as the user isn't logged in.

• Define the 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 site behavior (default) or whether they will be inactive, invisible or grayed.

• In our case, the "Add a product" link is in the "PAGETPL_Menu" page template:
  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 Option_2", select "Grayed" in the "State" combo box.
     
  4. Close the browser.

Site test

• We will test the site.
  1. Test the project (click in the quick access buttons).
  2. By default, the "ADD A PRODUCT" option is grayed out.
     
  3. Click "Log in" and enter "Alison" in the username and password fields. Validate.
  4. The "ADD A PRODUCT" 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: on the "Project" tab, in the "Project" group, expand "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.