Customizing the User Groupware

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

User Groupware

Compatible version

Customizing the User Groupware

How to customize the User Groupware?

Customizing the windows and the pages

Defining the rights on the menus

Configuring the data files of user groupware

Reinitializing the data files

Modifying the data files

See also

Customizing the User Groupware

Not available

Warning
From version 18, the User Groupware evolves. This help page corresponds to the User Groupware kept for backward compatibility. For help on the new version of the User Groupware, see User Groupware.

How to customize the User Groupware?

Several solutions are proposed by WINDEV/WEBDEV to customize the User Groupware. This page explains how to:

Customize and translate the windows and the pages, ...
Modify the first window of the application (or the first page of the site) according to the user,
Start the login window or page from an application window or from a site page,
Define the rights on popup menus
Define the rights on the options of the automatic menu ("?" menu)
Configure the location of the data files specific to the groupware.
Reinitialize the data files specific to the groupware.
Modify the data files specific to the groupware.
Find out the structure of the data files specific to the groupware.

Customizing the windows and the pages

The login window/page

You may want to customize the login window/page that is displayed when starting your application. If this window or page is included in your project, the style or the skin templates used by your application can be applied to this window or page.

Caution: This window/page must not be renamed.

All the windows/pages of user groupware

If all the windows/pages of user groupware have been included in your project, they can all be customized. However, only the login window/page will be viewed by all the users. The windows/pages for configuring the groupware can only be viewed by the supervisor of the application .

Caution:

The GPWLogin and GPWSupervisorMenu windows must not be renamed.
The GPWLogin_WB page must not be renamed.

For more details, see The windows and pages of user groupware.

Translating the windows/pages for the multilingual applications

To use the User Groupware in a multilingual application, see User Groupware and multilingual feature.

Modifying the first window or the first page according to the user

To change the first application window or the first site page according to the user, gpwGetUserInfo must be called in the initialization code of your project. This option allows you to get information about the user such as his name or password for example.

Depending on his name, you have the ability to open a given window or a given page.

Example:

IF gpwGetUserInfo(gpwLogin) = "FP" THEN
Open(WIN_Management)
ELSE
Open(WIN_Menu)
END

Starting the login window/page from an application window or from a site page

When the User Groupware is included in an application, you can choose whether the User Groupware will be automatically started or not. This option can be modified at any time.

By default (automatic start), the login window/page is the first window/page of the application. It is run with the initialization code of the project.

In some cases, you may want to open a configuration window before the login window. To do so, you must:

Select "Manual start".
Open the login window or page anywhere in the code with gpwOpen.

Defining the rights on the menus

Define the rights on popup menus

To define the rights on the popup menus, all the windows of user groupware must be included. Then, you can modify the window for managing rights (GPWConfigurationDetails.WDW).

To get the list of context menus, use EnumSubElement (associated with the enumFirst + enumContextMenu constants).

Defining the rights on the automatic menu ("?" menu)

Some options of the automatic menu must be used with great care. These options are as follows:

Optimize access speed to the database
Save data
Save application
Repair the database.

The operating mode of these options with the User Groupware is as follows:

By default, these options are grayed if the user is not the supervisor.
To allow a non-supervisor user to access these options, modify the rights of the internal window named IW_MenuHWinDevHelp that contains the popup menu.

Remark: This behavior was implemented since WINDEV 10 version 100050. If you already have customized the groupware and included the window for modifying the rights in your application, you must copy:

the GPWAssociationConfiguration.wdw window. This window is found in the Programs\Data\Models\GPW\WD directory of WINDEV.
the wdxxxgpu.dll file found in the Programs directory of WINDEV.

Configuring the data files of user groupware

Two types of data files are used by the User Groupware:

Data files of users
Data files of rights

The location of these data files can be configured:

When including the user groupware for test ("Workshop .. Configure the user groupware").
When creating the executable.
When installing the application (by the person who performs the setup).
Through programming.

For more details, see User Groupware files.

Reinitializing the data files

To reinitialize the data files of user groupware

All you have to do is delete the data files specific to the User Groupware (file of users and file of rights). These files are automatically re-created when starting the application.

Remarks

If the user files are deleted (GPWUserConfiguration and GPWUser), only the supervisor will be able to start the application.
If the rights files are deleted (GPWElementConfiguration, GPWConfiguration and GPWElement), all the users will have all the rights on the entire application.

For more details, see User Groupware files.

Caution: The <None> group and the DEFAULT group cannot be deleted.

Modifying the data files

The structure of the data files specific to the user groupware cannot be modified.

Remark: These files contain confidential information and therefore they are encrypted.

Managing the analyses

If a specific analysis is opened when configuring the User Groupware, gpwInitAnalysis (used to open the analysis of the User Groupware) must be executed again.

Reminder: At run time, several analyses cannot be opened at the same time.