PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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 WatchCatalystUniversal Windows 10 AppWindows Mobile
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.
Versions 17 et supérieures
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone et iPad.
Nouveauté 17
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone et iPad.
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone et iPad.
Versions 18 et supérieures
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Nouveauté 18
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Exemple
UnFichier est une Description de Fichier
MonFichier1, MonFichier2 sont des Descriptions de Fichier
// Description du fichier de données"CLIENT"
UnFichier..Nom = "CLIENT"
UnFichier..Type = hFichierNormal
UnFichier..CryptageFic = hCryptageStandard
 
// Description des rubriques du fichier
...
 
// Validation de la description du fichier "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.
Versions 23 et supérieures
Inaltérable
Nouveauté 23
Inaltérable
Inaltérable
Mode 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).
NullSupportéMode de gestion de la valeur NULL.
Versions 19 et supérieures
RepeatableReadSupporté
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