PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


  • Conseils d'utilisation
  • hCompatible : conditions permettant de considérer les structures comme incompatibles
  • Limitation
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HVérifieStructure (Fonction)
En anglais : HCheckStructure
HFSQLHFSQL 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.
Versions 16 et supérieures
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
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.
Nouveauté 16
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
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.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
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.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Android Cette fonction est désormais disponible pour les applications Android (pour les fichiers de données HFSQL).
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Exemple
// Autorise l'ouverture du fichier "Client"
// Même si les structures sont différentes
HVérifieStructure(Client, hSansContrôle)
Syntaxe
<Résultat> = HVérifieStructure([<Nom du fichier>,] <Mode de gestion>)
<Résultat> : Constante de type Entier
Ancien mode de gestion de la description (avant utilisation de la fonction HVérifieStructure).
<Nom du fichier> : Chaîne de caractères optionnelle (avec ou sans guillemets)
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 :
hSansContrôleAucune vérification n'est effectuée, les descriptions de l'analyse et du fichier physique peuvent être différentes.
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
(valeur par défaut)
Les structures doivent être strictement identiques.
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é

Limitation

Cette fonction n'est pas disponible lors de l'utilisation d'une base de données via Accès Distant.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire