SQL_CONNECTION
Gestion des objets runtime du logiciel PcVue pour les connexions Sql.
Support WebVue - Oui.
L'utilisation de connexions Sql préconfigurées avec les instructions SQL_CONNECTION, SQL_COMMAND et SQL_QUERY sont préférables à l'utilisation du verbe SVSQL (basé sur ODBC).
Les connexions Sql préconfiguré sont configurées dans l'Application Explorer. Consultez le chapitre Data Connections pour plus d'informations.
Certains des modes sont asynchrones. Le développeur de l'application doit s'assurer que la valeur de la variable de status est surveillée et prendre des mesures adéquates lorsqu'elle change.
Ce verbe peut être exécuté localement sur le poste de production de la connexion Sql ou à partir de n'importe quel poste client du producteur. Dans ce dernier cas, les commandes et les données renvoyées sont acheminées de manière transparente à travers le système de messagerie multi-postes. Plusieurs connexions à la même source de données ne sont autorisées que si vous utilisez différentes Connexions Sql. Les connexions multiples en utilisant la même Connexion Sql seront refusées, cependant, il est possible d'envoyer plusieurs requêtes simultanément en utilisant la même Connexion Sql.
Les connexions, et les données qui leur sont associées, sont gérées dans le contexte des sessions utilisateurs. Une connexion ne doit être utilisée que dans le contexte de la session qui l'a initiée à l'origine; et tous les objets correspondant doivent être libérés/fermés correctement avant que la session ne se termine. Par exemple, il n'est pas possible d'initier une connexion au démarrage et d'avoir des requêtes qui s'exécutent ultérieurement dans des sessions utilisateurs.
| Mode | Mnémonique | Syntaxe |
| 1 | TESTCONNECTION | 1 |
| 2 | START | 2 |
| 3 | STOP | 2 |
Arguments communs à plus d'un mode
|
Argument |
Définition |
| SqlConnectionName | Nom de la connexion Sql tel que configuré dans Général.Connexions de données de l'Application Explorer. Type STR |
Syntaxe 1
IntVal = SQL_CONNECTION(Mode, SqlConnectionName, StatusVariable, ErrorTextVariable);
Type de retour : INTEGER
|
Argument |
Définition |
|
StatusVariable |
Nom de la variable mesure utilisée pour surveiller le status d'une opération asynchrone. Type STR. Terminé avec succès = 0 |
|
ErrorTextVariable |
Nom d'une variable texte utilisée pour retourner une information supplémentaire lorsque la valeur de la variable de status est positionnée à Echec (2). Type STR. |
Exécution
|
Mode |
Mnémonique |
Action |
| 1 | TESTCONNECTION |
Teste la connexion de bout en bout avec une source de donnée en utilisant la connexion Sql spécifiée. C'est l'équivalent de la tâche Test connexion disponible dans l'Application Explorer. Retour : 0 si OK, sinon un nombre négatif indique une des erreurs suivantes : Voir le tableau ci-dessous pour les valeurs de retour. |
Ce mode est asynchrone. Le programme doit surveiller la valeur de la variable de status.
Syntaxe 2
IntVal = SQL_CONNECTION(Mode, SqlConnectionName);
Type de retour : INTEGER
Exécution
|
Mode |
Mnémonique |
Action |
| 2 | START |
Modifie le status de l'objet connexion Sql en 'démarré'. Aucune action n'est réalisée si l'objet est déjà démarré. Retour : 0 si OK, sinon un nombre négatif indique une des erreurs suivantes : Voir le tableau ci-dessous pour les valeurs de retour. |
| 3 | STOP |
Modifie le status de l'objet de connexion Sql en 'arrêté'. Aucune action n'est réalisée si l'objet est déjà arrêté. Retour : 0 si OK, sinon un nombre négatif indique une des erreurs suivantes : Voir le tableau ci-dessous pour les valeurs de retour. |
Similaires au status des objets de communication, ces modes sont conçus pour empêcher un poste qui produit une connexion Sql d'exécuter des commandes réelles vers la source de données en donnant au concepteur de l'application la possibilité de forcer des connexions Sql dans un status (arrêté) . Les modes START et STOP sont toujours exécutées localement (par opposition à routées vers le poste produisant la connexion Sql). En conséquence, ils doivent être exécutés sur les postes de production de la connexion Sql pour être utiles - au lieu d'être exécutés sur des postes client émettant des requêtes qui sont acheminées au producteur de connexion Sql sur le réseau multi-postes.
Liste des valeurs de retour possible et leurs significations
| Valeur de retour | Enum | Définition |
| 0 | OPERATION_SUCCEEDED | Opération terminée avec succès |
| -1 | SQLCONNAME_PARAM_NOT_STR_OR_NOT_READ | Le paramètre SqlConnectionName n'est pas de type string ou n'a pas pu être lu |
| -2 | STATUSVARIABLE_PARAM_NOT_STR_OR_NOT_READ | Le paramètre StatusVariable n'est pas de type string ou n'a pas pu être lu |
| -3 | ERRORTEXTVARIABLE_PARAM_NOT_STR_OR_NOT_READ | Le paramètre ErrorTextVariable n'est pas de type string ou n'a pas pu être lu |
| -4 |
SQLCON_DOES_NOT_EXIST |
La connexion Sql spécifiée n'existe pas dans la configuration |
| -5 |
STATUSVARIABLE_NOT_REGISTER_OR_DOES_NOT_EXIST |
La variable de status passée en paramètre (StatusVariable) n'est pas une variable mesure ou n'existe pas |
| -6 |
ERRORTEXTVARIABLE_NOT_TEXT_OR_DOES_NOT_EXIST |
La variable information supplémentaire passée en paramètre (ErrorTextVariable) n'est pas une variable texte ou n'existe pas |
| -7 | SEND_COMMAND_FAILED | Impossible d'envoyer la commande Sql. Cette erreur se produit si le service Windows sous-jacent est arrêté ou si l'utilisateur n'a pas assez de privilèges pour exécuter la commande |