Inhaltsübersicht
Volltextsuche
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
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.
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 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 - 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
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 dem Sie Bibliotheken (Schemas), Dateien (Tabellen) und Felder (Spalten) anzeigen können.
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.
SQL importieren
Mit diesem Befehl können Sie Quellenanweisungen von iSeries Sourcefiles einlesen.