Zum Hauptinhalt springen

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.

NameWertBemerkung
ProbenstellennummerProbe.Unterstelle.octowareIDText (20 Zeichen)
Entnahme-Datum UhrzeitProbe.nahmedatum, .nahmezeit 
Labor-Datum UhrzeitProbe.eingangsdatum, .eingangszeit 
AnalyseanlassProbe.Unterstelle.octowareIDText (6 Zeichen)
Datum nächste Analyse leer
NachkontrolleProbe.nachkontrolleText (1 Zeichen), 1 wenn Schalter gesetzt, sonst 0
Probennummer (Labor)Probe.kurzbezeichnungText (20 Zeichen)
ProbennehmerProbe.Betreuer.beschreibung / Probe.probennehmerIst kein Betreuer zugeordnet wird der Probennehmer ausgegeben
(Gesamt-)Gebühr numerisch (2 Nachkommastellen), leer
LaborOctoware-Labor-IDKonfigurierbar 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
DatenblattartProbe.Produkt.octowareIDText (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.

NameWertBemerkung
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.

NameWertBemerkung
BemerkungProbe.bemerkungBerichtText (80 Zeichen)

Ausgabe des Bemerkung-Satzes erfolgt nur, wenn das Feld gefüllt ist.

NameWertBemerkung
EntnahmestelleProbe.entnahmestelleText (80 Zeichen)

Ausgabe des Entnahmestelle-Satzes erfolgt nur, wenn das Feld gefüllt ist.

NameWertBemerkung
KostenträgerProbe.Kunde.beschreibungText (80 Zeichen)

Ausgabe des Zahlungspflichtiger-Satzes erfolgt nur, wenn das Feld gefüllt ist.

NameWertBemerkung
PrüfplanPruefplan.octowareIDText (6 Zeichen)

Ausgabe eines Prüfplan-Satzes pro der Probe zugeordnetem Prüfplan mit eingetragener Octoware-ID

NameWertBemerkung
ParametercodeProbenergebnis.Stoff.octowareID oder Probenergebnis.Ergebnis.octowareIDText (6 Zeichen); Ausgabe der octowareID des Stoffs, falls vorhanden, sonst octowareID des Ergebnis
Statussiehe Tabelle untenText (1 Zeichen)
AbschätzungszeichenProbenergebnis.wert.vorsilbeText (1 Zeichen)
MesswertProbenergebnis.wertText (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
VerfahrenProbenergebnis.Ergebnis.octowareVerfahrenText (10 Zeichen)
BemerkungProbenergebnis.wert.messwertbemerkungText (248 Zeichen)
Ursache Text (6 Zeichen); leer
Maßnahme Text (6 Zeichen); leer
Zeitplan Text (6 Zeichen); leer
PrüfplankonformitätProbenergebnis.pruefplanText (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:

AusgabeBeschreibung OctowareBedingung
 Parameterwert i. O.Wert innerhalb der Soll- und Grenzwerte
-Parameterwert i. O. - keine Grenz-/Richt-/Warnwerte vorhandenEs gibt keine Soll- oder Grenzwerte am Parameter
<Parameterwert kleiner Nachweisgrenzenicht implementiert
RRichtwertüberschreitungnicht implementiert
WWarnwertüberschreitungWert liegt außerhalb der Sollwerte
*GrenzwertüverschreitungWert liegt außerhalb der Grenzwerte
AGrenzwertüberschreitung innerhalb einer erteilten Ausnahmegenehmigungnicht implementiert
!Grenzwertüberschreitung außerhalb einer erteilten Ausnahmegenehmigungnicht 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.