DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Les fonctions de gestion des tables 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'une table.
  • le contenu d'une variable de type Enregistrement dans l'enregistrement en cours d'une table.
<Source>.ActiveFiltreActive le filtre précédemment créé pour la table (la vue ou la requête) spécifiée.
<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 la table (la requête ou la vue).
  • l'enregistrement présent dans une variable de type Enregistrement dans la table (la requête ou la vue).
<Source>.AliasCrée un alias logique d'une table (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 la table, à partir de la position en cours, selon une rubrique spécifiée.
<Source>.BloqueNumEnrBloque un enregistrement et restreint l'accès à cet enregistrement pour toutes les autres applications.
<Source>.BloqueTableBloque une table et restreint l'accès à cette table pour tous les autres sites ou applications.
<Source>.ChangeCléChange la rubrique de parcours.
<Source>.ChangeConnexionChange dynamiquement la connexion associée à une table.
<Source>.ChangeLocalisationModifie le mode de recherche des tables physiques (.FIC, .NDX, ...).
<Source>.ChangeNomModifie le nom physique d'une table.
<Source>.ChangeRepModifie le chemin d'accès à une table (c'est-à-dire le répertoire dans lequel la table sera manipulée).
<Source>.ChangeRepJnlModifie l'emplacement des fichiers du journal correspondant à une table 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éeCrée à vide une table (table d'extension ".FIC") avec le fichier d'index, le fichier d'index full-text, le fichier d'index spatial et le fichier mémo si nécessaire.
<Source>.CréeSiInexistantEffectue les opérations suivantes:
  • Si la table n'existe pas, crée à vide une table (fichier d'extension ".FIC") avec la table d'index, la table d'index full-text et la table mémo si nécessaire. La fonction est équivalente à <Source>.Crée.
  • Si la table existe, ouvre la table.
<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 une table HFSQL (Classic ou Client/Serveur).
<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ébloqueTableDébloque les enregistrements d'une table:
  • précédemment bloqués avec la fonction <Source>.BloqueTable.
  • bloqués individuellement avec une fonction de lecture bloquante.
