RIDING BYTES
← Alle Insights

31. Oktober 2026 · 6 min Lesezeit

Geräte-Importe: von der Ergebnisdatei zum eingereichten Ergebnis

Wie SENAITE die Ergebnisdatei eines Geräts liest, jeden Wert einer Probe und einer Analyse zuordnet, und was Sie prüfen, wenn ein Wert nicht ankommt. Manueller Upload, automatischer Import aus einem Ordner und die Einstellungen dazwischen.

Geräte-Importe: von der Ergebnisdatei zum eingereichten Ergebnis

In den meisten Laboren gibt es mindestens ein Gerät, dessen Ergebnisse noch von Hand aus einem Ausdruck oder vom Bildschirm abgetippt werden. Jeder getippte Wert ist eine Gelegenheit für einen Zahlendreher, und jeder muss bei der Verifizierung auffallen. Kann das Gerät seine Ergebnisse in eine Datei schreiben (CSV, TXT, XLSX, XML), kann SENAITE stattdessen diese Datei lesen.

Dieser Beitrag erklärt, was bei einem Import passiert, wie Sie ihn einrichten und woran Importe in der Praxis scheitern.

Zwei Teile: Parser und Importer

Jede Importschnittstelle besteht aus zwei Teilen.

Der Parser versteht ein Dateiformat. Er liest die Datei und liefert pro Probe eine Menge von Werten, geordnet nach dem Schlüsselwort der Analyse. SENAITE bringt Parser für mehrere Dutzend Gerätemodelle mit (Abaxis, Beckman Coulter, FOSS, Horiba, Lachat, Mettler Toledo, Roche, Seal Analytical, Shimadzu, Sysmex, Thermo Scientific, Varian und weitere), dazu die generische Schnittstelle 2-Dimensional-CSV.

Der Importer ist für alle gleich. Er nimmt die geparsten Werte, sucht die passende Probe und Analyse, schreibt das Ergebnis und reicht es ein.

Ein Gerät einrichten

Wählen Sie am Gerät (Setup, Geräte) unter Datenschnittstelle importieren eine oder mehrere Schnittstellen. Nur Analysen, die auf diesem Gerät laufen, sollen Ergebnisse von ihm erhalten. Prüfen Sie daher, dass die Analyseleistungen das Gerät ebenfalls führen.

Passt kein Hersteller-Parser, passt oft die generische Schnittstelle. Sie liest eine einfache Tabelle: Die erste Spalte ist die Proben-ID, die weiteren Spalten sind Schlüsselwörter von Analysen.

ID,PH,COND,NO3,end
W-0101,7.42,512,8.1,
W-0102,7.38,498,12.6,
end

Die meisten Gerätesoftwares können eine Tabelle in dieser Form exportieren oder mit einer kleinen Vorlage dazu gebracht werden. Die end-Markierungen werden aus Kompatibilitätsgründen toleriert und können entfallen.

Ausschnitt aus dem Bearbeitungsformular eines Instruments: die Liste Import Data Interface, beginnend mit None, 2-Dimensional-CSV, Abaxis VetScan VS2, Abbott m2000 Real Time, darunter die Tabelle Result files folders mit Interface Code und dem Ordner für die Ergebnisdateien.
Am Instrument: die unterstützten Importschnittstellen und je Schnittstelle der Ordner für den automatischen Import.

Ein manueller Import, Schritt für Schritt

Wählen Sie Import im Menü oben rechts, dann Gerät und Schnittstelle (Importschnittstelle auswählen), und laden Sie die Datei hoch. Zwei erweiterte Optionen legen fest, was der Import anfassen darf. Sie erscheinen in der Oberfläche auf Englisch:

  • Samples state: Received (Standard) oder Received and to be verified. Proben in anderen Status werden ignoriert.
  • Results override: Don't override results (Standard), Override non-empty results oder Override non-empty results (also with empty).

Mit den Standardwerten füllt ein Import nur leere Ergebnisse eingegangener Proben. Das ist die richtige Einstellung für den Alltag. Überschreiben ist für eine Wiederholungsmessung nach einem Kalibrierproblem gedacht und sollte eine bewusste Entscheidung sein.

Für die Datei oben geht der Importer so vor:

  1. Er sucht W-0101 als Proben-ID. Findet er nichts, versucht er die Kunden-Proben-ID.
  2. Er sucht auf dieser Probe die Analyse mit dem Schlüsselwort PH, im Status Nicht zugeordnet, Zugewiesen oder Zu verifizieren.
  3. Er schreibt 7.42 als Ergebnis und reicht die Analyse ein.
  4. Er berechnet alle berechneten Analysen der Probe neu, die von den importierten Werten abhängen.
  5. Liegt die Analyse auf einem Arbeitsblatt, hängt er die Importdatei an dieses Arbeitsblatt.

Am Ende zeigt er ein Protokoll mit jedem geschriebenen Wert und jeder übersprungenen Zeile samt Grund.

Importierte Ergebnisse brauchen trotzdem eine Verifizierung

Standardmäßig werden importierte Analysen sofort eingereicht (Analysen beim Import einreichen unter Setup, SENAITE-Registrierung, Import). Sie landen in Zu verifizieren und durchlaufen dieselbe Verifizierung wie getippte Ergebnisse. Der Import erspart das Tippen, nicht die Prüfung. Wie die Verifizierung eingerichtet wird, steht in Mehrstufige Verifizierung.

