version 2004
ODBC LOGIN ({nomSource{; utilisateur{; motDePasse}}})
Paramètre | Type | Description | |
nomSource | Chaîne | Nom de la source de données dans le gestionnaire ODBC | |
utilisateur | Chaîne | Nom d'utilisateur enregistré dans la source de données | |
motDePasse | Chaîne | Mot de passe de l'utilisateur |
Description
La commande ODBC LOGIN vous permet d'ouvrir une connexion avec une source de données ODBC externe.
Note : Le standard ODBC (Open DataBase Connectivity) définit une librairie de fonctions standard. Ces fonctions permettent à une application telle que 4e Dimension d'accéder via le langage SQL à tout système de gestion de données compatible ODBC (bases de données, tableurs, etc.).
Le paramètre nomSource contient le nom de la source de données telle qu'elle a été définie dans le gestionnaire du pilote ODBC.
Le paramètre utilisateur contient le nom de l'utilisateur autorisé à se connecter à la source de données externe. Par exemple, avec Oracle®, ce nom d'utilisateur peut être "Scott".
Le paramètre motDePasse contient le mot de passe de l'utilisateur autorisé à se connecter. Par exemple, avec Oracle®, ce mot de passe peut être "tiger".
Tous ces paramètres sont facultatifs. Si aucun paramètre n'est passé, la commande provoquera l'affichage de la boîte de dialogue du gestionnaire ODBC, permettant de désigner manuellement la source de données à laquelle se connecter :
La portée de cette commande est le process. Autrement dit, si vous souhaitez ouvrir deux connexions distinctes, vous devez créer deux process et ouvrir chaque connexion dans chaque process.
Exemples
(1) Cette instruction provoque l'affichage de la boîte de dialogue du gestionnaire ODBC :
ODBC LOGIN
(2) Cette instruction provoque la connexion à la source de données ODBC "MonOracle" avec les identifiants "Scott" et "tiger" :
ODBC LOGIN("MonOracle";"Scott";"tiger")
Référence
Variables et ensembles système
Si la connexion est correctement établie, la variable système OK prend la valeur 1, sinon elle prend la valeur 0.