Geräte-Importe bringen Ergebnisse vom Gerät nach SENAITE. Die andere Richtung ist genauso wichtig. Vor einem Lauf muss jemand der Gerätesoftware sagen, welche Probe auf welcher Position steht. Von Hand getippt ist diese Sequenz die Stelle, an der Proben-IDs vertauscht werden, und eine vertauschte ID an dieser Stelle erzeugt eine korrekte Messung an der falschen Probe, die bei keiner Verifizierung auffällt.
Eine Exportschnittstelle nimmt diesen Schritt von der Tastatur: SENAITE schreibt die Laufliste aus dem Arbeitsblatt, im Format, das die Gerätesoftware liest.
Was der Kern mitbringt
Exportschnittstellen sind seltener als Importschnittstellen, weil weniger Geräte eine Laufliste von außen annehmen. Der Kern von SENAITE bringt Exporter für drei mit:
- Varian Vista-PRO ICP
- Lachat QuickChem
- FOSS FIAStar
Das Add-on senaite.instruments ergänzt weitere Schnittstellen, darunter Exporter für Agilent ChemStation, Agilent MassHunter und Thermo Xcalibur. Für alles andere entsteht die Exportschnittstelle im Projekt-Add-on (siehe unten).
Prüfen Sie vor der Planung einer Anbindung zwei Dinge in der Dokumentation des Geräts: ob seine Software überhaupt eine Sequenz oder Laufliste laden kann, und welche Datei sie erwartet. Das entscheidet, ob ein Export möglich ist, nicht SENAITE.
Einrichtung
Wählen Sie am Gerät (Setup, Geräte) unter Datenschnittstelle
den Exporter. Jedes Gerät hat eine Exportschnittstelle, neben
beliebig vielen Importschnittstellen.
Weisen Sie dieses Gerät dem Arbeitsblatt zu. Ein Arbeitsblatt wird immer für ein Gerät exportiert; ohne zugewiesenes Gerät bricht der Export mit “You must select an instrument” ab, und bei einem Gerät ohne Exportschnittstelle mit “Instrument has no data interface selected”.
Dann wählen Sie auf dem Arbeitsblatt Export. Der Browser lädt die
Datei herunter, und die Bedienung lädt sie in die Gerätesoftware.
Was in der Datei steht
Der Varian-Exporter zeigt gut, wie solche Dateien aussehen. Er schreibt eine Zeile pro Probe, sortiert nach Position auf dem Arbeitsblatt, mit der Proben-ID in der ersten Spalte und festen Werten, die die Gerätesoftware erwartet, in den übrigen:
"W-0101*"," "," "," ",1.000000000,1.000000,1.0000000
"W-0102*"," "," "," ",1.000000000,1.000000,1.0000000
Der Stern trennt die Proben-ID vom Titel der Probenahmestelle, der hier leer ist. Blindproben, Kontrollen und Doppelbestimmungen auf dem Arbeitsblatt bekommen ebenfalls eine Zeile, gekennzeichnet durch die Gruppen-ID ihrer Referenzanalysen statt einer Proben-ID.
Was die übrigen Spalten bedeuten, ist Sache des Geräts. Der Exporter schreibt, was die Gerätesoftware verlangt; SENAITE interpretiert es nicht.
Wie sich der Kreis schließt
Der Import ordnet Ergebnisse nicht nach Position zu, sondern nach ID: zuerst als Proben-ID, dann als Kunden-Proben-ID, bei QC über die Gruppen-ID der Referenzanalysen. Deshalb funktioniert der Rückweg: Das Gerät schreibt die IDs, die es mit der Laufliste erhalten hat, in seine Ergebnisdatei zurück, und der Importer findet dieselben Proben und dieselben QC-Analysen wieder.
Daraus folgen zwei Dinge.
Die Belegung der Schale muss der Laufliste entsprechen. SENAITE sieht die physische Schale nicht. Setzt die Bedienung Position 5 und 6 vertauscht ein, meldet das Gerät die Messung von W-0105 unter der ID von W-0106. Eine Arbeitsblattvorlage hilft dabei, weil dann jedes Arbeitsblatt dieselbe Struktur hat wie die Schale.
IDs müssen die Gerätesoftware überstehen. Manche Geräte kürzen IDs oder entfernen Zeichen. Testen Sie den Rundweg vor dem Produktivstart mit Ihrem echten ID-Format, etwa einem mit Präfix und Jahr. Wie Proben-IDs entstehen, steht im Beitrag zum ID-Server.
Was der Export nicht tut
Der Export ist ein Download. SENAITE behält keine Kopie der Datei am Arbeitsblatt, anders als beim Import, der die Ergebnisdatei anhängt. Braucht das Labor die Laufliste als Nachweis, ist das Laufarchiv der Gerätesoftware der richtige Ort dafür.
Der Export ändert keinen Status. Die Analysen bleiben Zugewiesen,
bis Ergebnisse zurückkommen.
Er schickt auch nichts über das Netzwerk. Für Geräte, die Aufträge über eine stehende Verbindung statt über eine Datei erhalten, führt der Weg über ein Protokoll wie ASTM, siehe senaite.astm.
Einen eigenen Exporter schreiben
Eine Exportschnittstelle ist ein kleiner Adapter im Projekt-Add-on.
Er implementiert IInstrumentExportInterface, stellt eine Methode
Export bereit und bekommt beim Aufruf die Analysen des
Arbeitsblatts. Daraus baut er die Datei (Proben-ID, Position und
was das Gerät sonst braucht) und schickt sie als Download an den
Browser. Nach der Registrierung erscheint er unter
Datenschnittstelle neben den mitgelieferten.
Der Code ist der kleinere Teil der Arbeit. Der Aufwand steckt in der Dateispezifikation des Geräts: welche Spalten, welches Trennzeichen, welcher Zeichensatz, wie QC-Proben gekennzeichnet werden, ob eine Kopfzeile nötig ist. Besorgen Sie sich eine Beispiel-Laufliste aus der Gerätesoftware und einen vollständigen Lauf mit Ergebnisdatei, bevor Sie etwas schreiben, und testen Sie den fertigen Exporter am Gerät selbst, nicht nur durch einen Blick in die Datei.
Ohne Netzwerk an der Laborbank
Geräte-PCs hängen oft nicht im Labornetz. Das Muster aus Export und Import funktioniert trotzdem: Laufliste herunterladen, per USB-Stick zum Gerät bringen, Serie messen, Ergebnisdatei zurückbringen und importieren. Entscheidend ist, dass die IDs in Dateien reisen und nicht über eine Tastatur.