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 fichiers de données
  • Comment décrire des fichiers de données par programmation ?
  • Manipulation des rubriques d'un fichier de données décrit par programmation
  • Journalisation
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
Une variable de type Description de Fichier permet de décrire par programmation un ou plusieurs fichiers de données. La description de chaque fichier de données est validée par la fonction HDécritFichier.
Après cette validation :
  • Ce fichier de données pourra être manipulé comme n'importe quel fichier de données décrit dans l'analyse.
  • La variable de type "Description de Fichier" est réinitialisée et pourra être utilisée pour décrire par programmation un autre fichier de données.
Exemple
UnFichier est une Description de Fichier
MonFichier1, MonFichier2 sont des Descriptions de Fichier
// Description du fichier de données "CLIENT"
UnFichier est une Description de Fichier

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

// Description des rubriques du fichier de données
...

// Validation de la description du fichier de données "CLIENT"
HDécritFichier(UnFichier)
Syntaxe

Déclarer une ou plusieurs descriptions de fichier de données 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 fichiers de données. Pour plus de détails, consultez les remarques.
Pour valider la description d'une variable de type "Description de Fichier" :
Utilisez la fonction HDécritFichier.
Remarques

Propriétés spécifiques à la description de fichiers de données

Les propriétés spécifiques à la description de fichiers de données 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'un fichier de données par programmation.
Nom de la propriétéEffet
CompressionMmoMode de compression du fichier MMO (contenant les mémo binaires et texte) associé au fichier de données
CryptageFicMode de cryptage du fichier de données
CryptageMmoMode de cryptage du fichier mémo (d'extension .MMO) associé au fichier de données
CryptageNdxMode de cryptage du fichier d'index associé au fichier de données
CxAccèsType d'accès au fichier 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 au fichier 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 le fichier 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 du fichier de données (ANSI ou Unicode).
GrosFichierTaille maximale d'un fichier de données.
InaltérableMode de gestion de l'inaltérabilité du fichier de données.
JournalisationMode de journalisation d'un fichier de données.
MotDePasseWDD55Mot de passe à utiliser pour manipuler un fichier définit par programmation au format Hyper File 5.5 dans une analyse au format WINDEV.
Nom ( * )Nom du fichier HFSQL.
Nom55Nom logique du fichier au format Hyper File 5.5 présent dans une analyse au format WINDEV.
NomDécritNom logique d'un fichier de données.
NomPhysiqueNom physique des fichiers de données.
NomPhysiqueDécritNom physique des fichiers 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 fichiers 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 fichiers 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 l'analyse.
RubriqueTexteComplétéeComplète ou non les rubriques texte par des espaces.
SécuriséNiveau de sécurité du cryptage des fichiers de données.
TypeType d'un fichier de données.
WDD55Chemin du fichier WDD au format 5.5 utilisé pour manipuler des fichiers de données au format 5.5 dans une application WINDEV.

Comment décrire des fichiers de données par programmation ?

Pour décrire des fichiers de données 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 fichier de données :
  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'un fichier de données décrit par programmation

Lors de la création d'un fichier de données sous l'éditeur d'analyses, les noms du fichier de données et de ses rubriques sont automatiquement reconnus par le compilateur.
Lors de la création d'un fichier de données à l'aide d'une variable de type "Description de Fichier", les noms du fichier de données 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 le fichier de données ou ses rubriques provoque une erreur de compilation.
Pour que le nom du fichier de données décrit par programmation soit reconnu par le compilateur, il est nécessaire de déclarer ce nom de fichier comme une source de données grâce au mot-clé source de données. Ce fichier de données pourra alors être manipulé par son nom sous l'éditeur de code.
Par exemple :
UnFichier est une Description de Fichier
...
UnFichier.Nom = "CLIENT"
...
HDécritFichier("CLIENT")
...
CLIENT est une Source de Données
...
HLitPremier(CLIENT, "NOMCLI")
Remarque : Il est également possible de déclarer le nom du fichier de données avec le mot-clé Externe. Cependant, la vitesse d'exécution du traitement sera ralentie.

Journalisation

Lors de la description du fichier de données par programmation :
  • si le fichier de données est journalé 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 le fichier de données est journalé 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 : 19/02/2024

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