PC SOFT

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview
  • Allowing the user to configure the directory of data files
  • Directory where the data files are created
  • Setting during the setup
  • Special case: data files are installed with the application
  • Allowing the user to configure the directory of data files
  • Allowing the user to configure the directory of the files of user groupware
  • Directory for creating the data files of the user groupware
  • Allowing the user to configure the directory of the data files of user groupware
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
WDInst: configuring the directory of the data files and the directory of the files of user groupware
Overview
The setup editor WDInst allows you to add additional options into the setup program. These additional options allow the user to specify:
  • the directory of the data files of the application.
  • the directory of the files of user groupware.
These options can also be added using the setup program creation wizard.
Reminder: To start WDInst, go to the "Tools" pane, "Utilities" group and click "WDInst".
Allowing the user to configure the directory of data files

Directory where the data files are created

By default, the data files are created in the directories specified when describing files in the analysis. However, these directories can be modified:
  • when creating the executable of the application.
  • by programming with HSubstDir or HChangeDir.
  • when installing the application. The directory for creating the data files will be selected by the user.

Setting during the setup

If your application uses data files, you can allow the user to set the location of the data files when installing the application.
The directory selected by the user will be automatically used for all the data files created by the application. It is directly stored in the executable, without using the registry or a parameter file.
Remark: This directory will be proposed by default when installing the application updates.
This option is used to avoid programming the location of data files (with HSubstDir for example).
Reminder: In any case, the directory for creating the data files is defined according to the following priority order:
  1. Directory specified by HSubstDir or HChangeDir.
  2. Directory selected when installing the application (if this option is proposed to the user).
  3. Directory selected when creating the executable.
  4. Directory specified when describing the files in the analysis.
Therefore, the directory defined by HSubstDir or HChangeDir has priority over all the other directories.

Special case: data files are installed with the application

These data files are installed in the directory specified in WDInst (destination directory).
For a network setup, these data files will be installed in the "<ExecutableName>" subdirectory of the application setup directory on the server.
To allow the user to configure the location of the data files, check "Customize the path of the data files during setup".

Allowing the user to configure the directory of data files

To allow the user to configure the location of the data files:
  1. Select "Setup parameters .. HFSQL files".
  2. Click the "Connections" tab.
  3. Select "Edit the location of the data files".
  4. Click the "Parameter" button.
  5. Check "The values entered during the setup (specify the default values)".
Allowing the user to configure the directory of the files of user groupware

Directory for creating the data files of the user groupware

If your application uses the user groupware, two categories of data files are managed:
  • the data files used to identify the users. These data files can be common to several applications.
  • the data files used to manage the rights granted to the users on the different windows of the application. These files are specific to the application.
See The files of user groupware for more details.
By default, these data files are created in the "GPW_<ApplicationName>" subdirectory of the application setup directory. However, this directory can be modified. The table below presents the different methods proposed by WINDEV to modify this directory.
Data files used to
identify the users		Data files used to
manage the rights granted to the users
How to modify the creation directory of these files?
  • when configuring the user groupware (caution: this directory is used for the tests of the application only).
  • when creating the executable of the application.
  • when installing the application. This directory is selected by the user.
  • when installing the application. This directory is selected by the user.
What is the priority order when defining the creation directory of these files?
  1. The directory selected by the user when installing the application (if the setup program allows the user to select this directory).
  2. The directory selected when creating the application executable.
  3. The default directory ("GPW_<ApplicationName>" subdirectory of the application setup directory).
Therefore, the directory selected by the user has priority over the other directories.
  1. The directory selected by the user when installing the application (if the setup program allows the user to select this directory).
  2. The default directory ("GPW_<ApplicationName>" subdirectory of the application setup directory). Therefore, the directory selected by the user has priority over the default directory.

Allowing the user to configure the directory of the data files of user groupware

To allow the directory of the data files of user groupware to be configured:
  1. Select "Setup parameters .. HFSQL files".
  2. Check "Configure the directory of the groupware files during the setup".
See also
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment