DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Lancement d'une application associée à une analyse
  • Lancement d'une application non associée à une analyse
  • Ouverture d'une analyse déjà ouverte
  • Version des analyses ouvertes avec la fonction HOuvreAnalyse
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Ouvre une analyse au format HFSQL Classic. Il est ainsi possible d'accéder aux fichiers de données décrits dans cette analyse, et à la structure de ces fichiers de données.
Attention : Une seule analyse peut être ouverte à un moment donné avec la fonction HOuvreAnalyse.
  • Si une analyse était déjà ouverte avant l'appel de la fonction, cette analyse est automatiquement fermée ainsi que les fichiers de données associés.
  • Pour ouvrir plusieurs analyses simultanément, utilisez la fonction HOuvreAnalyse pour ouvrir l'analyse principale et la fonction HOuvreAnalyseComplémentaire pour ouvrir les analyses complémentaires.
Attention : Lors de l'utilisation de la fonction HOuvreAnalyse, le contexte HFSQL en cours est automatiquement ré-initialisé. Les opérations suivantes sont automatiquement effectuées :
  • Tous les fichiers de données précédemment ouverts sont fermés.
  • Toutes les vues HFSQL existantes sont supprimées.
  • Toutes les requêtes existantes sont supprimées.
  • Toutes les déclarations réalisées avec les fonctions HDéclareExterne et HDécritFichier sont supprimées.
Exemple
// Ouverture de l'analyse GESTCOM
HOuvreAnalyse("C:\GESTCOM\GESTCOM.WDD", "Mot de passe")
Syntaxe
<Résultat> = HOuvreAnalyse(<Chemin du .WDD> [, <Mot de passe>])
<Résultat> : Booléen
  • Vrai si l'analyse a été ouverte,
  • Faux dans le cas contraire. La fonction HErreur permet d'obtenir plus d'informations sur le problème rencontré.
<Chemin du .WDD> : Chaîne de caractères
Chemin complet du fichier ".WDD" de l'analyse. Ce fichier contient la description de l'analyse à ouvrir.
WINDEV Si seuls le lecteur et le nom de l'analyse sont spécifiés, l'analyse est recherchée dans le répertoire en cours du lecteur spécifié.
Si ni le lecteur, ni le chemin de l'analyse ne sont spécifiés, l'analyse est recherchée dans le répertoire en cours du disque en cours.
La syntaxe <Unité>:<Nom d'analyse> permet de rechercher l'analyse dans le répertoire courant du lecteur spécifié.
<Mot de passe> : Chaîne de caractères optionnelle
  • Mot de passe de l'analyse, défini dans l'éditeur d'analyses.
  • Chaîne vide ("") si aucun mot de passe n'est associé à l'analyse.
Remarques

Lancement d'une application associée à une analyse

  • Au lancement d'une application, l'analyse associée à cette application est automatiquement ouverte. L'analyse est recherchée dans la bibliothèque principale de l'application, puis dans le répertoire de l'application.
    Pour éviter que l'analyse ne soit pas trouvée, il est conseillé d'inclure l'analyse dans la bibliothèque principale de l'application.
  • Si la fonction HOuvreAnalyse est appelée par une application associée à une analyse, cette fonction :
    • n'a aucun effet si le chemin de l'analyse spécifié correspond au chemin de l'analyse associée à l'application.
    • retourne Faux si le chemin de l'analyse spécifié n'existe pas. Dans ce cas, l'application continue de travailler avec l'analyse en cours.
    • ouvre l'analyse et retourne Vrai si l'analyse spécifiée existe et est valide.

Lancement d'une application non associée à une analyse

Au lancement d'une application non associée à une analyse, aucune analyse n'est automatiquement ouverte. Il est donc nécessaire d'utiliser la fonction HOuvreAnalyse.
L'analyse ouverte avec la fonction HOuvreAnalyse est recherchée :
  • tout d'abord, dans la bibliothèque principale de l'application selon son nom physique complet.
  • puis, sur le disque en cours.

Ouverture d'une analyse déjà ouverte

Si l'analyse ouverte par la fonction HOuvreAnalyse est déjà ouverte, la fonction HOuvreAnalyse n'a aucun effet.

Version des analyses ouvertes avec la fonction HOuvreAnalyse

La fonction HOuvreAnalyse ne permet pas d'ouvrir les analyses au format Hyper File 5.5 et inférieur. Seules les analyses HFSQL Classic peuvent être ouvertes.
Pour utiliser la fonction HOuvreAnalyse sur des fichiers Hyper File 5.5, il est nécessaire d'utiliser le fichier ".WDD" d'une analyse HFSQL Classic contenant des fichiers au format Hyper File 5.5. Dans ce cas, le fichier ".WDD" de l'analyse WINDEV 5.5 d'origine devra impérativement être présent dans le répertoire de l'exécutable.
Il est également possible d'utiliser la fonction HDéclare pour manipuler directement un fichier Hyper File 5.5.
Classification Métier / UI : Code métier
Composante : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/06/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale