DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
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
Les fonctions de gestion des fichiers de données HFSQL (Syntaxe préfixée) sont :
<Destination>.CopieEnregCopie :
  • le contenu de l'enregistrement en cours (chargé en mémoire) dans l'enregistrement en cours d'un fichier de données.
  • le contenu d'une variable de type Enregistrement dans l'enregistrement en cours d'un fichier de données.
<Fichier HFSQL>.ExporteChaîneJSONExporte les enregistrements d'un fichier de données (HFSQL ou OLE DB), d'une vue ou d'une requête dans une chaîne au format JSON.
Renvoie la liste des clés spatiales d'un fichier de données (d'une requête ou d'une vue) reconnues par le moteur HFSQL.
<Source>.ActiveFiltreActive le filtre précédemment créé pour le fichier de données (la vue ou la requête) spécifié.
<Source>.ActiveFiltreAutoActive un filtre automatique sur les fichiers reliés lors du parcours d'un fichier XML.
<Source>.AjouteAjoute :
  • l'enregistrement présent en mémoire dans le fichier de données (la requête ou la vue).
  • l'enregistrement présent dans une variable de type Enregistrement dans le fichier de données (la requête ou la vue).
<Source>.AliasCrée un alias logique d'un fichier de données (ou d'une requête) ou annule tous les alias existants.
<Source>.AnnuleDéclarationPermet de :
<Source>.AnnuleRechercheAnnule le critère de recherche en cours.
<Source>.AttacheMémoPermet d'associer un fichier à une rubrique de type mémo binaire ou d'annuler l'attachement existant entre un fichier et une rubrique binaire.
<Source>.AvanceAvance de plusieurs enregistrements dans le fichier de données, à partir de la position en cours, selon une rubrique spécifiée.
<Source>.BloqueFichierBloque un fichier de données et restreint l'accès à ce fichier de données pour tous les autres sites ou applications.
<Source>.BloqueNumEnrBloque un enregistrement et restreint l'accès à cet enregistrement pour toutes les autres applications.
<Source>.ChangeCléChange la rubrique de parcours.
<Source>.ChangeConnexionChange dynamiquement la connexion associée à un fichier de données.
<Source>.ChangeLocalisationModifie le mode de recherche des fichiers de données physiques (.FIC, .NDX, ...).
<Source>.ChangeNomModifie le nom physique d'un fichier de données.
<Source>.ChangeRepModifie le chemin d'accès à un fichier de données (c'est-à-dire le répertoire dans lequel le fichier sera manipulé).
<Source>.ChangeRepJnlModifie l'emplacement des fichiers du journal correspondant à un fichier de données HFSQL.
<Source>.CompareRubriqueCompare deux valeurs en les triant selon la rubrique d'index HFSQL spécifiée : toutes les options de tri spécifiées pour la rubrique sont prises en compte (sensibilité à la casse, la ponctuation, sens de tri, langue Unicode, ...).
<Source>.ConstruitValCléConstruit la valeur d'une clé composée pour réaliser un filtre (fonction <Source>.Filtre) ou effectuer une recherche (fonctions <Source>.LitRecherchePremier, <Source>.LitRechercheDernier, ...).
<Source>.CréationCrée à vide un fichier de données (fichier d'extension ".FIC") avec le fichier d'index et le fichier mémo si nécessaires.
<Source>.CréationSiInexistantEffectue les opérations suivantes :
  • Si le fichier n'existe pas, crée à vide un fichier de données (fichier d'extension ".FIC") avec le fichier d'index et le fichier mémo si nécessaire.La fonction est équivalente à <Source>.Création.
  • Si le fichier existe, ouvre le fichier.
<Source>.CréeVueCrée une vue HFSQL.
Cette fonction utilise l'ancien mécanisme des vues.
<Source>.DateEnregRenvoie la date et l'heure de la dernière écriture d'un enregistrement dans un fichier HFSQL (Classic ou Client/Serveur).
<Source>.DébloqueFichierDébloque les enregistrements d'un fichier de données :
  • précédemment bloqués avec la fonction <Source>.BloqueFichier.
  • bloqués individuellement avec une fonction de lecture bloquante.
