TEIS 3
Fachlicher Hintergrund
Umweltlabore in Nordrhein-Westfalen müssen die Analysenergebnisse bestimmter Entnahmestellen regelmäßig an das Gesundheitsamt übermitteln. Das Austauschformat TEIS (Version 3) ist in diesem Bundesland vorgegeben.
In diaLIMS ist der Export von Proben im TEIS-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 und das Exportverzeichnis geöffnet werden können. 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:
-
GAInterfaceTeis3Exportpath
Gibt den Pfad an, in dem die erzeugten Dateien aus dem TEIS-3-Export abgelegt werden.
-
GAInterfaceTeis3SenderName
Gibt den Namen des Senders für den TEIS-3-Export an.
Dies kann z.B. der Name Ihres Unternehmens sein (bzw. des Unternehmens, das den Teis-Export an das Gesundheitsamt ausführt).
-
GAInterfaceTeis3UntersuchungsstelleZID
Gibt die ID des Labors (Untersuchungsstelle-ZID) für den TEIS-3-Export an.
-
GAInterfaceTeis3DruckenSchalterIgnorieren
Gibt an, ob beim TEIS-3-Export der Drucken-Schalter der Probenergebnisse ignoriert werden soll.
- true: Der Drucken-Schalter wird ignoriert. Probenergebnisse mit und ohne gesetzten Drucken-Schalter werden exportiert.
- false (Standardwert): Der Drucken-Schalter wird berücksichtigt. Es werden nur Probenergebnisse mit gesetztem Drucken-Schalter exportiert. Probenergebnisse ohne gesetzten Drucken-Schalter werden nicht exportiert.
Makroaufrufe
Der Export kann zusätzlich auch in Makros für Proben oder Aufträge eingebunden werden. Die Aufrufe sind folgendermaßen:
Für Proben:
com.dialog.dialims.business.ProbeController.getInstance().getTeis3Exporter().exportProbenToTeis3(proben, toc);
wobei proben ein Array (Object[]) oder eine Liste (List<Probe>) mit Proben ist (z.B. selected)
Für Aufträge:
com.dialog.dialims.business.ProbeController.getInstance().getTeis3Exporter().exportAuftraegeToTeis3(auftraege, toc);
wobei auftraege ein Array (Object[]) mit Aufträgen ist (z.B. selected)
Dateiaufbau
Es wird in jedem Exportvorgang genau eine XML-Datei erzeugt, die die Daten aller exportierten Proben enthält. Der Dateiname wird nach dem Schema TEIS_yyyyMMddhhmmss.XML erstellt, wobei yyyyMMddhhmmss der Zeitpunkt des Imports ist. Das Format (Encoding) der Datei ist "ISO-8859-1".
Viele Daten werden durch eine ZID (Zentrale Identifikation) identifiziert. Dies ist eine 21-stellige Identifikationsnummer, s. Tabelle 4. Eine IID (Instance ID) ist 7-stellig.
Der <TEIS>-Tag umschließt alle weiteren Tags. Innerhalb des <TEIS>-Tags sind folgende relevante Attribute vorhanden.
|
Attribut |
Wert |
Bemerkung |
|---|---|---|
|
version |
3.0 |
TEIS-Version |
|
application |
diaLIMSvXrY |
Anwendung, mit der die TEIS-Exportdatei erstellt wurde: diaLIMS mit Versionskürzel (Beispiel: diaLIMSv13r1) |
|
sender |
Eintrag in den Optionen unter 'GAInterfaceTeis3SenderName' |
Name des Unternehmens, das den Export zum Gesundheitsamt ausführt. |
|
recipient |
Probe.organisation.teisIID |
Empfänger: IID des zuständigen Gesundheitsamts |
Die Informationen zur Probe werden in folgenden Tags in das <PROBE>-Tag eingeschlossen. Das <PROBE>-Tag befindet sich direkt innerhalb des <TEIS>-Tags.
|
Tag |
Pflichtfeld |
Wert |
Bemerkung |
|---|---|---|---|
|
<PROBENAHMESTELLE> |
x |
Probe.unterstelle.teisProbenahmestelleZID |
ZID der Probenahmestelle |
|
<UNTERSUCHUNGSSTELLE> |
x |
Eintrag in den Optionen unter 'GAInterfaceTeis3UntersuchungsstelleZID' |
ZID des Labors |
|
<ENTNAHMEDATUM> |
x |
Probe.nahmedatum + Probe.nahmezeit |
Entnahmedatum im Format yyyy-MM-dd HH:mm:ss |
|
<PROBENAHMETVO> |
x |
1 |
Probenahme gemäß $15 Abs. 4 TrinkwV - 1 bedeutet ja
|
|
<PROBENART> |
|
Probe.teisProbenart |
ZID der Probenart für Hausinstallationen, s. Tabelle 6 |
|
<PROBENUMMER> |
|
Probe.kurzbezeichnung |
Probenummer, maximal 20 Zeichen |
|
<STICHWORT> |
|
wird standardmäßig nicht exportiert |
Stichwort, maximal 250 Zeichen |
Die Informationen zu einem Probenergebnis werden in folgenden Tags in das <UNTERSUCHUNGSERGEBNIS>-Tag eingeschlossen. Das <UNTERSUCHUNGSERGEBNIS>-Tag befindet sich ebenfalls direkt innerhalb des <TEIS>-Tags. Den <UNTERSUCHUNGSERGEBNIS>-Tags zu einer Probe muss ein <PROBE>-Tag vorausgehen, um die Zuordnung der Untersuchungsergebnisse zu einer Probe zu gewährleisten. Einem <PROBE>-Tag können beliebig viele <UNTERSUCHUNGSERGEBNIS>-Tags folgen.
|
Tag |
Pflichtfeld |
Wert |
Bemerkung |
|---|---|---|---|
|
<PROBE> |
x |
. |
das Untersuchungsergebnis bezieht sich auf die vorherige Probe |
|
<PARAMETER> |
x |
ZPAE.ergebnis.teisParameterZID |
|
|
<ANALYSEVERFAHREN> |
x |
ZPAE.analyse.teisAnalyseverfahrenZID |
|
|
<MESSWERTSTATUS> |
|
ErgebnisWert.wert (/ ZPAE.statistikwert.mittelwert) (Vorzeichen des Wertes) |
|
|
<MESSWERTTEXT> |
x |
ZPAE.statistikwert.mittelwert / ErgebnisWert.wert |
|
|
<STICHWORT> |
|
wird standardmäßig nicht exportiert |
|
Beispiel einer Exportdatei für TEIS 3
<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<TEIS version="3.0" application="diaLIMSv13r1" sender="Max Mustermann GmbH" recipient="1234567">
<PROBE>
<PROBENAHMESTELLE>251234567123456789012</PROBENAHMESTELLE>
<UNTERSUCHUNGSSTELLE>309000000123456789012</UNTERSUCHUNGSSTELLE>
<ENTNAHMEDATUM>2021-12-07 08:55:00</ENTNAHMEDATUM>
<PROBENAHMETVO>1</PROBENAHMETVO>
<PROBENART>089999999000000000287</PROBENART>
<PROBENUMMER>P2021001234</PROBENUMMER>
</PROBE>
<UNTERSUCHUNGSERGEBNIS>
<PROBE>.</PROBE>
<PARAMETER>229999999000000000042</PARAMETER>
<ANALYSEVERFAHREN>019999999000000000461</ANALYSEVERFAHREN>
<MESSWERTSTATUS>089999999000000000002</MESSWERTSTATUS>
<MESSWERTTEXT>0,05</MESSWERTTEXT>
</UNTERSUCHUNGSERGEBNIS>
<UNTERSUCHUNGSERGEBNIS>
<PROBE>.</PROBE>
<PARAMETER>229999999000000000043</PARAMETER>
<ANALYSEVERFAHREN>019999999000000000461</ANALYSEVERFAHREN>
<MESSWERTSTATUS>089999999000000000002</MESSWERTSTATUS>
<MESSWERTTEXT>0,05</MESSWERTTEXT>
</UNTERSUCHUNGSERGEBNIS>
<UNTERSUCHUNGSERGEBNIS>
<PROBE>.</PROBE>
<PARAMETER>229999999000000000403</PARAMETER>
<ANALYSEVERFAHREN>019999999000000000347</ANALYSEVERFAHREN>
<MESSWERTTEXT>7,58</MESSWERTTEXT>
</UNTERSUCHUNGSERGEBNIS>
<PROBE>
<PROBENAHMESTELLE>251234567000000001234</PROBENAHMESTELLE>
<UNTERSUCHUNGSSTELLE>309000000123456789012</UNTERSUCHUNGSSTELLE>
<ENTNAHMEDATUM>2021-12-07 09:40:00</ENTNAHMEDATUM>
<PROBENAHMETVO>1</PROBENAHMETVO>
<PROBENART>089999999000000000287</PROBENART>
<PROBENUMMER>P2021001235</PROBENUMMER>
</PROBE>
<UNTERSUCHUNGSERGEBNIS>
<PROBE>.</PROBE>
<PARAMETER>229999999000000000403</PARAMETER>
<ANALYSEVERFAHREN>019999999000000000347</ANALYSEVERFAHREN>
<MESSWERTTEXT>7,6</MESSWERTTEXT>
</UNTERSUCHUNGSERGEBNIS>
</TEIS>
Die Datenobjekte innerhalb der Datei werden über eine 21-stellige ZID (Zentrale Identifikation) identifiziert. Sie besteht aus folgenden Teil-IDs.
| Kurzbezeichnung | Name | Stellen | Beschreibung |
|---|---|---|---|
| CID | Class-ID | 2 | Kennzeichnung der Datenklasse, s. Tabelle 5 |
| IID | Instance-ID | 7 | Kennzeichnung der TEIS-Instanz, die das Objekt erstellt hat, also die LID vergeben hat (das IWW vergibt z.B. die LID für die Parameter und das zugehörige Gesundheitsamt die LID für die Probenahmestellen). |
| LID | Local-ID | 12 | Lokale Kennzeichnung einer entsprechenden TEIS-Instanz |
|
CID |
Datenklasse TEIS |
Datenklasse/Feld diaLIMS |
|---|---|---|
|
01 |
Analyseverfahren |
Methode |
|
08 |
Probenart (s. Tabelle 6) |
Probe.teisProbenart |
|
08 |
Messwertstatus (Codierung für "<" oder ">") (s. Tabelle 7) |
ErgebnisWert.wert (/ ZPAE.statistikwert.mittelwert) (Vorzeichen des Wertes) |
|
22 |
Parameter |
Ergebnis |
|
25 |
Probenahmestelle |
Unterstelle |
|
30 |
Untersuchungsstelle |
Das Labor (Eintrag in den Optionen unter 'GAInterfaceTeis3UntersuchungsstelleZID') |
|
39 |
Messwerttext (Codierung für "nicht bestimmbar" oder "nicht nachweisbar") |
|
| Vorzeichen | ZID |
|---|---|
| > | 089999999000000000001 |
| < | 089999999000000000002 |
Logging
Die Schnittstelle loggt pro Durchlauf folgende Informationen:
- Den Speicherort und Dateinamen der Exportdatei bei erfolgreichem Export
- Die fehlenden Pflichtfelder
- 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.