Geräteanbindungen
Standardimport-Modul
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
Tip:
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.*
* steht für eine Nummer, 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.
properties-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 etsprechenden Probe gesetzt. Das funktioniert mit normalen Datentypen und LIMSObjekten.
Ablauf des Imports
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.