<Source>.DébloqueNumEnrDébloque un enregistrement précédemment bloqué avec :
  • soit la fonction <Source>.BloqueNumEnr,
  • soit une fonction de lecture utilisée avec un paramètre bloquant (par exemple fonction <Source>.Lit utilisé avec l'option hBlocageEcriture ou hBlocageLectureEcriture).
<Source>.DéclareDéclare une description de fichier de données (présente dans une analyse) dans le projet en cours.
<Source>.DéclareExterneImporte temporairement dans l'analyse en cours la description d'un fichier de données à partir d'un fichier de données HFSQL existant.
<Source>.DécritFichierDécrit un fichier de données par programmation.
<Source>.DécritTriggerAjoute ou modifie un trigger sur un fichier de données HFSQL.
<Source>.DernierPositionne sur le dernier enregistrement d'un fichier de données selon une rubrique de parcours.
<Source>.DésactiveFiltreDésactive temporairement un filtre sur un fichier de données (une vue ou une requête).
<Source>.DésactiveFiltreAutoDésactive un filtre automatique sur les fichiers reliés lors du parcours d'un fichier XML.
<Source>.DétruitTriggerDétruit un trigger.
<Source>.DétruitVueDétruit une vue précédemment créée. Cette fonction utilise l'ancien mécanisme des vues.
<Source>.DupliqueEnregistrementDuplique l'enregistrement lu dans un fichier de données : l'enregistrement présent en mémoire est ajouté dans le fichier de données (la requête ou la vue).
<Source>.EcritÉcrit un enregistrement dans le fichier de données sans mettre à jour les index correspondants à toutes les clés utilisées dans le fichier.
<Source>.EnDehorsPermet de savoir si l'enregistrement sur lequel on veut se positionner est en dehors du fichier de données, du filtre, de la vue ou de la requête.
<Source>.EnregistreModifie l'enregistrement courant s'il existe, sinon ajoute un nouvel enregistrement.
<Source>.EnregistrementVersChaîneConvertit sous forme de chaîne le contenu de l'enregistrement en cours (dans un fichier de données, une vue HFSQL, une requête, ...).
<Source>.EnregistrementVersJSONRécupère la structure et la valeur de l'enregistrement en cours et les exporte dans une chaîne de caractères au format JSON.
<Source>.EnregistrementVersXMLRécupère la structure et la valeur de l'enregistrement en cours et les exporte dans une chaîne de caractères au format XML.
<Source>.ErreurEtatModificationRenvoie l'état d'un enregistrement lors d'un conflit de modification.
<Source>.ErreurModificationPermet de renvoyer la valeur d'une rubrique d'un enregistrement lors d'un conflit de modification.
<Source>.EtatPermet de connaître l'état d'un enregistrement.
<Source>.ExécuteRequêteDéclare une requête créée sous l'éditeur de requêtes au moteur HFSQL et exécute cette requête.
<Source>.ExécuteRequêteAsynchroneExécute une requête de type SELECT de manière asynchrone.
<Source>.ExécuteRequêteSQLInitialise une requête écrite en langage SQL et déclare cette requête au moteur HFSQL.
<Source>.ExécuteRequêteSQLAsynchroneExécute une requête SQL de manière asynchrone.
<Source>.ExécuteVueExécute une vue créée auparavant (permet par exemple de réactualiser les données de la vue). Cette fonction utilise l'ancien mécanisme des vues.
<Source>.ExporteCSVExporte les enregistrements d'un fichier de données (HFSQL ou OLE DB), d'une vue ou d'une requête dans un fichier CSV.
<Source>.ExporteJSONExporte les enregistrements d'un fichier de données (HFSQL ou OLE DB), d'une vue ou d'une requête dans un fichier JSON.
<Source>.ExporteXLSExporte les enregistrements d'un fichier de données (HFSQL ou OLE DB), d'une vue ou d'une requête dans un fichier Excel (XLSX).
<Source>.ExporteXMLExporte les enregistrements d'un fichier de données (HFSQL ou OLE DB), d'une vue ou d'une requête dans un fichier XML.
<Source>.ExtraitMémoExtrait le contenu d'une rubrique de type mémo binaire d'un fichier HFSQL, d'une requête ou d'une vue HFSQL dans un fichier physique (sur le disque).
<Source>.FermeFerme soit un fichier de données, soit tous les fichiers de données ouverts par l'utilisateur en cours : tous les fichiers de données physiques correspondant sont fermés pour l'utilisateur en cours.
<Source>.FichierExistePermet de savoir :
<Source>.FiltreDéfinit et active un filtre sur un fichier de données, une vue ou une requête.
<Source>.FiltreCommenceParDéfinit et active un filtre de type "Commence par" sur un fichier, une vue ou une requête.
<Source>.FiltreComprisEntreDéfinit et active un filtre de type "Compris entre" sur un fichier, une vue ou une requête.
<Source>.FiltreContientDéfinit et active un filtre de type "Contient" sur un fichier de données, une vue ou une requête.
<Source>.FiltreIdentiqueDéfinit et active un filtre permettant de rechercher la valeur exacte d'une rubrique de type chaîne.
<Source>.FinInterditModifDébloque un fichier qui a été bloqué par le même programme avec la fonction <Source>.InterditModif.
<Source>.ForceEcritureForce le système d'exploitation du poste sur lequel les fichiers de données sont présents à écrire les données directement sur le disque.
<Source>.FTListeMotListe les mots de l'enregistrement courant qui seront pris en compte par l'indexation full-text.
<Source>.FusionneVueCrée une vue HFSQL à partir de deux vues précédemment créées (fonction <Source>.CréeVue). Cette fonction utilise l'ancien mécanisme des vues.
<Source>.GèreDoublonActive ou désactive la gestion des doublons sur une clé unique.
<Source>.GèreJournalActive ou désactive la gestion du journal d'un fichier journalé.
<Source>.GèreMémoPermet de modifier la gestion des rubriques de type mémo.
<Source>.GèreTransactionActive ou désactive la gestion des transactions sur un ou plusieurs fichiers.
<Source>.HistoriqueModificationRenvoie les modifications apportées à une ou plusieurs rubriques d'un enregistrement donné. Le résultat peut être par exemple affiché dans une liste ou une table afin de permettre à l'utilisateur de visualiser les modifications effectuées sur le fichier spécifié.
<Source>.ImporteHF55Importe un fichier Hyper File 5.5 dans un fichier au format HFSQL Classic.
<Source>.ImporteJSONImporte un fichier JSON dans un fichier de données au format HFSQL Classic (fichier de données décrit sous l'éditeur d'analyses ou déclaré par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou <Source>.DécritFichier).
<Source>.ImporteTexteImporte un fichier Texte dans un fichier de données au format HFSQL Classic ou Client/Serveur (fichier de données décrit sous l'éditeur d'analyses, ou déclaré par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou <Source>.DécritFichier).
<Source>.ImporteXLSImporte un fichier XLS dans un fichier de données au format HFSQL Classic ou Client/Serveur (fichier de données décrit sous l'éditeur d'analyses ou déclaré par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou HDécritFichier).
<Source>.ImporteXMLImporte un fichier XML dans un fichier de données au format HFSQL Classic ou Client/Serveur (fichier de données décrit sous l'éditeur d'analyses ou déclaré par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou <Source>.DécritFichier).
<Source>.InfoFichierRenvoie les caractéristiques d'un fichier de données HFSQL Classic ou Client/Serveur.
<Source>.InfoMémoRenvoie les caractéristiques des mémo binaire et texte.
<Source>.InitAbonnéInitialise la plage d'identifiants automatiques d'un fichier de description d'un réplica abonné (extension ".RPL").
<Source>.InterditModifInterdit toute modification sur un fichier de données (pour tous les programmes, y compris le programme qui a demandé l'interdiction).
<Source>.JournalInfoAjoute des commentaires dans le journal lors de l'enregistrement de l'opération journalée.
<Source>.JournalRecréePermet de re-créer un journal à vide.
<Source>.JournalRedémarreRedémarre la journalisation du fichier.
<Source>.JournalStopArrête la journalisation du fichier.
<Source>.JSONVersEnregistrementImporte des données JSON vers l'enregistrement courant.
<Source>.LibèreRequêteLibère les ressources d'une requête (suite à l'utilisation des fonctions <Source>.ExécuteRequête ou <Source>.ExécuteRequêteSQL).
<Source>.ListeCléRenvoie la liste des clés d'un fichier (d'une requête ou d'une vue) reconnu par le moteur HFSQL.
<Source>.ListeIndexFullTextRenvoie la liste des index full-text d'un fichier de données (d'une requête ou d'une vue) reconnus par le moteur HFSQL.
<Source>.ListeLiaisonRenvoie la liste des liaisons (de type Merise) présentes dans l'analyse en cours ou dans une analyse spécifique.
<Source>.ListeMotVideRenvoie la liste des mots vides utilisés par un index full-text.
<Source>.ListeParamRequêteRenvoie la liste des paramètres d'une requête créée avec l'éditeur de requêtes.
<Source>.ListeRubriqueRenvoie la liste des rubriques présentes dans un fichier de données (d'une requête ou d'une vue) reconnu par le moteur HFSQL. Les fichiers de données définis par les fonctions <Source>.Déclare, <Source>.DéclareExterne et <Source>.DécritFichier sont pris en compte.
<Source>.ListeSynonymeRenvoie la liste des synonymes utilisés par un index full-text.
<Source>.LitLit un enregistrement dans un fichier en fonction d'un numéro d'enregistrement donné.
<Source>.LitDernierPositionne sur le dernier enregistrement d'un fichier selon une rubrique de parcours.
<Source>.LitPrécédentPositionne sur l'enregistrement précédent d'un fichier en fonction d'une rubrique de parcours.
<Source>.LitPremierPositionne sur le premier enregistrement d'un fichier en fonction d'une rubrique de parcours.
<Source>.LitRecherchePositionne sur le premier enregistrement du fichier dont la valeur d'une rubrique spécifique est supérieure ou égale à une valeur recherchée (recherche générique).
<Source>.LitRechercheDernierPositionne sur le dernier enregistrement du fichier dont la valeur d'une rubrique spécifique est inférieure ou égale à une valeur recherchée (recherche à l'identique).
<Source>.LitRecherchePremierPositionne sur le premier enregistrement du fichier dont la valeur d'une rubrique spécifique est strictement égale à une valeur recherchée (recherche à l'identique).
<Source>.LitSuivantPositionne sur l'enregistrement suivant d'un fichier de données en fonction d'une rubrique de parcours.
<Source>.MigreCléComposéeReliéeMigre les valeurs des clés composées reliées provenant d'un fichier au format Hyper File 5.5 vers le format HFSQL Classic.
<Source>.ModeChange le mode et la méthode de blocage des fichiers de données.
<Source>.ModifieModifie l'enregistrement spécifié ou l'enregistrement présent en mémoire dans le fichier de données (la requête ou la vue).
<Source>.ModifieStructurePermet de mettre à jour la structure d'un fichier de données HFSQL en effectuant une modification automatique des données (également appelée Synchronisation des données).
<Source>.MotDePasseFixe le mot de passe utilisé pour créer ou pour ouvrir un fichier de données.
<Source>.NbEnrRenvoie le nombre d'enregistrements d'un fichier, d'une requête ou d'une vue HFSQL : enregistrements actifs, rayés, supprimés, etc.
<Source>.NumEnrRenvoie :
  • le numéro de l'enregistrement en cours dans le fichier de données HFSQL.
  • le numéro de l'enregistrement en cours dans la vue HFSQL.
