DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Types de variables HFSQL
  • Propriétés WLangage utilisables sur une connexion décrite par programmation
  • Connecteur Natif Oracle : gestion de l'authentification externe
  • Équivalences de code : Description d'une connexion
  • Équivalences de code : Ouverture d'une connexion
  • Équivalence de code : Affecter une connexion
  • Équivalence de code : Modifier une connexion existante
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 type Connexion permet de décrire par programmation une ou plusieurs connexions à des bases de données externes (HFSQL Client/Serveur, Connecteur Natif, ...). Cette connexion pourra être ouverte grâce à la fonction HOuvreConnexion. Les caractéristiques de cette connexion peuvent être modifiées à l'aide de différentes propriétés WLangage.
La variable de type Connexion permet aussi bien de :
  • décrire une nouvelle connexion (équivalent à la fonction HDécritConnexion).
  • créer une connexion (qui sera ouverte grâce à la fonction HOuvreConnexion).
  • modifier une connexion existante.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
MaConnexion est une Connexion
 
// Description de la connexion
MaConnexion.Utilisateur = "USER"
MaConnexion.MotDePasse = "PASSWORD"
MaConnexion.Serveur = "MONSERVEUR"
MaConnexion.BaseDeDonnées = "Base de données"
MaConnexion.Provider = hAccèsHFClientServeur
MaConnexion.Accès = hOLectureEcriture
MaConnexion.InfosEtendues = "Infos étendues"
MaConnexion.OptionsCurseur = hCurseurClient
 
// Ouverture de la connexion
HOuvreConnexion(MaConnexion)
 
// Affectation de la connexion à tous les fichiers de données
HChangeConnexion("*", MaConnexion)
Remarques

Propriétés WLangage utilisables sur une connexion décrite par programmation

Les propriétés spécifiques aux connexions sont détaillées dans le tableau suivant :
Remarque : Les propriétés Provider et Serveur, ou Provider et Source doivent obligatoirement être initialisées lors de la description d'une connexion.
Nom de la propriétéEffet
AccèsPermet de gérer le type d'accès d'une connexion (HFSQL Client/Serveur, OLE DB, ...) : Lecture, Lecture/Ecriture
ActiveDirectoryPermet de gérer la connexion via Active Directory.
BaseDeDonnéesPermet de gérer le nom de la base de données associée à une connexion (HFSQL Client/Serveur, OLE DB, ...).
Dans le cas d'une base de données découpée en schémas, le nom du schéma dans la base de données sera précisé par la fonction HChangeNom.
CompressionPermet de gérer la compression des données transmises par la connexion.
CryptagePermet de gérer le type de cryptage de la communication entre les postes Client et le poste Serveur HFSQL.
InfosEtenduesPermet de gérer les informations supplémentaires d'une connexion.
LibelléPermet de connaître et de modifier le libellé d'une connexion.
MotDePassePermet de modifier le mot de passe associé à un utilisateur d'une connexion.
NomPermet de connaître le nom de la connexion
OptionsCurseurPermet de gérer les différents types de curseurs utilisés par la connexion.
ProviderPermet de gérer le type de données manipulées par la connexion.
ServeurPermet de gérer le nom du serveur utilisé dans la connexion. Cette propriété est identique à la propriété Source. Cette propriété est plutôt utilisée pour les connexions HFSQL Client/Serveur ou les Accès Natifs sur les serveurs.
HFSQL Client/Serveur Il est possible d'indiquer une adresse IPv6 en écrivant l'adresse IPv6 entre des crochets. Dans ce cas, le numéro de port doit être indiqué après le crochet fermant. Par exemple : [0154:2145:2155::5554]:4900.
SourcePermet de gérer le nom de la source de données utilisée dans la connexion. Cette propriété est identique à la propriété Serveur. Cette propriété est plutôt utilisée pour une connexion sur MS Access ou sur un fichier xBase.
TailleCachePermet de gérer la taille du cache
UtilisateurPermet de gérer l'utilisateur de la connexion
Connecteurs Natifs (Accès Natifs)

Connecteur Natif Oracle : gestion de l'authentification externe

Pour se connecter via une authentification externe :
  • la propriété Utilisateur doit correspondre à "/" (slash)
  • la propriété MotDePasse doit correspondre à "" (chaîne vide)
Remarque : L'authentification externe consiste à se baser sur le nom de l'utilisateur Windows et son mot de passe pour se connecter à la base de données. L'authentification externe nécessite un paramétrage du serveur. Reportez-vous à la documentation de Oracle pour savoir comment autoriser les authentifications externes sur le serveur.

