DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Caractéristiques de la table créée
  • Les différents fichiers créés
  • Gestion du mot de passe
  • Gestion des erreurs fatales lors de la création d'une table
  • Gestion des alphabets non latins
  • Réplication : Plage d'identifiants
  • Priorité pour la définition de l'emplacement des fichiers du journal
  • Création d'une table existante
  • Contraintes d'intégrités référentielles
  • OLE DB Oracle : Création d'une table contenant un mémo binaire
  • OLE DB : Création d'une table contenant des identifiants automatiques
  • Gestion des index
  • Création de la table à partir de sa description dans l'éditeur de schémas des données
  • Rubriques DATE et HEURE avec le Connecteur Natif SQL Server
  • Fonction HCrée et Connecteur Natif SQLite
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Crée à vide une table (fichier d'extension ".FIC") avec le fichier d'index, le fichier d'index full-text, le fichier d'index spatial, le fichier d'index sémantique et le fichier mémo si nécessaire.
Cette fonction permet également de supprimer tous les enregistrements d'une table. Dans ce cas, l'enregistrement en mémoire n'est pas annulé. Pour l'initialiser, utilisez la fonction HRAZ.
Remarque : Il est possible d'activer la création automatique des tables inexistantes lors de la description du projet (onglet "Tables" de la description du projet, option "Créer les tables automatiquement au moment de leur ouverture"). La fonction HCrée est automatiquement utilisée si la table n'existe pas lors de sa première manipulation.
WINDEVWEBDEV - Code ServeurHFSQL Classic Si la table est journalée, il est possible de préciser l'emplacement des tables journaux.
HFSQL Client/Serveur Si des contraintes d'intégrité ont été définies et si elles sont gérées, les liaisons sont mises à jour sur le serveur.
// Création de la table Commande (décrit dans le schéma des données)
HCrée(Commande)
Syntaxe
<Résultat> = HCrée(<Table> [, <Mot de passe> [, <Chemin du fichier JNL> [, <Chemin du fichier JournalOperation> [, <Options>]]]])
<Résultat> : Booléen
  • Vrai si la table a été créée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. En cas d'erreur fatale, un traitement spécifique est nécessaire pour continuer le programme et vérifier si la table a été créée (voir Notes).
<Table> : Chaîne de caractères
Nom de la table à créer.
Connecteurs Natifs (Accès Natifs) MySQL : le nom de la table ne doit pas contenir d'accent (Exemple : "FichierAccentué"). Ceci est un problème interne à MySQL (testé sur les versions 3.23.52-max-nt et 3.23.47-max-nt du serveur MySQL).
<Mot de passe> : Chaîne de caractères optionnelle ou Chaîne secrète
  • Mot de passe associé à la table.
    HFSQL ClassicHFSQL Client/Serveur Le mot de passe des tables HFSQL est insensible à la casse.
  • Chaîne vide ("") si aucun mot de passe n'est utilisé.
    Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode".
    Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes.
<Chemin du fichier JNL> : Chaîne de caractères optionnelle
Chemin d'accès au fichier JNL associé à la table journalée. Ce paramètre est pris en compte uniquement si la table est journalée. Dans ce cas, le fichier <Nom du fichier>JNL.fic sera créé à l'emplacement spécifié.
HFSQL Client/Serveur Ce paramètre ne doit pas être précisé. En effet, en HFSQL Client/Serveur, le chemin du fichier JNL est fixé et ne peut pas être modifié.
AndroidWidget AndroidiPhone/iPadPHP Ce paramètre est ignoré.
Java Accès par JDBC : Ce paramètre est ignoré.
<Chemin du fichier JournalOperation> : Chaîne de caractères optionnelle
Chemin d'accès de la table JournalOperation et de la table JournalIdentification associée à la table journalée. La table JournalOperation contient toutes les opérations effectuées sur la table journalée. Ce paramètre est pris en compte uniquement si la table est journalée.
HFSQL Client/Serveur Ce paramètre ne doit pas être précisé. En effet, en HFSQL Client/Serveur, le chemin du fichier des opérations est fixé et ne peut pas être modifié.
AndroidWidget AndroidiPhone/iPadPHP Ce paramètre est ignoré.
Java Accès par JDBC : Ce paramètre est ignoré.
<Options> : Constante optionnelle de type Entier
Options de création de la table :
hChangeAlphabetL'alphabet défini avec la fonction ChangeAlphabet sera pris en compte dans la nouvelle table. Les tris, recherches, ... sur des clés de type chaîne (chaînes, caractères, date et heure) seront effectués selon cet alphabet.
hSansLiaisonGestion de l'intégrité : Les liaisons ne sont pas mises à jour sur le serveur (création, modification, suppression selon le cas).
Rappel : par défaut, lors de la création d'une table, les liaisons sont mises à jour sur le serveur.
HFSQL Client/Serveur Cette constante est disponible uniquement en mode HFSQL Client/Serveur.

PHP Ce paramètre est ignoré.
Java Accès par JDBC : Ce paramètre est ignoré.
AndroidWidget Android Ce paramètre est ignoré.
Remarques
WINDEVWEBDEV - Code ServeuriPhone/iPadJavaAjaxHFSQL ClassicHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBConnecteurs Natifs (Accès Natifs)

Caractéristiques de la table créée

Les caractéristiques de la table créée sont les suivantes :
  • Nom de la table :
    Nom physique défini lors de la description de la table sous l'éditeur de schémas des données. Ce nom peut être modifié avant la création de la table grâce à la fonction HChangeNom.
  • Répertoire de la table :
    Répertoire défini lors de la description de la table sous l'éditeur de schémas des données. Ce répertoire peut être modifié avant la création de la table par les fonctions HChangeRep et HSubstRep.
  • Contenu de la table :
    La table créée est vide ce qui ne signifie pas que sa taille est nulle (la table contient un entête décrivant sa structure).
  • L'ordre des rubriques créées dans le fichier physique est l'ordre physique des rubriques créées dans le schéma des données et non l'ordre logique.
Si la table existait déjà : Si la table existait déjà (même nom, même répertoire), cette table est recréée : la table ne contient plus aucun enregistrement. Les fichiers d'index et mémo (s'ils existent) sont aussi recréés. Dans ce cas, les contraintes d'intégrité ne sont pas testées.
Attention : La re-création de la table n'est possible que si la table n'est pas utilisée par une autre application. Si une table en cours d'utilisation doit être vidée, utilisez la fonction HSupprime lors d'un parcours. Il est également possible d'utiliser la fonction HSupprimeTout pour supprimer tous les enregistrements d'une table.
WINDEVWEBDEV - Code ServeuriPhone/iPadAjaxHFSQL ClassicHFSQL Client/ServeurProcédures stockéesHyper File 5.5

