PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

  • Overview
  • .REP or list of files?
  • What is the .REP file used for?
  • Example: Updating an application while modifying the analysis
  • Using the .REP file by programming
  • Managing the .REP file or the list of data files
  • Creating and modifying the .REP file (or the list of data files)
  • Reading the .REP file
  • Writing into the file
  • Updating the list fo data files
  • Structure of .REP file
  • Structure of .REP file
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
The .REP file
HFSQLHFSQL Client/ServerAvailable only with these kinds of connection
Overview
The .REP file (or the list of files in WINDEV Mobile) allows you to store the list of the data files used by the application.
This .REP file can be used in programming by the WLanguage functions.
Note: From version 19, HFSQL is the new name of HyperFileSQL.
.REP or list of files?
WINDEVWEBDEV - Server codeReports and QueriesUser code (UMC) The <MyProject>.REP file contains the list of files used by the application (identifier, logical name and full path of physical file).
The GUID of the analysis is the unique identifier of the analysis linked to the project, containing the description of files. This identifier can be found in the data model editor, in the analysis description ("Options" tab).
The file GUID corresponds to the identifier of logical file. This identifier can be found in the data model editor, in the description window of file ("Notes" tab).
This file is automatically created in the directory of the application and it is filled by the HFSQL engine.
Windows Mobile WINDEV Mobile allows you to update a list of data files used by the Windows Mobile application (equivalent to the.REP file in WINDEV).
This list is saved in the Pocket PC registry, in the following key: "\HKEY_LOCAL_MACHINE\SOFTWARE\PC SOFT\WD Mobile\23.0\<ApplicationName>\DATA".
The following details are stored for each data file used by the current application:
  • Identifier (GUID of the file). This identifier can be found in the data model editor, in the description window of file ("Notes" tab).
  • Logical name.
  • Full path of the physical file.
This information is automatically filled by the HFSQL Mobile engine.
For example:
What is the .REP file used for?
The ".REP" file (or the list of files in WINDEV Mobile) allows you to easily locate the data files that have been used by the WINDEV or WINDEV Mobile application.
The WINDEV application automatically updates the ".REP" file but it rarely uses the ".REP" file.
This file is used by all the tools that handle the data files of the application, and mainly by the automatic update of the data files, etc.

Example: Updating an application while modifying the analysis

When updating a WINDEV application, the automatic modification of data files is automatically started if the structure of the database is modified.
This procedure is using the ".REP" file to locate the physical files used by the application in order to modify them.
Using the .REP file by programming

Managing the .REP file or the list of data files

HSetREPEnables or disables the management of .REP file

WINDEVWEBDEV - Server code When the management of .REP file is enabled, you have the ability to specify the name and path of the .REP file. A HFREP.INI file will be created in the directory of common application data (\Application Data\PC SOFT directory). The management of ".REP" file is enabled by default.

Creating and modifying the .REP file (or the list of data files)

HCreationCreates a physical data file. This function fills the .REP file if the management of .REP file is enabled.
HCreationIfNotFoundCreates a physical data file if it does not exist.

This function fills the .REP file if the management of .REP file is enabled and if the hDelayedOpening constant is not used. If the hDelayedOpening constant is specified, the .REP file will be updated during the automatic opening of the file during the first access to the file.
HOpenOpens a physical data file and fills the .REP file if necessary
Note: The information given by HChangeDir, HSubstDir and HChangeName is taken into account when creating and updating the ".REP" file.

Reading the .REP file

HListREPLists the different files found in the .REP file as well as their physical path

Writing into the file

To write into the .REP file, all you have to do is use the functions for managing the external files:
The structure of the added line must be as follows:
LOCALIZATION=File GUIDTabulationLogical file nameTabulationPath of physical file
LOCALIZATION_CS=File GUIDTabulationLogical name of the fileTabulationPhysical location of the file in the HFSQL serverTabulation
ServerName:PortTabulationServerIP:PortTabulationDatabase
In an application in Unicode, LOCALIZATION_CS is replaced by LOCALIZATION_CS_UTF8: the different strings are encoded in UTF8.
The GUID of the file corresponds to the identifier of the logical data file. This identifier can be found in the data model editor, in the description of the data file ("Notes" tab).
Two WLanguage properties return the GUID of a data file and the GUID of the analysis that created it:
GUIDAnalysisReturns the GUID of the analysis that was used to create the data file.
GUIDFileReturns the GUID of the file defined in the analysis that was used to create the data file.

Updating the list fo data files

To update the list of data files, you have the ability to use the functions for registry management (or the ceRegistryXXX functions from a standard WINDEV application).
Structure of .REP file

Structure of .REP file

The .REP file has the following structure:
  • The first line contains the information regarding the analysis in which the data files have been described. This analysis corresponds to the analysis of the current project.
    The structure of this line is as follows:
    ANALYSISGUID=Analysis GUID

The GUID of the analysis is the unique identifier of the analysis linked to the project, containing the description of the data files. This identifier can be found in the data model editor, in the analysis description ("Options" tab).
  • The following lines describe the different data files handled by the application. A line is created for each physical data file handled. This line contains the following information:
    LOCALIZATION=File GUIDTabulationLogical name of data fileTabulationPath of physical data file

The file GUID corresponds to the identifier of logical file. This identifier can be found in the data model editor, in the description of the data file ("Notes" tab).
Example of .REP file:
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment