Registerkarte Konsole

Ereignis

Registerkarte Laufzeit

---

 Registerkarte Datenbank

Die Registerkarte Datenbank ist eine objekttypspezifische Registerkarte, die in dieser Form nur beim Objekt "Ereignis" zu finden ist. Sie wird in Datenbank-Ereignissen angezeigt und enthält die Definition für zwei Werte, die miteinander verglichen werden sollen.

Objekt: Ereignis
Objektklasse: Ausführbares Objekt
Objekttyp (Kurzbezeichnung): EVNT

Die Registerkarte ist in drei Bereiche geteilt. Geben Sie bei "Wert 1" den ersten Wert und bei "Wert 2" den zweiten Wert an. Dazwischen ist der Operator auszuwählen, mit dem die beiden Werte verglichen werden sollen. Es gilt:

Wert1 Operator Wert2

Operatoren:

• > (größer als)
• < (kleiner als)
• = (ist gleich)
• <> (ungleich)
• >= (größer oder gleich)
• <= (kleiner oder gleich)
• enthält ("Wert 1" enthält die Werte aus dem Bereich "Wert 2")

Ein Wert kann aus den folgenden Quellen bezogen werden:

• SQL-Abfrage
• Statischer Wert
• Variablen-Objekt

Die Quellen sind beliebig kombinierbar. Ein Wert einer SQL-Abfrage lässt sich mit einem Variablen-Objekt vergleichen, ein statischer Wert mit einer SQL-Abfrage, zwei Werte aus verschiedenen oder dem gleichen Variablen-Objekt usw.

Zeitstempel aus SQL-Abfragen und Variablen-Objekten werden in das Format "JJJJ-MM-TT HH:MM:SS" konvertiert.

Beachten Sie, dass Nachkommastellen abgeschnitten werden! Lesen Sie die Werte im !Script mithilfe der Scriptfunktion GET_EVENT_INFO aus und multiplizieren sie mit 10n, um das Komma zu verschieben. Danach können Sie die Werte im !Script miteinander vergleichen.

Beispiele:

123,44 * 100 (entspricht 102) = 12344

123,5555 * 10000 (entspricht 104) = 12355555

Im Allgemeinen werden Werte als String-Werte interpretiert und verglichen.
Wenn beide Werte als positive Ganzzahlen (>=0) interpretiert werden können, werden sie als Ganzzahlwert verglichen.

Beispiele:

5 >  1: Werte werden als positive Ganzzahlen interpretiert -> int 5 > int 1 -> true

1 > -1: Werte werden als Zeichenketten interpretiert -> string "1" > string "-1" -> false

SQL-Abfrage

Der Wert wird aus einer SQL-Abfrage ermittelt.

Sie benötigen einen Datenbank-Agenten, um eine SQL-Abfrage ausführen zu können!

Klicken Sie auf die Schaltfläche mit den drei Punkten, die sich neben dem Textfeld SQL befindet. Es öffnet sich ein komfortabler Editor, in dem Sie die SQL-Abfrage eingeben können. Der rechte Teil des Editors zeigt Ihnen die Struktur der Datenbank an, wenn Sie die Textfelder Server, Datenbank etc. ausgefüllt haben.

Sie können innerhalb der SQL-Abfrage Objektvariablen verwenden.

Das Datenbank-Ereignis bricht nicht ab, wenn die SQL-Abfrage fehlerhaft ist.

Beachten Sie, dass einige Datenbanken die Groß- und Kleinschreibung beachten!

Ergebnis: Ein Wert

Wenn die SQL-Abfrage einen bestimmten Wert zurückgibt, so wird dieser verwendet.

Ergebnis: Kein Wert

Das !Script wird nicht ausgeführt.

Ergebnis: NULL

Das Datenbank-Ereignis wandelt NULL in den String "NULL" um.

Ergebnis: Mehrere Werte oder Datensätze

Gibt die SQL-Abfrage mehr als einen Wert zurück, wird der erste Wert des ersten Datensatzes verwendet.

Beispiel eines SQL-Ergebnisses:

Das Datenbank-Ereignis benutzt den Wert "Meier".

Auslesen des Ergebnisses mit GET_EVENT_INFO

Das Script-Sprachmittel GET_EVENT_INFO bietet Ihnen die Möglichkeit, im !Script auf die Werte der SQL Abfrage zuzugreifen.

Beachten Sie, dass das Datenbank-Ereignis nur die ersten 10 Spalten ausliest. Außerdem werden Spalteninhalte mit mehr als 255 Zeichen abgeschnitten.

Statischer Wert

Der Wert wird direkt vorgegeben.

Variablen-Objekt

Der Wert wird aus einem Variablen-Objekt ermittelt.

Wenn der Key in dem Variablen-Objekt nicht existiert, wird das Datenbank-Ereignis nicht aktiviert.

Enthält der Key keine Werte, so hängt die Reaktion von der Einstellung ab, die Sie im Variablen-Objekt in der Registerkarte Attribute vorgenommen haben. Es wird entweder eine Fehlermeldung protokolliert oder die Initialwerte verwendet. Das Datenbank-Ereignis bricht aber nicht ab.

Siehe auch:

GET_EVENT_INFO