...

Es gibt zwei Möglichkeiten, [XSQL] aufzurufen:

- Durch Doppelklick im Tabellenblatt. Gibt es bereits eine Abfragedefinition, wird diese ausgeführt, ansonsten wird das [XSQL] Dialogfeld angezeigt.

- Durch Klicken der rechten Maustaste das Zellen-Kontextmenü aufrufen und einen der am Ende stehenden [XSQL]-Befehle auswählen.

...

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.

Im Dialogfeld [XSQL] Abfrage bearbeiten stehen folgende Eingaben zur Verfügung:Führen Sie irgendwo im Arbeitsblatt einen rechten Mausklick aus und wählen Sie im Kontextmenü XSQL Abfrage bearbeiten

Image Added

Image Added

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

Textfeld SQL Anweisung

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

Folgende Erweiterungen der SQL-Syntax sind möglich:

• 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.

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] 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.

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.

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

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

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

Ü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."

Es gibt zwei Möglichkeiten, [XSQL] aufzurufen:

- Durch Doppelklick im Tabellenblatt. Gibt es bereits eine Abfragedefinition, wird diese ausgeführt, ansonsten wird das [XSQL] Dialogfeld angezeigt.

- Durch Klicken der rechten Maustaste das Zellen-Kontextmenü aufrufen und einen der am Ende stehenden [XSQL]-Befehle auswählen.

3.1.1) Kontextmenü der SQL-Anweisung

...