DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL
  • Présentation
  • .REP ou liste des fichiers ?
  • A quoi sert le fichier .REP ?
  • Exemple : Mise à jour d'une application avec modification de l'analyse
  • Manipuler le fichier .REP par programmation
  • Gestion du fichier .REP ou de la liste des fichiers de données
  • Création et modification du fichier .REP (ou de la liste des fichiers de données)
  • Lecture du fichier .REP
  • Écriture dans le fichier
  • Structure du fichier .REP
  • Structure du fichier .REP
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
Le fichier .REP
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Présentation
Le fichier .REP permet de conserver la liste des fichiers de données manipulés par l'application.
Ce fichier .REP peut être manipulé par programmation grâce aux fonctions du WLangage.
.REP ou liste des fichiers ?
Le fichier <MonProjet>.REP est un fichier contenant la liste des fichiers manipulés par l'application (identifiant, nom logique et chemin complet du fichier physique).
Le GUID de l'analyse est l'identifiant unique de l'analyse liée au projet, contenant la description des fichiers. Cet identifiant peut être connu sous l'éditeur d'analyses, dans la description de l'analyse (onglet "Options").
Le GUID du fichier correspond à l'identifiant du fichier logique. Cet identifiant peut être connu sous l'éditeur d'analyses, dans la description du fichier (onglet "Notes").
Ce fichier est automatiquement créé dans le répertoire de l'application et renseigné par le moteur HFSQL.
A quoi sert le fichier .REP ?
Le fichier ".REP" permet de localiser facilement les fichiers de données qui ont été utilisés par l'application WINDEV ou WINDEV Mobile.
L'application WINDEV met à jour automatiquement le fichier ".REP", mais ne se sert pas (ou rarement) du fichier ".REP".
Ce fichier est utilisé par tous les outils devant manipuler les fichiers de données de l'application, et principalement par la mise à jour automatique des fichiers de données, etc.

Exemple : Mise à jour d'une application avec modification de l'analyse

Lors de la mise à jour d'une application WINDEV, la modification automatique des fichiers de données est automatiquement lancée en cas de modifications sur la structure de la base de données.
Cette procédure utilise le fichier ".REP" pour retrouver les fichiers physiques utilisés par l'application afin de les modifier.
Pour plus de détails, consultez : La modification automatique des fichiers de données
Manipuler le fichier .REP par programmation

Gestion du fichier .REP ou de la liste des fichiers de données

HGèreREPActive ou désactive la gestion du fichier .REP

Lors de l'activation de la gestion du .REP, il est possible de donner le nom et le chemin du fichier .REP. Un fichier HFREP.INI sera alors créé dans le répertoire des données communes de l'application (répertoire \Application Data\PC SOFT). Par défaut, la gestion du fichier ".REP" est activée.

Création et modification du fichier .REP (ou de la liste des fichiers de données)

HCréationCrée un fichier de données physique. Cette fonction renseigne le fichier .REP si la gestion du .REP est activée.
HCréationSiInexistantCrée un fichier de données physique s'il n'existe pas déjà.

Cette fonction renseigne le fichier .REP si la gestion du .REP est activée et si la constante hOuvertureDifférée n'est pas utilisée. Si la constante hOuvertureDifférée est utilisée, le .REP sera mis à jour lors de l'ouverture automatique du fichier lors du premier accès au fichier.
HOuvreOuvre un fichier de données physique et renseigne le fichier .REP si nécessaire

Remarque : Les informations données par les fonctions HChangeRep, HSubstRep et HChangeNom sont prises en compte lors de la création et de la mise à jour du fichier ".REP".

Lecture du fichier .REP

HListeREPListe les différents fichiers et leur chemin physique associé présents dans le fichier .REP

Écriture dans le fichier

Pour écrire dans le fichier .REP, il suffit d'utiliser les fonctions de gestion de fichiers externes :
  • fOuvre : pour ouvrir le fichier
  • fEcritLigne : pour écrire une nouvelle ligne dans le fichier
  • fFerme : pour fermer le fichier
La structure de la ligne ajoutée doit suivre la norme suivante :
LOCALIZATION=GUID FichierTabulationNom logique fichierTabulationChemin du fichier physique
LOCALISATION_CS=GUID FichierTabulationNom logique du fichierTabulationLocalisation physique du fichier dans le serveur HFSQLTabulation
NomServeur:PortTabulationIPServeur:PortTabulationBase de données
Dans une application en Unicode, LOCALISATION_CS est remplacé par LOCALISATION_CS_UTF8 : les différentes chaînes sont encodées en UTF8.
Le GUID du fichier correspond à l'identifiant du fichier de données logique. Cet identifiant peut être connu sous l'éditeur d'analyses, dans la description du fichier de données (onglet "Notes").
Deux propriétés du WLangage permettent de connaître le GUID d'un fichier de données et de l'analyse qui l'a créé :
GUIDAnalyseRenvoie le GUID de l'analyse qui a permis de créer le fichier de données.
GUIDFichierRenvoie le GUID du fichier défini dans l'analyse qui a permis de créer le fichier de données.
Structure du fichier .REP

Structure du fichier .REP

La structure du fichier .REP est la suivante :
  • La première ligne comprend les informations concernant l'analyse dans laquelle les fichiers de données ont été décrits. Cette analyse correspond à l'analyse du projet en cours.
    La structure de cette ligne est la suivante :
    ANALYSISGUID=GUID Analyse

    Le GUID de l'analyse est l'identifiant unique de l'analyse liée au projet, contenant la description des fichiers de données. Cet identifiant peut être connu sous l'éditeur d'analyses, dans la description de l'analyse (onglet "Options").
  • Les lignes suivantes décrivent les différents fichiers de données manipulés par l'application. Une ligne est créée par fichier de données physique manipulé. Cette ligne comprend les informations suivantes :
    LOCALIZATION=GUID FichierTabulationNom logique fichier de donnéesTabulationChemin du fichier de données physique

    Le GUID du fichier correspond à l'identifiant du fichier logique. Cet identifiant peut être connu sous l'éditeur d'analyses, dans la description du fichier de données (onglet "Notes").
Exemple de fichier .REP :
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/06/2023

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