Menüpunkt: XSQL-Abfrage bearbeiten

Mit diesem Befehl werden neue Abfragen definiert bzw. bestehende geändert. Pro Tabellenblatt kann nur eine (1) Abfrage definiert werden. Die Abfragedefinition ist in einem speziellen Bereich der XLSX-Datei gespeichert, der dem C++ API zur Verfügung steht und vom Benutzer nur über das Dialogfelds geändert werden kann.

Führen Sie irgendwo im Arbeitsblatt einen rechten Mausklick aus und wählen Sie im Kontextmenü XSQL Abfrage bearbeiten

Auswahlfelder

Name der DSN Datenquelle (drop-down-Liste oben links)  - In diesem Dropdown-Feld werden sämtliche vorhandene ODBC-Verbindungen aufgeführt. Die IBM i Access Verbindung wird standardmäßig ausgewählt.

SQL-Abfrage (schwarzes Textfeld) - Text der auszuführenden SQL Anweisung (aus Sicherheitsgründen nur SELECT Anweisungen).

Blättertasten der History - In der rechten unteren Ecke des SQL-Textfeldes befinden sich Blättertasten, mit denen Sie durch früher eingegeben SQL-Anweisungen blättern können, um diese ggf. erneut auszuführen.

Diese Anweisungen werden in der Datei XSQLHST.TXT sitzungsübergreifend gespeichert.

Ausgabebereich (Adresse) - Um auszuwählen, an welche Position [XSQL] die Ausgabedaten stellen soll, gehen Sie wie folgt vor:

- Stellen Sie den Zellzeiger an die gewünschte Stelle im Arbeitsblatt (Sie brauchen das Dialogfeld dazu nicht zu verlassen)
"- Klicken Sie im Dialogfeld die Schaltfläche ""Adresse"". Die Adresse der linken oberen Zelle wird eingeblendet."

Bitte beachten Sie, dass [XSQL] ohne Warnung sämtliche Zellen des Ausgabebereichs überschreibt.

Max. Anzahl Zeilen - Mit diesem Bedienfeld können Sie die Anzahl der Zeilen, die xsql maximal vom Server übertragen soll, beschränken.

"Bei Auswahl von ""dynamisch"" (am oberen Ende der Liste) werden - soweit in Excel möglich - alle zur Verfügung" stehenden Sätze abgerufen. Die Beschränkung der Satzanzahl ist sinnvoll, da Sie hierdurch - insbesondere bei komplexen Abfragen gegen große Tabellen - die Responsezeit erheblich verkürzen können.

Um alle Sätze zu bekommen klicken Sie auf den aufwärts zeigenden Pfeil und halten die Maustaste gedrückt, bis das Wort "alle" erscheint.

Formatieren - Durch Aktivieren dieser Option werden am Ende der Abfrage im Ausgabebereich folgende Formatierungen vorgenommen:

"- Überschriftszeile (sofern ausgewählt) in fetter Schrift, grau unterlegt;"
"- numerische Felder mit vordefinierter Anzahl Dezimalstellen;"
- Datums und Zeitfelder im korrekten Format.

Autofilter setzen - Durch Aktivieren dieser Option wird am Ende der Abfrage der Excel Autofilter aktiviert. Das erzeugt für jedes Feld einen drop-down-Button über den man die Sätze sortieren und selektieren kann:

Spaltenbreite anpassen - Durch Aktivieren dieser Option werden am Ende die Breite aller Spalten des Ausgabebereichs automatisch angepasst.

Spaltenüberschriften - Wählen Sie aus, ob Sie Feldnamen, Label(Feldtexte) oder keine Spaltenüberschriften möchten.

Buttons - Ausführen und Übernehmen

Ausführen - Durch Klicken diese Schaltfläche wird die Abfrage ausgeführt.

• Die geholten Daten werden beginnend an der als Adresse definierten Zelle eingetragen
• Die Inhalte in den Zellen werden überschrieben

Übernehmen - Durch Klicken diese Schaltfläche wird die Abfragedefinition im Tabellenblatt gespeichert und mit diesem gesichert.

"Wenn Sie den SQL-Text löschen und ""Übernehmen"" klicken, wird die Abfragedefinition komplett gelöscht."

