• Vrai si l'opération a été réalisée,
• Faux en cas de problème (par exemple, lors d'une connexion décrite par programmation, certains paramètres utilisés dans la fonction HDécritConnexion peuvent être inexacts).

La fonction HErreurInfo permet d'identifier l'erreur.

Connexion à une base de données. Cette connexion correspond :

• soit au nom de la connexion définie sous l'éditeur d'analyses,
• soit au nom de la connexion définie par la fonction HDécritConnexion. La description de la connexion doit être connue au moment de l'exécution de la fonction.
• soit au nom d'une variable de type Connexion.

• Vrai si l'opération a été réalisée,
• Faux en cas de problème. La fonction HErreurInfo permet d'identifier l'erreur. Pour affecter cette connexion à un fichier, utilisez la fonction HChangeConnexion. La description de la connexion sera détruite lors de la fermeture de la connexion.

Nom de la nouvelle connexion à définir et à ouvrir. Ce nom ne doit pas être déjà utilisé par une autre connexion (connexion définie dans l'analyse, ou définie avec la fonction HOuvreConnexion ou HDécritConnexion).

Ce paramètre correspond à la propriété ..Nom utilisée sur une variable de type Connexion.

Nom de l'utilisateur utilisé pour la base de données. Ce paramètre peut être modifié et récupéré grâce à la propriété ..Utilisateur utilisée sur une variable de type Connexion.

Mot de passe de la connexion (si ce mot de passe existe). Si aucun mot de passe n'est nécessaire, utilisez une chaîne vide ("") ou le mot-clé NULL. Ce paramètre peut être modifié grâce à la propriété ..MotDePasse utilisée sur une variable de type Connexion.

Chemin complet de la source de données. La connexion sera créée et ouverte pour cette source de données.

Ce paramètre peut être connu et modifié grâce à la propriété ..Source (ou ..Serveur) utilisée sur une variable de type Connexion.

Ce paramètre correspond au nom du serveur. Il est possible de préciser le numéro de port utilisé par le serveur HFSQL. Par défaut, le numéro de port utilisé est 4900. Si le numéro de port du serveur HFSQL est différent, utilisez la notation suivante :
<Nom du poste> : <Numéro de port>
Exemple : "NomPoste:4901".
Pour une utilisation via Internet, une gestion des ports avec Firewall est nécessaire. Pour plus de détails, consultez Gestion des ports.

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.

Accès par JDBC :

• Ce paramètre doit correspondre à l'URL de connexion à la base de données. Cet URL est spécifique à chaque driver.
• Selon le driver JDBC utilisé, il est nécessaire de spécifier le nom de la base de données dans l'URL de connexion.

Versions 18 et supérieures
Pour une connexion à une base HFSQL Client/Serveur qui se trouve sur le poste de développement depuis un émulateur Android, il faut utiliser l'adresse IP 10.0.2.2 avec le port du serveur. Exemple : "10.0.2.2:4900".
Pour une connexion à une base HFSQL Client/Serveur qui se trouve sur le réseau du poste de développement depuis un émulateur Android, il faut utiliser le nom complet du serveur avec le domaine alors qu'avec le simulateur WINDEV Mobile, le nom de la machine sans le domaine peut suffire. Exemple : "posteServeur@domaine.com:4900".

Nouveauté 18
Pour une connexion à une base HFSQL Client/Serveur qui se trouve sur le poste de développement depuis un émulateur Android, il faut utiliser l'adresse IP 10.0.2.2 avec le port du serveur. Exemple : "10.0.2.2:4900".
Pour une connexion à une base HFSQL Client/Serveur qui se trouve sur le réseau du poste de développement depuis un émulateur Android, il faut utiliser le nom complet du serveur avec le domaine alors qu'avec le simulateur WINDEV Mobile, le nom de la machine sans le domaine peut suffire. Exemple : "posteServeur@domaine.com:4900".

Pour une connexion à une base HFSQL Client/Serveur qui se trouve sur le poste de développement depuis un émulateur Android, il faut utiliser l'adresse IP 10.0.2.2 avec le port du serveur. Exemple : "10.0.2.2:4900".
Pour une connexion à une base HFSQL Client/Serveur qui se trouve sur le réseau du poste de développement depuis un émulateur Android, il faut utiliser le nom complet du serveur avec le domaine alors qu'avec le simulateur WINDEV Mobile, le nom de la machine sans le domaine peut suffire. Exemple : "posteServeur@domaine.com:4900".Pour une connexion à une base SQLite : chemin complet du fichier contenant la base de données SQLite sur le périphérique Android.
Exemple : /sdcard/bdd/MaBaseDeDonnees.db
Si le paramètre correspond à chaîne vide (""), le fichier contenant les données de la base sera créé dans le répertoire "databases" de l’application et portera le nom de l'application suivi de l'extension ".db".

Nom de la base de données à utiliser sur la source de données. Si ce paramètre n'est pas nécessaire, utilisez une chaîne vide ("").

Ce paramètre peut être connu et modifié grâce à la propriété ..BaseDeDonnées utilisée sur une variable de type Connexion.

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.

Si cette base de données n'existe pas, cette base sera automatiquement créée.

• Nom du provider OLE DB utilisé. Pour retrouver facilement la chaîne à utiliser, utilisez l'option "Connexion" de l'éditeur d'analyses (voir Notes).
  ou
• une des constantes suivantes :
  

  hAccèsHF7	Pseudo-connexion à une base de données HFSQL Classic.
  hAccèsHFClientServeur	Connecteur Natif à une base de données HFSQL Client/Serveur.
  hAccèsNatifAS400	Connecteur Natif AS/400 (module optionnel de WINDEV/WEBDEV).
  hAccèsNatifDB2	Connecteur Natif DB2 (module optionnel de WINDEV/WEBDEV).
  hAccèsNatifInformix	Connecteur Natif Informix (module optionnel de WINDEV/WEBDEV).
  Versions 20 et supérieures hAccèsNatifMariaDB Nouveauté 20 hAccèsNatifMariaDB hAccèsNatifMariaDB	Connecteur Natif MariaDB (module optionnel de WINDEV/WEBDEV).
  hAccèsNatifMySQL	Connecteur Natif MySQL (module optionnel de WINDEV/WEBDEV).
  hAccèsNatifOracle	Connecteur Natif Oracle (module optionnel de WINDEV/WEBDEV).
  hAccèsNatifOracleLite	Connecteur Natif Oracle (module optionnel de WINDEV Mobile).
  hAccèsNatifPostgreSQL	Connecteur Natif PostgreSQL (module optionnel de WINDEV/WEBDEV).
  hAccèsNatifProgress	Connecteur Natif Progress (module optionnel de WINDEV/WEBDEV).
  Versions 16 et supérieures hAccèsNatifSQLAzure Nouveauté 16 hAccèsNatifSQLAzure hAccèsNatifSQLAzure	Connecteur Natif SQL Azure (module optionnel de WINDEV/WEBDEV, fourni avec le Connecteur Natif SQL Server).
  Versions 16 et supérieures hAccèsNatifSQLite Nouveauté 16 hAccèsNatifSQLite hAccèsNatifSQLite	Connecteur Natif SQLite (fourni en standard avec WINDEV/WEBDEV).
  hAccèsNatifSQLServer	Connecteur Natif SQL Server (module optionnel de WINDEV/WEBDEV) Par défaut, l'ancien Connecteur Natif est utilisé. Pour forcer l'utilisation du nouveau Connecteur Natif SQL Serveur, utilisez la variable H.ModeSQLServer.
  hAccèsNatifSQLServerMobile	Connecteur Natif SQL Serveur Mobile (module optionnel de WINDEV Mobile).
  hAccèsNatifSybase	Connecteur Natif Sybase (module optionnel de WINDEV/WEBDEV).
  hAccèsNatifXBase	Connecteur Natif xBase (fourni en standard avec WINDEV/WEBDEV).
  hAccèsNatifXML	Connecteur Natif XML (fourni en standard avec WINDEV/WEBDEV).
  hODBC	Provider OLE DB pour ODBC (permet d'accéder à une source de données ODBC déclarée dans les sources de données ODBC de Windows).
  hOledbAccess97	Provider OLE DB pour Access 97.
  hOledbAccess2000	Provider OLE DB pour Access 2000.
  hOledbAccess2007	Provider OLE DB pour Access 2007.
  Versions 19 et supérieures hOledbAccess2010 Nouveauté 19 hOledbAccess2010 hOledbAccess2010	Provider OLE DB pour Access 2010.
  hOledbDBase5	Provider OLE DB pour DBase 5.
  hOledbExcel2007	Provider OLE DB pour Excel 2007.
  hOledbExcel2000	Provider OLE DB pour Excel 2000.
  hOledbExcel97	Provider OLE DB pour Excel 97.
  hOledbLotus4	Provider OLE DB pour Lotus 4.
  hOledbOracle	Provider OLE DB pour Oracle.
  hOledbSQLServer	Provider OLE DB pour SQL Server

  
  Les constantes disponibles sont les suivantes :

  hAccèsHF7	Pseudo-connexion à une base HFSQL Mobile.
  HAccèsHFClientServeur	Connexion à une base HFSQL Client/Serveur.
  hAccèsNatifOracle	Connecteur Natif Oracle Lite (module optionnel).
  hAccèsNatifSQLServerMobile	Connecteur Natif SQL Server Mobile (module optionnel).

  
  Les constantes disponibles sont les suivantes :

  Versions 15 et supérieures hAccèsNatifSQLite Nouveauté 15 hAccèsNatifSQLite hAccèsNatifSQLite	Connecteur Natif SQLite pour les applications Android.

  
  Les constantes disponibles sont les suivantes :

  hAccèsHF7	Pseudo-connexion à une base HFSQL
  HAccèsHFClientServeur	Connexion à une base HFSQL Client/Serveur.
  hAccèsJDBCMySQL	Accès par JDBC à une base de données MySQL.
  Versions 15 et supérieures hAccèsJDBCSQLite Nouveauté 15 hAccèsJDBCSQLite hAccèsJDBCSQLite	Accès par JDBC à une base de données SQLite.
  hAccèsJDBCSQLServer	Accès par JDBC à une base de données SQL Server.

Attention : Pour utiliser une connexion OLE DB il est nécessaire :

• d'installer le MDAC version 2.6 minimum (installation réalisée avec WINDEV/WEBDEV et lors de la création de la version Client).
• d'installer le provider OLE DB correspondant à la base de données manipulée.
  Ce paramètre peut être récupéré grâce à la propriété ..CxProviderOLEDB.

Ce paramètre peut correspondre à une des constantes suivantes :

hAccèsNatifAS400	Connecteur Natif AS/400 (module optionnel de WEBDEV).
Versions 20 et supérieures hAccèsNatifMariaDB Nouveauté 20 hAccèsNatifMariaDB hAccèsNatifMariaDB	Connecteur Natif MariaDB (module optionnel de WINDEV/WEBDEV).
hAccèsNatifMySQL	Connecteur Natif MySQL (module optionnel de WEBDEV).
Versions 15 et supérieures hAccèsNatifOracle Nouveauté 15 hAccèsNatifOracle hAccèsNatifOracle	Connecteur Natif Oracle (module optionnel de WEBDEV).
Versions 15 et supérieures hAccèsNatifPostgreSQL Nouveauté 15 hAccèsNatifPostgreSQL hAccèsNatifPostgreSQL	Connecteur Natif PostgreSQL (module optionnel de WEBDEV).

Ce paramètre peut être connu et modifié grâce à la propriété ..Provider utilisée sur une variable de type Connexion.

Paramètre le type d'accès à la base.

hOLectureEcriture (valeur par défaut)	La base de données est accessible en lecture et en écriture. Il est possible aussi bien de lire des enregistrements que d'écrire de nouveaux enregistrements.
hOLecture	La base de données est accessible uniquement en lecture. Seule la lecture des enregistrements est possible. Il n'est pas possible d'en ajouter ou d'en supprimer. Cette constante est ignorée.

Ce paramètre peut être connu et modifié grâce à la propriété ..Accès utilisée sur une variable de type Connexion.

Accès par JDBC : Ce paramètre est ignoré.

Ce paramètre n'est pas disponible.

Informations optionnelles insérées dans la chaîne de connexion à la base de données. Si des mots-clés spécifiques sont reconnus, les informations correspondantes sont extraites de la chaîne de connexion. Le reste de la chaîne de connexion est envoyé à la base de données. Les paramètres extraits sont ensuite traités spécifiquement par l'accès natif ou OLE DB utilisé.
Ces mots-clés doivent être indiqués de la manière suivante : "<Mot-clé> = <Valeur>;".

Il est par exemple possible de préciser le paramètre "Trusted_Connection=YES" pour utiliser une connexion avec authentification par le login NT.

Les mots-clés reconnus par OLE DB et les accès natifs sont présentés dans la page Informations optionnelles de connexion.

Exemple de chaîne à utiliser :

"WD Cache Size = 10000; Server Port=3306;"

Les mots-clés reconnus pour l'accès par HFSQL Client/Serveur :

COMPRESSION	Active ou non la compression des données transmises entre le Client et le Serveur. Ce mot-clé peut correspondre à : VRAI pour activer la compression des données. FAUX pour ne pas compresser les données.
CRYPTAGE	Active le cryptage des informations transmises entre le Client et le Serveur. Ce mot-clé peut prendre deux valeurs : RAPIDE RC5_16 pour utiliser un cryptage RC5 à 16 boucles.
BDD_EXISTE	Teste l'existence de la base de données. Si la base de données spécifiée n'existe pas, cette base de données n'est pas créée et la fonction HOuvreConnexion retourne Faux.

Ce paramètre peut être récupéré et modifié grâce à la propriété ..InfosEtendues.

Base de données HFSQL accédée à l'aide d'un serveur RMI : Ce paramètre correspond à l'adresse du serveur RMI et au port utilisé. Le format à utiliser est le suivant : "RMI=<Adresse du serveur>:<Numéro du port>". Par exemple : "RMI=192.168.52.148:1099".

Accès par JDBC : Ce paramètre est obligatoire. Il doit correspondre au nom complet du driver JDBC à utiliser. Ce nom est sensible à la casse.

Ce paramètre n'est pas disponible.

Si ce paramètre n'est pas spécifié, le moteur HFSQL détermine automatiquement les meilleurs paramètres à utiliser en fonction de la base accédée et du provider OLE DB utilisé.

Par défaut, ce paramètre correspond à la combinaison de constantes suivante :

hCurseurServeur + hCurseurOpenKeySet + hCurseurOptimiste

Toutefois, ces paramètres peuvent varier en fonction des informations retournées par la base.

Pour forcer certains paramètres, il est possible de combiner les constantes suivantes :

• Emplacement des curseurs
  

  hCurseurClient	Curseur géré par le MDAC. Offre souvent plus de fonctionnalités qu'un curseur serveur. Un curseur client est obligatoirement un curseur statique.
  hCurseurServeur	Curseur géré par la base de données. Ce curseur peut répercuter facilement les changements effectués par d'autres utilisateurs sur les données.

• Type de curseur
  

  hCurseurDynamique	Curseur offrant de nombreuses fonctionnalités, mais consommant beaucoup de mémoire. Ce curseur autorise tous les types de déplacement. Il permet d'accéder à toutes les modifications, ajouts et suppressions réalisées par les autres utilisateurs.
  hCurseurForwardOnly	Curseur rapide et consommant peu de mémoire. Le déplacement se fait du premier enregistrement au dernier. Les données modifiées par les autres utilisateurs ne sont pas visibles.
  hCurseurOpenKeySet	Curseur manipulant un jeu d'enregistrements figé. Seules des clés correspondant à l'enregistrement sont stockées et non les enregistrements (peu de ressources mémoire utilisées). Les enregistrements supprimés ne sont plus accessibles. Les modifications réalisées par les autres utilisateurs sont visibles (mais pas les ajouts).
  hCurseurStatique	Récupère une copie de tous les enregistrements de la requête en mémoire (consommation mémoire importante). Tous les types de déplacement sont autorisés.

• Mode de blocage
  

  hCurseurLectureSeule	Le jeu d'enregistrements manipulé ne pourra pas être modifié.
  hCurseurOptimiste	L'enregistrement n'est verrouillé que lors de sa mise à jour
  hCurseurPessimiste	L'enregistrement est verrouillé dès son édition pour être modifié.

Attention : tous les providers OLE DB ne gèrent pas tous les types de curseur.

Ce paramètre peut être récupéré et modifié grâce à la propriété ..OptionsCurseur.

Ce paramètre est ignoré.

Ce paramètre n'est pas disponible.