PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Propriétés WLangage utilisables sur une connexion décrite par programmation
  • Accès 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Connexion (Type de variable)
En anglais : Connection (Type of variable)
HFSQLNon disponible avec ce type de connexion
Le type Connexion permet de décrire par programmation une ou plusieurs connexions à des bases de données externes (HFSQL Client/Serveur, Accès 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.
Versions 15 et supérieures
PHP Ce type de variable est désormais disponible pour les sites PHP.
Nouveauté 15
PHP Ce type de variable est désormais disponible pour les sites PHP.
PHP Ce type de variable est désormais disponible pour les sites PHP.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
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.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
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)
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
BaseDeDonnéesPermet de gérer le nom de la base de données associée à une connexion (HFSQL Client/Serveur, OLE DB, ...).
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
Versions 15 et supérieures
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.
Nouveauté 15
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.
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
Versions 18 et supérieures
WINDEVWEBDEV - Code ServeurAccès Natifs

Accès 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.
Nouveauté 18
WINDEVWEBDEV - Code ServeurAccès Natifs

Accès 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.
WINDEVWEBDEV - Code ServeurAccès Natifs

Accès 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
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
Les Propriétés d'une connexion existantes sont accessibles
Cela ne figure pas explicitement mais les propriétés d'une connexion existante peuvent être accèder :

// Retrouver la Base de données associée à une connexion
MaConnexion est une Connexion
...
sBaseDeDonnées est une Chaîne = MaConnexion..BaseDeDonnées
Jean-Pierre BLOCH (
29 mar. 2010