Standard-Importschnittstelle
diaLIMS bietet ein Standardimport-Modul für den Import von Proben- und Ergebnisdaten. Dieses Importmodul erfordert die Bereitstellung einer Importdatei mit einem definierten Aufbau.
Dateiaufbau
Dateiaufbau für das Standardimport-Modul
- <Dateiattribut1>
- <Dateiattribut2>
- <Dateiattribut3>
- <Dateiattribut4>
- <Gruppenwechsel>
- <diaLIMS-Probennummer>
- <Attribut1>
- <Attribut2>
- <Attribut3>
- <Attribut4>
- <Probenattribut1>
- <Probenattribut2>
- .
- .
- .
- <Probenattributn>
- <Analysenkürzel1>;<Ergebniskürzel1>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
- <Analysenkürzel1>;<Ergebniskürzel2>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
- .
- .
- .
- <Analysenkürzel1>;<Ergebniskürzeln>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
- <Analysenkürzel2>;<Ergebniskürzel1>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
- <Analysenkürzel2>;<Ergebniskürzel2>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
- .
- .
- .
- <Analysenkürzel2>;<Ergebniskürzeln>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
- <Analysenkürzeln>;<Ergebniskürzel1>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
- .
- .
- .
- <Gruppenwechsel>
- <diaLIMS-Probennummer>
- <Analysenkürzel1>;<Ergebniskürzel1>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
- .
- .
- .
Erläuterungen zum Dateiaufbau
-
<Dateiattribut 1 bis 4>
Diese Dateiattribute dienen der Beschreibung der Datei selbst. Sie werden nicht angezeigt und auch nicht gespeichert.
-
<Gruppenwechsel>
Der Gruppenwechsel wird immer durch drei Rauten angegeben: ###
-
<diaLIMS-Probennummer>
Die diaLIMS-Probennummer muss eine gültige diaLIMS-Probennummer sein, es muss also bereits die Probe im diaLIMS existieren. Das Feld kann auch leer sein. In diesem Fall muss die diaLIMS-Probennummer später von Hand im diaLIMS-Importmodul nachgetragen werden.
-
<Attribut 1 bis 4>
Es gibt 4 Attribute zur freien Verwendung. Diese werden im diaLIMS-Importmodul nur angezeigt, aber nicht in die Datenbank gespeichert. Hier können Informationen angegeben werden, die beim Import benötigt werden, aber nicht gespeichert werden sollen (z.B. der Name der Importdatei).
-
<Probenattribut 0 bis n>
Nun folgt ein Block mit 0 bis n Probenattributen; dieser Block kann also auch komplett weggelassen werden. Die Probenattribute werden an der entsprechenden Probe gesetzt. Die Anzahl der Attribute wird in einer Properties-Datei festgelegt. Dort gibt es für jedes Attribut eine Zeile nach folgendem Muster:
sample.attribute.*, wobei * für eine Nummer steht, die laufend vergeben werden muss, beginnend bei 1.
-
<Analysenkürzel1>;<Ergebniskürzel1>;<1.Ergebniswert>;<2.Ergebniswert>;...<n.Ergebniswert>
Nun folgen die Zeilen mit den Ergebniswerten. Dabei muss zuerst das Analysenkürzel und dann das Ergebniskürzel, getrennt durch Semikolon angegeben werden. Die Zuordnung der angegebenen Kürzel zu den entsprechenden Kürzeln im diaLIMS kann vom Benutzer im diaLIMS eingestellt werden, sofern die Kürzel nicht identisch sind. Dies erfolgt in einer Properties-Datei.
-
Sonstiges
Im Dateipfad können mehrere Übergabedateien stehen. Alle Dateien müssen die Endung .DAT haben. Die Anzahl der Proben in einer Datei ist nicht fest oder beschränkt. Eine Gruppe mit Ergebniswerten wird immer mit dem Zeichen für den Gruppenwechsel, gefolgt von der nächsten diaLIMS-Probennummer angeführt. Die Anzahl der Analysen pro Probe ist nicht fest oder beschränkt. Allerdings müssen die Analysen in der diaLIMS-Probe vorhanden sein, andernfalls kann kein Ergebniswert zugeordnet werden. Die Anzahl der Ergebnisse zu einer Analyse pro Probe ist nicht fest oder beschränkt. Allerdings müssen die Ergebnisse zu den Analysen in der diaLIMS-Probe vorhanden sein, andernfalls kann kein Ergebniswert zugeordnet werden. Die Reihenfolge der Analysennamen innerhalb einer Gruppe ist beliebig. Die Anzahl der Analysen kann innerhalb einer Datei bei jeder Probe anders sein. Das CSV-Feldtrennzeichen, das CSV-Texttrennzeichen und das CSV-Dezimaltrennzeichen können frei eingestellt werden. Die Daten dürfen dann weder eines dieser Zeichen noch Zeilenumbrüche enthalten.
Einstellungen-Datei
In der Properties-Datei können "sample.attribute.x"-Keys angelegt werden. X steht dabei für eine Zahl. Die entsprechenden Werte sind die Namen von Probenattributen, für die in der Importdatei Werte vorhanden sein müssen. Diese werden dann an der entsprechenden Probe gesetzt. Das funktioniert mit normalen Datentypen und LIMSObjekten.
Ablauf des Imports
-
Übertragungsdatei einlesen
Liest die angegebene Übertragungsdateien in diaLIMS ein.
-
Übertragungsdatei löschen
Löscht alle eingelesenen Daten aus dem Modul.
-
Proben speichern
Speichert die eingelesenen Daten und erzeugt ggf. die benötigten Datensätze.
-
Zeilen entfernen
Entfernt die markierte Zeile aus dem Modul.
-
Optionen
Öffnet einen Dialog um Einstellungen für den Import vorzunehmen.
-
Probe öffnen
Öffnet das markierte Objekt im entsprechenden Modul.
Der Import läuft nach folgendem Schema ab:
- Der diaLIMS-Benutzer registriert die Proben und ordnet den passenden Prüfplan zu. Damit steht fest, zu welchen Analysen Ergebniswerte erwartet werden.
- Die externen Übergabedateien werden erstellt und in den dafür vorgesehenen Pfad gestellt.
- Der diaLIMS-Benutzer startet das diaLIMS-Geräteanbindungsmodul und lässt auf Knopfdruck sämtliche Übergabedateien einlesen. Die Inhalte werden interpretiert und in einer Tabelle dargestellt (Analysen in Spalten, Proben in Zeilen).
- Nach Durchsicht und Nacharbeit - es können z.B. Proben selektiert oder aus der Tabelle entfernt werden - werden die Daten in die diaLIMS-Datenbank übertragen. Dabei wird ein Protokoll erstellt, dem man ggf. aufgetretende Importfehler entnehmen kann (z.B. weil ein Analysenwert nicht übertragen werden konnte, weil die entsprechende Probe nicht für diese Analyse vorgesehen war).
- Auf Wunsch können sämtliche Übergabedateien danach gelöscht werden.
Import-Optionen
Die Optionen für den Import erreichen Sie über Optionen einstellen in der Modulsymbolleiste. Geben Sie für den Schlüssel
filename den Namen der einzulesenden Datei als Wert ein. Die Werte der attribute.name.1 bis attribute.name.4 geben die Spaltenüberschriften, wie in der properties-Datei festgelegt, wieder.
Zusätzliche Schlüssel können über das Eingabefeld Eigenschaftsschlüssel hinzugefügt werden. Die zugehörige Bezeichnung muss anschließend in der Spalte Wert eingetragen werden.
Beispieldatei
Dateiattribut1;
Dateiattribut2;
Dateiattribut3;
Dateiattribut4;
###
P2005003410
E:\daten\NIBEM\Ernte2007\Malz\M2007003410-3425.xls
13.07.2007
09:37:23
FIR-M-ORT;M-ORT-NAME;Lelystad
FIR-M-SORTE;M-SORTE-NAME;Barke
FIR-M-H2O;M-H2O-SCHALE-A;1;2
FIR-M-H2O;M-H2O-SCHALEGEW-A;5,5706;5,5684
FIR-M-H2O;M-H2O-EIN-A;10,5728;11,0823
FIR-M-H2O;M-H2O-AUS-A;10,3425;10,8274
FIR-M-H2O;M-H2O-A;4,60397425132944;4,62286222093254
FIR-EXTRAKT-F;DICHTE-F-A;1,03391;1,03406
FIR-M-EIWEISS;M-EIWEISS-LT-A;9,284;9,413
FIR-N-LOESL-TS;N-LOESL-A;0,728;0,728
FIR-VISKO;VISKO-A;1,561;1,556
FIR-GLUCAN-K;K-GLUCAN-A;300,558;298,904
FIR-FRIAB;TR-FRIA;6,5
FIR-FRIAB;TG-FRIA;1,1
FIR-FRIAB;GG-FRIA;0,3
FIR-ENDV;ENDV-SPIND;1,63
FIR-DK;MESS-A;13,5;13,5
FIR-DK;BLIND-A;23,2
FIR-FARBE-SPEKTR;TRANS430nm;74,5
FIR-FARBE-SPEKTR;W-FARBE-A;3,19609318129268
FIR-PH;PH-A;6,04
###
P2007003411
E:\daten\NIBEM\Ernte2007\Malz\M2007003410-3425.xls
13.07.2007
09:37:23
FIR-M-ORT;M-ORT-NAME;Lelystad
FIR-M-SORTE;M-SORTE-NAME;Reggae
FIR-M-H2O;M-H2O-SCHALE-A;3;4
FIR-M-H2O;M-H2O-SCHALEGEW-A;5,5593;5,5826
FIR-M-H2O;M-H2O-EIN-A;10,4802;11,116
FIR-M-H2O;M-H2O-AUS-A;10,2628;10,8711
FIR-M-H2O;M-H2O-A;4,41789103619256;4,42585029096034
FIR-EXTRAKT-F;DICHTE-F-A;1,03382;1,03384
FIR-M-EIWEISS;M-EIWEISS-LT-A;8,88;8,919
FIR-N-LOESL-TS;N-LOESL-A;0,722;0,723
FIR-VISKO;VISKO-A;1,602;1,614
FIR-GLUCAN-K;K-GLUCAN-A;348,86;358,83
FIR-FRIAB;TR-FRIA;7,5
FIR-FRIAB;TG-FRIA;1,2
FIR-FRIAB;GG-FRIA;0,5
FIR-ENDV;ENDV-SPIND;1,75
FIR-DK;MESS-A;14,5;14,6
FIR-DK;BLIND-A;22,9
FIR-FARBE-SPEKTR;TRANS430nm;72,1
FIR-FARBE-SPEKTR;W-FARBE-A;3,55161838201427
FIR-PH;PH-A;6,03