DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Conditions d'utilisation
  • Changements de nom multiples
  • Changement de répertoire ou de lecteur
  • Fonction HChangeNom : Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB
  • 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
HChangeNom (Fonction)
En anglais : HChangeName
ODBCNon disponible avec ce type de connexion
Modifie le nom physique d'un fichier de données.
Rappel : Par défaut, le fichier physique est créé avec le nom qui lui a été donné dans l'analyse.
Exemple
// Création du fichier de statistiques de janvier
HChangeNom(Stat, "StatistiquesJanvier")
HCréation(Stat)
Syntaxe
<Résultat> = HChangeNom(<Fichier de données> , <Nom physique>)
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données (défini dans l'analyse). Ce nom est utilisé dans toutes les fonctions de manipulation des fichiers de données HFSQL.
<Nom physique> : Chaîne de caractères
Nouveau nom physique du fichier de données.
  • Si ce paramètre est une chaîne vide (""), le nom physique utilisé correspondra au nom physique défini dans l'analyse.
  • Ce paramètre ne doit contenir ni nom de lecteur, ni nom de répertoires.
  • Ce nom sera conservé à la fermeture du fichier de données.
  • La propriété NomPhysique permet de connaître le nom physique donné au fichier de données par la fonction HChangeNom.
OLE DBConnecteurs Natifs (Accès Natifs) Selon la base de données utilisée, le nom physique du fichier de données peut être préfixé par le nom de la base de données ou le nom de l'utilisateur, ou le nom du schéma. Dans ce cas :
  • le nom physique complet est indiqué dans la description du fichier de données sous l'éditeur d'analyses (option "Nom de la table dans la base de données externe").
  • la fonction HChangeNom permet également de changer le nom physique du fichier de données. Consultez également le paragraphe Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB.
Remarques

Conditions d'utilisation

  • Le fichier de données doit être fermé pour que cette modification soit prise en compte (utilisez la fonction HFerme si nécessaire), sinon la modification sera prise en compte lors de la prochaine ouverture.
  • Connecteurs Natifs (Accès Natifs) XML : La fonction HChangeNom modifie le nom du TAG XML associé au fichier de données décrit dans l'analyse (ne change donc pas le nom physique du fichier). Pour changer le nom du fichier, il est nécessaire d'utiliser une connexion (fonction HDécritConnexion en spécifiant le nom du fichier XML comme source de données), puis d'associer cette connexion au fichier avec la fonction HChangeConnexion.

Changements de nom multiples

La fonction HChangeNom peut être appelée plusieurs fois avec des paramètres différents. Lorsque le nom physique est redéfini plusieurs fois pour un même nom logique de fichier de données, le dernier nom physique donné remplace tous les autres.

Changement de répertoire ou de lecteur

La fonction HChangeNom permet uniquement de changer le nom du fichier physique. Pour modifier son emplacement, utilisez les fonctions HChangeRep et HSubstRep.
Etats et RequêtesOLE DBConnecteurs Natifs (Accès Natifs)

Fonction HChangeNom : Utilisation avec les Connecteurs Natifs et/ou le provider OLE DB

Par défaut, le nom logique fourni à la fonction HChangeNom est considéré comme étant le seul nom de la table. Il est encapsulé en utilisant les caractères d'encapsulation correspondant à la base ou spécifiés par le provider OLE DB avant d'être envoyé à la base (ce qui permet de gérer des noms de table contenant des caractères spéciaux).
Pour fournir un nom de fichier composé de <nom du user>.<nom de la table> (ou suivant la base de données <nom du schéma>.<nom de la table>) dans la fonction HChangeNom, il est nécessaire de fournir ces noms déjà formatés (en utilisant les caractères d'encapsulation correspondant à la base de données ou spécifiés par le provider OLE DB).
Exemple pour SQLServer :
Les caractères d'encapsulation sont " ".
Pour changer le nom CLIENT en DBO.CLIENT avec la fonction HChangeNom, il est nécessaire de passer la chaîne "DBO"."CLIENT".
Il faut donc utiliser le code suivant :
HChangeNom(CLIENT, """DBO"".""CLIENT""")

Divers

  • Si la gestion du ".REP" est branchée (fonction HGèreREP), la modification de nom est enregistrée dans le fichier ".REP" (voir gestion du .REP).
  • La fonction HChangeNom est équivalente à la fonction HSubstNom disponible dans WINDEV 5.5/WEBDEV 1.5.
Composante : wd290hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
"Changements de nom multiples" Attention!
Quand le HChangeNom intervient dans une boucle, je n'ai pas constaté ce fonctionnement.
Seul le premier nom physique était conservé.
J'ai dû ajouter un HFerme() avant la boucle suivante pour que le nouveau nom physique soit pris en compte.
Toucau
26 juin 2020

Dernière modification : 25/05/2022

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