<Source>.OptimisePermet d'utiliser des temps morts dans l'utilisation d'un logiciel (période sans traitements) pour optimiser les requêtes et les parcours qui vont être exécutés plus tard.
<Source>.OuvreOuvre un fichier de données.
<Source>.PositionCouranteRenvoie la position approximative de l'enregistrement en cours dans le fichier de données.
<Source>.PositionnePositionne sur un enregistrement à partir de la position approximative d'une de ses rubriques.
<Source>.PrécédentPositionne sur l'enregistrement précédent du fichier en fonction d'une rubrique de parcours.
<Source>.PremierPositionne sur le premier enregistrement d'un fichier de données en fonction de la rubrique de parcours spécifiée.
<Source>.PrépareRequêteInitialise une requête et déclare cette requête au serveur de base de données pour optimiser les prochaines exécutions de cette requête.
<Source>.PrépareRequêteSQLInitialise une requête écrite en langage SQL et déclare cette requête au serveur de base de données pour optimiser les prochaines exécutions de cette requête.
<Source>.RayeRaye un enregistrement d'un fichier de données.
<Source>.RAZInitialise :
  • une ou toutes les variables des rubriques d'un fichier de données avec leurs valeurs par défaut.
  • une ou toutes les rubriques d'une variable de type Enregistrement avec leurs valeurs par défaut.
