Inhaltsübersicht
XSQL-Excel-Funktionen im Überblick
Eigene Lizenz: XSQP
Die XSQL-Excel-Funktionen sind extra lizenziert mit der Option XSQP. Wenn diese Funktionen für Sie interessant sind, lassen Sie sich bitte von unserem Vertrieb (sales@toolmaker.de) ein Angebot erstellen.
xsql fügt Excel 3 Funktionen in einer neuen Kategorie [xsql] hinzu:
- fQuery - Start einer SQL-Abfrage beim Öffnen der Datei oder bei Änderungen an den relevanten Zellen
- fTables -
- fColumns -
Das Arbeiten mit diesen Funktionen wird in diesem Kapitel beschrieben.
Eine xsql-Funktion mithilfe des Excel-Formeleditors einfügen
Die Tabellenfunktion fQuery kann wie jede andere Funktion direkt in die Zelle oder über den Formeleditor eingegeben werden:
Über den Formeleditor:
- Registerkarte "Formeln" anklicken
- "Funktion einfügen" klicken
- Im Dropdownfeld "Kategorie" [XSQL] auswählen
- die gewünschte Funktion markieren und OK klicken
Die xsql-Funktionen sind Array-Funktionen
Hier eine kleine Hilfestellung, falls Sie nicht wissen, wie man Array-Funktionen erstellt:
Am einfachsten:
1. Geben Sie die Funktion einer Zelle ein (hier zum Beispiel fQuery):
2. Drücken Sie ENTER
Beachten Sie die Zelle, in der Sie die Funktion eingegeben haben.
- wenn sie jetzt die Überschrift des ersten ausgewählten Feldes hat, dann haben Sie die Funktion syntaktisch korrekt eingegeben. Fahren Sie mit Schritt 3 fort.
- wenn sie jetzt den Inhalt ##WERT hat, dann gibt es noch einen Fehler in der eingegebenen Funktion. Bitte korrigieren Sie die Funktion.
3. Markieren Sie soviele Spalten, wie Felder ausgewählt wurden und mindestens soviele Zeilen, wie Sie an Sätzen erwarten (mehr ist nicht schlimm)
4. Drücken Sie die Taste F2
5. Drücken Sie die Tastenkombination STRG+UMSCH+EINGABE
Die Funktion fQuery
fQuery führt eine SQL-Abfrage aus und liefert das Ergebnis in die Tabelle.
Syntax von fQuery
fQuery(SQL; Optionen; DNS; P1; P2; P3; ...)
Die Parameter sind:
SQL: Die SQL Anweisung
Optionen für die Überschrift:
0 - keine Überschriften
1 - Feldnamen
2 - Kurztexte ("COLHDG")
4 - Langtexte ("TEXT")
8 - Unbenutzte Zellen als #N/V ausgeben
Die Optionen können addiert werden.
DSN: Name der ODBC Datenquelle.
Falls leer, sucht fQuery unter den vorhandenen DSN's die erste iSeries-Verbindung.
Wenn man eine Datenquelle angeben möchte, dann ist sie in Anführungszeichen (") zu setzen.
P1, P2, P3, ... (wahlweise): Zellbezüge für Platzhalter (Parametermarker im Statement): Fragezeichen im SQL Statement
Beispiele für fQuery:
=fQuery("SELECT * FROM QIWS/QCUSTCDT";1)
- holt alle Felder von allen Sätzen der Datei QIWS/QCUSTCDT und schreibt sie in die Tabelle
- es wird die erste IBM i - ODBC-Datenquelle verwendet
- als Überschriften werden die Feldnamen verwendet
=fQuery("select * from qiws/qcustcdt where cdtlmt >= ?";1;"AETOAD";$C$1)
- holt alle Felder von ausgewählten Sätzen der Datei QIWS/QCUSTCDT und schreibt sie in die Tabelle
- Es wird die Datenquelle AETOAD verwendet
- als Überschriften werden die Feldnamen verwendet
- die Auswahl wird durch den Inhalt der Zelle C1 bestimmt: alle Sätze, in denen das Feld CDTLMT grösser oder gleich dem Inhalt von C1 ist, werden geholt
Die Funktion fTables
Die Funktion liefert die Namen und Beschreibungen von Tabellen in einer Bibliothek
Syntax von fTables
fTables(bibliothek; tabelle; spaltenüberschrift)
Die Parameter sind:
bibliothek: Der Name einer Bibliothek/eine Schemas
tabelle: der Name einer Datei in der Bibliothek