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.
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.
<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.
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
- 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.
- Cette fonction n'est pas utilisable lors d'un accès distant. Pour plus de détails sur l'accès distant, consultez RPC sur HFSQL (Accès distant).
- Le nombre de substitutions est illimité.
Classification Métier / UI : Code métier