DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Gestion du mot de passe
  • Création ou ouverture d'un fichier de données
  • Ouverture d'un fichier de données déjà ouvert
  • Gestion de la liste des fichiers de données manipulées (.REP)
  • Gestion des erreurs fatales
  • Ouverture d'une connexion et de la table spécifiée
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 un fichier de données.
Remarque : L'ouverture des fichiers de données est automatiquement gérée. Cependant, dans certains cas, il est nécessaire d'ouvrir explicitement un fichier de données (par exemple pour tester l'existence du fichier de données ou la validité du mot de passe).
Exemple
// Ouvre le fichier de données Client
HOuvre(Client)
// Ouvre tous les fichiers de données avec le mot de passe "PSW"
HOuvre("*", "PSW")
// Test du compte-rendu de la fonction HOuvre
SI HOuvre(Client, "ABCD", hOLecture) = Faux ALORS
Erreur("Impossible d'ouvrir le fichier de données Client" + HErreurInfo())
FIN
Syntaxe
<Résultat> = HOuvre([<Fichier de données> [, <Mot de passe>] [, <Mode d'accès>]])
<Résultat> : Booléen
  • Vrai si le fichier de données a été ouvert.
  • Faux en cas de problème (mot de passe incorrect, ...). La fonction HErreur permet d'identifier l'erreur. La fonction HErreurInfo permet d'obtenir plus de détails.
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données manipulé (nom logique, défini dans l'analyse).
Si ce nom n'est pas spécifié, la fonction HOuvre va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
Si ce paramètre correspond à "*", tous les fichiers de données décrits dans l'analyse sont ouverts. Si le mot de passe est précisé, ce mot de passe sera utilisé pour ouvrir tous les fichiers de données.
Ce paramètre peut également correspondre au nom d'un groupe de fichiers (ou perso-dossier) défini dans l'analyse (non disponible en Android et Android Widget). Si le mot de passe est précisé, ce mot de passe sera utilisé pour ouvrir tous les fichiers de données du groupe.
Attention : ce paramètre ne peut pas correspondre à une variable de type Description de fichier.
<Mot de passe> : Chaîne de caractères optionnelle
Mot de passe du fichier de données.
Si aucun mot de passe n'est associé au fichier de données, il est possible d'utiliser une chaîne vide ("").
<Mode d'accès> : Constante de type entier optionnelle
Paramètre le mode d'accès au fichier de données.
Si ce paramètre n'est pas spécifié, le fichier de données sera ouvert selon ses caractéristiques (si le fichier de données est en lecture seule, il sera ouvert en lecture; si le fichier de données est en lecture/écriture, il sera ouvert en mode lecture/écriture).
HOLectureLe fichier de données est accessible uniquement en lecture. Seule la lecture des enregistrements est possible. Il n'est pas possible d'en ajouter ou d'en supprimer.
HOLectureEcritureLe fichier de données est accessible en lecture et en écriture. Il est possible aussi bien de lire des enregistrements que d'écrire de nouveaux enregistrements.

Hyper File 5.5 Ce paramètre n'est pas pris en compte.
PHP Ce paramètre est ignoré.
Remarques

Gestion du mot de passe

Le mot de passe peut être précisé :
  • soit directement à l'ouverture du fichier de données avec la fonction HOuvre,
  • soit avant l'ouverture du fichier de données grâce à la fonction HPasse.

Création ou ouverture d'un fichier de données

La fonction HCréationSiInexistant peut remplacer la fonction HOuvre. En effet, si le fichier de données existe, il est automatiquement ouvert.

Ouverture d'un fichier de données déjà ouvert

Si la fonction HOuvre est utilisée sur un fichier de données déjà ouvert avec un <Mode d'accès> différent, les filtres, les blocages et les caractéristiques du parcours en cours sont perdus.

Gestion de la liste des fichiers de données manipulées (.REP)

WINDEV Mobile permet de mettre à jour une liste des fichiers de données manipulés par l'application (équivalent au fichier .REP sous WINDEV standard).
La fonction HOuvre renseigne la liste des fichiers de données manipulés par l'application (.REP pour WINDEV et WEBDEV) si la mise à jour de cette liste est activée.

Gestion des erreurs fatales

En cas d'erreur fatale lors de l'ouverture d'un fichier de données, il peut être intéressant de continuer le programme en traitant l'erreur rencontrée. Pour cela, il est conseillé de faire le traitement d'exception suivant :
QUAND EXCEPTION DANS
HOuvre(PERE)
FAIRE
Erreur("Erreur HFSQL : " + HErreur())
SINON
Trace("Fichier ouvert")
FIN
PHP Non disponible.
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaCode Utilisateur (MCU)Langage ExternePHPOLE DBConnecteurs Natifs (Accès Natifs)

Ouverture d'une connexion et de la table spécifiée

La fonction HOuvre ouvre si nécessaire la connexion sur la base de données avant d'ouvrir la table spécifiée. Si la connexion est déjà ouverte (avec les mêmes paramètres), cette connexion est automatiquement utilisée.
Remarque : La connexion utilisée par défaut correspond à la connexion associée à la table sous l'éditeur d'analyses.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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