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.
<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é.
Nouveauté SaaS
<Source>.ImporteCSV
Importe un fichier CSV 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>.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 de données (d'une requête ou d'une vue) reconnu par le moteur HFSQL.
<Source>.ListeClésSpatialesRenvoie 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>.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").
<Source>.RequêteExécutéePermet 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.
<Source>.SourceDeDonnéesConnuePermet 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