Zur Einführung in den SqlSurfer wird an dieser Stelle der Tutorialjob "Hello World" erläutert. Diesen (und viele weitere Tutorials) finden Sie in der heruntergeladenen und entpackten Distribution im Tutorialverzeichnis unter tutorial\01_HelloWorld\01_HelloWorld\helloworld.sqj.

Mit diesem Tutorial soll ein Einstieg in die Bedienung und die ersten Schritte bei Erstellung von SQL-Jobs gegeben werden.

Alle Einstellungen, die über die Benutzeroberfläche getätigt werden, werden als xml-Datei gespeichert und können deshalb auch manuell angepasst werden.

Nach Öffnen des Jobs sind folgende Felder der Benutzeroberfläche gefüllt.

In diesem Reiter lässt sich u.a. die Ausgabe des Ergebnisses, das Ausgabeverzeichnis und der Name des Jobs festlegen. Mit den Auswahlfeldern kann bestimmt werden, ob die Kommandos und die Logdateien in separate Dateien exportiert werden sollen.

In diesem Fenster lassen sich die genauen Ausgabeeinstellungen festlegen.

Es lässt sich mehr als ein Ausgabedokument hinterlegen. Das Ausgabedokument kann aus einer Vorlage (bspw. mit Zellenformatierung) erstellt werden.

Im Reiter "Kommandos" werden die Parameter, Makros und Kommandos des Jobs gespeichert.

Die Anzahl der maximal zu erstellenden Befehle ist nicht limitiert.

Die Erstellung der SQL-Statements wird durch die Java Template Engines FreeMarker und Velocity unterstützt und ist daher flexibel, d.h. die SQL-Statements können programmiert werden (for-Schleife, if-then-else, etc.).

Unter Eigenschaften wird in diesem Beispiel die gewünschte Datenbankverbindung ausgewählt.

Hier können noch weitere Einstellungen, wie z.B. der Typ und der Name des Jobs vorgenommen werden.

Im Reiter "cmd" muss für dieses Beispiel das SQL-Statement, welches ausgeführt werden soll, hinterlegt werden. Sollte hier kein Statement hinterlegt werden, so wird bei Jobausführung in diesem Feld das fertig ausgeführte SQL-Kommando angezeigt.

Im Reiter "Export" wird die gewünschte Ausgabeeinstellung angelegt. Es können mehrere Ausgaben mit unterschiedlichen Parametern festgelegt werden.

Unter AusgabeDatei lassen sich die Dateien wählen, die zuvor unter OutPut in dem ersten Fenster "Eigenschaften" angelegt worden sind.

Um den Excel Export zu spezifizieren, können hier bspw. der Ausgabe WorksheetName, der Template WorksheetName, die Startzelle und die Zeilensortierung angepasst werden.