Octoware
Fachlicher Hintergrund
Labore in Sachsen müssen die Analysenergebnisse bestimmter Entnahmestellen regelmäßig an das Gesundheitsamt übermitteln. Das Austauschformat Octoware ist im Land Sachsen vorgegeben.
In diaLIMS ist der Export von Proben im Octoware-Format für die Datenübertragung vom Labor ans Gesundheitsamt implementiert. Die Funktion wird nach Aktivierung der Lizenz im Modul Proben angeboten. Zusätzlich kann sie in Makros für Proben oder Aufträge eingebunden werden.
Wenn der Export ausgeführt wird, werden alle markierten Proben verarbeitet und die erzeugte Datei an einem konfigurierbaren Ort abgelegt.
Wenn der Export beendet ist, erscheint eine zusammenfassende Meldung, von der aus auch die erzeugte Exportdatei geöffnet werden kann. Der Inhalt der Meldung ist anschließend auch im Log zu finden.
Konfiguration
Im Modul Optionen befinden sich unter Allgemein/Schnittstellen zum Gesundheitsamt die folgenden Konfigurationsmöglichkeiten für die Schnittstelle:
-
GAInterfaceOctowareExportpath
Gibt den Pfad an, in dem die erzeugten Dateien aus dem Octoware-Export abgelegt werden.
-
GAInterfaceOctowareLaborID
Gibt die ID des Labors für den Octoware-Export an. Ohne diese Angabe kann der Export nicht ausgeführt werden.
Dateiaufbau
Es wird in jedem Exportvorgang nur eine Datei erzeugt, die die Daten aller exportierten Proben enthält. Der Datentyp ist ASCII-ANSI. Der Dateiname wird nach dem Schema Octoware_yyyyMMddhhmmss erstellt.
Für jede Probe können ein oder mehrere unterschiedlich aufgebaute Sätze exportiert werden. Ein Satz beginnt immer mit der Nennung der vierstelligen Satzart, dann folgen ein oder mehrere Felder getrennt durch \ . Abgeschlossen wird jeder Satz mit einem Zeilenumbruch. Jede Probe wird durch mindestens einen Pflichtsatz, den Probenkopfsatz, und eine Reihe weiterer Sätze (bis zum nächsten Probenkopfsatz) repräsentiert. Die Reihenfolge der Sätze innerhalb einer Probe spielt keine Rolle.
Datumswerte werden im Format dd.MM.yyyy hh:mm:ss (bzw. dd.MM.yy wenn die Uhrzeit leer ist) exportiert.
Textwerte haben immer eine feste Längenangabe. Sollte der Wert diese Länge überschreiten, wird er entsprechend gekürzt.
| Name | Wert | Bemerkung |
|---|---|---|
| Probenstellennummer | Probe.Unterstelle.octowareID | Text (20 Zeichen) |
| Entnahme-Datum Uhrzeit | Probe.nahmedatum, .nahmezeit | |
| Labor-Datum Uhrzeit | Probe.eingangsdatum, .eingangszeit | |
| Analyseanlass | Probe.Unterstelle.octowareID | Text (6 Zeichen) |
| Datum nächste Analyse | leer | |
| Nachkontrolle | Probe.nachkontrolle | Text (1 Zeichen), 1 wenn Schalter gesetzt, sonst 0 |
| Probennummer (Labor) | Probe.kurzbezeichnung | Text (20 Zeichen) |
| Probennehmer | Probe.Betreuer.beschreibung / Probe.probennehmer | Ist kein Betreuer zugeordnet wird der Probennehmer ausgegeben |
| (Gesamt-)Gebühr | numerisch (2 Nachkommastellen), leer | |
| Labor | Octoware-Labor-ID | Konfigurierbar im Modul Optionen |
| Export erlaubt | Text (1 Zeichen), leer | |
| Statistik | Text (1 Zeichen), leer | |
| Spezifikation | Text (12 Zeichen), leer | |
| Wasser nicht genutzt | Text (1 Zeichen), leer | |
| Bearbeiter | Text (64 Zeichen), leer | |
| Betroffene | numerisch (Ganzzahl), leer | |
| Datenblattart | Probe.Produkt.octowareID | Text (2 Zeichen) |
Proben die storniert sind werden beim Export kommentarlos übergangen. Für alle anderen Proben werden die Exportdatensätze erzeugt. Ist bei einer Probe die Octoware-ID an der Unterstelle nicht hinterlegt, wird das im Log vermerkt und diese Probe beim Export übergangen. Eine Probe wird auch dann exportiert, wenn außer dem Probenkopf-Satz keine weiteren Sätze erzeugt wurden.
| Name | Wert | Bemerkung |
|---|---|---|
| Protokollzeile | Text (250 Zeichen) |
Die Ausgabe von Protokoll-Sätzen ist durch eine kundenindividuelle Erweiterung leicht möglich. Im diaLIMS-Standard ist dies nicht enthalten.
| Name | Wert | Bemerkung |
|---|---|---|
| Bemerkung | Probe.bemerkungBericht | Text (80 Zeichen) |
Ausgabe des Bemerkung-Satzes erfolgt nur, wenn das Feld gefüllt ist.
| Name | Wert | Bemerkung |
|---|---|---|
| Entnahmestelle | Probe.entnahmestelle | Text (80 Zeichen) |
Ausgabe des Entnahmestelle-Satzes erfolgt nur, wenn das Feld gefüllt ist.
| Name | Wert | Bemerkung |
|---|---|---|
| Kostenträger | Probe.Kunde.beschreibung | Text (80 Zeichen) |
Ausgabe des Zahlungspflichtiger-Satzes erfolgt nur, wenn das Feld gefüllt ist.
| Name | Wert | Bemerkung |
|---|---|---|
| Prüfplan | Pruefplan.octowareID | Text (6 Zeichen) |
Ausgabe eines Prüfplan-Satzes pro der Probe zugeordnetem Prüfplan mit eingetragener Octoware-ID
| Name | Wert | Bemerkung |
|---|---|---|
| Parametercode | Probenergebnis.Stoff.octowareID oder Probenergebnis.Ergebnis.octowareID | Text (6 Zeichen); Ausgabe der octowareID des Stoffs, falls vorhanden, sonst octowareID des Ergebnis |
| Status | siehe Tabelle unten | Text (1 Zeichen) |
| Abschätzungszeichen | Probenergebnis.wert.vorsilbe | Text (1 Zeichen) |
| Messwert | Probenergebnis.wert | Text (12 Zeichen); Ausgabe des Mittelwerts oder ersten Einzelwerts ohne Ausreißermarkierung |
| Gebühr | numerisch mit 2 Nachkommastellen; leer | |
| Parameterspezifikation | Text (1 Zeichen); leer | |
| Parameter hier bewerten | Text (1 Zeichen); leer | |
| Verfahren | Probenergebnis.Ergebnis.octowareVerfahren | Text (10 Zeichen) |
| Bemerkung | Probenergebnis.wert.messwertbemerkung | Text (248 Zeichen) |
| Ursache | Text (6 Zeichen); leer | |
| Maßnahme | Text (6 Zeichen); leer | |
| Zeitplan | Text (6 Zeichen); leer | |
| Prüfplankonformität | Probenergebnis.pruefplan | Text (1 Zeichen); Ausgabe von 1 wenn ein Prüfplan zugeordnet ist, sonst 0 |
Probenergebnisse die storniert sind, an denen der Drucken-Schalter nicht gesetzt oder keine Octoware-ID am Stoff oder Ergebnis hinterlegt ist, werden beim Export kommentarlos übergangen. Für alle anderen Probenergebnisse wird je ein Parameter-Satz erzeugt wenn mindestens ein Messwert eingetragen ist und ein Octoware-Verfahren am Ergebnis hinterlegt ist. Fehlt eine dieser Angaben wird das im Log vermerkt und das Probenergebnis übergangen.
Der Wert des Felds Status am Parameter-Satz wird wie folgt ermittelt:
| Ausgabe | Beschreibung Octoware | Bedingung |
|---|---|---|
| Parameterwert i. O. | Wert innerhalb der Soll- und Grenzwerte | |
| - | Parameterwert i. O. - keine Grenz-/Richt-/Warnwerte vorhanden | Es gibt keine Soll- oder Grenzwerte am Parameter |
| < | Parameterwert kleiner Nachweisgrenze | nicht implementiert |
| R | Richtwertüberschreitung | nicht implementiert |
| W | Warnwertüberschreitung | Wert liegt außerhalb der Sollwerte |
| * | Grenzwertüverschreitung | Wert liegt außerhalb der Grenzwerte |
| A | Grenzwertüberschreitung innerhalb einer erteilten Ausnahmegenehmigung | nicht implementiert |
| ! | Grenzwertüberschreitung außerhalb einer erteilten Ausnahmegenehmigung | nicht implementiert |
OCT>HIDD1205KITA\28.02.2005 10:00\\TURNUS\\\E2005-01776\Künne\\LAB\\\\\Meier\\TW
REM>KiTa 1992 eröffnet
EST>Wasserhahn Küche
KST>Jugendamt Dresden
PPA>SA4360\*\\0,80\\\\A14\\\\\0
PPA>GesQl0\\\ohne\\\\A14\\\\\0
PPA>+KZ221\\\0,0\\\\A18\\\\\0
PPA>+KZ361\\\1,0\\\\A18\\\\\1
PPA>NO3 0\*\\76,0\\\\A14\\\\\0
PPA>NO2 0\\\0,160\\\\A14\\\\\0
PPA>EColi1\\\0,0\\\\A14\\\\\0
PPA>Colif1\\\0,0\\\\A14\\\\\1
PPA>pH 0\\\7,04\\\\A14\\\\\0
VOP>TWV4P0
VOP>TWV1CB
OCT>HIDD1205KITA\28.02.2005 11:00\\TURNUS\\\E2005-01777\Künne\\LAB\\\\\\\BW
EST>Wasseruhr
PPA>NH4 0\\<\0,10\\\\A18\\\\\0
Logging
Die Schnittstelle loggt pro Durchlauf folgende Informationen:
- Die Anzahl der zum Export markierten Proben
- Die fehlenden Pflichtfelder der Proben
- Die fehlenden Pflichtfelder der Probenergebnisse
- Den Speicherort und Dateinamen der Exportdatei
- Sämtliche Fehler, die beim Verarbeiten der Daten oder Erstellen der Datei auftreten
Diese Informationen werden nach dem Export in einer Hinweismeldung angezeigt. Zusätzlich sind sie im Modul Logeinträge zu finden.