Datenbanken und Formelsprache
Daten lesen
Die Verwendung der beiden Funktionen @DBColumn und @DBLookup entspricht im Kontext von ODBC dem in Lotus Notes-Datenbanken. Während @DBColumn die Werte einer Spalte aus einer Tabelle ausliest, können Sie mit @DBLookup unter Angabe eines Schlüsselwertes nach den entsprechenden Daten suchen.
Die allgemeine Syntax der Funktion @DBColumn lautet
@DbColumn("ODBC" : <Cache>; <Quelle>; <Benutzer1> :
<Benutzer2>; <Kennwort1> : <Kennwort2>; <Tabelle>;
<Spalte> : <Nullwerte>; "Distinct" : <Sort>)
Die Angabe eines oder mehrerer Benutzer und der zugehörigen Kennwörter ist nur erforderlich, wenn sie vom verwendeten DBMS verlangt werden. Beim Auslesen der Werte können doppelte Datensätze mit der Angabe des Parameters Distinct unterdrückt werden. Bei dessen Verwendung können zusätzlich die Datensätze aufsteigend (Angabe von Ascending für den Parameter <Sort>) oder absteigend (Descending) sortiert werden.
Eine Erläuterung der einzelnen Parameter enthält Tabelle 1. Die Funktion @DBLookup verfügt über eine ähnliche Syntax:
@DbColumn("ODBC" : <Cache>; <Quelle>; <Benutzer1> :
<Benutzer2>; <Kennwort1> : <Kennwort2>; <Tabelle>;
<Spalte> : <Nullwerte>; <Keyspalte>; <Key>; "Distinct"
: <Sort>)
|
Parameter |
@DB- |
@DB- |
@DB- |
Beschreibung |
|
"Distinct" |
X |
X |
Der Parameter löscht doppelte Werte vor der Rückgabe an Lotus Notes Domino. | |
|
"ODBC" |
X |
X |
X |
Mit dieser Zeichenfolge wird festgelegt, dass der Zugriff auf eine ODBC Datenquelle erfolgen soll. |
|
<Benutzer1> : |
X |
X |
X |
Verlangt die externe Datenquelle einen autorisierten <Benutzer2> Zugriff, können Sie bis zu zwei Benutzer-IDs in Listenform angeben. Sollen diese nicht in der Formel gespeichert werden, verwenden Sie einen bzw. zwei Leerstrings "". Die Benutzernamen werden dann beim Zugriff abgefragt. Dies ist allerdings nur möglich, wenn der Befehl nicht im |
|
<Cache> |
X |
X |
X |
Zur Zwischenspeicherung der vom Server abgefragten Daten kann ein Cache verwendet werden. Zu diesem Zweck wird als Parameter ein Leerstring "" übergeben. Zur Aktualisierung des Caches verwenden Sie Recache (neu in Version 6). Soll bei jeder Ausführung eine Abfrage der externen Datenquelle ohne Verwendung eines Caches erfolgen, geben Sie NoCache an. |
|
<Kennwörter1> |
X |
X |
X |
Falls Benutzer-IDs angegeben werden, erfolgt die Angabe |
|
<Key> |
X |
Der Parameter enthält einen einzelnen Wert oder eine Liste von Werten der Typen Text, Zahl, Datum oder Zeit, nach dem in der <Keyspalte> gesucht wird. | ||
|
<Keyspalte> |
X |
Die Spalte, in der die bei <Key> übergebenen Werte gesucht werden. | ||
|
<Nullwerte> |
X |
X |
X |
Steuert die Behandlung der Nullwerte. Standard ist hier das Löschen der Werte und die Ausgabe der Meldung Warnung: Null-Werte von @DB-Liste entfernt. Dies ent spricht der Angabe des Parameters Discard. Alternativ kann über Fail die Abfrage abgebrochen oder in Hoch kommata "" eine Ersatzzeichenkette angegeben werden. |
|
<Quelle> |
X |
X |
X |
Der Name der definierten ODBC-Datenquelle. |
|
<Sort> |
X |
Bestimmt die Sortierreihenfolge. | ||
|
<Spalte> |
X |
X |
Der Parameter bestimmt die Spalte, aus welcher die Daten ausgelesen werden sollen. | |
|
<SQL-Befehlsfolge> |
X |
Der Parameter enthält die vom DBMS auszuführende folge> Befehlsfolge. | ||
|
<Tabelle> |
X |
X |
Angabe der Tabelle oder Ansicht, aus der die Daten bezogen werden sollen. Durch das Voranstellen des Besitzers können Sie – so dies vom verwendeten DBMS unterstützt wird – die Eindeutigkeit des Zugriffs gewährleisten. Verwenden Sie dafür die Punktnotation. Für eine Tabelle adressen, die dem Besitzer gast gehört, lautet der Zugriff beispielsweise: gast.adressen. |