SQL REQ 2.1

Catégorie / Domaine : | Tools
Compatibilité Scol Engine : | V2.0c et supérieure
Mise à jour : | 09/2000

# Fonction

Le module SQL REQ fournit un accès à une base de données SQL ; les paramètres nécessaires pour accéder à la base de données doivent être renseignés dans l’Interface Editor DMI. Ce module doit être utilisé conjointement avec des modules spécifiques….(modules de Venise, Cryopolis…)

# Configuration

Figure 1 : Interface principale du module SQL REQ

##

ATTENTION ! : Cette librairie n'est pas fournie dans le Scol Voy@ger/Engine de base, car elle nécessite le support ODBC, et celui-ci n'est pas présent sur toutes les machines. Elle est fournie sous forme d'un plugin Scol : "scolsql.dll" téléchargeable à l’adresse suivante :

www.cryonetworks.com (Outils SCOL)

- Copier le fichier scolsql….dll dans le répertoire Scol/Plugins.

- Editer le fichier usm.ini :

### Le fichier usm.ini peut être édité facilement grâce au Scol Voy@ger :

Clic-droit sur l’icône Scol bleue dans la barre des tâches, puis menu Avancé…, Mode Expert.

- Entrer la ligne suivante :

plugin plugins/scolsql….dll SCOLloadSQL

##

## 1- Nom de la BDD : Nom de la base de données définie dans ODBC

2- Login : Nom de l’utilisateur pour accéder à la base de données ; s’il n’est pas renseigné, « Admin » est utilisé par défaut.

3- Password : Indique le mot de passe correspondant au login ; "" par défaut.

4- Requête SQL : Permet de définir la requête SQL qui sera exécutée ; doit respecter la syntaxe SCOL pour SQL (les paramètres apparaissent dans la Requête sous forme de « ? »)

5- Paramètres : Il faut définir, ici, un paramètre par ligne, chaque ligne contenant le type du paramètre SQL et la valeur du paramètre.

# Mise en oeuvre

Action |

#### Fonction

module.event à SQLReq.SqlDMIParamDMI | Indiquer deux noms d’action dans la liste déroulante Reply, sous la forme d’une chaîne de caractères construite avec la function linebuild de SCOL (à partir d’une liste de chaînes de caractères [S r1]) (ex : action1\naction2\n) - la première action de la liste sera l’action qui recevra le résultat comme paramètre (si aucun nom n’est fourni, le résultat est envoyé à l’événement « Result »

- La seconde action de la liste sera l’action qui recevra le SqlCod comme paramètre (si aucun nom n’est indiqué, le SqlCod est envoyé à l’événement « SqlCod »)

module.event à SQLReq.SqlSentParamSent | Indiquer deux noms d’action dans Reply, en indiquant qu’ils constituent une ligne de [Sr1] - La première action de la liste sera l’action qui recevra le résultat comme paramètre (si aucun nom n’est indiqué, le nom d’action par défaut est « Result »)

- La seconde action de la liste sera l’action qui recevra le SqlCod comme paramètre (si aucun nom n’est indiqué, le nom d’action par défaut est « SqlCod ».

Il faut aussi indiquer la requête SQL à exécuter, et les paramètres à utiliser. Cela doit passer comme paramètre avec l’action. Le paramètre doit être une chaîne produite par un strbuild d’une liste [[Sr1]r1], la première ligne contenant la chaîne de la requête SQL, et les lignes suivantes, contenant un type de paramètres SQL et une valeur.

module.event à SQLReq.SqlSentParamSentWithErr | Nécessite un seul nom dans Reply, les codes d’erreur sont envoyés à l’intérieur même du résultat ([Sr1]r1)
module.event à SQLReq.SqlDMIParamSent | Pas encore implémenté
module.event à SQLReq.SqlSentParamDMI | Pas encore implémenté

Evénement | Fonction

###

### SQLReq.result à module.action

Quand aucun nom d’action n’a été fourni dans le Reply du résultat, le résultat de la requête est envoyé par cet événement et engendre une action

SQLReq.resultWithErr à module.action | Quand aucun nom d’action n’a été fourni dans le Reply du résultat avec erreur, le résultat avec erreur de la requête est envoyé par cet événement et engendre une action
SQLReq.SQLCod à module.action | Quand aucun nom d’action n’a été fourni dans le Reply du SQLCod, le SQLCod de la requête est envoyé par cet événement et engendre une action
SQLReq.log à module.action | Le log du statut de la requête du serveur engendre une action

##### Zone

Fonction

Interface

Affectation

Aucune |  |  |