ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Developing an application or website / User Groupware
  • Overview
  • The options of the User Groupware
  • Implementing the User Groupware in your application
  • Options of the "General" tab
  • Type of groupware
  • Start mode
  • Options in the "Options" tab
  • Groupware customization
  • Security
  • Automatic login in test mode
  • File language
  • Password of data files
  • "Files" tab (Standard User Groupware)
  • Type of database ("Automatic start" mode only)
  • Type of authentication
  • Options
  • "OAuth" tab (Standard User Groupware)
  • "BaaS" tab (BaaS User Groupware)
  • "Email" tab (BaaS User Groupware)
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Overview
An application is often intended to be used by several users connected via a network. Similarly, a site is always intended to be used by several Web users. In most cases, different access levels must be defined according to the user or to the Web user.
To manage these access levels in your WINDEV applications or WEBDEV websites, simply include the User Groupware. In just a few clicks, a standard application can be transformed into an application that manages several access levels. This feature can be easily implemented.
For more details on the User Groupware, see User Groupware overview.
The options of the User Groupware

Implementing the User Groupware in your application

To implement the User Groupware in your application or site:
  1. On the "Project" tab, in the "Project" group, click "User Groupware".
  2. In the description window of the current project configuration, in the "User Groupware: Inactive" area, click on the "Modify" button..
  3. In the window that appears, enable the User Groupware. You can configure the User Groupware for your application or site in the different tabs of this window. This configuration is presented in the following paragraphs.
  4. Validate. The User Groupware is integrated into your project.
  5. An administrator account will be created during the first execution of application or site under the "supervisor" name. Then, the corresponding password can be specified.
Options of the "General" tab
The "General" tab allows you to enable or disable the User Groupware in the current project configuration. This tab includes the following options:
  • Type of groupware,
  • Start mode
  • User account.
Let's take a closer look at these options.

Type of groupware

There are various types of groupware:
  • Classic User Groupware: User Groupware will be integrated in its "Classic" version: User Groupware will be associated only with your application (or site), and rights will be defined from within the application (or site)..
    If this option is selected, two specific tabs are displayed:
    • the "Files" tab, which allows you to specify the type of database and authentication used.
    • the "OAuth" tab, which allows you to specify the connection services available to users.
  • BaaS user Groupware: This option lets you integrate BaaS (Backend as a Service) user Groupware with rights management via a server..
    If this option is selected, two specific tabs are displayed:
    • the "BaaS" tab, which allows you specify the characteristics of the BaaS server, the user accounts and the URLs of the administration sites.
    • the "Email" tab, which allows you to customize the messages to be sent to users (registration validation or password reset emails).
BaaS user Groupware: System requirements: Two cases may occur:
  • You are using a PCSCloud platform: the necessary elements are installed by default on your platform.
    Reminder: PCSCloud is a pay-as-you-go, turnkey solution. For more details, see PCSCloud.
  • You're not using a PCSCloud platform: install the following:
    • an HFSQL server,
    • the reserved server, including the modules for the Mobile User Groupware (WDBaaS).
    For more details, see Configuring a BaaS server (User Groupware and Private Store).

Start mode

Several start modes are available:
  • The "Automatic start" option indicates that the User Groupware is started at the same time as the application or site.
    The login window or page of the User Groupware is displayed before any other window/page of the application. The project initialization code is run when the login window/page is opened and validated.
  • The "Manual start (programmatically)" option allows you to define when the User Groupware should be started.
    The login window or page will only be opened if gpwOpen (or gpwLogin) is used. This option is used to run the project initialization code before opening the login window/page. This option is useful, for example, in the case of a multilingual application: a window or page can be displayed to ask for the application's runtime language.
  • Windows The "Manual start via a control template" option is used to integrate the User Groupware login page in the site. This allows you to work with the automatic User Groupware (and to benefit from its updates) while being able to customize the login page.
    If this option is selected, the WDGPU_WB_CNX internal component is added to your project. This component includes the "TPLC_GPU_Connection" control template that manages the connection. To add this control template, simply drag and drop it onto the desired pages (or templates).
    Once it has been added, you can customize it:
    • by overloading the controls and/or the processes for small changes,
    • by directly modifying the control template for more important changes.
Options in the "Options" tab

Groupware customization

There are several modes to customize the User Groupware in your application or site:
  • No customization:
    WINDEV and WEBDEV take care of everything. All you have to do is start the application or the site to configure the user access.
    WINDEV The windows of the User Groupware can automatically use the skin template of the application. Simply check "Apply project skin template to non-customized windows at runtime".
    To get the same appearance for all the windows of the application, it is recommended to always check this option if you use the User Groupware in non-custom mode.

  • Customize login UI:
    The login/register window or page is automatically integrated into your application.
    • WINDEV The internal component named WDGPU is included in your project. This component contains the login window and the associated procedure. You can customize the connection to the User Groupware.
  • Full customization (expert mode) - Standard User Groupware only:
    The programming of the User Groupware is automatically included in your application.
    • WINDEV The internal component named WDGPU is included in your project. This component contains an analysis as well as all the windows, queries, classes and procedures required to manage the User Groupware. This allows you to customize all the windows used by the User Groupware.

Security

