Zum Hauptinhalt springen

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

- In einem Exportvorgang dürfen nur Proben, die zu demselben Gesundheitsamt exportiert werden sollen, behandelt werden. Sind die Proben also unterschiedlichen Probenstellen zugeordnet, so wird der Export mit einem Hinweis abgebrochen. Die IID des zuständigen Gesundheitsamts ist somit pro Exportvorgang eindeutig.

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

  • 0 bedeutet nein

<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

- Eine TEIS-Probe wird durch ihre Probenahmestelle-ZID, die Untersuchungstelle-ZID und das Entnahmedatum identifiziert. Diese drei Daten müssen also pro Probe eindeutig sein. Sind die zu exportierenden Proben bzgl. dieser Felder nicht eindeutig, so wird der Export mit einem Hinweis abgebrochen. Damit die Proben trotzdem exportiert werden können, kann das Nahmedatum bzw. die Nahmezeit der Proben angepasst werden. - Stornierte und geplante Proben werden nicht exportiert.

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

.

  • Probe: Eintrag ist immer der Punkt,

das Untersuchungsergebnis bezieht sich auf die vorherige Probe

<PARAMETER>

x

ZPAE.ergebnis.teisParameterZID

  • ZID des Parameters

<ANALYSEVERFAHREN>

x

ZPAE.analyse.teisAnalyseverfahrenZID

  • ZID des Analyseverfahrens

<MESSWERTSTATUS>

ErgebnisWert.wert

(/ ZPAE.statistikwert.mittelwert)

(Vorzeichen des Wertes)

  • ZID des Vorzeichens (< oder >).
  • Wenn kein Vorzeichen vorhanden ist, wird der Tag nicht exportiert.
  • s. Tabelle 7

<MESSWERTTEXT>

x

ZPAE.statistikwert.mittelwert / ErgebnisWert.wert

  • Messwert, maximal 20 Zeichen
  • Es wird der Mittelwert oder sonst der erste gültige Ergebniswert exportiert.
  • Für numerische Werte sind nur Ziffern, das Minuszeichen und das Komma als Dezimaltrennzeichen erlaubt.
  • Handelt es sich nicht um ein numerisches Ergebnis oder enthält der Messwert eines numerischen Ergebnisses Buchstaben oder Sonderzeichen, so wird der Messwert in Textform exportiert. Das Format entspricht dem Format im diaLIMS.
  • Handelt es sich um ein numerisches Ergebnis mit numerischen Messwert, so wird dieser automatisch nach den TEIS-Vorgaben für numerische Werte formatiert.
  • Es wird davon ausgegangen, dass die Angabe eines numerischen Messwertes immer in der in TEIS festgelegten Einheit des entsprechenden Parameters erfolgt.

<STICHWORT>

wird standardmäßig nicht exportiert

  • Stichwort, maximal 250 Zeichen
- Probenergebnisse, die storniert sind, an denen der Drucken-Schalter nicht gesetzt ist oder keine TEIS-Parameter-ID am Ergebnis hinterlegt ist, werden beim Export kommentarlos übergangen. Für alle anderen Probenergebnisse wird je ein <UNTERSUCHUNGSERGEBNIS>-Tag erzeugt, wenn mindestens ein Messwert eingetragen ist und eine TEIS-Analyseverfahren-ZID an der Methode hinterlegt ist. Fehlt eine dieser Angaben, wird das im Log vermerkt und das Probenergebnis übergangen. - Wird kein Probenergebnis einer Probe exportiert werden, so wird die Probe auch nicht exportiert. - Ein TEIS-Untersuchungsergebnis wird durch seine Parameter-ZID identifiziert. Diese ZID muss also pro Probenergebnis an einer Probe eindeutig sein. Sind die Probenergebnisse einer Probe bzgl. der Parameter-ZID nicht eindeutig, so wird die komplette Probe nicht exportiert. Ein entsprechender Hinweis wird im Log vermerkt.

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.

KurzbezeichnungNameStellenBeschreibung
CIDClass-ID2Kennzeichnung der Datenklasse, s. Tabelle 5
IIDInstance-ID7Kennzeichnung 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).
LIDLocal-ID12Lokale 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")

|Kurzbezeichnung|ZID|Beschreibung| |---------------|---|------------| |PRO-Z|089999999000000000041|Zufallsstichprobe| |PRO-S0|089999999000000000042|Stagnationsprobe S-0| |PRO-S1|089999999000000000043|Stagnationsprobe S-1| |PRO-S2|089999999000000000045|Stagnationsprobe S-2| |PRO-N|089999999000000000044|Keine Zuordnung zu UBA-Empfehlung| |PRO-NP|089999999000000000066|Nachprobe| |PRO-M1|089999999000000000239|DIN EN ISO 19458:2006 \(D\), Zweck a| |PRO-M2|089999999000000000240|DIN EN ISO 19458:2006 \(D\), Zweck b| |PRO-M3|089999999000000000241|DIN EN ISO 19458:2006 \(D\), Zweck c| |PRO-T1|089999999000000000286|DIN EN ISO 5667-5:2011-02| |PRO-M4|089999999000000000287|DIN EN ISO 19458:2006 \(D\), Zweck a + DIN EN ISO 5667-5:2011-02| |PRO-M5|089999999000000000288|DIN EN ISO 19458:2006 \(D\), Zweck b + DIN EN ISO 5667-5:2011-02| |PRO-M6|089999999000000000289|DIN EN ISO 19458:2006 \(D\), Zweck c + DIN EN ISO 5667-5:2011-02| |PRO-SP|089999999000000000290|Schöpfprobe| |PRO-SU|089999999000000000294|Sonderuntersuchung| |PRO-RW|089999999000000000296|Rieselwasser|
VorzeichenZID
>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.