ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Your version: 01F150038E (WINDEV 15)

This page concerns the 2024 + version of WINDEV, WEBDEV and WINDEV Mobile. Update your version of WINDEV.
Help / WLanguage / Managing databases / HFSQL / HFSQL functions
  • Launching an application associated with a main analysis
  • Starting an application not associated with an analysis
  • Automatically hide data files with the same name in different analyses
  • Opening an analysis that is already open
  • Analysis version supported by HOpenComplementaryAnalysis
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
HOpenComplementaryAnalysis (Function)
In french: HOuvreAnalyseComplémentaire
Opens a new analysis, but keeps the main analysis of the application. Already open analyses are not closed.
Caution: To use this function, you must first have declared or opened a main analysis (HOpenAnalysis).
Example
// Open a complementary analysis
HOpenComplementaryAnalysis("C:\SALESMGT\SALESMGT.WDD", "Password")
Syntax
<Result> = HOpenComplementaryAnalysis(<WDD file path> [, <Password>])
<Result>: Boolean
  • True if the analysis was opened,
  • False otherwise. HError returns more details about the problem.
<WDD file path>: Character string
Full path of the ".WDD" file of the analysis. This file contains the description of the analysis to be opened.
<Password>: Optional character string
  • Analysis password, defined in the data model editor.
  • Empty string ("") if no password is associated with the analysis.
Remarks

Launching an application associated with a main analysis

  • The main analysis is automatically opened when the application is launched. The analysis is searched for in the main library of the application, then in the directory of the application.
    To make sure the analysis is found, we advise you to include the analysis in the main library of the application.
  • If HOpenComplementaryAnalysis is called by an application associated with a main analysis, this function:
    • has no effect if the path of the specified analysis corresponds to the path of the analysis associated with the application.
    • returns False if the path of the specified analysis does not exist. In this case, the application keeps working with the current analysis.
    • opens the analysis and returns True if the specified analysis exists and if it is valid.

Starting an application not associated with an analysis

When an application that is not associated with an analysis is started, no analysis is automatically opened. In this case, you need to use the HOpenAnalysis function.
To open a complementary analysis, use HOpenComplementaryAnalysis. The analysis opened by HOpenComplementaryAnalysis is searched:
  • first, in the main library of the application according to its full physical name.
  • then, on the current disk.

Automatically hide data files with the same name in different analyses

Different analyses can contain data files with the same name. In this case, only one data file will be used. Which file is used depends on the order of the analyses. This order can be defined in the project description or with the HOpenAnalysis and HOpenComplementaryAnalysis functions. Here is how it works:
  • Analysis 1:
    • File A
    • File B
  • Analysis 2:
    • File B. This file will be "hidden", as it is present in Analysis 1.
      To use File B from Analysis 2, you need to rename it in Analysis 2.
    • File C
  • Analysis 3:
    • File B: This file will be "hidden", as it is present in Analysis 1.
      To use File B from Analysis 3, you need to rename it in Analysis 3.
    • File C: This file will be "hidden", as it is present in Analysis 2.
      To use File C from Analysis 3, you need to rename it in Analysis 3.
    • File D.
In the "Analysis" section of the "Project Explorer" pane, the following files will be shown:
  • File A (Analysis 1)
  • File B (Analysis 1)
  • File C (Analysis 2)
  • File D (Analysis 3).

Opening an analysis that is already open

If the analysis you are trying to open with HOpenComplementaryAnalysis is already open, the function has no effect.

Analysis version supported by HOpenComplementaryAnalysis

HOpenComplementaryAnalysis cannot be used to open Hyper File 5.5 analyses (and earlier versions). Only HFSQL Classic analyses can be opened.
Business / UI classification: Business Logic
Component: wd290hf.dll
Minimum version required
  • Version 2024
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/21/2024

Send a report | Local help