The security options are as follows:
  • Allow windows and reports to open by default: This option allows all users to open windows and reports by default.. In this case, simply specify which elements will not be accessible when configuring the rights.
  • WINDEV Authorize editing of application reports and queries in "Reports and Queries ": If this option is checked, use of the "Reports and Queries" software will be authorized for application reports and queries..
    Note: This option is identical to the "Allow "Reports and Queries"" option in the "Advanced" tab of the project description..

Automatic login in test mode

Specify the login and password that will be used in automated test mode. This information will be used if an automated test is run on the application.

File language

By default, data files specific to the User Groupware are in English, but you can use data files in French.

Password of data files

By default, the data files found in the User Groupware have a specific password. This password is: "PCSGPW2001".
To change this password, enter the new password. The characters typed are hidden.
Remarks:
  • The new password is taken into account only if it is changed before the User Groupware data files are created.
  • This password is used when the files are re-indexed or when the files are opened by WDMAP.
"Files" tab (Standard User Groupware)

Type of database ("Automatic start" mode only)

The User Groupware handles data files used to identify the users and to define their rights.
These files can be:
  • in HFSQL Classic format (by default). The data file directory must be specified.
  • in HFSQL Client/Server format. The characteristics of the connection to the HFSQL server must be specified as well as the directory of the different categories of files.
Please note The location information entered applies only in "Automatic launch" mode.. If you chose the "Manual start (programmatically)" mode for the groupware, call gpwOpen and gpwOpenConnection.

Type of authentication

There are different types of authentication:
  • Authentication entirely managed by the User Groupware.
  • Authentication from an LDAP directory or Active Directory.
    This option avoids duplicating usernames and passwords by using the users from the LDAP directory. In this case, the connection characteristics must be specified (see below).
  • WINDEV Use of Windows authentication.
    This option requires you to create the users in the User Groupware database. Only the supervisor (supervisor password) is created by default. During the first execution, you must:
    • connect with the supervisor user.
    • create the users who exist in Windows.
      Note: It is not necessary to specify a password for these users: their Windows password will be checked for authentication.
For an authentication from an LDAP directory or an Active Directory, you must configure the characteristics of the LDAP server used for tests (and at runtime). The requested information is:
  • Server address
  • Port number of server.
  • Version of contacted LDAP server.
  • Database
In the code, simply use gpwOpenLDAPSession.
Remarks:
  • The User Groupware works with Active Directory. It does not work with openLDAP.
  • When the server port corresponds to port 636, the connection is automatically made in "Negociate" mode.

Options

There are several options depending on the type of authentication chosen:
  • Login window only (no rights management): This option is only available for LDAP and Windows logins..
    In this case, no groupware file will be created. If the application is started in automatic mode, the user will need to log in. If the user is saved in the LDAP directory or in Windows, the application will start ; otherwise, it will be closed. A supervisor cannot configure the rights on the windows or pages. If this option is unchecked, identification is carried out with rights management: only users present in the LDAP directory will be able to connect.. The rights can be configured on the windows or pages.
  • WINDEV Single sign-on (SSO): This option allows the user to identify himself only once (in the first application launched).. The other applications that use the User Groupware will automatically connect with the specified user. If Windows authentication is used with this option, users don't have to enter any login details: the connection is automatic.. In this case, to configure the groupware, the Windows session must have been started by a user who is supervisor.
"OAuth" tab (Standard User Groupware)
In the "Standard" User Groupware, the "OAuth" 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).
"BaaS" tab (BaaS User Groupware)
The "BaaS" tab allows you to define all the options necessary to manage rights from a specific site:
  • In "GPU application server (web service and administration site)", specify the server to use. In the case of a new server, select the type of server:
    • PCSCloud platform. In this case, specify the characteristics of your PCSCloud platform.
      Reminder: This option lets you take advantage of an already installed and configured Web server, reserved server and HFSQL Client/Server engine..
    • Network or Internet server with the protocol used. Enter the server name, user and password. This information was provided to you during the setup of the server reserved for the User Groupware/Private Store.
    • Specify the type of user accounts managed:
      • Shared accounts between applications: This option lets you deploy the application with other applications that will be accessible to the same users. This option is recommended for deployments in different companies.
      • Unique accounts for the application: This option stores the application with its user base.
        This option is recommended for deploying applications on a store.
    • The URLs of the administration sites are automatically filled in with the information specified above..
      WARNING: The URLs specified will only work when the user Groupware settings window is validated.. Upon validation, the modules installed with the reserved application server are automatically configured.
"Email" tab (BaaS User Groupware)
The "Email" tab allows you to configure email customization options:
  • Registration validation: if necessary, personalize the texts sent to users who have just registered..
  • Forgotten password: Customize the texts sent to users who forget their password.
Minimum version required
  • Version 18
This page is also available for…
Comments
Para migrar para a base de dados nativa precisa da senha dos arquivos do groupware
To migrate to the native database you need the groupware files password. By default, the data files found in the user groupware have a specific password.

This password is: "PCSGPW2001".

Para migrar para a base de dados nativa precisa da senha dos arquivos do groupware. Por padrão, os arquivos de dados encontrados no groupware de usuários possuem uma senha específica.

Esta senha é: "PCSGPW2001".

HIGHLY RECOMMENDED TO CHANGE THE PADREO PASSWORD
ALTAMENTE RECOMENDADO ALTERAR A SENHA PADRAO
BOLLER
30 Jan. 2019

Last update: 09/30/2024

Send a report | Local help