DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Types de variables HFSQL
  • Propriétés spécifiques à la description de tables
  • Comment décrire des tables par programmation
  • Manipulation des rubriques d'une table décrit par programmation
  • Journalisation
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Une variable de type Description de Table permet de décrire par programmation une ou plusieurs tables. La description de chaque table est validée par la fonction HDécritTable.
Après cette validation:
  • Cette table pourra être manipulée comme n'importe quelle table décrite dans le schéma des données.
  • La variable de type "Description de Table" est réinitialisée et pourra être utilisée pour décrire par programmation une autre table.
Exemple
UnFichier est une Description de Table
MonFichier1, MonFichier2 sont des Descriptions de Table
// Description de la table "CLIENT"
UnFichier est une Description de Table

UnFichier.Nom = "CLIENT"
UnFichier.Type = hTableNormale
UnFichier.CryptageFic = hCryptageStandard

// Description des rubriques de la table
...

// Validation de la description de la table "CLIENT"
HDécritTable(UneTable)
Syntaxe

Déclarer une ou plusieurs descriptions de table Masquer les détails

<Nom de la variable> est une Description de Fichier
<Nom de la variable 1>, <Nom de la variable 2> sont des Descriptions de Fichier
<Nom de la variable> :
Nom de la variable de type "Description de Fichier" à déclarer.
Remarque: Les mots-clés une et des ne sont pas obligatoires: ce sont des mots d'agrément.

Décrire une variable de type "Description de Fichier" Masquer les détails

Pour décrire une variable de type "Description de Fichier":
Utilisez les propriétés du WLangage spécifiques aux descriptions de tables. Pour plus de détails, consultez les remarques.
Pour valider la description d'une variable de type "Description de Fichier":
Utilisez la fonction HDécritTable.
Remarques

Propriétés spécifiques à la description de tables

Les propriétés spécifiques à la description de tables sont détaillées dans le tableau suivant:
Remarque: Les propriétés en gras suivies d'un astérisque ( * ) doivent obligatoirement être initialisées lors de la description d'une table par programmation.
Nom de la propriétéEffet
CompressionMmoMode de compression de la table MMO (contenant les mémo binaires et texte) associée à la table.
CryptageFicMode de cryptage de la table.
CryptageMmoMode de cryptage de la table mémo (d'extension .MMO) associée à la table.
CryptageNdxMode de cryptage de la table d'index associée à la table.
CxAccèsType d'accès à la table lors de la connexion OLE DB à une table spécifique (en tenant compte des modifications effectuées par la fonction HConnecte).
CxAccèsDécritType d'accès à la table lors de la connexion OLE DB à une table spécifique (sans tenir compte des modifications effectuées par la fonction HConnecte).
CxBaseDeDonnéesSource de données OLE DB lors de la connexion OLE DB à une table spécifique (en tenant compte des modifications effectuées par la fonction HConnecte).
CxBaseDeDonnéesDécriteSource de données OLE DB lors de la connexion OLE DB à une table spécifique (sans tenir compte des modifications effectuées par la fonction HConnecte).
CxLibelléDécritLibellé de la connexion à la source de données OLE DB.
CxMotDePasseDécritMot de passe utilisé pour ouvrir la table lors d'une connexion OLE DB.
CxProviderOLEDBNom du serveur OLE DB utilisé (en tenant compte des modifications effectuées par la fonction HConnecte).
CxProviderOLEDBDécritNom du serveur OLE DB (sans tenir compte des modifications effectuées par la fonction HConnecte).
CxUtilisateurNom de l'utilisateur lors d'une connexion OLE DB (en tenant compte des modifications effectuées par la fonction HConnecte).
CxUtilisateurDécritNom de l'utilisateur lors d'une connexion OLE DB (sans tenir compte des modifications effectuées par la fonction HConnecte).
FormatFormat des données de la table (ANSI ou Unicode).
GrosFichierTaille maximale d'une table.
InaltérableMode de gestion de l'inaltérabilité de la table.
JournalisationMode de journalisation d'une table.
MotDePasseWDD55Mot de passe à utiliser pour manipuler une table définie par programmation au format Hyper File 5.5 dans un schéma des données au format WINDEV.
Nom ( * )Nom de la table HFSQL.
Nom55Nom logique de la table au format Hyper File 5.5 présent dans un schéma des données au format WINDEV.
NomDécritNom logique d'une table.
NomPhysiqueNom physique des tables.
NomPhysiqueDécritNom physique des tables HFSQL (sans tenir compte des changements de nom réalisés grâce à la fonction HChangeNom).
NullIndexéMode de gestion de la valeur "Null" pour une rubrique clé.
NullSupportéMode de gestion de la valeur NULL.
RepeatableReadSupportéUtilisation du fichier dans une transaction HFSQL Client/Serveur ayant un mode d'isolation "Repeatable Read".
RépertoireRépertoire physique des tables HFSQL (cette propriété tient compte des changements de répertoires réalisés grâce aux fonctions HChangeRep ou HSubstRep).
RépertoireDécritRépertoire physique des tables HFSQL (cette propriété ne tient pas compte des changements de répertoires réalisés grâce aux fonctions HChangeRep ou HSubstRep).
RépertoireJournalRépertoire du fichier journal décrit dans le schéma des données.
RubriqueTexteComplétéeComplète ou non les rubriques texte par des espaces.
SécuriséNiveau de sécurité du cryptage des tables.
TypeType d'une table.
WDD55Chemin de la table WDD au format 5.5 utilisé pour manipuler des tables au format 5.5 dans une application WINDEV.

Comment décrire des tables par programmation

Pour décrire des tables par programmation, il faut:
  1. Déclarer des variables de type "Description de Fichier", "Description de Rubrique", "Description d'IndexFullText" et "Description de Liaison" (si nécessaire).
  2. Pour chaque table:
  3. Décrire si nécessaire les caractéristiques des liaisons grâce aux propriétés HFSQL.
  4. Valider si nécessaire la description de chaque liaison (fonction HDécritLiaison).

Manipulation des rubriques d'une table décrit par programmation

Lors de la création d'une table sous l'éditeur de schémas des données, les noms de la table et de ses rubriques sont automatiquement reconnus par le compilateur.
Lors de la création d'une table à l'aide d'une variable de type "Description de Table", les noms de la table et de ses rubriques sont définis grâce à la propriété Nom. Ces noms ne sont pas automatiquement reconnus par le compilateur. L'utilisation de ces noms pour désigner la table ou ses rubriques provoque une erreur de compilation.
Pour que le nom de la table décrit par programmation soit reconnu par le compilateur, il est nécessaire de déclarer ce nom de table comme une source de données grâce au mot-clé source de données. Ce table pourra alors être manipulée par son nom sous l'éditeur de code.
Par exemple:
UnFichier est une Description de Table
...
UnFichier.Nom = "CLIENT"
...
HDécritTable("CLIENT")
...
CLIENT est une Source de Données
...
HLitPremier(CLIENT, "NOMCLI")
Remarque: Il est également possible de déclarer le nom de la table avec le mot-clé Externe. Cependant, la vitesse d'exécution du traitement sera ralentie.

Journalisation

Lors de la description de la table par programmation:
  • si la table est journalée et si aucune rubrique n'est journalée, toutes les rubriques (sauf les clés composées) sont automatiquement passées en journalées.
  • si la table est journalée et si au moins une rubrique est journalée, les autres rubriques ne sont pas modifiées.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 23/01/2025

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