Soll das Labor importierte Werte vor dem Einreichen ansehen, schalten Sie diese Einstellung ab. Die Werte werden dann geschrieben, und die Analytikerin reicht sie auf dem Arbeitsblatt ein.

Die Importdatei hängt am Arbeitsblatt, die Rohdaten bleiben also neben den Ergebnissen. Mit Importdatei an Analysen anhängen (standardmäßig aus) wird sie zusätzlich mit jeder importierten Analyse verknüpft.

Berechnete Analysen und Ergebnisoptionen

Eine Analyse mit Berechnung übernimmt kein Ergebnis aus der Datei. Der Importer protokolliert für sie “Skipping result”. Übernommen werden dagegen die Zwischenwerte der Berechnung: Schreiben Sie deren Schlüsselwörter als Spalten in die Datei, und SENAITE berechnet das Ergebnis. Bei einer Trockenmassekorrektur zum Beispiel enthält die Datei den Wert bezogen auf die Feuchtmasse und den Faktor; das korrigierte Ergebnis entsteht in SENAITE, mit der Formel, die das Labor validiert hat. Siehe Berechnungen in SENAITE.

Bei Analysen mit Ergebnisoptionen kann die Datei den Zahlenwert der Option enthalten, und der Importer wählt den passenden Eintrag.

Automatischer Import aus einem Ordner

Schreibt ein Gerät seine Dateien auf eine Netzwerkfreigabe, kann SENAITE sie selbst abholen. Am Gerät enthält Ergebnisdatei-Ordner einen Ordner pro Importschnittstelle. Der Ordner muss für den Serverprozess von SENAITE erreichbar sein; an dieser Stelle braucht es meist ein Gespräch mit der IT über Mounts und Berechtigungen.

Ein Cronjob ruft dann in regelmäßigen Abständen die Ansicht auto_import_results der Website auf; die Schaltfläche Automatischen Import starten macht dasselbe auf Abruf. Für jede neue Datei führt SENAITE den Import aus und schreibt zwei Dateien in den Ordner:

  • imported.csv listet die bereits verarbeiteten Dateinamen, damit nichts doppelt importiert wird.
  • logs.log enthält dasselbe Protokoll wie der manuelle Import.

Aus diesem Aufbau folgen zwei Dinge. Eine korrigierte Datei, die unter demselben Namen erneut gespeichert wird, wird nicht noch einmal importiert; geben Sie ihr einen neuen Namen. Und die Überschreib-Optionen des Cron-Aufrufs stehen standardmäßig auf “nicht überschreiben”, die sichere Wahl für unbeaufsichtigte Läufe.

Wenn ein Wert nicht ankommt

Das Protokoll sagt, warum. Die häufigsten Ursachen, in der Reihenfolge, in der wir sie sehen:

Das Schlüsselwort passt nicht. Die Spaltenüberschrift muss das Schlüsselwort der Analyse sein, nicht ihr Titel. NO3 und Nitrat sind für den Importer verschiedene Dinge.

Die Probe ist nicht eingegangen. Mit dem Standardwert für Samples state wird eine Probe im Status Probe ausstehend übersprungen.

Es gibt schon ein Ergebnis. Ohne Überschreiben bleibt ein vorhandener Wert stehen, und das Protokoll vermerkt es.

Die Analyse ist berechnet. Die Datei muss die Zwischenwerte enthalten, nicht das Endergebnis.

Die ID ist nicht eindeutig. Kunden-Proben-IDs sind nicht in jedem Labor eindeutig. Tragen zwei Proben dieselbe Kunden-Proben-ID, lehnt der Importer die Zeile mit “More than one Sample found” ab.

Zwei Analysen mit demselben Schlüsselwort. Hat eine Probe zwei offene Analysen mit demselben Schlüsselwort, kann der Importer nicht entscheiden und überspringt den Wert.

Lesen Sie in den ersten Wochen nach jedem Import das Protokoll. Es ist der schnellste Weg, falsche Schlüsselwörter und Probenstatus zu finden.

Wenn kein Parser passt

Ein Parser für ein ungewöhnliches Format ist eine kleine Python-Klasse: Sie erweitert InstrumentCSVResultsFileParser (oder die TXT-Variante) und implementiert _parseline, das eine Zeile der Datei in Werte pro Probe und Schlüsselwort übersetzt. Zeichensatz, Zeilenverarbeitung und Fehlersammlung kommen aus der Basisklasse. Registriert wird der Parser als Adapter in einem Projekt-Add-on; danach erscheint er in der Schnittstellenliste wie die mitgelieferten.

Wie lange das dauert, hängt an der Datei. Eine saubere Tabelle ist schnell gemacht. Ein Hersteller-Export mit mehreren Kopfblöcken, Zeilen pro Replikat und Einheiten im Wert dauert länger, und die Arbeit steckt im Verstehen der Datei, nicht im Code. Fordern Sie früh echte Exportdateien des Geräts an, auch die unbequemen Fälle: eine nachgemessene Probe, einen Wert unter der Nachweisgrenze, einen abgebrochenen Lauf.

Für Geräte, die über eine serielle oder Netzwerkverbindung senden, statt Dateien zu schreiben, siehe senaite.astm. Die andere Richtung, die Laufliste an das Gerät zu schicken, behandelt Geräte-Exporte.

Zwei Personen prüfen Notizen auf Papier neben einem Laptop

Bringen Sie das in Ihr Labor

Ob Sie SENAITE evaluieren, über mehrere Standorte skalieren oder Geräte und Monitoring anbinden — das Team, das die Plattform geschrieben hat, ist das Team, mit dem Sie sprechen.