<Source>.RecherchePositionne sur le premier enregistrement du fichier de données dont la valeur d'une rubrique spécifique est supérieure ou égale à une valeur recherchée (recherche générique par défaut).
<Source>.RechercheDernierPositionne sur le dernier enregistrement du fichier dont la valeur d'une rubrique spécifique est inférieure ou égale à une valeur recherchée.
<Source>.RecherchePremierPositionne sur le premier enregistrement du fichier dont la valeur d'une rubrique spécifique est supérieure ou égale à une valeur recherchée.
<Source>.ReculeRecule de plusieurs enregistrements dans le fichier de données, à partir de la position en cours, selon une rubrique spécifiée.
<Source>.RécupèreEnregistrementRenvoie le contenu de l'enregistrement en cours (dans un fichier, une vue, une requête, ...).
<Source>.RécupèreRubriqueRenvoie le contenu d'une rubrique de l'enregistrement en cours (dans le fichier de données, la vue, la requête, ...).
<Source>.RéindexationEnCoursAvertit si une ré-indexation est en cours sur un fichier de données HFSQL et renvoie le pourcentage de ré-indexation effectué.
<Source>.RéindexeReconstruit l'index d'un fichier de données (fichier d'extension ".NDX").
Permet de savoir si une requête a été exécutée.
<Source>.RetourPositionRestaure le contexte précédemment sauvegardé d'un fichier (fonction <Source>.SauvePosition) : enregistrement en cours, filtre, pointeurs de lecture.
<Source>.SauvePositionMémorise le contexte en cours d'un fichier : enregistrement en cours, filtre, pointeurs de lecture.
<Source>.SécuritéActive ou désactive le mécanisme de sécurité automatique sur un ou plusieurs fichiers de données.
Permet de savoir si une source de données est initialisée.
<Source>.StatCalculeRéalise diverses statistiques sur les clés d'un fichier de données.
<Source>.StatDateRenvoie la date de la dernière mise à jour des statistiques d'index.
<Source>.StatHeureRenvoie l'heure de la dernière mise à jour des statistiques d'index.
<Source>.StatNbDoublonRenvoie le nombre de doublons pour une rubrique clé donnée.
<Source>.StatNbEnrRenvoie le nombre d'entrées pour une rubrique clé donnée.
<Source>.StatNbEnrIntervalleRenvoie une estimation majorée du nombre d'entrées pour une rubrique clé donnée dans un intervalle de valeurs donné.
<Source>.SuivantPositionne sur l'enregistrement suivant du fichier de données en fonction d'une rubrique de parcours.
<Source>.SupprimeSupprime un enregistrement d'un fichier de données (d'une requête ou d'une vue).
<Source>.SupprimeToutSupprime tous les enregistrements d'un fichier de données, d'une vue HFSQL ou d'une requête.
<Source>.SupprimeToutRayéTransforme les enregistrements rayés (<Source>.Raye) d'un fichier en enregistrements supprimés.
<Source>.SurErreurPersonnalise la gestion des erreurs HFSQL.
<Source>.TransactionLibèreTransforme tous les enregistrements "en transaction" en enregistrements "Normaux" si ces enregistrements n'appartiennent pas à une transaction en cours.
<Source>.TrieVueTrie une vue HFSQL en créant un index sur une rubrique de la vue. Cette fonction utilise l'ancien mécanisme des vues.
<Source>.TrouveVérifie si l'enregistrement en cours correspond au filtre ou à la recherche en cours.
<Source>.VérifieInaltéréVérifie qu'un ou tous les enregistrements d'un fichier de données inaltérable n'ont pas été modifiés (par exemple avec un éditeur hexadécimal).
<Source>.VérifieIndexVérifie que les données contenues dans le fichier d'index (fichier .NDX) référencent correctement les données contenues dans le fichier de données (fichier .FIC).
<Source>.VérifieMémoVérifie l'intégrité structurelle des mémos d'un fichier de données HFSQL.
<Source>.VérifieStructureFixe le mode de comparaison des fichiers de données.
<Source>.VersFichierCopie une source de données (fichier, requête, vue, ...) vers un fichier physique HFSQL de même description. Ce fichier n'est ni crypté, ni protégé par mot de passe.
<Source>.VersionPermet de savoir :
  • si le contenu d'un fichier a été modifié.
  • si le contenu d'un fichier utilisé par une requête a été modifié.
<Source>.VersRubriqueAffecte la valeur indiquée à une rubrique de l'enregistrement en cours.
<Source>.VueVersFichierEnregistre les modifications réalisées dans une vue HFSQL (grâce aux fonctions <Source>.Modifie, <Source>.Supprime ou <Source>.Raye) dans le fichier de données correspondant. Cette fonction utilise l'ancien mécanisme des vues.
<Variable Connexion>.FermeConnexionFerme une connexion à une base de données.
<Variable Connexion>.FichierExistePermet de savoir si un fichier existe, c'est-à-dire s'il a été créé physiquement (fonctions <Source>.Création ou <Source>.CréationSiInexistant).
<Variable Connexion>.GèreIntégritéActive ou désactive la gestion d'une contrainte d'intégrité sur une liaison d'un fichier de données.
<Variable Connexion>.InfoFichierRenvoie les caractéristiques d'un fichier de données HFSQL Classic ou Client/Serveur.
<Variable Connexion>.OuvreConnexionOuvre une connexion à une base de données spécifique.
<Variable Connexion>.RafraîchitVueDemande le recalcul du contenu d'une vue matérialisée.
<Variable Connexion>.RégénèreFichierRégénère un fichier de données à partir de son journal.
<Variable Connexion>.TransactionDémarre une transaction sur les fichiers de données (HFSQL ou accédés via Accès Natif) et crée le fichier des transactions.
<Variable Connexion>.TransactionAnnuleSi une transaction est en cours, annule toutes les opérations effectuées sur les fichiers de données en transactions depuis le début de la transaction.
<Variable Connexion>.TransactionDébutDémarre une transaction sur les fichiers de données (HFSQL ou accédés via Accès Natif) et crée le fichier des transactions.
<Variable Connexion>.TransactionFinValide la transaction en cours :
  • les modifications effectuées sur le fichier de données depuis le début de la transaction (fonction <Variable Connexion>.TransactionDébut) sont validées.
  • le fichier de transaction est supprimé (si la transaction est la dernière transaction en cours dans le cas d'une application réseau)
  • les enregistrements bloqués en lecture par la transaction sont débloqués.
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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