|
Onglet Console |
Evènement |
Onglet Exécution |
|
Onglet Base de donnéesL'onglet Base de données est un onglet spécifique à un type d'objet et on ne peut le trouver sous cet aspect que pour l'objet événement. Il est affiché dans les événements de base de données et contient la définition de deux valeurs devant être comparées.
Objet : Événement
Classe d'objet : Objet activable
Type d'objet (description courte) : EVNT
L'onglet contient trois parties : Entrez la première valeur dans le champ "Valeur 1" et la seconde dans le champ "Valeur 2" Choisissez l'opérateur de comparaison. Syntaxe :
Valeur1 opérateur Valeur2
Opérateurs :
Une valeur peut être issue des sources suivantes :
Les sources peuvent être combinées à volonté. Vous pouvez donc comparer, par exemple : la valeur d'une requête SQL et un objet Variable, une valeur statique et une requête SQL, deux valeurs issues d'objets Variable identiques ou différents etc...
Les marques horaires de requêtes SQL et d'objets Variable seront convertis au format "AAAA-MM-JJ HH:MM:SS".
Attention, les chiffres après une virgule sont supprimés. Récupérez les valeurs dans !Traitement avec la fonction de script GET_EVENT_INFO et multipliez-les par 10n, pour déplacer la virgule. Vous pouvez alors comparer les valeurs dans !Script.
Exemples :
123,44 * 100 (c'est à dire 102) = 12344
123,5555 * 10000 (c'est à dire 104) = 12355555
Normalement, les valeurs sont des interpréteurs et sont comparées comme des valeurs de chaîne.
Si les deux valeurs peuvent être interprétées comme entiers positifs (>=0), elles seront comparées comme valeurs d'entier.
Exemples :
5 > 1 : Les valeurs sont interprétées comme entiers positifs -> int 5 > int 1 -> vrai
1 > -1 : Les valeurs sont interprétées comme chaînes -> chaînes "1" > chaînes "-1" -> faux
La valeur est le résultat d'une requête SQL.
Vous avez besoin d'un Agent de base de données pour effectuer une requête SQL.
|
Champ/élément |
Description |
|---|---|
| SQL |
Requête SQL Max. 4096 caractères |
| Hôte |
Nom de l'agent de base de données qui traite la requête SQL Les groupes d'agents ne peuvent pas être sélectionnés pour les événements de la base de données. |
| Login | Nom de l'objet Login servant à la connexion à la base de données |
| Serveur |
Nom de la machine sur laquelle se trouve la base de données Format : Nom du Serveur :Port Les ports par défaut sont indiqués ci-dessous :
Ne remplissez pas ce champ si la requête doit se faire dans une base de données Oracle dans RAC. |
| Base de données | Nom de la base de données |
| Microsoft Access seulement : | Chemin et nom de fichier de la base de données MS Access |
Cliquez sur le bouton [...] à côté du champ SQL. Un éditeur de texte s'affiche pour vous permettre de composer aisément votre requête SQL. Si vous avez rempli les champs serveur, base de données etc..., la partie droite de l'éditeur affiche la structure de la base de données.
Vous pouvez utiliser des Variables d'objet dans la requête SQL.
L'événement de base de données ne s'interrompt pas si la requête est incorrecte.
Attention, certaines bases de données font la différence entre les majuscules et les minuscules.
Résultat : Une valeur
Si la requête livre une valeur particulière, elle sera utilisée.
Résultat : Aucune valeur
!Script ne s'exécute pas.
Résultat : NULL
L'événement de base de données convertit NULL en une chaîne de caractère "NULL".
Résultat : Plusieurs valeurs ou enregistrements
Si la requête livre plusieurs valeurs, la première valeur du premier enregistrement est utilisée.
Exemple de résultat SQL :
| Nom de famille | Prénom | Emplacement |
|---|---|---|
| Henri | Jean | Paris |
| Vert | Sepp | Vienne |
L'événement de base de données utilise la valeur "Smith"
Récupération du résultat avec GET_EVENT_INFO
L'élément de script GET_EVENT_INFO peut être utilisé pour accéder aux valeurs de la requête SQL dans !Traitement.
Notez que l'événement de la base de données ne lit que les dix premières colonnes. Le contenu des colonnes excédant 255 caractères est tronqué.
La valeur est donnée.
|
Champ/élément |
Description |
|---|---|
| Valeur statique |
Valeur quelconque Max. 40 caractères |
La valeur est déterminée à partir d'un objet Variable.
|
Champ/élément |
Description |
|---|---|
| Objet variable | Première colonne de valeur (pour les objets Variable dynamiques) |
| Valeur de la colonne clé ou première colonne de valeurs pour définir l'entrée de l'objet Variable qui est utilisée. Colonne de la première valeur (dans les Objets variables dynamiques) |
La valeur se réfère à la colonne Clé ou de la première colonne de valeurs pour déterminer l'entrée de l'objet Variable qui devrait être utilisé. La valeur se réfère à la colonne Valeur 1 (pour les Variables statiques) ou à la première colonne de valeurs (pour les Variables dynamiques) |
Si la clé de l'objet Variable n'existe pas, l'événement de la base de données n'est pas activé.
Si la clé ne contient aucune valeur, la réaction dépend de la configuration entrée dans l'onglet Attributs de l'objet Variable. Soit un message d'erreur est journalisé, soit les valeurs initiales sont utilisées. L'événement de base de données ne s'interrompt pas.
Rubriques connexes :