Erweiterungen der SQL-Syntax

• Auswahl von Teildateien:

Um bei einer Datei mit mehreren Teildateien eine bestimmte Teildatei auszuwählen, geben Sie den Dateinamen wie folgt ein:

Bibliothek/Datei[Teildatei], d. h. der Name der Teildatei muss unmittelbar im Anschluss an den Dateinamen in eckigen Klammern stehen, z. B.:

SELECT * FROM PRODLIB/STATISTIK[JAN2017]

• Arbeiten mit Parametermarkern

Parametermarker sind Platzhalter für Variablen, die es ermöglichen, die gleiche SELECT-Anweisung mit unterschiedlichen Auswahlkriterien aufzurufen.

Beispiel für eine SELECT-Anweisung mit Parametermarker:

SELECT * FROM AVLIB/AUFTRAEGE WHERE KUNDENNR = ?a1

In diesem Fall werden Aufträge ausgewählt, Kundennummer dem Wert in Zelle A1 des Tabellenblatts gleicht.

Es können auf einfache Weise auch Listen gebildet werden:

SELECT * FROM AVLIB/AUFTRAEGE WHERE AUFTRAGSART IN (?a1:h1)

In diesem Beispiel werden alle Aufträge ausgewält, bei denen die Auftragsart einem der Einträge im Bereich a1:h1 entspricht.

Bitte beachten Sie, dass Sie - um Eingaben im Tabellenblatt vorzunehmen - das [XSQL] Dialogfeld nicht verlassen müssen.

Kontextmenü der SQL-Anweisung

Wenn sich der Cursor im SQL Textfeld befindet, können Sie durch Klicken der rechten Maustaste ein Kontextmenü mit folgenden Befehlen aufrufen:

Abfrage testen

Mit diesem Befehl wird die aktuell eingegeben Anweisung mit lediglich 10 Zeilen ausgeführt. Diese Art der Abfrage ist sehr schnell und kann dazu dienen, die SQL Syntax zu überprüfen oder sich einen Überblick über die zu erwartenden Ausgabedaten zu verschaffen.

Verzeichnisse anzeigen

Dieser Befehl öffnet ein Dialogfeld mit 4 Reitern:

Schemas - Tables - Columns

Durch Auswahl der Einträge und Klicken der rechten Maustaste können Sie ausgewählte Einträge in die Zwischenablage und von dort ins SQL Textfeld übertragen:

Bibliothek TTOAD gewählt: es werden die Dateien/Tabellen in der Bibliothek gezeigt:

Dateien KUNDE und OAANG (Angebote) gewählt: es werden alle Felder gewählten Dateien gezeigt:

Einige Felder markieren und Rechtsklick-Kopieren: die Feldenamen werden in die Zwischenablage kopiert.

Die so kopierten Feldnamen kann man im Hauptfenster per Rechsklick-Einfügen (oder STRG-V) einfügen und dann mit dem restlichen SQL-Befehl garnieren.

SELECT

Zeigt alle Felder aller Tabellen an, die im SELECT-Befehl des Hauptfensters angesprochen werden

SQL importieren

Mit diesem Befehl können Sie Quellenanweisungen von IBM i Quell-Teildateien einlesen.

Bibliotheksliste ändern

Öffnet ein Fenster, in dem Sie die Bibliotheksliste ändern können. Geben einfach alle Bibliotheken, getrennt mit einem Leerzeichen ein und drücken Sie OK:

Standardbibliotheksliste: wenn Sie diese Checkbox aktivieren, dann wird xsql diese Bibliotheksliste in einer Datei speichern und beim nächsten Start von Excel wieder verwenden

Die Datei heisst XSQL.ini und ist im selben Pfad gespeichert, wie die anderen Ressourcen von xsql. Standardmässig ist dies: %programfiles(x86)%\Toolmaker\xsql

Menüpunkt: XSQL-Abfrage ausführen / Doppelklick in eine Zelle

Es erscheint die Abfrage: "Datenübertragung starten"

Wenn Sie die Frage mit "Ja" beantworten, dann wird die Abfrage so ausgeführt, wie sie definiert ist, inklusive der Position.