Abfragen
Das Abfragenmodul stellt die Möglichkeit zur Verfügung, in einer einfachen grafischen Oberfläche Abfragen an die diaLIMS-Datenbank zu erzeugen und zu speichern, um sie im täglichen Ablauf schnell ausführen zu können. Diese Abfragen können für zwei unterschiedliche Anwendungsfälle nutzbar sein:
-
Filter: Diese werden in anderen diaLIMS-Modulen zum Suchen von Datensätzen verwendet.
-
Auswertungen, Grafiken und Reports: Eine diaLIMS-Abfrage liefert beliebige Daten in einer vom Anwender jeweils definierten Struktur aus der Datenbank zurück. Die Daten können dann verwendet werden, um über eine Office-Anwendung automatisch einen Bericht aufbereiten zu lassen. Anwendungsbeispiele für Abfragen sind
-
- Listenauswertungen:
Proben und deren Parameterwerte einer Probenstelle des vergangenen Jahrs
-
Stammdatenübersichten:
Parameter und deren in den Stammdaten definierte Grenzwerte
-
Reports:
Rezepturberichte, Produktspezifikationen
Abfrage
Auf der Name-Seite werden die Angaben zu einer Abfrage vorgenommen, die diese eindeutig identifizieren und ihren Anwendungsbereich festlegen.
Name
-
Kurzbezeichnung
Kurzbezeichnung der Abfrage. Bei Filtern wird die Kurzbezeichnung und Beschreibung der Abfrage im Filterbereich angezeigt
-
Beschreibung
Ausführlichere Benennung der Abfrage, ggf. um den Zweck der Anfrage wiederzugeben.
Zuordnung
-
Hierarchiegruppe
-
Typ 1
Dient der Unterscheidung der Abfragen im Modul.
-
Modul
Auswahl, in welchem Modul der Filter verwendet werden soll. Jeder Abfragenfilter kann aufgrund seines Aufbaus nur in genau einem Modul funktionieren.
-
Einträge erzeugen
Über die Schaltfläche können auf Basis der Modulauswahl in der jeweiligen diaLIMS-Installation die korrekten Listeneinträge erzeugt werden. Bereits vorhandene Listeneinträge werden nicht nochmals angelegt.
Kreuztabelle
-
Kreuztabelle erzeugen
Die Ergebnistabelle wird nach der Ausführung der Abfrage automatisch in eine Kreuztabelle transformiert. Werden keine Werte für Transformier- und Wertespalte angegeben, passiert nichts.
-
Transformierspalte
Angabe, welche der Spalten in der Kreuztabelle als Transformierspalte verwendet werden soll.
-
Wertespalte
Angabe, welche der Spalten in der Kreuztabelle als Wertespalte verwendet werden soll.
Optionen
-
Abfragendialog einblenden
Dieser Schalter ist beim Neuanlegen einer Abfrage automatisch gesetzt.
-
aktiviert
Ist in der Abfrage das Häkchen "Abfragen-Dialog einblenden" gesetzt, können zunächst Kriterien eingetragen werden,bevor die Abfrage ausgeführt wird.
-
deaktiviert
Ist in der Abfrage das Häkchen "Abfragen-Dialog einblenden" nicht gesetzt, wird die Abfrage mit Standardzeilenfilterkriterien direkt ausgeführt.
-
-
Zutreffende Werte nicht anzeigen
Dieser Schalter bestimmt, ob im Filterbereich eines Moduls, wenn die entsprechende Abfrage ausgewählt ist, in den Zellen der Wert-Spalte eine Schaltfläche zum Anzeigen zutreffender Ergebnisse erscheint. Der Schalter ist beim Neuanlegen einer Abfrage nicht gesetzt.
Ergebnistabelle
-
Ausführen
Öffnet den Filter in einem Dialogfenster. Der Filter wird bei Bestätigen mit Ok mit den eingetragenen Kriterien ausgeführt.
-
Kreuztabelle erzeugen
Öffnet einen Dialog zur Angabe von Transformierspalte und Wertespalten. Nach der Angabe werden die Treffer in einer Kreuztabelle mit den angegebenen Spalten dargestellt.
Wird eine Kreuztabelle angezeigt, ändert sich die Schaltfläche in "Kreuztabelle zurücksetzen". Durch das Zurücksetzen werden die Filterergebnisse wieder in der flachen Tabellenform angezeigt.
Wenn die Abfrage nicht ausgeführt wurde oder keine Treffer ergab kann keine Kreuztabelle angezeigt werden.
-
Export
Erzeugt die Exportdateien für die Abfrage. Es wird ein Export der Abfrageergebnisse durchgeführt. Wenn die Abfrage zuvor nicht ausgeführt wurde, so wird nur eine Datei mit den Spaltenköpfen erzeugt. Wenn auf der Dateienseite der Export in eine Datei vorgesehen ist, wird ein Dateiauswahldialog angezeigt, der den Export mit der auf der Dateienseite definiertem Dateinamen vorschlägt. Ist der Export in eine Datei auf der Modulseite Dateien ausgewählt aber kein Dateiname benannt, so kann dieser im Dateiauswahldialog angegeben werden. Ist die direkte Übertragung der Daten auf der Dateien-Seite vorgesehen, kann ein Dateiname im Dateiauswahldialog angegeben werden, damit ein CSV-Export erfolgt.
-
Bericht
Wenn auf der Dateienseite der eine Vorlage für die Berichtserzeugung hinterlegt ist, so wird die Berichtserzeugung gestartet. Ist hierfür ein vorheriger Export von CSV-Dateien erforderlich, so wird dies automatisch durchgeführt.
Spaltenauswahl
Anhand der Seite Spaltenauswahl einer diaLIMS-Abfrage kann vorgegeben werden, welchen Aufbau die Ergebnistabelle der Abfrage bei deren Ausführung erhalten wird und mit welchen Inhalten diese zu füllen ist. In der Spaltenauswahl werden aus den verfügbaren Spalten einer ausgewählten Datenbanksicht die gewünschten Spalten der Abfrage zusammengestellt.
Die Tabelle der ausgewählten Spalten ist komplett editierbar. In der ersten Tabellenspalte "Spalte" können SQL-Funktionen auf die verwendeten Felder angewendet werden. Werden mehrere Funktionen in einer Spalte kombiniert, sollte der gesamte Ausdruck in runde Klammern eingeschlossen werden.
Übergabeparameter einer Funktion werden entsprechend des zulässigen Datentyps dargestellt. rtrim(char) bedeutet demnach, dass der Funktion char() nur ein Parameter des Typs Character übergeben werden kann.
Export Datentyp von Spalten definieren
Mit der Funktion können die Zellen einer Excel-Datei, die aus den Ergebnissen einer Abfrage erzeugt wurden, automatisch korrekt formatiert werden. Es ist nicht notwendig, die Zellen der erzeugten Datei manuell zu formatieren.
Das folgende Vorgehen beschreibt, wie Sie eine Abfrage so konfigurieren, dass die Spalten korrekt formatiert in eine Excel-Datei übertragen werden:
- Öffnen Sie das Modul
Abfragen - Wählen Sie die Abfrage aus, die Sie konfigurieren möchten
- Wechseln Sie auf den Reiter
Spaltenauswahl - Blenden Sie in der Tabelle
Ausgewählte Spaltendie SpalteExport Datentypein - Verwenden Sie für jede Spalte die Liste, um den gewünschten Typ auszuwählen
- Speichern Sie die Änderungen
Nachdem Sie die Konfiguration durchgeführt haben, werden die Spalten beim Export in eine Excel-Datei entsprechend formatiert.
-
Aktualisieren
Die verfügbaren Spalten werden entsprechend der hinterlegten Sicht aktualisiert. Sollte keine Sicht gesetzt sein, erscheint KEINE Fehlermeldung.
-
Schema
Das Datenbank-Schema, in welchem sich die Sicht befindet. Im diaLIMS gibt es 3 Standardschemata, in welchen sich die verschiedenen Sichten befinden:
-
dialims
Alle dialims-Tabellen sind in diesem Schema angelegt. Hier können einzelne Module abgefragt werden.
-
REBEWDAT
ReportBewegungsDaten - in diesem Schema befinden sich die wichtigsten Tabellen um Abfragen (Auswertungen) für Bewegungsdaten zu erstellen.
-
RESTADAT
ReportStammDaten - in diesem Schema befinden sich die wichtigsten Tabellen um Abfragen (Auswertungen) für Stammdaten zu erstellen.
-
FILTER
Ein Schema, in welchem verschiedene Modulfilter angelegt werden können.
-
Gegebenenfalls finden sich in der Auswahlliste noch weitere Schemata. Dies sind Systemschemata der Datenbank und können nicht abgefragt werden.
-
Sicht
In diesem Listenfeld werden die Sichten des ausgewählten Schemas angezeigt. Mit der Auswahl der Sicht wird die Liste der verfügbaren Spalten gefüllt. Die verfügbaren Spalten werden alphabetisch sortiert angezeigt, gegebenenfalls muss hierfür die Abfrage einmalig aktualisiert werden.
| Funktion | Beispiel | Beschreibung |
|---|---|---|
| ('') | ('Monatsbericht') | In einer Spalte wird kein Feld der Sicht ausgewählt, sondern es wird ausschließlich ein Freitext angegeben. Bei Ausführung der Abfrage steht in jeder Zeile dieser Spalte der in einfachen Hochkommata angegebene Begriff. |
| || | (PRODUKT || PRODUKTNAME) | Texte verketten. Es muss darauf geachtet werden, dass nur Elemente des Datentyps char verkettet werden. Gegebenenfalls müssen Elemente zunächst in char umgewandelt werden. |
| rtrim(char), ltrim(char) | rtrim(PRODUKT) | Leerzeichen rechts oder links abschneiden. |
| coalesce(char, char) | coalesce(PRODUKT, '-') | Prüfung, ob der erste übergebene Parameter null ist. Ist dies der Fall, wird der zweite angegebene Parameter statt des ersten Parameterwerts angezeigt. |
| char(int), char(double), char(date), char(timestamp) | char(PRIORITAET) | Einen beliebigen Datentyp zu einem Text (char) konvertieren. |
| char(date, EUR) | char(REGISTRIERDATUM, EUR) | Konvertiert ein Datum in einen Text (char) und formatiert in die übliche deutsche Schreibweise eines Datums um. |
| length(char) | length(PRODUKTNAME) | Ermittelt die Anzahl Zeichen eines übergebenen Parameters. |
| round(double, int) | round(WERT_NUM, 2) | Ein numerischer Wert wird auf die angegebene Anzahl Nachkommastellen gerundet. |
| decimal(double, int, int) | decimal(WERT_NUM, 10, 2) | Konvertiert eine Fließkommazahl in eine Dezimalzahl. Der zweite Parameter gibt die Anzahl der Stellen insgesamt an (Vor- + Nachkomma), der dritte Parameter die Nachkommastellen. |
| avg(double) | avg(WERT_NUM) | Bildet einen Mittelwert der übergebenen Werte. Gruppierung erforderlich. |
| stddev(double) | stddev(WERT_NUM) | Bildet die Standardabweichung der übergebenen Werte. Gruppierung erforderlich. |
| min(double) | min(WERT_NUM) | Findet den kleinsten der übergebenen Werte. Gruppierung erforderlich. |
| max(double) | max(WERT_NUM) | Findet den größten der übergebenen Werte. Gruppierung erforderlich. |
| count() | count(*), count(PROBE), count(distinct PROBE) | Zählt die Zeilen der Ergebnismenge. Gruppierung erforderlich. Die Angabe des * als Parameter zählt alle Zeilen einer Gruppe. Die Angabe einer Spalte als Parameter zählt die Anzahl der not null Zeilen in dieser Spalte. Mit vorangestelltem distinct werden nur die unterschiedlichen Einträge der genannten Spalte gezählt. |
| + - / * | WERT_NUM / 2 | Grundrechenarten können auf Spalten vom Typ double angewendet werden. |
Sortierung
Es darf hier keine Sortierung eingestellt werden. Eine Sortierung eines Filterergebnisses in der Abfrage ist nicht möglich und führt in der Regel zu Fehlermeldungen beim Ausführen des Filters. Die Sortierung des Abfrageergebnisses übernimmt immer das anzeigende Modul.
Zeilenfilter
Dies ist die eigentlich interessante Modulseite bei der Erzeugung eines Abfragenfilters, denn hier wird die Liste der Kriterien zusammengestellt, die dem Anwender später angeboten wird.
In der Auswahlliste Kriterium wird aus allen verfügbaren Spalten die erste gewünschte ausgewählt. In der Auswahlliste Vergleichstyp stehen verschiedene Operatoren für den Vergleich zur Verfügung. Ein passender wird ausgewählt.
Im Feld Vergleichswert kann ein Begriff eingetragen werden, der dem Anwender bei der späteren Verwendung dieses Filters als vorgeschlagener Filterwert für dieses Kriterium angeboten wird.
Mit der Schaltfläche Hinzufügen wird eine Kriterienzeile dem Filter hinzugefügt. Ein Filter kann aus beliebig vielen Kriterienzeilen bestehen. Die Zeilen können über die Pfeil-Schaltflächen sortiert werden.
Die Änderung von Kriterium, Vergleichstyp und Wert ist direkt in der Tabelle möglich. Hier kann außerdem
- Der Operator UND / ODER für die Verknüpfung mit der jeweils nächsten Kriterienzeile vorgegeben werden.
- Über die Kontrollkästchen Spalte / Vergleich / Wert / Operator änderbar kann für jede Zelle des späteren Modulfilters festgelegt werden, ob diese vom Anwender individuell geändert werden darf. Eine Änderung des Anwenders führt nicht zur Änderung der in diesem Modul eingestellten Standard-Kriterienzusammenstellung.
Dateien
Auf der Dateien-Seite kann die automatische Berichtserzeugung gesteuert werden. Hier geben Sie an, welche Vorlagen bei der Erstellung von Auswertungen und Berichten benutzt werden sollen und wie die automatische Datenübertragung vom diaLIMS in die Berichte erfolgen soll.
Die hier getroffenen Einstellungen werden ausgeführt, wenn Sie Ausführen auf der Seite Ergebnistabelle betätigen.
-
Ergebnisdaten automatisch weiterverarbeiten
Das Aktivieren dieses Schalters ist Voraussetzung dafür, dass bei Abfragen automatisch Berichte erzeugt werden können. Erst bei aktivem Schalter können weitere Angaben auf der Seite vorgenommen werden.
Exportdaten an Excel übertragen
Über diese Funktion werden zuerst Exportdateien erzeugt, welche dann vom “MS Excel” eingelesen werden.
Exportdatei erzeugen
-
Daten-Datei
Geben Sie hier an, in welche Datei die Daten für die Berichtserstellung geschrieben werden sollen. Es werden alle Daten gespeichert, welche durch die angegebenen Kriterien gefunden wurden.
-
Filterkriterien-Datei
Geben Sie hier an, in welche Datei die Parameter der Berichtserstellung geschrieben werden sollen. Es werden die Kriterien gespeichert, mit welchen die Abfrage ausgeführt wurden.
Direkte Übertragung in Excel-Datei
Die Option "Direkte Übertragung in Excel-Datei" überträgt die Ergebnistabelle direkt ohne vorher eine Exportdatei zu schreiben in die angegebene Excel-Datei. Die Excel-Datei muss im Feld Dateiname unter dem Punkt Vorlagendatei angegeben sein.
-
Datenblattseite
Angabe, auf welche Seite des Excel-Formulars die Export-Daten geschrieben werden sollen.
-
Filterkriterien-Seite
Angabe, auf welche Seite der Excel-Datei die Bedingungen der Abfrage, über welche die Export-Daten ermittelt wurden geschrieben werden sollen. Die Bedingungen der Abfrage erhalten Sie in einem Dialog-Fenster angezeigt, wenn Sie im Abfragen-Modul auf der Seite Ergebnistabelle
Ausführenbetätigen.
Die Seitenzahlen für die Datenblatt- und Filterkriterien-Seite dürfen nicht identisch sein.
Wird eine in der Vorlage nicht vorhandene Seite angegeben, wird die Berichtserzeugung mit einer Hinweismeldung abgebrochen
Vorlagen und Übersetzung
Vorlage automatisch öffnen
-
Vorlagendatei
Angabe, welche Vorlagendatei (i.d.R. Excel) für die Berichtserzeugung genutzt werden soll. Die Vorlagendatei wird beim Zuordnen in der Datenbank gespeichert. Sie müssen für die Ausführung der Abfrage Zugriffsberechtigung auf den Berichtspfad besitzen in dem die erzeugte Auswertungsdatei gespeichert wird.
-
Spezialablagepfad
Bericht übersetzen
-
Sprachspalte
Angabe, in welcher Spalte der Ergebnistabelle sich die Zielsprache (Kurzbezeichnung der Sprache) für Übersetzungen befindet.
-
Verkettungszeichen
Angabe des Verkettungszeichen einer Textfolge, die bei der Berichtserzeugung in eine Zelle exportiert wird. Diese Angabe ist wichtig für die Übersetzung. Der Standardwert ist "~". Eine Textfolge mit Verkettungszeichen wird bei Kreuztabellenberichten verwendet.
Produkte
Auf dieser Seite können Produkte angegeben werden, für welche diese Abfrage gültig ist. Beim Registrieren einer Probe zu diesem Produkt wird die Abfrage automatisch der Probe zugeordnet.
-
Produkt zuordnen
Zuordnung eines Produktes. Die Abfrage kann, über die Optionen gesteuert, automatisch bei Registrierung einer Probe mit einem hier aufgeführten Produkt zugeordnet und ausgeführt werden.
-
Produkt entfernen
Hebt die Zuordnung des Produktes zur Abfrage auf.
Probenstellen
Auf dieser Seite können Probenstellen angegeben werden, für welche diese Abfrage gültig ist. Beim Registrieren einer Probe mit der angegebenen Probenstelle wird die Abfrage automatisch der Probe zugeordnet.
-
Probenstelle zuordnen
Zuordnung eine Probenstelle. Die Abfrage kann, über die Optionen gesteuert, automatisch bei Registrierung einer Probe mit einer hier aufgeführten Probenstelle zugeordnet und ausgeführt werden.
-
Probenstelle entfernen
Hebt die Zuordnung der Probenstelle zur Abfrage auf.
SQL
SQL ist die Abkürzung fürStructured Query Language. Das ist eine standardisierte Datenbankabfragesprache für relationale Datenbanken. Mit Hilfe von SQL können Daten aus den Datenbanktabellen ausgelesen und für die Ausgabe umgewandelt und weiter verarbeitet werden. Jede im Abfragenmodul definierte Abfrage ermittelt beim Ausführen mit Hilfe von SQL die geforderten Daten aus der Datenbank.
Das auf der SQL-Seite im Abfragenmodul dargestellte SQL-Statement ist jedoch nicht für die Ausführung auf einer Datenbank nutzbar. Hier wird nicht das SQL-Statement angezeigt, dass beim Ausführen der Abfrage auf der Datenbank verwendet wird, sondern eine angepasste Version mit einer speziellen für diaLIMS angepassten Syntax. Das hier angezeigt SQL-Statement wird dafür genutzt, die gesamte Definition der Abrage von den Seiten Spaltenauswahl, Sortierung und Zeilenfilter festzuhalten und dauerhaft zu speichern.
Auf dieser Seite kann das diaLIMS-spezifische SQL-Statement manuell geändert werden. Aber Vorsicht, hierdurch kann schnell die gesamte Abfrage unbrauchbar werden. Daher sollten nur erfahrene diaLIMS-Administratoren diese Möglichkeit zur manuellen Änderung des SQL-Statement nutzen. Nutzen Sie anstelle dessen die Möglichkeiten auf den genannten anderen Seiten. Sie können dann auf der SQL-Seite die dadurch generierten Änderungen nachvollziehen.
In der folgenden Tabelle wird eine kurze Erklärung zum Aufbau des diaLIMS-spezifischen SQL-Statements gegeben.
|
|
Startanweisung zum Suchen von Daten aus einer Datenbank mit der Vorgabe, keine mehrfachen gleichen Zeilen zu ermitteln. |
|
|
Angabe der gesuchten Datenbankfelder, ggf. mehrere mit Komm getrennt und angegeben auf der Seite Spaltenauswahl. |
|
|
Angabe des Schemas und des Views, der durchsucht werden soll, angegeben auf der Seite Spaltenauswahl. |
|
Angabe des Bedingungenblocks, angegeben auf der Seite Zeilenfilter.
|
Über diese Schaltfläche kann, bei defektem Zeilenfilter, dieser neu aus dem SQL erstellt werden.
Extra-SQL
Auf der Seite Extra-SQL kann ein SQL-Statement angegeben werden, welches statt des Statements auf der Seite SQL ausgeführt wird. Dies wird insbesondere für spezielle Abfragen benötigt, welche auf Funktionen zurückgreifen, die im Zeilenfilter nicht zur Verfügung stehen.
Es ist möglich beim Extra-SQL auf die Kriterienwerte des Zeilenfilters zuzugreifen. Dafür wird der Name des Kriteriums (Spaltenname der View) mit Fragezeichen umschlossen verwendet. Beim Ausführen der Abfrage müssen für diese verwendeten Kriterien Werte eingetragen sein. Beispiel an der Abfrage "Letzte Proben". Der Kriterienwert des Kriteriums Anzahl wird folgendermaßen ermittelt: select oid from filter.letzteproben order by erstellung desc fetch first ?Anzahl? rows only
Im Extra-SQL kann auch die komplette Where-Klausel der Abfrage verwendet werden (Seite SQL). Dafür wird anstatt der Where-Klausel das Schlüsselwort ?WHERE_CLAUSE? eingegeben (das Wort where darf dann nicht mehr im Extra-SQL vorhanden sein). Beim Ausführen der Abfrage müssen in dem Fall nicht alle Kriterienwerte eingetragen sein. Die Whereklausel wird entsprechend so generiert, dass die nicht verwendeten Kriterienwerte ignoriert werden (analog zu einer Abfrage ohne Extra-SQL).
Die Where-Klausel, die durch ?WHERE_CLAUSE? eingefügt wurde, kann auch durch weitere Where-Bedingungen erweitert werden, indem diese hinten angehängt werden (z.B. beginnend mit AND oder OR). In diesem Fall muss jedoch sichergestellt werden, dass in den Kriterien mindestens ein Kriterienwert eingetragen ist, z.B. indem ein Kriterienwert des Zeilenfilters nicht editierbar gemacht wird.
DDL
DDL ist die Abkürzung für Data Definition Language. Mit Hilfe eines DDL-Statements kann die Datenbankstruktur geändert werden, also z.B. Tabellen und Sichten (Views) angelegt, gelöscht und geändert werden. Jede im diaLIMS definierte Abfrage basiert auf einer Sicht. Es wird immer eine Sicht benötigt, über den die Abfrage die Daten ermittelt. Ein direkter Zugriff von einer Abfrage auf eine Tabelle ist nicht möglich. Eine Sicht führt mehrere relationale Tabellen mithilfe der Schlüsselbeziehungen (Foreign Keys) zusammen (Join) und ermöglicht so, den Zugriff auf Daten aus unterschiedlichen Tabellen in einem einfachen SQL-Statement.
Auf der DDL-Seite kann die für die Abfrage benötigte Sicht angelegt und angepasst werden. Weiterhin werden hier für die Sicht alle notwendigen Konfigurationen vorgenommen, wie z.B. die Zugriffsrechte und die Spaltenbenennungen. Dafür wird ein DDL-Skript benötigt, in dem entsprechende DDL-Statements in der folgenden Reihenfolge enthalten sein müssen:
- Drop: Löschen der Sicht
- Create: Anlegen der Sicht
- Grant: Festlegung der Zugriffsrechte auf die Sicht
- Comments: Kommentare auf Schema, Sicht und Spalten für eine verständlichere Darstellung der Spaltennamen in den Abfragedialogen und Filtertabellen.
Ein DDL-Skript muss i.d.R. nicht komplett manuell geschrieben werden. Es kann mit Hilfe der Funktion DDL-Skript erzeugen automatisch generiert werden. Voraussetzung dafür ist, dass bereits eine vorhandene Sicht auf der Seite Spaltenauswahl ausgewählt wurde. Bei der automatischen Erzeugung des DDL-Skriptes werden alle benötigten DDL-Statements in der richtigen Reihenfolge generiert. Außerdem werden automatisch verständliche und gut lesbare Spaltennamen bzw. Spaltenkommentare erzeugt, die bei der Nutzung der Abfrage angezeigt werden.
Die beste Vorgehensweise für die Erzeugung einer neuen Sicht ist die folgende:
- Erzeugen Sie eine neue Abfrage und wählen Sie auf der Seite Spaltenauswahl eine Sicht aus, die der neu zu erstellenden Sicht ähnlich ist. Alternativ wählen Sie eine bereits existierende ähnliche Abfrage aus und erstellen Sie davon eine Kopie.
- Erzeugen Sie auf der DDL-Seite das DDL-Skript mit Hilfe der Funktion DDL-Skript erzeugen.
- Löschen Sie im DDL-Skript alle DDL-Statements (Drop, Grant und Comments) außer dem Create-Statement.
- Benennen Sie im Create-Statement die Sicht um und führen Sie das DDL-Skript mit Hilfe der Funktion DDL-Skript ausführen aus. Dadurch wird eine neue Sicht mit dem von Ihnen gesetzten Namen erzeugt.
- Wechseln Sie auf die Seite Spaltenauswahl und wählen Sie in der Auswahlliste die neu erzeugte Sicht aus. Sollte sich diese noch nicht in der Auswahl befinden, klicken Sie auf den Funktionsknopf Aktualisieren.
- Nun ist die Abfrage mit der neuen Sicht verknüpft. Speichern Sie die Abfrage.
- Wechseln Sie wieder auf die Seite DDL und erzeugen Sie dort wieder das DDL-Skript mit Hilfe der Funktion DDL-Skript erzeugen.
- Machen Sie nun die benötigten Änderungen im Create-Statement und führen Sie am Ende das DDL-Skript erneut aus.
- Erzeugen Sie nun wiederum das DDL-Skript. Durch diese wiederholte Erzeugung werden zu den manuell im Create-Statement gemachten Änderungen die passenden Spaltenbenennungen und Spaltenkommentare generiert. Sie sollten daher nach jeder Änderung und Ausführung des DDL-Skriptes das DDL-Skript neu erzeugen.
- Sie haben nun die neue, angepasste Sicht angelegt und können diese nun benutzen.
Die Funktionen der DDL-Seite sollten nur von erfahrenen diaLIMS-Administratoren verwendet werden. Unbedarfte Änderungen an Sichten und DDL-Skripten können die Abfragen unbrauchbar machen. Erzeugen Sie immer eine Sicherheitskopie der Abfrage bevor Sie Änderungen am DDL-Skript vornehmen.
-
DDL-Skript erzeugen
Erzeugt das DDL-Skript für die auf der Seite Spaltenauswahl angegebenen Sicht. Achtung, ein vorhandenes DDL-Skript wird dabei überschrieben.
-
DDL-Skript ausführen
Führt das gesamte DDL-Skript oder den markierten Teil des DDL-Skriptes aus. Dabei öffnet sich ein Vorgangsdialog in dem die einzelnen ausgeführten DDL-Statements angezeigt werden. Kann ein DDL-Statement nicht fehlerfrei ausgeführt werden, erscheint eine entsprechende Fehlermeldung. Die weitere Ausführung des DDL-Skriptes kann dann abgebrochen oder fortgesetzt werden. Im Vorgangsdialog werden alle auch bereits vorher ausgeführten DDL-Statements angezeigt, ggf. auch solche aus anderen Abfragen. Durch Klick auf den Funktionsknopf Löschen wird die Ausgabe im Vorgangsdialog geleert, Schließen schließt den Dialog.
DDL-Statement zu einer Abfrage generieren
Funktion benutzen
Mit der Funktion kann ein DDL-Statement für die direkten Attribute einer Klasse erstellen.
- Öffnen Sie das Modul
Abfragen. - Wechseln sie auf die Notizbuchseite DDL
- Klicken sie auf den Button
DDL-Generator - Vergeben sie einen noch nicht vergebenen Datenbank-View-Namen
- Wählen sie die Klasse aus, zu der sie das DDL-Statement generieren möchten
- Wählen sie wahlweise einzelne Spalten aus oder betätigen sie den Button
Direkte Referenzen auswählen - Betätigen sie den Button
DDL generieren
Note: Die Funktion ist aktuell nur für 1:N Referenzen verwendbar.
Vordefinierte Variablen / Funktionen für Abfrage-Kriterien.
In Abfragekriterien (Spalte "Wert") können aktuell datenbankspezifische SQL-Variablen (wie z.B. "current date" unter DB2) verwendet werden. Diese SQL-Variablen unterscheiden sich jedoch von DB-System zu DB-System. Für bestimmte Anwendungsfälle gibt es auch keine SQL-Variable, z.B. für den "Kürzel des angemeldeten diaLIMS-Benutzers". Gerade diese Variable wird oft benötigt, um z.B. im Dashboard Benutzer-bezogene Auswertungen machen zu können um so die offenen Urlaubstage einer Ressource zu bestimmen.
Funktion benutzen
Mit Hilfe von vordefinierten Variablen bzw. Funktionen können Abfragekriterien flexibler eingestellt werden. Beim Verwenden muss auf Folgendes geachtet werden:
- Variable bzw. Funktion startet mit
$ - Wenn Variable /bzw. Funktion keine Parameter hat, kann sie ohne Klammern angegeben werden.
$current_time()und$current_timeist gleich. - Bei der Schreibweise ist auf Groß- und Kleinschreibung zu achten.
- Variablen bzw. Funktionen können als Parameter in anderen Variablen bzw. Funktionen verwendet werden.
$plus_months($last_year_begin, 1)oder$minus_days($current_date, 5).
|
Name von der Variable bzw. Funktion |
Aliases |
Wert |
|---|---|---|
|
|
|
Aktuelle Zeit bis zur Sekunde. Geeignet für Spalten vom Typ |
|
|
|
Aktuelles Timestamp bis zur Sekunde. Geeignet für Spalten vom Typ |
|
|
|
Aktuelles Datum. Geeignet für Spalten vom Typ |
|
|
|
Datum von gestern. Geeignet für Spalten vom Typ |
|
|
|
Datum von morgen. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) der aktuellen Woche. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) der aktuellen Woche. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) der nächsten Woche. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) der nächsten Woche. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) der letzten Woche. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) der letzten Woche. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) des aktuellen Monat. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) des aktuellen Monat. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) des nächsten Monat. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) des nächsten Monat. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) des letzten Monat. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) des letzten Monat. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) des aktuellen Jahr. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) des aktuellen Jahr. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) des nächsten Jahr. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) des nächsten Jahr. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Beginn (der erste Tag) des letzten Jahr. Geeignet für Spalten vom Typ |
|
|
|
Datum vom Ende (der letzte Tag) des letzten Jahr. Geeignet für Spalten vom Typ |
|
|
|
Datum in |
|
|
|
Datum vor |
|
|
|
Datum in |
|
|
|
Datum vor |
|
|
|
Datum in |
|
|
|
Datum vor |
|
|
|
Datum in |
|
|
|
Datum vor |
|
|
|
Kurzbezeichnung des angemeldeten Benutzers. Geeignet für Spalten vom Typ |
|
|
|
Kurzbezeichnung der Benutzer-Gruppe des angemeldeten Benutzers. Geeignet für Spalten vom Typ |
|
|
|
Kurzbezeichnung des Ansprechpartners, der am angemeldeten Benutzer gesetzt ist. Geeignet für Spalten vom Typ |
|
|
|
Kurzbezeichnung der Ressource, die dem selben Ansprechpartner zugeordnet ist. Geeignet für Spalten vom Typ |
|
|
|
Wandelt alle Buchstaben des übergebenen |
|
|
|
Wandelt alle Buchstaben des übergebenen |
Abfragen-Seite
Auf der Name-Seite des Abfragenmoduls muss der Modulfilter im Feld Modul-Schlüssel das Modul zugewiesen erhalten, für welches der Filter angelegt wird. Erst dadurch ist es anschließend möglich, den Filter im entsprechenden Modul zu verwenden. Für die Zuordnung wird ein interner Modul-Schlüssel verwendet, der für jedes Modul im Service-Modus in einem Kurzinfo-Fenster eingeblendet werden kann.
Zusätzlich sollte für die Abfrage in einem der Typ-Felder der Eintrag Filter ausgewählt werden. Dadurch kann im Modul Abfragen leichter nach diesem Filter gesucht werden.
Spaltenauswahl
In der Auswahlliste Schema muss der Eintrag „Filter“ ausgewählt sein.
Nach der Auswahl des Schemas werden in der Auswahlliste Sicht die möglichen Einträge zur Verfügung gestellt. Hier muss eine Sicht gewählt werden, die für einen Abfragenfilter im gewünschten Modul geeignet ist. Typischerweise lautet der Name der Sicht genauso wie das Modul.
Aus der dann angezeigten Liste „Verfügbare Spalten“ wird ausschließlich die Spalte OID ausgewählt und nach rechts in die Liste „Ausgewählte Spalten“ übertragen. Funktioniert ein Filter in einem Modul irgendwann einmal nicht mehr, sollte diese Stelle kontrolliert werden. Falsche Einträge in dieser Liste gehören zu den häufigsten Fehlern bei der Erstellung von Abfragenfiltern.
Zeilenfilter
Das Kontrollkästchen Keine gleichen Zeilen unten auf der Modulseite muss gesetzt werden.
Bei Änderungen am Zeilenfilter sind auch auf diesem Filter basierende gespeicherte Modulschnellfilter betroffen und können nicht mehr korrekt verwendet werden.
Ab Programmversion 8 werden die Modulschnellfilter automatisch an die Änderungen der Abfrage angepasst. Bei Änderungen, die sich auf die Trefferliste des Schnellfilters auswirken könnten, wird der Anwender informiert. Anschließend können die Schnellfilter deaktiviert oder angepasst und weiter verwendet werden.
Abfragen für Auswertungen
Duplizieren von Abfragen
Soll ein Filter für ein Modul neu angelegt werden, ist es am einfachsten, einen bereits bestehenden Filter dieses Moduls zu kopieren. Es müssen dann nur noch Änderungen in der Benennung von Kurzbezeichnung und Beschreibung sowie in der Definition des Zeilenfilters gemacht werden. Alle anderen relevanten Filtereinstellungen müssen auch beim neuen Filter identisch sein zu denen des Quellfilters.
Spezielle Funktionen
-
Abfragen exportieren
Bestehende Abfragen können aus diaLIMS heraus exportiert und als XML-Datei gespeichert werden. In dieser Datei ist die koplette Abfrage (bestehend aus Abfragendefinition, Vorlagendatei und DDL-Text) enthalten. Die zu exportierende Abfrage muss im Abfragenmodul ausgewählt werden. Nach dem Anklicken des Symbols "Abfrage exportieren" kann ein Speicherort für den Export ausgewählt werden.
-
Abfragen importieren
Der Import einer exportierten XML-Datei in diaLIMS ist ebenso möglich. Nach dem Anklicken des Symbols "Abfrage importieren" kann eine XML-Datei ausgewählt werden. Sollte es nach dem Import zu einer Fehlermeldung kommen, müssen alle Befehle auf der Modul-Seite DDL der neu importierten Abfrage ausgeführt (Schaltfläche "Ausführen") werden. Für diesen Schritt ist eine diaLIMS-Anmeldung mit Datenbank-Administrator-Rechten erforderlich.
-
DDL erzeugen
Erzeugt für alle selektierten Abfragen das DDL neu. Über das DDL werden die Spalten für eine Abfrage ermittelt und dem Benutzer das Recht gegeben diese auszulesen. Vor und nach Änderungen an der Abfrage sowie nach dem Import vorbereiteter Abfragen sollte das DDL immer ausgeführt werden.
Statusmanagement
Obwohl Abfragen als Bewegungsdaten angelegt werden, haben sie für die Statusübergänge die Funktionen der Stammdaten. Sie können also nur in die folgenden Status überführt werden:
-
Zulassen
Der Datensatz wird auf "zugelassen" gesetzt und damit für die Verwendung in anderen Modulen freigegeben. Änderungen am Datensatz sind möglich. Alle Stammdaten werden im Status "Zugelassen" angelegt.
-
Sperren
Der Datensatz wird gesperrt. Er kann in anderen Modulen nicht mehr verwendet werden. Es ist möglich, Änderungen vorzunehmen.
-
Stornieren
Der Status des Datensatzes wird auf "storniert" gesetzt. Dies kann der Fall sein, wenn ein Datensatz nicht mehr benötigt wird, weil er fehlerhaft oder unnötig geworden ist. Stornieren ist die Alternative zum Löschen eines Datensatzes, da in vielen Modulen die Zuordnungsnummern einmalig vergeben werden und gelöschte Nummern nicht wieder neu vergeben werden. Durch das Stornieren wird eine Nachvollziehbarkeit der Nummernvergabe vereinfacht, da keine Lücken in der Vergabe der Zuordnungsnummern auftreten. Am Datensatz können keine Änderungen mehr vorgenommen werden.
Allgemeine Technik
Werden in einem Modul mittels der Lupe Datensätze aus der Datenbank geladen, wird grundsätzlich ein select * auf die Datenbank abgesetzt, um die benötigten Informationen zu laden. Beispiel Modul Proben:
SELECT * FROM dialims.proben;
Um die zu ladende Menge an Datensätzen einzuschränken kann dem Statement eine Where-Bedingung angehängt werden. Hierbei unterstützen diaLIMS-Module aber nur die Bedingung auf das Feld OID, welches in jeder diaLIMS-Tabelle als Spalte vorhanden ist. Soll nur eine einzige Probe geladen werden, müsste das auszuführende SQL-Statement also folgendermaßen lauten:
SELECT * FROM dialims.proben WHERE oid = '0.101.123';
Wie oben beschrieben stellt ein diaLIMS-Abfragenfilter ein SQL-Statement dar. Dieses fragt als einziges Feld die OID ab. Bei der Verwendung eines Abfragenfilters wird das SQL-Statement der Abfrage als Subselect der SELECT * Anweisung im jeweiligen Modul verwendet und erreicht so eine interaktive Filterung der Datenmenge.
SELECT * FROM dialims.proben WHERE oid IN (
SELECT OID FROM filter.proben
WHERE registrierdatum >= current date
AND status in ('R','A','W')
);
Dies erklärt die beiden wichtigen Regeln, dass in Filterabfragen
- nur die Spalte OID ausgewählt werden darf
- kein ORDER BY verwendet werden darf. ORDER BY ist in den meisten DBM für SUBSELECTs nicht vorgesehen.
Optionen / Einstellungen
-
SemaphorTimeoutTimeout-Zeit in Sekunden [s] für das Warten auf einen externen Prozess
-
RequestSetWaitTimeWartezeit zwischen dem Ausführen zweier Abfragen in Millisekunden [ms]