DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Substitutions de répertoire multiples
  • Substitution de répertoire
  • Divers
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
HSubstRep (Fonction)
En anglais : HSubstDir
OLE DBHFSQL ClassicDisponible uniquement avec ces types de connexion
Associe le répertoire des données spécifié dans l'analyse à un répertoire présent sur le disque. Après l'exécution de la fonction HSubstRep, tous les fichiers de données associés au répertoire spécifié dans l'analyse seront manipulés dans le répertoire indiqué.
Attention : Les fichiers de données doivent être préalablement fermés (fonction HFerme).
Pour modifier le chemin d'un seul fichier de données, utilisez la fonction HChangeRep.
Remarque : En mode Client/Serveur, utilisez la fonction HChangeRep.
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)AjaxHFSQL ClassicHyper File 5.5OLE DB
// Changement de répertoire pour les fichiers définis dans
// un répertoire spécifique dans l'analyse
HSubstRep("C:\Fichier", "D:\Fichier")
// Ouverture/création des fichiers dans le nouveau répertoire
HCréationSiInexistant("*")
WINDEVWEBDEV - Code ServeurEtats et RequêtesCode Utilisateur (MCU)AjaxHFSQL Classic
SI HSubstRep(".","C:\COMPTA\ANNEE2012") = Vrai ALORS
	Info("Vous allez travailler sur les fichiers présents dans le répertoire : C:\COMPTA\ANNEE2012")
SINON
	Erreur(HErreur)
FIN
Syntaxe
<Résultat> = HSubstRep(<Répertoire des fichiers spécifié dans l'analyse> , <Répertoire physique des fichiers sur le disque>)
<Résultat> : Booléen
Ce paramètre est toujours égal à Vrai. En cas d'erreur, la prochaine fonction d'accès au fichier de données utilisée renverra Faux. Par exemple, si le répertoire physique indiqué n'existe pas, une erreur de répertoire apparaîtra lors du premier accès au fichier de données.
<Répertoire des fichiers spécifié dans l'analyse> : Chaîne de caractères
Nom du répertoire donné lors de la description du fichier de données.
WINDEVWEBDEV - Code Serveur Si ce paramètre est égal à "?" ou ".", le répertoire courant de l'application est pris en compte (répertoire retourné par la fonction fRepEnCours).
<Répertoire physique des fichiers sur le disque> : Chaîne de caractères
Nouveau nom du répertoire (260 caractères maximum). Un chemin de type UNC peut être utilisé.
Si le répertoire spécifié contient des fichiers de données non HFSQL, la fonction HSubstRep est ignorée.
WINDEVWEBDEV - Code Serveur Si ce paramètre correspond à :
  • une chaîne vide ("") : la substitution est annulée : le répertoire des données décrit dans l'analyse est pris en compte.
  • "?" ou "." : le répertoire physique des données correspond au répertoire en cours.
Remarques

Substitutions de répertoire multiples

La fonction HSubstRep peut être appelée plusieurs fois avec des paramètres différents. Lorsque le répertoire physique est redéfini plusieurs fois pour un même répertoire logique (décrit dans l'analyse), le dernier répertoire physique spécifié remplace tous les autres.

Substitution de répertoire

La fonction HChangeRep permet d'associer un répertoire à un fichier de données. Pour substituer un répertoire par un autre, utilisez la fonction HSubstRep.
Attention : la substitution de répertoire effectuée par HSubstRep s'applique sur le répertoire définit par la fonction HChangeRep. Par exemple :
HSubstRep("C:\Statistiques\Janvier", "C:\Nouveau\StatJanv")
HChangeRep(Stat, "C:\Statistiques\Janvier")
HCréation(Stat) //Fichier créé sous C:\Nouveau\StatJanv

Divers

  • Si la gestion du ".REP" est branchée (fonction HGèreRep), la modification du chemin est enregistrée dans le fichier ".REP" (voir gestion du .REP).
  • La fermeture du fichier de données conserve le nouveau chemin.
  • Le nombre de substitutions est illimité.
Classification Métier / UI : Code métier
Composante : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/06/2024

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