PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
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
dbgStartRecording (Function)
In French: dbgDébutEnregistrement
Starts recording a test scenario (also called reproduction scenario).
The reproduction scenario is a ".wsct" file containing the test scenario.
This file can be supplied to the application designer who will be able to include this scenario in the automatic tests of the application via 'Automatic tests .. Import a scenario recorded on the application".This file can be supplied to the application designer. To include this scenario in the automatic tests of the application, on the "Automatic tests" pane, in the "Tests" group, expand "New" and select "Import a scenario recorded on the application".
See Scenario created by the user for more details.
Example
dbgStartRecording()
Syntax
<Result> = dbgStartRecording([<Name of Scenario File>])
<Result>: Boolean
  • True if the recording was started,
  • False otherwise.
<Name of Scenario File>: Optional character string
Location and name of the scenario file to create. The name of the file can be built with the following elements:
[%ExeDir%]Directory of executable, always filled with the "\" character. This directory is equivalent to the result of fExeDir.
[%ExeName%]Executable name.
[%Date%]Start date of scenario (YYYYMMDD format).
[%Time%]Start time of scenario (HHMMSS format).
[%UserName%]Name of current user.
[%ComputerName%]Computer name.
Versions 18 and later
[%DataDir%]
New in version 18
[%DataDir%]
[%DataDir%]
Directory of HFSQL data files specified by the user when installing the application. This directory is equivalent to the result of fDataDir.
Versions 18 and later
[%DirUserData%]
New in version 18
[%DirUserData%]
[%DirUserData%]
Directory for the data of the current user of the current application. This directory is equivalent to the result of fDataDirUser.
By default:
  • before version 180062: the name of the scenario file corresponds to: "[%ExeDir%][%ExeName%]_[%Date%]_[%Time%]".
    For example: "C:\MyApp\Myapp_20071023_130812.wsct".
  • from version 180062: the name of the scenario file corresponds to: "[%UserDataDir%][%ExeName%]_[%Date%]_[%Time%]".
    For example: "C:\Users\Doc\AppData\Roaming\WINDEV Applications\MyApp\MyApp_20071023_130812.wsct".
By default, the name of the scenario file corresponds to: "[%UserDataDir%][%ExeName%]_[%Date%]_[%Time%]".
For example: "C:\Users\Doc\AppData\Roaming\WinDev Applications\MyApp\Myapp_20161023_130812.wsct".
Versions 22 and later
Caution: If you are using the dynamic construction of strings ("Allow "[% %]" in the strings" option in the "Compilation" tab of project description), a compilation error occurs (unknown identifier). In this case, each string must be preceded by '-%'. Example:
dbgStartRecording("[%DirUserData%][%exeName%]_[%Date%]_[%Time%]")
becomes
dbgStartRecording(-%"[%DirUserData%][%ExeName%]_[%Date%]_[%Time%]")
New in version 22
Caution: If you are using the dynamic construction of strings ("Allow "[% %]" in the strings" option in the "Compilation" tab of project description), a compilation error occurs (unknown identifier). In this case, each string must be preceded by '-%'. Example:
dbgStartRecording("[%DirUserData%][%exeName%]_[%Date%]_[%Time%]")
becomes
dbgStartRecording(-%"[%DirUserData%][%ExeName%]_[%Date%]_[%Time%]")
Caution: If you are using the dynamic construction of strings ("Allow "[% %]" in the strings" option in the "Compilation" tab of project description), a compilation error occurs (unknown identifier). In this case, each string must be preceded by '-%'. Example:
dbgStartRecording("[%DirUserData%][%exeName%]_[%Date%]_[%Time%]")
becomes
dbgStartRecording(-%"[%DirUserData%][%ExeName%]_[%Date%]_[%Time%]")
Remarks
  • dbgStartRecording has no effect if a scenario is currently recorded.
  • dbgEndRecording is used to end the recording of the scenario.
  • The recording of the scenario can also be started via the ".wx" file found beside the executable. See Scenario created by the user for more details.
Components
WINDEVReports and Queries wd230vm.dll
Minimum required version
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment