PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Lancement d'une application associée à une analyse
  • Lancement d'une application non-associée à une analyse
  • Ouverture d'une analyse déjà ouverte
  • Syntaxe 2 : ouverture d'une analyse distante
  • Version des analyses ouvertes avec HOuvreAnalyse
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HOuvreAnalyse (Fonction)
En anglais : HOpenAnalysis
ODBCNon disponible avec ce type de connexion
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.
Rappel : Une seule analyse peut être ouverte à un moment donné. 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.
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.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// Ouverture de l'analyse GESTCOM
HOuvreAnalyse("C:\GESTCOM\GESTCOM.WDD", "Mot de passe")
Syntaxe

Ouverture d'une analyse HFSQL localement Masquer les détails

<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 (avec guillemets)
Chemin complet du fichier ".WDD" de l'analyse. Ce fichier contient la description de l'analyse à ouvrir.
WINDEVWEBDEV - Code Serveur 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.

Ouverture d'une analyse HFSQL distante Masquer les détails

<Résultat> = HOuvreAnalyse(<Chemin du .WDD> , <Mot de passe> , <Adresse du serveur> , <Nom de l'utilisateur> , <Mot de passe utilisateur>)
<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 (avec guillemets)
Chemin complet du fichier ".WDD" de l'analyse. Ce fichier contient la description de l'analyse à ouvrir.
WINDEVWEBDEV - Code Serveur 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 (avec guillemets)
  • 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.
<Adresse du serveur> : Chaîne de caractères (avec guillemets)
Adresse IP ou nom DNS du serveur.
Rappel : Une adresse IP est une chaîne de caractères qui contient l'adresse "Internet Protocole" de la machine au format xxx.xxx.xxx.xxx.
<Nom de l'utilisateur> : Chaîne de caractères (avec guillemets)
Nom de l'utilisateur (permet d'accéder aux données).
<Mot de passe utilisateur> : Chaîne de caractères (avec guillemets)
Mot de passe utilisateur (associé au nom de l'utilisateur).
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.

Syntaxe 2 : ouverture d'une analyse distante

Cette syntaxe permet de manipuler des fichiers de données via Internet : cette manipulation est transparente pour l'utilisateur. Il est conseillé d'utiliser la fonction HConnecteAccèsDistant.
Attention : Si une analyse "distante" est ouverte, certaines fonctions HFSQL ne sont plus exécutées localement : ces fonctions sont transmises à la DLL de gestion des fonctions HFSQL distante, via le module d'accès distant de wdxxxcom.dll. Le seul changement, du point de vue de la programmation pour une application utilisant l'accès distant est effectué au niveau de l'ouverture de l'analyse.
Remarque : Afin de réaliser l'ouverture d'une analyse distante, une configuration spécifique du poste serveur et du poste client sont nécessaires. Pour plus de détails, consultez Accès distant avec HFSQL.

Version des analyses ouvertes avec 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.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire