Zum Hauptinhalt springen

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:

  1. Filter: Diese werden in anderen diaLIMS-Modulen zum Suchen von Datensätzen verwendet.

  2. 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:

  1. Öffnen Sie das Modul Abfragen
  2. Wählen Sie die Abfrage aus, die Sie konfigurieren möchten
  3. Wechseln Sie auf den Reiter Spaltenauswahl
  4. Blenden Sie in der Tabelle Ausgewählte Spalten die Spalte Export Datentyp ein
  5. Verwenden Sie für jede Spalte die Liste, um den gewünschten Typ auszuwählen
  6. 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.

FunktionBeispielBeschreibung
('')('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 / 2Grundrechenarten 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ühren betätigen.

hinweis

Die Seitenzahlen für die Datenblatt- und Filterkriterien-Seite dürfen nicht identisch sein.

hinweis

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.

select distinct

Startanweisung zum Suchen von Daten aus einer Datenbank mit der Vorgabe, keine mehrfachen gleichen Zeilen zu ermitteln.

OID

Angabe der gesuchten Datenbankfelder, ggf. mehrere mit Komm getrennt und angegeben auf der Seite Spaltenauswahl.

from FILTER.PROBEN

Angabe des Schemas und des Views, der durchsucht werden soll, angegeben auf der Seite Spaltenauswahl.

  • where strue vtrue wtrue otrue REGISTRIERDATUM >=
  • AND strue vtrue wtrue otrue STATUS not in ( 'F' , 'S')
  • AND strue vtrue wtrue otrue LABOR =
  • AND strue vtrue wtrue otrue LABORABTEILUNG =<

Angabe des Bedingungenblocks, angegeben auf der Seite Zeilenfilter.

  • AND - Verknüpfung der Zeilen miteinander, angegeben als Operator
  • strue / sfalse - Spalte editierbar oder nicht
  • vtrue / vfalse - Vergleich editierbar oder nicht
  • wtrue / wfalse - Wert editierbar oder nicht
  • otrue / ofalse - Operator editierbar oder nicht
  • Registrierdatum - Kriterium, welches überprüft werden soll
  • >= - Vergleich als SQL-Ausdruck
Parse SQL

Ü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.
hinweis

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.

  1. Öffnen Sie das Modul Abfragen.
  2. Wechseln sie auf die Notizbuchseite DDL
  3. Klicken sie auf den Button DDL-Generator
  4. Vergeben sie einen noch nicht vergebenen Datenbank-View-Namen
  5. Wählen sie die Klasse aus, zu der sie das DDL-Statement generieren möchten
  6. Wählen sie wahlweise einzelne Spalten aus oder betätigen sie den Button Direkte Referenzen auswählen
  7. 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_time ist 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

$current_time

$now, $jetzt

Aktuelle Zeit bis zur Sekunde. Geeignet für Spalten vom Typ Time

$current_timestamp

$timestamp

Aktuelles Timestamp bis zur Sekunde. Geeignet für Spalten vom Typ Timestamp

$current_date

$today, $heute

Aktuelles Datum. Geeignet für Spalten vom Typ Date

$yesterday

$gestern

Datum von gestern. Geeignet für Spalten vom Typ Date

$tomorrow

$morgen

Datum von morgen. Geeignet für Spalten vom Typ Date

$current_week_begin

$week_begin, $woche_beginn

Datum vom Beginn (der erste Tag) der aktuellen Woche. Geeignet für Spalten vom Typ Date

$current_week_end

$week_end, $woche_ende

Datum vom Ende (der letzte Tag) der aktuellen Woche. Geeignet für Spalten vom Typ Date

$next_week_begin

$naechste_woche_beginn

Datum vom Beginn (der erste Tag) der nächsten Woche. Geeignet für Spalten vom Typ Date

$next_week_end

$naechste_woche_ende

Datum vom Ende (der letzte Tag) der nächsten Woche. Geeignet für Spalten vom Typ Date

$last_week_begin

$letzte_woche_beginn

Datum vom Beginn (der erste Tag) der letzten Woche. Geeignet für Spalten vom Typ Date

$last_week_end

$letzte_woche_ende

Datum vom Ende (der letzte Tag) der letzten Woche. Geeignet für Spalten vom Typ Date

$current_month_begin

$month_begin, $monat_beginn

Datum vom Beginn (der erste Tag) des aktuellen Monat. Geeignet für Spalten vom Typ Date

$current_month_end

$month_end, $monat_ende

Datum vom Ende (der letzte Tag) des aktuellen Monat. Geeignet für Spalten vom Typ Date

$next_month_begin

$naechster_monat_beginn

Datum vom Beginn (der erste Tag) des nächsten Monat. Geeignet für Spalten vom Typ Date

$next_month_end

$naechster_monat_ende

Datum vom Ende (der letzte Tag) des nächsten Monat. Geeignet für Spalten vom Typ Date

$last_month_begin

$letzter_monat_beginn

Datum vom Beginn (der erste Tag) des letzten Monat. Geeignet für Spalten vom Typ Date

$last_month_end

$letzter_monat_ende

Datum vom Ende (der letzte Tag) des letzten Monat. Geeignet für Spalten vom Typ Date

$current_year_begin

$year_begin, $jahr_beginn

Datum vom Beginn (der erste Tag) des aktuellen Jahr. Geeignet für Spalten vom Typ Date

$current_year_end

$year_end, $jahr_ende

Datum vom Ende (der letzte Tag) des aktuellen Jahr. Geeignet für Spalten vom Typ Date

$next_year_begin

$naechstes_jahr_beginn

Datum vom Beginn (der erste Tag) des nächsten Jahr. Geeignet für Spalten vom Typ Date

$next_year_end

$naechstes_jahr_ende

Datum vom Ende (der letzte Tag) des nächsten Jahr. Geeignet für Spalten vom Typ Date

$last_year_begin

$letztes_jahr_beginn

Datum vom Beginn (der erste Tag) des letzten Jahr. Geeignet für Spalten vom Typ Date

$last_year_end

$letztes_jahr_ende

Datum vom Ende (der letzte Tag) des letzten Jahr. Geeignet für Spalten vom Typ Date

$plus_days({DATE}, {COUNT})

$plus_tage({DATE}, {COUNT})

Datum in {COUNT} Tagen von {DATE}. Geeignet für Spalten vom Typ Date

$minus_days({DATE}, {COUNT})

$minus_tage({DATE}, {COUNT})

Datum vor {COUNT} Tagen von {DATE}. Geeignet für Spalten vom Typ Date

$plus_weeks({DATE}, {COUNT})

$plus_wochen({DATE}, {COUNT})

Datum in {COUNT} Wochen von {DATE}. Geeignet für Spalten vom Typ Date

$minus_weeks({DATE}, {COUNT})

$minus_wochen({DATE}, {COUNT})

Datum vor {COUNT} Wochen von {DATE}. Geeignet für Spalten vom Typ Date

$plus_months({DATE}, {COUNT})

$plus_monate({DATE}, {COUNT})

Datum in {COUNT} Monaten von {DATE}. Geeignet für Spalten vom Typ Date

$minus_months({DATE}, {COUNT})

$minus_monate({DATE}, {COUNT})

Datum vor {COUNT} Monaten von {DATE}. Geeignet für Spalten vom Typ Date

$plus_years({DATE}, {COUNT})

$plus_jahre({DATE}, {COUNT})

Datum in {COUNT} Jahren von {DATE}. Geeignet für Spalten vom Typ Date

$minus_years({DATE}, {COUNT})

$minus_jahre({DATE}, {COUNT})

Datum vor {COUNT} Jahren von {DATE}. Geeignet für Spalten vom Typ Date

$current_user

$user, $benutzer

Kurzbezeichnung des angemeldeten Benutzers. Geeignet für Spalten vom Typ Benutzer und Text

$current_user_group

$user_group, $benutzer_gruppe, $user_role, $benutzer_rolle

Kurzbezeichnung der Benutzer-Gruppe des angemeldeten Benutzers. Geeignet für Spalten vom Typ BenutzerGruppe und Text

$current_contact

$contact, $kontakt

Kurzbezeichnung des Ansprechpartners, der am angemeldeten Benutzer gesetzt ist. Geeignet für Spalten vom Typ Ansprechpartner und Text

$current_resource

$resource, $ressource

Kurzbezeichnung der Ressource, die dem selben Ansprechpartner zugeordnet ist. Geeignet für Spalten vom Typ Ressource und Text

$lower({TEXT})

$klein({TEXT})

Wandelt alle Buchstaben des übergebenen TEXTes in Kleinbuchstaben um. Geeignet für Spalten vom Typ Text

$upper({TEXT})

$groß({TEXT})

Wandelt alle Buchstaben des übergebenen TEXTes in Großbuchstaben um. Geeignet für Spalten vom Typ Text

## Abfragen als Modulfilter

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.

hinweis

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​

  • SemaphorTimeout

    Timeout-Zeit in Sekunden [s] für das Warten auf einen externen Prozess

  • RequestSetWaitTime

    Wartezeit zwischen dem Ausführen zweier Abfragen in Millisekunden [ms]