Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Bereich "Datenbank"

Im Bereich Datenbank werden auf der linken Seite die vorhandenen Nachlagedefinitionen angezeigt. Auf der rechten Seiten werden die Eigenschaften der aktuell ausgewählten Nachschlagedefinition angezeigt. Über einen Klick auf den Button Copy.png wird eine Kopie der ausgewählten Definition erstellt.

Datenbankabfragen dienen in einer Indexierungsmaske primär dazu, Felder automatisch mit den Ergebniswerten dieser Datenbankabfragen zu befüllen. In einer Maske können mehrere Nachschlagedefinitionen genutzt werden.

interface_maskendesigner_datenbank.jpg

Basiseigenschaften

Feld

Beschreibung

Name

technischer Name der Datenbank-Nachschlagedefinition

Dieser Name ist zwingend erforderlich und muss innerhalb der Maske eindeutig sein.

Datenbank

Als zugreifbare Datenquellen werden dieselben Datenquellen unterstützt wie im Hauptprogramm (siehe Externe Datenquellen). Hier muss daher dieselbe Syntax wie im Hauptprogramm für die Verbindungs- und Abfragezeichenfolgen verwendet werden.

Feld

Beschreibung

Verbindungszeichenfolge

Verbindungszeichenfolge zur Datenbank

Passwort

Passwort, das in der Verbindungszeichenfolge benötigt wird

Das Passwort kann separat in Password definiert und über die Variable %Password% in die Zeichenfolge eingebunden werden.

Abfragezeichenfolge

Die Abfrage gegen die Datenbank erfolgt in Form einer SELECT-Anweisung. Zur Generierung dynamischer Abfragen, in denen aktuelle Feldinhalte als Filterkriterium dienen, können Feldvariablen in den Ausdruck eingebunden werden. Wenn eine OLEDB-Verbindung oder einer native SQL-Server-Verbindung verwendet wird, sollten typisierte Variablen in der Form @Feldname genutzt werden. Ansonsten beschränkt sich die Nutzung von Variablen auf eine Textersetzung mit %Feldname%. Der Ersetzungstext muss die für das jeweilige Datenbanksystem erforderliche Syntax haben.

Über einen Klick auf den Button ButtonConstant.png können die Feldvariablen, die in der Maske definiert sind, ausgewählt werden. Die ausgewählte Feldvariable wird an der aktuellen Cursor-Position oder Auswahl in die Abfragezeichenfolge eingefügt.

Über einen Klick auf den Button Query.png kann die Datenbankabfrage testweise ausgeführt werden. Wenn in der Zeichenfolge Feldvariablen verwendet werden, müssen vor der Ausführung Testwerte für die Variablen angegeben werden. Das Abfrageergebnis wird in einem weiteren Dialog angezeigt. In diesem Dialog ist auch die Selektion von Spalten der Ergebnisdatensätze verfügbar. Über einen Klick auf Spalten übernehmen werden die Indexnummern der gewählten Spalten als Vorgabewerte für die Auto-Füll-Felder gesetzt.

Feldzuordnung

Feld

Beschreibung

Trigger-Feld

Name des Feldes, das den Datenbankzugriff auslöst

Standardmäßig erfolgt dieses nach Änderung eines Feldwertes. In der Regel wird diese Option genutzt, wenn ein eindeutiges Abfrageergebnis erwartet wird. Das ist z. B. der Fall, wenn das auslösende Feld einen eindeutigen Schlüssel darstellt, der als Filter in der Abfrage genutzt wird und genau einen Ergebnisdatensatz zurückliefert, aus dessen Werten weitere Felder befüllt werden.

Wenn hingegen die nachfolgende Eigenschaft Nachschlagetabelle gesetzt ist, wird neben dem Feld eine Button angezeigt, über den der Benutzer aktiv die Abfrage starten muss. Das Ergebnis wird dem Benutzer in Form einer Tabelle angezeigt, aus der dieser manuell den gewünschten Satz auswählen kann. In dieser Tabellendarstellung hat der Benutzer die Möglichkeit, das Ergebnis weiter zu filtern und nach Spalten zu sortieren. Diese Form der Abfrage ist dafür ausgelegt, dem Benutzer den Inhalt kompletter Datenbanktabellen oder eine grob vorgefilterte Teilmenge davon zur Auswahl anzubieten.

Demselben Feld können mehrere Datenbank-Nachschlagedefinitionen zugeordnet werden, die nacheinander ausgeführt werden. Nur eine Nachschlagedefinition kann dabei vom Typ "Nachschlagetabelle" sein. Das Erstellen von Kaskaden von Abfragen ist ebenfalls möglich, d.h. ein Feld, das aus einem Abfrageergebnis befüllt wurde, löst durch diese Änderung eine weitere Abfrage aus.

Nachschlagetabelle

Legt fest, ob das Abfrageergebnis als Nachschlagetabelle dargestellt wird.

Auto-Füll-Felder

Definition der Felder, die aus dem Ergebnisdatensatz der Abfrage automatisch gefüllt werden

Wenn das auslösende Feld selbst auch befüllt werden soll, muss dieses Feld hier ebenfalls angegeben werden. Die Zuordnung von Quellfeldern zu Zielfeldern erfolgt über die Indexnummer (beginnend bei 1) des Quellfeldes im Ergebnisdatensatz und den Namen des Zielfeldes. Wenn die Liste der Feldzuordnungen anhand einer testweise ausgeführten Datenbankabfrage automatisch vorbelegt wurde, werden zusätzlich die Namen der Quellfelder in der Liste angezeigt. Diese Namen haben keine technische Relevanz, sondern sind rein informativ.