<Source>.DéclareDéclare une description de table (présente dans un schéma des données) dans le projet en cours.
<Source>.DéclareExterneImporte temporairement dans le schéma des données en cours la description d'une table à partir d'une table HFSQL existante.
<Source>.DécritTableDécrit une table par programmation.
<Source>.DécritTriggerAjoute ou modifie un trigger sur une table HFSQL.
<Source>.DernierPositionne sur le dernier enregistrement d'une table selon une rubrique de parcours.
<Source>.DésactiveFiltreDésactive temporairement un filtre sur une table (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 une table: l'enregistrement présent en mémoire est ajouté dans la table (la requête ou la vue).
<Source>.EcritÉcrit un enregistrement dans la table sans mettre à jour les index correspondants à toutes les clés utilisées dans la table.
<Source>.EnDehorsPermet de savoir si l'enregistrement sur lequel on veut se positionner est en dehors de la table, 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 une table, 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>.ExporteChaîneJSONExporte les enregistrements d'une table (HFSQL ou OLE DB), d'une vue ou d'une requête dans une chaîne au format JSON.
<Source>.ExporteCSVExporte les enregistrements d'une table (HFSQL ou OLE DB), d'une vue ou d'une requête dans un fichier CSV.
<Source>.ExporteJSONExporte les enregistrements d'une table (HFSQL ou OLE DB), d'une vue ou d'une requête dans un fichier JSON.
<Source>.ExporteXLSExporte les enregistrements d'une table (HFSQL ou OLE DB), d'une vue ou d'une requête dans un fichier Excel (XLSX).
<Source>.ExporteXMLExporte les enregistrements d'une table (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'une table HFSQL, d'une requête ou d'une vue HFSQL dans un fichier physique (sur le disque).
<Source>.FermeFerme soit une table, soit toutes les tables ouvertes par l'utilisateur en cours: toutes les tables physiques correspondantes sont fermées pour l'utilisateur en cours.
<Source>.FiltreDéfinit et active un filtre sur une table, 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 une table, 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 tables sont présentes à é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é 2025
<Source>.ImporteCSV
Importe un fichier CSV dans une table au format HFSQL Classic ou Client/Serveur (table décrite sous l'éditeur de schémas des données, ou déclarée par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou <Source>.DécritTable).
<Source>.ImporteHF55Importe un fichier Hyper File 5.5 dans un fichier au format HFSQL Classic.
<Source>.ImporteJSONImporte un fichier JSON dans une table au format HFSQL Classic (table décrite sous l'éditeur de schémas des données ou déclarée par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou <Source>.DécritTable).
<Source>.ImporteTexteImporte un fichier Texte dans une table au format HFSQL Classic ou Client/Serveur (table décrite sous l'éditeur de schémas des données, ou déclarée par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou <Source>.DécritTable).
<Source>.ImporteXLSImporte un fichier XLS dans une table au format HFSQL Classic ou Client/Serveur (table décrite sous l'éditeur de schémas des données ou déclarée par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou HDécritTable).
<Source>.ImporteXMLImporte un fichier XML dans une table au format HFSQL Classic ou Client/Serveur (table décrite sous l'éditeur de schémas des données ou déclarée par les fonctions <Source>.Déclare, <Source>.DéclareExterne ou <Source>.DécritTable).
<Source>.InfoMémoRenvoie les caractéristiques des mémo binaire et texte.
<Source>.InfoTableRenvoie les caractéristiques d'une table HFSQL Classic ou Client/Serveur.
<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 une table (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'une table (d'une requête ou d'une vue) reconnue par le moteur HFSQL.
<Source>.ListeClésSpatialesRenvoie la liste des clés spatiales d'une table (d'une requête ou d'une vue) reconnues par le moteur HFSQL.
<Source>.ListeIndexFullTextRenvoie la liste des index full-text d'une table (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 le schéma des données en cours ou dans un schéma des données 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 une table (d'une requête ou d'une vue) reconnue par le moteur HFSQL. Les tables définies par les fonctions <Source>.Déclare, <Source>.DéclareExterne et <Source>.DécritTable sont prises 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'une table 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 tables.
<Source>.ModifieModifie l'enregistrement spécifié ou l'enregistrement présent en mémoire dans la table (la requête ou la vue).
<Source>.ModifieStructurePermet de mettre à jour la structure d'une table 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 une table.
<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 la table 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 une table.
<Source>.PositionCouranteRenvoie la position approximative de l'enregistrement en cours dans la table.
<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'une table 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'une table.
<Source>.RAZInitialise:
  • une ou toutes les variables des rubriques d'une table 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 de la table 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 la table, à 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 la table, la vue, la requête, ...).
<Source>.RéindexationEnCoursAvertit si une ré-indexation est en cours sur une table HFSQL et renvoie le pourcentage de ré-indexation effectué.
<Source>.RéindexeReconstruit l'index d'une table (table 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'une table: enregistrement en cours, filtre, pointeurs de lecture.
<Source>.SécuritéActive ou désactive le mécanisme de sécurité automatique sur une ou plusieurs tables.
<Source>.SourceDeDonnéesConnuePermet de savoir si une source de données est initialisée.
<Source>.StatCalculeRéalise diverses statistiques sur les clés d'une table.
<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 de la table en fonction d'une rubrique de parcours.
<Source>.SupprimeSupprime un enregistrement d'une table (d'une requête ou d'une vue).
<Source>.SupprimeToutSupprime tous les enregistrements d'une table, 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>.TableExistePermet de savoir:
<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'une table 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 la table (fichier .FIC).
<Source>.VérifieMémoVérifie l'intégrité structurelle des mémos d'une table HFSQL.
<Source>.VérifieStructureFixe le mode de comparaison des tables.
<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>.VersTableCopie 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>.VueVersTableEnregistre les modifications réalisées dans une vue HFSQL (grâce aux fonctions <Source>.Modifie, <Source>.Supprime ou <Source>.Raye) dans la table correspondante. Cette fonction utilise l'ancien mécanisme des vues.
<Variable Connexion>.FermeConnexionFerme une connexion à une base de données.
<Variable Connexion>.GèreIntégritéActive ou désactive la gestion d'une contrainte d'intégrité sur une liaison d'une table.
<Variable Connexion>.InfoTableRenvoie les caractéristiques d'une table 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èreTableRégénère une table à partir de son journal.
<Variable Connexion>.TableExistePermet de savoir si un fichier existe, c'est-à-dire s'il a été créé physiquement (fonctions <Source>.Crée ou <Source>.CréeSiInexistant).
<Variable Connexion>.TransactionDémarre une transaction sur les tables (HFSQL ou accédées 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 tables en transactions depuis le début de la transaction.
<Variable Connexion>.TransactionDébutDémarre une transaction sur les tables (HFSQL ou accédées via Accès Natif) et crée le fichier des transactions.
<Variable Connexion>.TransactionFinValide la transaction en cours:
  • les modifications effectuées sur la table 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 : 08/12/2024

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