Équivalences de code : Description d'une connexion

Code utilisant la fonction HDécritConnexion :
HDécritConnexion("MaConnexion", "USER", "PASSWORD", "SERVEURTEST", ...
"Base de données", hAccèsHFClientServeur, hOLectureEcriture, ...
"Infos étendues", hCurseurClient)
Code utilisant la connexion :
MaConnexion est une Connexion
// Description de la connexion
MaConnexion.Utilisateur = "USER"
MaConnexion.MotDePasse = "PASSWORD"
MaConnexion.Serveur = "SERVEURTEST"
MaConnexion.BaseDeDonnées = "Base de données"
MaConnexion.Provider = hAccèsHFClientServeur
MaConnexion.Accès = hOLectureEcriture
MaConnexion.InfosEtendues = "Infos étendues"
MaConnexion.OptionsCurseur = hCurseurClient

Équivalences de code : Ouverture d'une connexion

Code utilisant la fonction HOuvreConnexion :
HOuvreConnexion("MaConnexion", "USER", "PASSWORD", "SERVEURTEST", ...
"Base de données", hAccèsHFClientServeur, hOLectureEcriture, ...
"Infos étendues", hCurseurClient)
Code utilisant la connexion :
MaConnexion est une Connexion
// Description de la connexion
MaConnexion.Utilisateur = "USER"
MaConnexion.MotDePasse = "PASSWORD"
MaConnexion.Serveur = "SERVEURTEST"
MaConnexion.BaseDeDonnées = "Base de données"
MaConnexion.Provider = hAccèsHFClientServeur
MaConnexion.Accès = hOLectureEcriture
MaConnexion.InfosEtendues = "Infos étendues"
MaConnexion.OptionsCurseur = hCurseurClient
HOuvreConnexion(MaConnexion)

Équivalence de code : Affecter une connexion

Code utilisant la fonction HChangeConnexion :
HChangeConnexion(CLIENT, MaConnexion)
Code utilisant la connexion :
CLIENT.Connexion = MaConnexion

Équivalence de code : Modifier une connexion existante

Code utilisant la fonction HDécritConnexion :
HDécritConnexion(MaConnexion, "USER2", "PASSWORD2", MaConnexion.CxBaseDeDonnées, ...
MaConnexion.CxInitialCatalog, ...
MaConnexion.CxProviderOLEDB, MaConnexion.CxAccès, ...
MaConnexion.CxInfosEtendues, MaConnexion.CxOptionsCurseur)
Code utilisant la connexion :
// Modifie le login et le mot de passe pour la connexion
MaConnexion.Utilisateur = "USER2"
MaConnexion.MotDePasse = "PASSWORD2"
Version minimum requise
  • Version 10
Documentation également disponible pour…
Commentaires
Nom Serveur
Si la connexion ne fonctionnement avec le nom du serveur, il faut indiquer l'adresse IP de celui-ci.
Denis >TRIQUENEAUX
22 juil. 2019
fonctionne sur Android
Fonctionne aussi pour Android d'après l'exemple de la page
http://doc.pcsoft.fr/fr-FR/?3044282&name=HCopieFichier
Lionel PERRET
28 fév. 2015
ATTENTION : Passage des paramètres d'une connexion à une autre !
CNX_SERVEUR est la connexion principale, vous souhaitez recopier les paramètres de cette connexion vers une autre connexion appelée CNX_cible :

CNX_cible est une Connexion=CNX_SERVEUR

Si vous changer CNX_cible..Serveur les informations dans CNX_SERVEUR..serveur seront AUSSI modifiées.

Pour éviter cela vous devez affecter chaque membre de la structure comme suit :

CNX_cible..Utilisateur=CNX_SERVEUR..Utilisateur
CNX_cible..MotDePasse="Mot de passe"
CNX_cible..Serveur=CNX_SERVEUR..Serveur
CNX_cible..BaseDeDonnées = CNX_SERVEUR..BaseDeDonnées
CNX_cible..Provider = CNX_SERVEUR..Provider
CNX_cible..Accès = CNX_SERVEUR..Accès
CNX_cible..OptionsCurseur = CNX_SERVEUR..OptionsCurseur
CNX_cible..Source=CNX_SERVEUR..Serveur
CNX_cible..Compression=CNX_SERVEUR..Compression
CNX_cible..Cryptage=CNX_SERVEUR..Cryptage
Olivier BLAIS
06 sep. 2014

Dernière modification : 03/02/2023

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