Les différents fichiers créés

Lors de la création d'une table, les fichiers suivants peuvent être créés en plus de la table :
  • Un fichier d'index (d'extension ".NDX") si une ou plusieurs clés ont été définies dans la description de la table.
  • Une table d'index full-text (d'extension ".FTX") si une ou plusieurs clés "Index full-text" ont été définies dans la description de la table.
  • Nouveauté 2026
    Un fichier d'index sémantique (d'extension ".VEX") si une ou plusieurs clés de type "Index sémantique" ont été définies dans la description de la table.
  • Une table d'index spatiaux (d'extension ".SDX") si une ou plusieurs clés de type "Clé spatiale" ont été définies dans la description de la table.
  • Un fichier mémo (d'extension ".MMO") si une ou plusieurs rubriques de type mémo ont été définies dans la description de la table.
  • Un fichier journal (d'extension ".JNL). Ce fichier est créé uniquement si l'option correspondante a été sélectionnée lors de la description de la table.
    AndroidWidget AndroidiPhone/iPadPHP Ce fichier n'est pas créé.
  • Un fichier <NomProjet>.REP. Ce fichier contient la liste des tables manipulées par l'application. Ce fichier est créé (ou complété) si la gestion du .REP est active (fonction HGèreREP). Pour plus de détails sur le fichier .REP, consultez Fichier .REP.
    iPhone/iPad Ce fichier n'est pas créé.

Gestion du mot de passe

  • Le mot de passe peut être défini :
    • directement à la création de la table avec la fonction HCrée.
    • avant la création de la table grâce à la fonction HPasse.
  • Si la table existait et était protégée par mot de passe, la table est recréée, même si le mot de passe change ou n'existe plus.
Attention : Le mot de passe est indépendant du chiffrement des données. Le chiffrement des données doit être configuré lors de la description de la table dans l'éditeur de schémas des données (onglet "Détail").
PHPConnecteurs Natifs (Accès Natifs) Le mot de passe n'est pas associé à une table mais à une base de données. Ce mot de passe doit être indiqué lors de la connexion (fonction HConnecte).

Gestion des erreurs fatales lors de la création d'une table

En cas d'erreur fatale lors de la création d'une table, il peut être intéressant de continuer le programme tout en vérifiant si la table a tout de même été créée. Pour cela, il est conseillé de faire le traitement d'exception suivant :
QUAND EXCEPTION DANS
	HCrée(PERE)
FAIRE
	Erreur("Erreur HFSQL : " + HErreur())
SINON
	Trace("fichier créé")
FIN
WINDEVWEBDEV - Code ServeuriPhone/iPadAjaxHFSQL ClassicHFSQL Client/ServeurHyper File 5.5OLE DBConnecteurs Natifs (Accès Natifs)

Gestion des alphabets non latins

Si la constante hChangeAlphabet est précisée, l'alphabet utilisé dans la table sera celui précisé par la fonction ChangeAlphabet. Les tris, recherches, ... sur des clés de type chaîne (chaînes, caractères, date et heure) seront effectués selon cet alphabet.
L'alphabet utilisé pourra ensuite être modifié avec la fonction HRéindexe.
Remarque : La taille des rubriques de type chaîne spécifiée dans le schéma des données est une taille en octets et non en caractères. Selon l'alphabet utilisé, il peut être nécessaire d'augmenter la taille de la rubrique (par exemple si les caractères utilisés sont codés sur 2 octets).
Pour plus de détails sur la gestion des alphabets non latins dans les tables, consultez Gérer des alphabets spécifiques dans des tables.
WINDEVWEBDEV - Code ServeurAjaxHFSQL ClassicHFSQL Client/ServeurHyper File 5.5

Réplication : Plage d'identifiants

Les identifiants automatiques des fichiers des réplicas abonnés utilisent une plage d'identifiants différente de celle du fichier du réplica maître et des autres fichiers de réplicas abonnés.
Cette plage d'identifiants automatiques est inscrite dans l'entête de chaque table (extension ".FIC").
Cette plage est initialisée :
Pour plus de détails, consultez les conséquences de la mise en place de la réplication.
WINDEVWEBDEV - Code ServeurAjaxHFSQL ClassicHyper File 5.5

Priorité pour la définition de l'emplacement des fichiers du journal

La définition de l'emplacement des fichiers journal se fait selon l'ordre de priorité suivant :
  1. Emplacement spécifié lors de la création de la table journalée (fonction HCrée).
  2. Emplacement spécifié par la fonction HChangeRepJNL.
  3. Emplacement spécifié dans le schéma des données.
  4. Emplacement de la table journalée.
Si une autre application utilise la fonction HDéclareExterne sur une table journalée, les modifications effectuées par cette application sont enregistrées dans les fichiers journaux spécifiés dans l'entête de la table HFSQL journalée.
HFSQL Client/Serveur L'emplacement des fichiers du Journal est fixe et ne peut pas être modifié. Pour plus de détails, consultez Fichiers du journal en mode Client/Serveur.
OLE DB

Création d'une table existante

Si la table existait, la fonction HCrée tente d'effacer puis de recréer la table.
Par exemple : Utilisation d'une base de données Oracle
  • avec le provider OLE DB "MSDAORA" : la création d'une nouvelle table est impossible. Si la table existe déjà; les enregistrements sont effacés.
  • avec le provider OLE DB "oraOLEDB.Oracle" : la création d'une nouvelle table est possible ainsi que la re-création d'une table existante. Il est cependant impossible de créer des index ou des rubriques mémo.
Lors d'une création de table, WINDEV et WEBDEV tentent de créer les rubriques dans le type OLE DB correspondant au type HFSQL. Si ce type n'est pas supporté, WINDEV et WEBDEV essayent successivement tous les types OLE DB "compatibles" jusqu'à trouver un type supporté par la base OLE DB.
OLE DB

Contraintes d'intégrités référentielles

Lors de la création d'une table, les contraintes d'intégrités référentielles décrites dans le schéma des données ne sont pas créées sur la base.
OLE DB

OLE DB Oracle : Création d'une table contenant un mémo binaire

Attention : la création d'une table Oracle contenant des mémos binaires échoue sous Oracle 7.x (car les LOB ne sont pas gérés dans cette version d'Oracle).
OLE DB

OLE DB : Création d'une table contenant des identifiants automatiques

Les identifiants automatiques ne seront créés dans la table que si le provider OLE DB supporte les identifiants automatiques.
Connecteurs Natifs (Accès Natifs)

Gestion des index

Si l'ajout d'un index échoue, aucun message d'erreur n'est renvoyé par la fonction HCrée. La table est simplement créée sans l'index posant problème. Dans ce cas, il est possible de trouver des doublons dans une rubrique considérée comme clé unique par WINDEV et WEBDEV si la base de données externe ne peut pas gérer de clé unique.

Création de la table à partir de sa description dans l'éditeur de schémas des données

Il est possible de créer directement la table à vide à partir de sa description dans l'éditeur de schémas des données. Il suffit de sélectionner l'option "Créer la table" et de sélectionner le répertoire dans lequel la table doit être créée.
Connecteurs Natifs (Accès Natifs)

Rubriques DATE et HEURE avec le Connecteur Natif SQL Server

Lors de l'utilisation de la fonction HCrée, le Connecteur Natif SQLServer crée des rubriques DATE et TIME si la version du serveur et la version de la couche client correspondent au moins à SQL Server 2008.
Connecteurs Natifs (Accès Natifs)

Fonction HCrée et Connecteur Natif SQLite

La fonction HCrée peut échouer (erreur "database table is locked") si les conditions suivantes sont réunies :
  • le fichier à créer existe déjà.
  • un parcours est en cours sur un autre fichier de la même base de données.
Ceci est dû à une limitation de la base de données SQLite.
Composante: wd310hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/03/2026

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