Das zentrale Element in DataNAUT CS sind die Templates und ihre Erstellung und damit das Schreiben von SQL-Scripten und -Queries. Um Sie bei der Erstellung dieser SQL-Scripte möglichst effizient zu unterstützen, bietet DataNAUT CS diverse Hilfsmittel zum Testen und Debuggen der Scripte. Dieser Artikel bietet einen Überblick über die Werkzeuge, die Ihnen DataNAUT CS zur Seite stellt und wie Sie diese anwenden können.
Queries und Scripte im Templateeditor testen
Das Schreiben einer SQL-Abfrage oder eines SQL-Scripts erfordert meist häufiges Ausprobieren und Umschreiben des SQL-Quelltextes. Damit Sie nicht nach jeder Änderung an einem Script das komplette Template ausführen und testen müssen, bietet DataNAUT CS die Möglichkeit, jedes einzelne Script direkt aus dem Templateeditor heraus auszuführen.
Über Ausführen und Ausführen als können einzelne SQL-Queries und Scripte getestet werden.
Während Sie ein Script bearbeiten, können Sie dies jederzeit mit einem Klick auf den Punkt Ausführen im Menü unter SQL-Abfragen und Scripte ausführen lassen. Bei einem reinen Script, also einer SQL-Anweisung ohne Rückgabetabelle, verrät Ihnen das Datenbank-Log unter dem SQL-Editor, ob die Abfrage funktioniert hat oder falls nicht, welche Fehler aufgetreten sind. Liefert das Script auch eine Ergebnistabelle zurück, dann wird diese ebenfalls unterhalb des SQL-Editors auf dem Reiter Ausgabe angezeigt. So können Sie jederzeit schnell und einfach überprüfen, ob Ihr Script funktioniert, ob die richtigen Daten zurückgeliefert werden und welche Meldungen die Datenbank zurückliefert.
Über den Button Ausführen als können Sie ein Script bzw. Query gezielt als Script oder Query ausführen lassen. Der Unterschied zwischen beiden Methoden ist, dass beim Ausführen als Script nach der Ausführung immer das Datenbank-Log angezeigt wird und beim Ausführen als Query immer die Ausgabe.
Das Datenbank-Log Protokolliert alle Meldungen der Datenbank.
Parameterwerte vorgeben
Die Möglichkeit, Scripte direkt aus dem Templateeditor heraus zu testen, stößt in dem Moment zunächst an Ihre Grenzen, in dem Sie Parameter in einem Script verwenden, denn die Parameter erhalten normalerweise erst über die Parametermaske ihre Werte. Aber auch hierfür bietet DataNAUT CS eine Lösung: Auf der rechten Seite des Templateeditors finden Sie den Kasten Parameter, über den Sie für jeden im angezeigten Script verwendeten Parameter Vorgabewerte zum Testen definieren können.
Als Standardvorgabe für alle Parameter in einem Script ist die Option Wert ist NULL angekreuzt. Das bedeutet, dass der jeweilige Parameter den Wert NULL (also keinen definierten Wert) bekommt, wenn das Script über die Funktion Ausführen gestartet wird. Um einen bestimmten Vorgabewert für einen Parameter zu definieren, gehen Sie wie folgt vor:
1 Markieren Sie den entsprechenden Parameter in der Liste Script-Parameter und Werte mit einem Linksklick.
2 Entfernen Sie das Häkchen an der Option Wert ist NULL, damit DataNAUT CS weiß, dass dieser Parameter einen bestimmten Wert bekommen soll.
3 Geben Sie jetzt in das Eingabefeld Wert den gewünschten Wert für den Parameter ein. DataNAUT CS merkt sich jeden neuen Wert den Sie eingeben, so dass Sie "alte" Werte später immer wieder über die Drop-Down-Liste des Eingabefeldes Wert erneut auswählen können. Dies erspart Ihnen das ständige neu Eingeben komplexerer Wertvorgaben.
4 Wiederholen Sie diesen Vorgang mit allen Parametern, für die Sie Werte vorgeben wollen. Diese Wertvorgaben beziehen sich nur auf das Testen von Scripten und haben keinerlei Auswirkung auf die spätere Ausführung des Templates.
5 Führen Sie jetzt das Script über die Funktion Ausführen unter SQL-Abfragen und Scripte aus und die von Ihnen angegeben Parametervorgaben werden dabei verwendet. So können Sie bequem testen, ob sich ein Script bei entsprechenden Parameterwerten so verhält, wie es soll.
Damit sich DataNAUT CS Ihre Wertvorgaben auch über mehrere Bearbeitungssitzungen hinaus merkt, können Sie die Listen der Werte jederzeit über den Button Liste Speichern im Kasten Parameter speichern und später über den Button Liste laden wieder laden.
Scratch-Query und Scratch-Script
Haben Sie einmal eine funktionierende Lösung für eine Abfrage gefunden, kann es trotzdem sein, dass Sie noch andere Varianten für diese Abfrage ausprobieren wollen, beispielsweise um die Abfrage zu optimieren oder zu vereinfachen. Wenn Sie dies direkt in den entsprechenden Scripten erledigen, dann bedeutet dies, das bestehende Script zu verändern. Das heißt, Sie müssten sich das alte Script merken, damit Sie es jederzeit wiederherstellen können, falls Ihre Änderung nicht funktioniert oder nicht den gewünschten Effekt hat. Vergessen Sie aus Versehen das alte Script, dann stehen Sie allerdings vor einem Problem.
Damit Ihnen dies erspart bleibt, können Sie in jedem Template Scratch-Queries und -Scripte anlegen. Bei diesen Scripten handelt es sich um reine Test-Abfragen, die während der eigentlichen Template-Ausführung vollkommen ignoriert werden. Sie sind also der ideale Platz, um Änderungen an den vorhandenen Abfragen und Scripten zu testen und um verschiedene Varianten davon zu vergleichen, denn Sie können beliebig viele Scratch-Queries und -Scripte in einem Template anlegen.
Scratch-Queries und -Scripte eignen sich zum Testen von SQL-Code in einzelnen Templates.
Um ein solches anzulegen, klicken Sie einfach in der Toolleiste unter SQL-Abfragen und Scripte auf den Eintrag Neu und wählen Sie im Auswahldialog entweder Scratch-Script oder Scratch-Query aus. Danach können Sie zum Beispiel Ihre Hauptabfrage in dieses Script hineinkopieren und verschiedenste Änderungen testen, ohne dabei Gefahr zu laufen, das eigentliche Template aus Versehen zu zerstören.
DSR-Parameter und Parametermaske testen
Mit allen bisher beschriebenen Methoden können Sie einzelne SQL-Scripte testen, aber nicht, ob die Eingabe in der Parametermaske auch funktioniert, sofern eine verwendet wird. Auch DSR-Parameter können nicht direkt getestet werden, allerdings lassen sich dazu mehrere Scratch-Queries anlegen, die jeweils ein Query mit einer der möglichen Ersetzungen für einen DSR-Parameter enthalten.
Ob in der Parametermaske alles richtig eingegeben und eingestellt ist, lässt sich so jedoch nicht herausfinden. Unmöglich ist dies aber selbstverständlich nicht, zumindest nicht für die Hauptabfrage des Templates:
1 Öffnen Sie das zu testende Template im Templateeditor und klicken Sie dann auf den ButtonTesten.
2 Geben Sie nun wie gewohnt die Parameterwerte in der Parametereingabe ein, klicken Sie danach aber zunächst auf den Button Optionen.
3 Im Kasten Templateansicht finden Sie die Optionen SQL-Script der Hauptabfrage vor der Ersetzung der DSR-Parameter anzeigen und SQL-Script der Hauptabfrage nach der Ersetzung der DSR-Parameter anzeigen. Aktivieren Sie eine dieser Optionen, wird das Template nicht ausgeführt, sondern das Script der Hauptabfrage vor bzw. nach der Ersetzung der DSR-Parameter angezeigt. Hierüber können Sie genau sehen, wie das Script nach der Parametereingabe aussieht, bevor es an die Datenbank gesendet wird.
4 Übernehmen Sie die neuen Einstellungen mit einem Klick auf Speichern und bestätigen Sie dann Ihre Parametereingabe mit einem Klick auf OK. Sie bekommen nun, je nach gewählter Option, das entsprechende Script angezeigt. Schließen Sie die Anzeige, wird wieder der Dialog zur Parametereingabe angezeigt, so dass Sie weitere Parametereingaben testen können.
So können Sie testen, ob die Werte der Parametereingabe auch wirklich richtig eingesetzt werden und ob es sich auch um die richtigen Werte handelt. Die Einstellungen können Sie übrigens nicht nur über den Button Optionen in der Parametereingabe anpassen, sondern auch über den Button Optionen direkt im Templateeditor.