Inhaltsübersicht

XSQL-Excel-Funktionen im Überblick

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:

1. Registerkarte "Formeln" anklicken
2. "Funktion einfügen" klicken
3. Im Dropdownfeld "Kategorie" [XSQL] auswählen
4. 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 (physischen Dateien) in einer Bibliothek

Syntax von fTables

fTables(bibliothek; tabelle; spaltenüberschrift)

Die Parameter sind in Grossbuchstaben einzugeben:

bibliothek: Der Name einer Bibliothek/eine Schemas

tabelle: der Name einer Datei in der Bibliothek

Hier können Sie auch das Prozentzeichen (%) als Wildcard verwenden:

Beispiele:

ST% - findet alle Dateien, der Name mit "ST" beginnt
%KFZ% - findet alle Dateien mit "KFZ" im Namen, egal, was davor oder dahinter steht
%P - findet alle Dateien, dern Name mit "P" endet
ST%P - findet alle Dateien, deren Name mit "ST" beginnt und mit "P" endet

spaltenüberschrift: Überschriften, oder nicht

Gültige Werte:

0 - keine Überschriften
1 - Feldnamen
8 - Unbenutzte Zellen als #N/V ausgeben

Beispiele für fTables

Auswahlkriterien in den Zellen A1, A2 und A3:

Alle Dateien:

Alle, die mit "OA" beginnen:

Alle, in deren Name "MS" vorkommt:

Die Funktion fColumns

Die Funktion liefert Informationen über Felder von Dateien (physische und logische) zurück: Name, Typ, Dimensionen, Pufferposition, u.a.

Syntax von fCoumns

fColumns(bibliothek; tabelle; feldname ; spaltenüberschrift)

Die Parameter sind in Grossbuchstaben einzugeben:

bibliothek: Der Name einer Bibliothek/eine Schemas

tabelle: der Name einer Datei in der Bibliothek

Hier können Sie auch das Prozentzeichen (%) als Wildcard verwenden:

Beispiele:

ST% - findet alle Dateien, der Name mit "ST" beginnt
%KFZ% - findet alle Dateien mit "KFZ" im Namen, egal, was davor oder dahinter steht
%P - findet alle Dateien, dern Name mit "P" endet
ST%P - findet alle Dateien, deren Name mit "ST" beginnt und mit "P" endet

feldname: der Name des Feldes

Hier können Sie auch das Prozentzeichen (%) als Wildcard verwenden:

Beispiele:

ST% - findet alle Felder, der Name mit "ST" beginnt
%KFZ% - findet alle Felder mit "KFZ" im Namen, egal, was davor oder dahinter steht
%P - findet alle Felder, dern Name mit "P" endet
ST%P - findet alle Felder, deren Name mit "ST" beginnt und mit "P" endet

spaltenüberschrift: Überschriften, oder nicht

Gültige Werte:

0 - keine Überschriften
1 - Feldnamen
8 - Unbenutzte Zellen als #N/V ausgeben

Beispiele für fTables

Auswahlkriterien in den Zellen A1, A2, A3 und A4:

Alle Felder einer bestimmten Datei

Alle Felder aller Dateien in der Bibliothek
(hier sollte man aufpassen, dass man die Matrix gross genug aufzieht...)

Alle Felder aller Dateien, die "KDN" in ihrem Namen tragen

Alle Felder in Dateien, die auf "P" enden und deren Name "KMP" enthält