DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Conseils d'utilisation
  • hCompatible : conditions permettant de considérer les structures comme incompatibles
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
HVérifieStructure (Fonction)
En anglais : HCheckStructure
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Fixe le mode de comparaison des fichiers de données. Cette comparaison est effectuée lors de l'ouverture des fichiers de données.
Sont comparées :
  • la structure du fichier de données HFSQL décrit dans l'analyse,
  • la structure réelle du fichier de données physique HFSQL.
Par défaut, ces deux structures doivent être strictement identiques pour pouvoir manipuler le fichier de données.
Selon le mode choisi, une erreur WLangage peut apparaître en cas de structures incompatibles. Il est alors nécessaire d'appliquer la modification automatique des fichiers de données.
Remarque : La description utilisée par l'application correspond toujours à la description du fichier physique HFSQL.
Java Cette fonction est disponible uniquement pour les fichiers de données HFSQL. Elle n'est pas disponible pour les fichiers de données accédés par JDBC.
Exemple
// Autorise l'ouverture du fichier de données "Client"
// Même si les structures sont différentes
HVérifieStructure(Client, hSansContrôle)
Syntaxe
<Résultat> = HVérifieStructure([<Fichier de données>, ] <Mode de gestion>)
<Résultat> : Constante de type Entier
Ancien mode de gestion de la description (avant utilisation de la fonction HVérifieStructure).
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données manipulé.
Si ce paramètre n'est pas spécifié ou correspond à "*", la gestion des descriptions est prise en compte pour tous les fichiers de données de l'analyse.
<Mode de gestion> : Constante de type Entier
Mode de gestion voulu :
hCompatible
(valeur par défaut)
Les structures des fichiers de données doivent être compatibles. Si une des manipulations suivantes est réalisée, les structures sont considérées comme incompatibles :
  • Ajout d'une rubrique clé unique (sauf identifiant automatique).
  • Passage d'une clé avec doublon en clé unique.
  • Suppression ou renommage d'une rubrique.
  • Changement de type d'une rubrique (sauf transformation de texte en texte Unicode).
  • Diminution de la taille d'une rubrique.
  • Diminution de la partie entière ou décimal d'une rubrique de type Numérique.
  • Une rubrique devient non clé.
  • Suppression d'un index full-text.
  • Ajout ou suppression de rubriques dans un index full-text (par contre, la création d'une nouvelle rubrique full-text est compatible).
hIdentique
Les structures doivent être strictement identiques.
hSansContrôleAucune vérification n'est effectuée, les descriptions de l'analyse et du fichier physique peuvent être différentes.
Remarques

Conseils d'utilisation

La fonction HVérifieStructure doit être utilisée :
  • de préférence avant l'ouverture de la connexion pour éviter les appels au serveur.
  • avant l'ouverture des fichiers de données.

hCompatible : conditions permettant de considérer les structures comme incompatibles

Si une des différences suivantes existe entre la description du fichier de données présente dans l'analyse et la description du fichier de données enregistrée dans le fichier physique, les structures sont considérées par le moteur HFSQL comme incompatibles : une modification automatique est nécessaire.
Structure dans l'analyseStructure lue dans le fichier de données physiqueConséquence possible
- identifiant automatique
ou bien
- clé avec doublons
ou bien
- rubrique non clé
Clé unique et non identifiant automatiqueRisque d'apparition d'une erreur de doublons lors d'un ajout d'un enregistrement.
Remarque : Si seules des lectures sont réalisées sur le fichier de données, aucun problème n'apparaîtra.
Utilisation de la rubrique "XXX"La rubrique "XXX" n'existe pasAjout d'une valeur pour une rubrique inexistante dans le fichier physique.
La rubrique "XXX" a été renommée.
Type de la rubrique différent
Mauvaise conversion lors de l'affectation de la valeur à la rubrique.
Valeur affectée à la rubrique tronquée.
Changement de fonctionnement :
  • Recherche possible uniquement à l'identique
  • Parcours effectué sur le numéro d'enregistrement
Taille de la rubrique différente
Rubrique cléRubrique non clé
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/07/2023

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