Die HL7-Schnittstelle in Cypro · Die HL7-Schnittstelle in Cypro ... Trainings- (Test-) und...

Die HL7-Schnittstelle in Cypro

Der bekannteste Kommunikationsstandard für Daten des Gesundheitswesens ist HL7 (HealthLevel Seven). Dieser ursprünglich in den USA (Universitätsklinik in Palo Alto 1987) entwickelte Standard spezifiziert Austauschformate und -inhalte auf der Anwendungsebene, d.h. er beschreibt die Kommunikation unabhängig von der eingesetzten Soft- und Hardware.

Die Cypro-HL7-Schnittstelle arbeitet mit SAP- und nicht SAP-Krankenhaus-Systemen. Diese Systeme benutzen normalerweise keine SAP-Bewegungs-Nummer, deshalb erstellt Cypro eigeneBewegungs-Nummern. Wenn Sie es wünschen, können Sie allerdings auch HL7 Schnittstellen mit Nicht-SAP-Systemen benutzen, die eigene Bewegungs-Nummern verwenden.

Cypro unterstützt die HL7-Version 2.2 und 2.31 mit folgenden HL7-Befehlen:

A01 : Admit Patient (Patient neu aufnehmen)

A02 : Transfer Patient (Patient verlegen)

A03 : Discharge Patient (Patient entlassen)

A04 : Register Patient (Ambulanter Besuch)

A06 : Transfer outpatient to inpatient (Wechsel ambulant nach stationär)

A07 : Transfer inpatient to outpatient (Wechsel stationär nach ambulant)

A08 : Update Patient (Patientdaten ändern)

A11 : Cancel Admit Patient (Neuaufnahme stornieren)

A12 : Cancel Transfer Patient (Verlegung stornieren)

A13 : Cancel Discharge Patient (Entlassung stornieren)

A31 : Update Patient (Patientdaten ändern, analog A08)

A40 : Merge Patient (Patienten zusammenführen)

Hier ein Beispiel:Patient A kommt ins Krankenhaus. Die Aufnahmedaten werden in das Krankenhaus-Informations-System eingebracht (Name, Vorname, Adresse, .Aufnahme-Nummer, Station,...). Die Apotheke verfügt über ein eigenes EDV-System, in dem diese Daten über die HL7-Schnittstelle in Cypro eingefügt werden, wodurch die erneute manuelle Eingabe von Patienten, sowie das Aufnehmen und Entlassen entfällt. Daten bestehender Cypro-Patienten werden durch die HL7-Schnittstelle automatisch aktualisiert, die Daten von Nicht-Cypro-Patienten verbleiben in der HL7 Datenbank. Diese können als HL7-Patienten in die Cypro-Datenbank eingefügt werden.

CIS healthcare Deutschland GmbH Große Gänseweide 22 21423 Winsen (Luhe) DeutschlandGeschäftsführer Norbert Beins, Clive Richardson [email protected] www.cypro.de

Amtsgericht Lüneburg HRB 201720 USt-ID-Nr. DE 262 117 338 Steuer-Nr. 50/200/22051Seite 1 / 39 Sparkasse Harburg-Buxtehude BLZ 207 500 00 Konto 60096641 IBAN DE75 2075 0000 0060 0966 41

Das Programm der Zytostatika-Herstellung.

Allgemeines

Voraussetzungen für den Betrieb der HL7-Schnittstelle

Die HL7-Schnittstelle ist als Windows-Dienst realisiert und läuft deswegen nur in Windows NT 4.0, Windows 2000 und Windows XP. Für Windows 9x-Systemen sieht Cypro keine Anbindung an das krankenhausinterne Kommunikations-System vor.

Vor der Inbetriebnahme der HL7-Schnittstelle muss entweder ein Firebird-Client (wenn die Cypro-Datenbank sich nicht auf dem lokalen Rechner befindet) oder ein Firebird-Server (wenn sich die Cypro-Datenbank auf dem lokalen Rechner befindet) installiert sein und laufen. Die HL7-Schnittstelle funktioniert global im Cypro-Netzwerk und braucht deswegen nur auf einem Rechner installiert werden. Mehrere Installationen sind sehr kontraproduktiv für die Geschwindigkeit der Datenbank, da nun die HL7-Botschaften mehrfach abgearbeitet werden. Dies führt zwar nicht dazu, das Daten doppelt eingetragen werden (da die Schnittstelle ja von vornherein von einer dualen Eingabe ausgeht), Einfüge-Operationen werden von den mehrfach aktiven Schnittstellen dann aber als Aktualisierungen ausgeführt.

Die HL7-Schnittstelle sollte also auf jedem Fall nur ein einziges Mal aktiv installiert sein.

Die generische Cypro-Schnittstelle

Cypro verwendet für die Schnittstelle zum Krankenhaus-Informations-System eine generische Schnittstellen, die im Bedarf programmiertechnisch an individuelle Besonderheiten angepasst werden kann:

Andere HL7-Versionen, besondere Feld-Formatierungen, angepasste HL7-Botschaften, Typ der Nachrichten-Übermittlung (Socket-Verbindung, XML)

Im nachfolgenden ist die Cypro-Standard-HL7-Schnittstelle beschrieben.

Wie werden Daten in Cypro eingefügt?

Die HL7-Schnittstelle ist an das Krankenhaus-interne HL7-Kommunikations-System angeschlossen und empfängt über eine Socket-Verbindung alle gesendeten HL7-Botschaften. Die Kommunikations-Einstellungen können in den Cypro-Optionen geändert werden.

Die empfangenen Daten werden zunächst auf Fehlerfreiheit geprüft und dann in eine spezielle HL7-Daten-Verwaltung in die Cypro-Datenbank eingetragen. Die ankommenden HL7-Daten werden nur dann an die Cypro-Patienten weitergereicht, wenn ein „HL7-Patienten“ zuvor als„Cypro-Patient“ eingefügt wurde.



Allgemeines

Das MSH-Segment

Für jede HL7-Botschaft wird ein MSH- und ein EVN-Segment gesendet. Die HL7-Schnittstelle liest folgende Informationen aus:

HL7-Segment HL7-Sequenz-Name Sequenz-Nr.MSH SENDING APPLICATION 3MSH SENDING FACILITY 4MSH RECEIVING APPLICATION 5MSH RECEIVING FACILITY 6MSH DATE/TIME OF MESSAGE 7MSH MESSAGE TYPE 9MSH MESSAGE CONTROL ID 10MSH PROCESSING ID 11MSH VERSION ID 12MSH ACCEPT ACKNOWLEDGEMENT TYPE 15MSH APPLICATION ACKNOWLEDGEMENT TYPE 16EVN EVENT TYPE CODE 1EVN DATE/TIME OF EVENT 2PV1 SET ID - PATIENT VISIT 1

Der Haupt-Separator (normalerweise das Zeichen „|“’) wird aus dem ersten Zeichen im MSH-Segment hinter der Segmentbezeichnung („MSH“) gelesen. Der Detail-Separator wird aus dem ersten Zeichen im zweiten Feld des MSH-Segments gelesen (normalerweise das Zeichen „^“).

Die Datums- und Zeitinformationen müssen in einem bestimmten Format vorliegen. Abhängig vom Feldtyp in der HL7-Botschaft können diese entweder als „yyyymmdd[hhmmss]“ gesendet werden, oder auch noch weitere Zeitinformationen, wie z.B. Millisekunden enthalten.

Die HL7-Schnittstelle liest jedoch bei Datumsfeldern nur Jahr, Monat und Tag aus, bei Zeitfeldern wird noch zusätzlich Stunde, Minute und Sekunde ausgelesen. Alle weiteren Informationen werden ignoriert.

Die Länder-Informationen (Land und Staatsangehörigkeit) muss als Alpha-2 oder Alpha-3 Code nach ISO 3166-1 vorliegen. Cypro entscheidet je nach Länge des Eintrages, welcher Code vorliegt.

Die Bewegungs-Nummer wird standardmäßig aus dem ersten Feld im PV1-Segment (SET ID - PATIENT VISIT) ausgelesen. Hier sind nur Zahlen erlaubt. Buchstaben oder andere Zeichen, die eine Umformung der Feld-Informationen in eine Zahl nicht zulassen würden, sind nicht erlaubt.



Allgemeines

Voraussetzung für die Daten-Annahme durch Cypro

Die HL7-Schnittstelle nimmt nur dann Daten an, wenn diese folgende Voraussetzungen erfüllen:

1. Die HL7-Daten stammen von einer Cypro bekannten Anwendung (Dieser Wert entsprichtMSH.SENDING_APPLICATION)

2. Die HL7-Daten stammen von einer Cypro bekannten „Einrichtung“ (Dieser Wert entsprichtMSH.SENDING_FACILITY)

3. Die HL7-Daten werden für eine Cypro bekannte Anwendung (normalerweise ist dies Cypro selbst) ausgesandt (Dieser Wert entspricht MSH.RECEIVING_APPLICATION)

4. Die HL7-Daten werden an eine Cypro bekannte „Einrichtung“ ausgesandt (Dieser Wert entspricht MSH.RECEIVING_FACILITY)

5. Es handelt sich um Produktions-Daten (MSH.PROCESSING-ID=“P“). Trainings- (Test-) undDebug-Daten werden nur dann empfangen (allerdings auch vollständig in die HL7-bzw. Cypro-Datenbank eingetragen), wenn dies in den Optionen eingestellt ist.

6. Die ausgesandten Daten können von bestimmten Start- und Endzeichen eingeschlossen sein. In diesem Fall wird alles ignoriert, was außerhalb dieser Zeichen steht.

Bestätigungsmeldung an den HL7-Server

Alle empfangene Daten werden überprüft, ob sie für Cypro bestimmt sind und alle Voraussetzungen für die weitere Verarbeitung erfüllen (dazu gehört auch Fehlerfreiheit und vollständige Übermittlung aller HL7-Daten).

Sieht die HL7-Botschaft eine Bestätigungsmeldung vor oder wird dies in den Optionen explizit eingestellt, so sendet Cypro nach Empfang bzw. nach Verarbeitung der Daten eine Bestätigungsmeldung (Acknowledgement) an das übermittelnde System

Dabei sieht Cypro zwei Möglichkeiten vor.

Möglichkeit 1: Accept-AcknowledgementDie Nachricht wird gespeichert und anschließend das MSH-Segment überprüft. Werden die Einträge der Felder MSH-9, MSH-11 und/oder MSH-12 nicht akzeptiert, so wird ein „Commit Reject“ (CR) zurückgesandt. Liegen andere Gründe für eine Ablehnung der Nachricht vor, so wird ein „Commit Error“ (CE) übermittelt, andernfalls wird die Nachricht zur Weiterverarbeitung weitergegeben und ein „Commit Accept“ (CA) zurückgesandt.



Allgemeines

Möglichkeit 2: Application-AcknowledgementBei diesem Verfahren werden die ACK-Nachrichten erst nach Verarbeitung der Daten in der HL7-Patienten-Verwaltung und in der Cypro-Patienten-Verwaltung verschickt. Dies erfolgt in der Regel zeitversetzt zum Eingang der zu bestätigenden Nachricht. Es gibt dabei zwei Möglichkeiten:

● Wenn die Nachricht korrekt verarbeitet werden konnte, wird „Application Accept“ (AA) zurückgesandt.

● Konnte die Nachricht aufgrund eines formalen oder inhaltlichen Fehlers nicht ausgewertet werden, so wird „Application Error“ (AE) geschickt.

Die HL7-Schnittstelle kann natürlich auch zuerst ein Accept-Acknowledgement versenden und dann im Anschluss ein Application-Acknowledgement. Dies kann man entweder über die eingehende HL7-Nachricht steuern (Felder MSH-15 und MSH-16) oder über die Cypro-Optionen.

Das Senden eines Application-Acknowledgement ist beim Betrieb in hochfrequenten Nachrichtensystemen nicht möglich.

Aufbau der ACK-Nachricht

Bei einer ACK-Nachricht sendet Cypro zunächst das empfangene MSH-Segment und dann nach einem Zeilenumbruch (<CR>) das MSA-Segment mit Acknowledgement-Code und Message-Control-ID aus dem MSH-Segment.

Im MSH-Segment kann der Wert für „MESSAGE_TYPE“ durch „ACK“ ersetzt werden. Aktivieren Sie dazu die Option „im MSH-Segment "ACK" anstatt des ursprünglichen MESSAGE_TYPE senden“ (Cypro-Optionen – Rubrik „HL7“- Seite „Allgemeines“).



Allgemeines

Eingefügte Daten in Cypro

Die HL7-Schnittstelle fügt folgende Daten in Cypro ein:

Wert für Cypro HL7-Segment

HL7-Sequenz-Name Länge Sequenz-Nummer

Patienten-ID PID PATIENT-ID 30 3Patient-Name PID PATIENT NAME 30 5Patient-Vorname PID PATIENT NAME 30 5Patient-Anrede/Titel PID PATIENT NAME 30 5Patient-Geburtsdatum PID DATE OF BIRTH ./. 5Patient-Geschlecht PID SEX 8Adresse-Strasse PID PATIENT ADRESS 50 11Adresse-Ort PID PATIENT ADRESS 50 11Adresse-Postleitzahl PID PATIENT ADRESS 10 11Adresse-Land PID PATIENT ADRESS 50 11Telefon privat PID PHONE NUMBER-HOME 25 13Telefon geschäftlich PID PHONE NUMBER-BUSINESS 25 14Staatsangehörigkeit PID CITIZENSHIP 50 26Bewegungsnummer PV1 30 1Krankenhaus PV1 ASSIGNED PATIENT LOCATION 50 3Abteilung PV1 ASSIGNED PATIENT LOCATION 50 3Station PV1 ASSIGNED PATIENT LOCATION 50 3Arzt-ID-Kennung PV1 ATTENDING DOCTOR 20 7Arzt-Name PV1 ATTENDING DOCTOR 30 7Arzt-Vorname PV1 ATTENDING DOCTOR 30 7Arzt-Anrede/Titel PV1 ATTENDING DOCTOR 30 7Patient-Aufnahme-Nummer PV1 VISIT NUMBER 15 19Aufnahme-Zeitpunkt PV1 ADMIT DATE/TIME ./. 44Entlassungszeitpunkt PV1 DISCHARGE DATE/TIME ./. 45Patient verlegen ab EVN DATE TIME OF EVENT ./. 2Gültigkeitsdatum der Versicherungs-Karte

IN1 PLAN EXPIRATION DATE 8 13

Krankenkassen-Nummer IN1 INSURANCE COMPANY ID 15 3Krankenkasse IN1 INSURANCE COMPANY NAME 60 4Versicherten-Nummer IN1 POLICY NUMBER 25 36Arzt-ID-Kennung STF ATTENDING DOCTOR 20 1Arzt-Name STF ATTENDING DOCTOR 30 3Arzt-Vorname STF ATTENDING DOCTOR 30 3Arzt-Anrede/Titel STF ATTENDING DOCTOR 30 3Bewegungsnummer ZBE 30 2Patient verlegen ab ZBE /. 3Bewegungsnummer ZID 30 2Patient verlegen ab ZID /. 3

Vorgabe-Felder, alternative Felder sind andersfarbig markiert



Eingefügte Daten in Cypro

Besondere HL7-Sequenzen

Einige HL7-Sequenzen liegen nicht als einzelne Felder, sondern als zusammengesetzte Felder vor. Die nachfolgend beschrieben HL7-Sequenzen können je nach Krankenhaus unterschiedlich aufgebaut sein. Hier wird zunächst die standardmäßige Kodierung beschrieben. In den nachfolgenden Kapiteln wird auf die Anpassung an spezifische Gegebenheiten eingegangen.

1. Patient-Namens-Informationen: Patient-Vorname, Patient-Name, Patient-Anrede/TitelDiese Information liegt standardmäßig wie folgt vor:FAMILY NAME ^ GIVEN NAME ^ MIDDLE INITIAL OR NAME ^ SUFFIX ^ PREFIX ^ DEGREE

Die HL7-Schnittstelle liest folgendes aus:Patient-Name = MIDDLE INITIAL OR NAME + FAMILY NAME + SUFFIX,Patient-Vorname = GIVEN NAME, Patient-Anrede = PREFIX + DEGREE

2. Patient-Adresse: Strasse, Ort, Postleitzahl, LandDiese Information liegt wie folgt vor:STREET ADDRESS ^ OTHER DESTINATION ^ CITY ^ STATE OR PROVINCE ^ ZIP ^ COUNTRY ^ TYPE

Die HL7-Schnittstelle liest folgendes aus:Strasse = STREET ADDRESS, Ort = CITY, Postleitzahl = ZIP, Land = COUNTRYDer Wert in TYPE wird ignoriert. Die HL7-Schnittstelle trägt immer alles als Privat-Adresse ein.

3. Stations-Informationen: Krankenhaus, Abteilung, StationDiese Information liegt standardmäßig wie folgt vor:NURSE UNIT ^ ROOM ^ BED ^ FACILITY ID ^ BED STATUS

Die HL7-Schnittstelle liest folgendes aus:Station = NURSE UNIT, Abteilung = FACILITY ID, Krankenhaus = die ersten zwei Zeichen von NURSE UNITDie Werte für Krankenhaus, Abteilung, Station sind keine vollständigen Namensbezeichnungen, sondern eindeutige Abkürzungen. Die Kodierung des Krankenhauses kann in den Optionen verändert werden (siehe „Kodierung für Krankenhaus“). Hier wird das Standard-Verfahren aufgezeigt.

4. Arzt-Namens-Informationen: Arzt-ID-Kennung, Arzt-Vorname, Arzt-NameDiese Information liegt standardmäßig wie folgt vor:ID NUMBER ^ FAMILY NAME ^ GIVEN NAME ^ MIDDLE INITIAL OR NAME ^ SUFFIX ^PREFIX ^ DEGREE

Die HL7-Schnittstelle liest folgendes aus:Arzt-ID-Kennung = ID NUMBERArzt-Name = MIDDLE INITIAL OR NAME + FAMILY NAME + SUFFIX,Arzt-Vorname = GIVEN NAME, Arzt-Anrede = PREFIX + DEGREE




Kodierung für Namen

Die Kodierung für Arzt- und Patienten-Namen kann in den Cypro-Optionen entsprechend den Gegebenheiten des Krankenhauses angepasst werden.

Standardmäßig erwartet Cypro den Patienten-Namen in folgendem Format:FAMILY NAME ^ GIVEN NAME ^ MIDDLE INITIAL OR NAME ^ SUFFIX ^ PREFIX ^ DEGREE

Der Arzt-Name wird wie folgt erwartet:ID NUMBER^FAMILY NAME^GIVEN NAME^MIDDLE INITIAL OR NAME^SUFFIX^PREFIX^ DEGREE

Werden die Namens-Informationen abweichend übertragen, so wählen Sie aus den nachfolgend aufgeführten Optionen. Sie finden diese in der Rubrik „HL7“ auf der Seite „Spezielles“ und der Unterseite „Kodierung“.

● Der Arzt-Name wird genauso wie der Patienten-Name übertragen:ID NUMBER^FAMILY NAME^GIVEN NAME^MIDDLE INITIAL OR NAME^SUFFIX^PREFIX^ DEGREE

● Der Arzt-Name wird ohne "MIDDLE INITIAL OR NAME" übertragen

Verwenden Sie diese Option, wenn Ihr HL7-Server an Cypro für den Arzt-Namen das Feld „MIDDLE INITIAL OR NAME“ nicht sendet.

Achtung:Damit ist nicht gemeint, dass dieses Feld nicht gefüllt wird.

Wählen Sie dies also nur, wenn an Cypro für den Arzt z.B. folgendes gesendet wird:

0001^Muster-Arzt^Paul^^^Dr. med.Wählen Sie dies NICHT, wenn an Cypro für den Arzt z.B. folgendes gesendet wird:

0001^Muster-Arzt^Paul^^^^Dr. med.

● Der Arzt-Name wird ohne „SUFFIX“ und ohne „PREFIX“ übertragen

● „MIDDLE INITIAL OR NAME“ des Patient- und des Arzt-Namens gehört zum Nachnamen




● „MIDDLE INITIAL OR NAME” des Patient- und des Arzt-Namens ist Vorsatz zum Titel und gehört nicht zum Nachnamen

Mit dieser Option wird das Feld „MIDDLE INITIAL OR NAME“ als Bestandteil des Titels gewertet.

Cypro setzt den Titel dann aus MIDDLE INITIAL OR NAME + PREFIX + DEGREE zusammen, ansonsten wird der Titel aus PREFIX + DEGREE zusammengesetzt.

● „MIDDLE INITIAL OR NAME“ des Patient- und des Arzt-Namens beinhaltet den 2. sowie weitere Vornamen und gehört nicht zum Nachnamen

Die hier beschriebenen Optionen haben keinen Einfluss auf schon verarbeitete HL7-Botschaften. Sie gelten nur für neu ankommende HL7-Botschaften.

Leere Vornamen und unvollständiges Geburtsdatum

Um HL7-Botschaften auch verarbeiten zu können, wenn der Patienten-Vorname leer ist oder das Geburtsdatum unvollständig ist, wählen Sie die Optionen „Erlaube leere Vornamen für Patienten“ und „Erlaube ein unvollständiges Geburtsdatum für Patienten“ (HL7-Optionen – Rubrik „HL7“- Seite „Spezielles“ - Unterseite „Eingabe/Aktualisierung“).

Ist die Option „Erlaube leere Vornamen für Patienten“ gewählt, so verwendet Cypro ein Leerzeichen („ “) anstelle des leeren Vornamens. Wird ein solcher Patient als Cypro-Patient eingefügt und anschließend in der Patientenverwaltung bearbeitet, so erhalten Sie eine Hinweismeldung, dass der Vornamen eingeben werden muss. Ein Leerzeichen ist nicht zulässig. Um dies zu umgehen und ein Leerzeichen als zulässigen Vornamen verwenden zu können, aktivieren Sie auch bei den Cypro-Clients die Option „Erlaube leere Vornamen für Patienten“.

Ist die Option „Erlaube ein unvollständiges Geburtsdatum für Patienten“ gewählt, so wird ein unvollständiges Geburtsdatum um die fehlenden Werte vervollständigt.

Ein vollständiges Geburtsdatum wird im Format „yyyymmdd“ übertragen. Nicht übertragene Werte werden durch „01“ ersetzt.

Beispiel:Geburtsdatum in der HL7-Botschaft „Cypro“-Geburtsdatum

19550724 24.07.1955

195507 01.07.1955

1955 01.01.1955




Kodierung für Krankenhaus

Die Kodierung für die Krankenhaus-Informationen wird in den Cypro-Optionen – Rubrik „HL7“- Seite „Spezielles“ - Unterseite „Kodierung“ eingetragen.

Cypro unterstützt 4 „Kodierungs-Verfahren“:

1. Das Krankenhaus wird in einem 2-stelligen Code als Bestandteil von Abteilung und Station übertragen: <Krankenhaus><Station>^^^<Krankenhaus><Abteilung>Dies ist das Standard-Verfahren der Cypro-HL7-Schnittstelle (siehe „Besondere HL7-Sequenzen“). In Segment PV1.3 wird die Abteilung und die Station als „NURSE UNIT ^ ROOM ^ BED ^ FACILITY ID ^ BED STATUS“ übertragen. Das Krankenhaus wird als zweistelliges Zeichen jeweils vor „NURSE UNIT“ und jeweils vor „FACILITY ID“ übertragen.

2. Das Krankenhaus wird in Segment MSH.SENDING FACILITY kodiertDas Krankenhaus wird in Segment MSH.SENDING FACILITY (MSH.4) anstelle der Kennung für die sendende „Einrichtung“ übertragen.

3. Das Krankenhaus wird in der HL7-Botschaft nicht kodiertWählen Sie diese Variante nur, wenn immer sichergestellt ist, das alle mit HL7 übertragenen Abteilungen und Stationen nur zu einem Krankenhaus gehören. Cypro verwendet in diesem Fall für jede Abteilung/Station ein Krankenhaus mit der Kennung „0“.

4. Das Krankenhaus UND die Abteilung wird in der HL7-Botschaft nicht kodiertWählen Sie diese Variante nur, wenn immer sichergestellt ist, dass Krankenhaus und Abteilung nicht in der HL7-Botschaft übertragen werden. Noch nicht in die Cypro-Stationsverwaltung eingetragene Stationen können mit dieser Option allerdings nicht automatisch in Cypro eingetragen werden, da das zugehörige Krankenhaus und die Abteilung nicht bekannt sind.

Führende Nullen in Stationsbezeichnungen werden entfernt, wenn die ersten beiden Zeichen als Krankenhaus-Kennung dienen (Option „Das Krankenhaus wird in einem 2-stelligen Code als Bestandteil von Abteilung und Station übertragen: <Krankenhaus><Station> ^^^<Krankenhaus> <Abteilung>“).




Bewegungsnummer und Verlegungsdatum

Wenn ein ZID-Segment gesendet wird, dann wird die Bewegungsnummer aus dem zweiten Feld dieses Segments gelesen. Wird ein ZBE-Segment gesendet wird, dann wird die Bewegungsnummer aus dem zweiten Feld des ZBE-Segments gelesen, ansonsten wird das erste Feld des PV1-Segments verwendet.

Wenn ein ZID- oder ein ZBE-Segment gesendet wird, dann wird das Verlegungsdatum bei einer Patientenverlegung aus dem dritten Feld dieser Segmente gelesen, ansonsten wird das zweite Feld des EVN-Segments verwendet.

Arzt-Informationen aus dem STF-Segment

Die Arzt-Informationen in der HL7-Botschaft werden aus dem STF-Segment gelesen, wenn ein solches Segment übertragen wird. Ist das STF-Segment nicht vorhanden, werden die Information aus Feld PV1.7 verwendet.

Die ID-Nummer des Arztes wird aus dem ersten Feld des STF-Segments ausgelesen.

Krankenkassen-Informationen

Die Krankenkassen-Informationen werden aus dem IN1-Segment ausgelesen.

Cypro akzeptiert nur IN1-Segmente, wenn diese als Hauptversicherung deklariert sind (22. Feld des IN1-Segments='01' oder Feld 15.2 des IN1-Segments='H'). Als Hauptversicherung wird auch ein IN1-Segment mit Feld 15.2 des IN1-Segments='H' angesehen. Wenn es in der HL7-Botschaft keine Hauptversicherung gibt, dann wird nur das IN1-Segment mit leerer Segmentnummer (Feld IN1.1) oder mit „1“ als Segmentnummer verwendet. IN1-Segmente, die als „Selbstzahler“ deklariert sind (22. Feld des IN1-Segments='98') werden immer abgelehnt.

Das Gültigkeitsdatum der Versicherungs-Karte wird aus dem 13. Feld des IN1-Segments gelesen.




Geschlecht und Patienten-Klasse/ Patientenstatus

Als Wert für Geschlecht (Feld PID.8) sind neben den englischen auch die deutschen Abkürzungen zulässig:

„F“ (female), „M“ (male), „O“ (other), „U“ (unknown), „W“ (weiblich), „M“ (männlich).

Als Wert für die Patienten-Klasse/ Patientenstatus (Feld PV1.2) ist folgendes zulässig:

„I“ oder „1“ (inbound), „O“ oder „2“ (outbound), „T“ oder „3“ (teilstationär),„S“ oder „4“ (stationär), „A“ (ambulant).

Welche Felder dürfen nicht leer sein?

Cypro benötigt bestimmte Felder in der HL7-Botschaft, die nicht leer bleiben dürfen. Dies sind:

1. Alle Felder im MSH-Segment außer ACCEPT ACKNOWLEDGEMENT TYPE undAPPLICATION ACKNOWLEDGEMENT TYPE

2. Die Felder EVENT TYPE CODE und DATE/TIME OF EVENT aus dem EVN-Segment

3. Die Felder für Patient-ID, Name, Vorname, Geburtsdatum aus dem PID-SegmentAnmerkung: Je nach Option, ist auch ein Betrieb ohne Vorname möglich (siehe „Leere Vornamen und unvollständiges Geburtsdatum”).

4. Die Felder für Bewegungs-Nummer, Aufnahme-Nummer, Aufnahme-Zeitpunkt aus dem PV1-SegmentAnmerkung: Je nach Option, ist auch ein Betrieb ohne Bewegungsnummer möglich (siehe „Warum benötigt Cypro eine Bewegungs-Nummer?”, ff.).

Folgende Felder müssen eindeutig sein, d.h. sie dürfen nie doppelt vergeben werden:

1. Patient-ID

2. Bewegungs-Nummer

3. Aufnahme-Nummer

4. ID-Kennung für den Arzt

5. Abkürzungen (ID-Kennung) für Krankenhaus, Abteilung, Station




Konfiguration der Schnittstelle

Alle Einstellungen für die HL7-Schnittstelle können in den Cypro-Optionen getroffen werden. Für die HL7-Konfiguration ist im Options-Programm eine Rubrik „HL7“ eingefügt worden.

Hier kann, wie auch schon bereits erwähnt, eingestellt werden, welche HL7-Botschaften Cypro entgegennehmen soll (z.B. nur Produktionsdaten, nur Botschaften, die für ein bestimmtes Programm ausgeschickt werden). Ebenso kann hier eingestellt werden, ob und welche Art der ACK-Nachricht ausgeschickt werden soll. Sie finden diese Einstellungen auf der Seite „HL7“-„Allgemeines“.

Die Optionen gelten nur lokal, d.h. die Optionen für die Schnittstelle wirken sich nur dann aus, wenn Sie auf dem Rechner eingestellt werden, auf dem die HL7-Schnittstelle aktiviert ist.

Anbindung an den Krankenhaus-Kommunikationsserver

Auf der Seite „HL7“-HL7-Server“ können die Einstellungen zur Anbindung an den Krankenhaus-internen HL7-Kommunikationsserver gewählt werden (Port und Rechner-Name bzw. IP-Adresse).

Cypro unterstützt 3 Betriebs-Modi:1. Eine ständige Socket-Verbindung zwischen der HL7-Schnittstelle und dem HL7-Server-Rech

ner (der Rechner, der die HL7-Botschaften aussendet)

2. Eine Socket-Verbindung, wobei der Verbindungsaufbau erst dann erfolgt, wenn der HL7-Server eine HL7-Botschaft aussendet (dies ist die Standard-Option)

3. HL7-Botschaften aus Dateien auslesen

Wenn Sie keine ständige Verbindung zum HL7-Server herstellen, wird die Verbindung zur HL7-Schnittstelle vom HL7-Server erst dann aufgebaut, wenn eine HL7-Botschaft gesendet werden soll und im allgemeinen nach Erhalt der ACK-Meldung wieder abgebaut.

Wenn Sie eine ständige Verbindung aufbauen, wird die Schnittstelle in den "Abhören"-Modus gesetzt.

Wenn Sie eine ständige Verbindung einrichten möchten, wählen Sie die Option „Eine ständige Verbindung zwischen HL7-Schnittstelle und „HL7-Server" einrichten“. Sie benötigen nun den Port und den Rechner-Namen bzw. die IP-Adresse des HL7-Servers.

Wenn Sie keine ständige Verbindung einrichten möchten (dies ist die Standard-Option), dann markieren Sie die obige Option nicht. Sie benötigen nun nur den Port des HL7-Servers. Auf dem HL7-Server müssen Sie nun natürlich beim aussendenden Programm den Rechner-Namen bzw. die IP-Adresse des Rechners mit der HL7-Schnittstelle angeben.




HL7-Botschaften aus Dateien auslesen

Cypro kann nicht nur HL7-Botschaften über eine Socket-Verbindung empfangen, sondern auch HL7-Botschaften aus Dateien auslesen. Es ist aber nur eine HL7-Botschaft pro Datei zulässig.

Zum Auslesen der Dateien dient das Programm „Cypro-HL7-Server“.

Um HL7-Botschaften aus Dateien auszulesen gehen Sie wie folgt vor:

● Starten Sie die Cypro-HL7-Optionen über das Windows-Startmenü (Gruppe „Cypro“-“Cypro-Dienste“-“HL7-Schnittstelle“-“HL7-Optionen“), über das Programm „Dienst Status Informationen“ (Rechtsklick auf das farbige Kugelsymbol links neben der Uhrzeit-Anzeige auf der Windows-Leiste am unteren Bildschirmrand, Eintrag „HL7-Client“ - „Optionen“) oder über die Optionen im Cypro-Programm (Rubrik „HL7“).

● Gehen Sie nun auf die Seite „HL7-Server“ und wählen Sie „Eine ständige Verbindung zwischen HL7-Schnittstelle und "HL7-Server" einrichten“ ab und dann „HL7-Botschaften aus Dateien auslesen“ aus.

● Geben Sie den Port des HL7-Servers an (z.B. 29777). Der Cypro-HL7-Servers kommuniziert mit der HL7-Schnittstelle über eine lokale Socketverbindung.

● Geben Sie die Datei-Erweiterung (Datei-Endung) der HL7-Dateien, aus denen die Botschaften gelesen werden, und den Pfad zum HL7-Verzeichnis an (hier befinden sich die HL7-Dateien).

Wenn Sich das HL7-Verzeichnis auf einem externen Rechner befindet, müssen Sie einen lokalen Benutzer mit Passwort angeben, der Zugriff auf dieses Verzeichnis hat. Dies müssen Sie auch dann tun, wenn der aktuelle Windows-Benutzer ausreichende Zugriffsrechte besitzt, da der Cypro-HL7-Server aus einem lokalen Windows-Dienst heraus gestartet wird und ansonsten nur Zugriff auf den lokalen Rechner hat. Alternativ können Sie auch einen Benutzer aus einer Domäne angeben.

Um den Datenbank-Server zu entlasten, können Sie ein Sende-Intervall angeben, nach dem die ausgelesen Botschaften an die HL7-Schnittstelle gesendet werden sollen (geben Sie in diesem Fall kein Zeit-Intervall für die HL7-Schnittstelle an (Seite „HL7-Client“), für den HL7-Wartungs-Modus, sollten Sie das aber natürlich tun).

Der Cypro-HL7-Server führt folgendes aus:Die Botschaft wird aus der HL7-Datei ausgelesen und an die Cypro-HL7-Schnittstelle gesendet. Dann wird je nach Option (Seite „Allgemeines“-“ACK-Nachricht senden“) auf das Accept- und Application-Acknowledgement gewartet und ausgewertet. Falls die HL7-Botschaft von der HL7-Schnittstelle erfolgreich empfangen und in die Cypro-Datenbank gespeichert wurde, wird die HL7-Datei gelöscht. Wenn Sie nochmals gesendet werden soll (Accept- Acknowledgement = „CR“) wird die Botschaft einmalig neu gesendet. Wenn die Botschaft von der HL7-Schnittstelle immer noch nicht korrekt verarbeitet werden kann und weiterhin ein Neu-Senden gewünscht wird, dann wird die HL7-Datei mit angehängter ACK-Meldung in den Ordner „HL7_Receive_Error“ unterhalb des HL7-Verzeichnisses verschoben. Fehlerhafte HL7-Botschaften (Accept- Acknowledgement = „CE“ oder Application- Acknowledgement = „AE“) werden mit angehängter ACK-Meldung in den




Ordner „HL7_Error“ unterhalb des HL7-Verzeichnisses verschoben. Cypro legt diese Ordner bei Bedarf an. Das heißt, der Cypro-HL7-Server benötigt Vollzugriff auf den HL7-Datei-Ordner.

Nach dem Senden der Botschaften wartet der Cypro-HL7-Server mindestens die in den Optionen angebende Intervall-Zeit bis zum Senden der nächsten Botschaft, falls diese nicht durch das Warten auf die Acknowledgement-Meldungen überschritten wird.

Für Test-Zwecke können Sie den Cypro-HL7-Server sichtbar schalten (Option „Sende und Empfangsdaten anzeigen“).

Werden HL7-Botschaften aus Dateien gelesen und und ist der Cypro-HL7-beendet bzw. hat dieser keinen Zugriff auf den HL7-Datei-Ordner, so erscheint die HL7-Schnittstelle in der Dienst-Status-Information als deaktiviert (rotes Kugelsymbol).

Die Cypro-HL7-Schnittstelle startet einen manuell beendeten Cypro-HL7-Server automatisch nach 30 Sekunden wieder neu (natürlich nur dann, wenn HL7-Botschaften aus Dateien gelesen werden).

Betriebsmodus der HL7-Schnittstelle festlegen

Die Cypro-HL7-Schnittstelle unterstützt 2 Betriebsmodi, den Normalbetrieb und den Betrieb in hochfrequenten Nachrichtensystemen.

Der NormalbetriebDie eingehenden Daten werden von der HL7-Schnittstelle zunächst ausgewertet und dann als abzuarbeitende Aufgabe vermerkt. Sobald eine HL7-Nachricht als abzuarbeitende Aufgabe vermerkt ist, wird ein Zeitgeber aktiv, der nach einer bestimmten Zeit (normalerweise 1 Minute, einstellbar über die Cypro-Optionen) die aufbereitete HL7-Botschaft entgegennimmt und in die HL7- bzw. die Cypro-Patienten-Verwaltung einfügt. Sind währen dieser Verarbeitungszeit neue Aufgaben angefallen, so werden diese sofort wieder an das Verarbeitungs-System übergeben, ohne ein neues Zeitintervall (1 Minuten) abzuwarten. Gibt es jedoch keine neuen Aufgaben, so bleibt der Zeitgeber aktiv und kontrolliert nun ständig, ob neue Aufgaben zur Verarbeitung vorliegen.

Sie können die eingehenden HL7-Botschaften aber auch sofort verarbeiten lassen. Stellen Sie dazu in den Option als Wert für das Zeit-Intervall „0“ ein (Optionen- Rubrik „HL7“-Seite „Allgemeines“- Option „Die eingehenden HL7-Botschaften immer nach diesem Zeit-Intervall in die HL7- bzw. die Cypro-Datenbank eintragen:“). Ein Zeit-Intervall größer als „0“ können Sie den Datenbank-Server entlasten, da es nun keine „dauerhaften“ Datenbank-Zugriffe gibt (dies ist z.B. dann der Fall, wenn alle 30 oder 60 Sekunden eine HL7-Botschaft an den Cypro-Server gesendet wird).

Für den Normalbetrieb muss ein zeitverzögertes Accept-Acknowledgement eingestellt werden. Dies dient dazu die HL7-Schnittstelle zu entlasten, da die Krankenhaus-HL7-Server sofort nach Empfang der ACK-Meldung eine neue HL7-Botschaft versenden.




Ein Zeit-Intervall größer als „0“ hat aber den Nachteil, das die eingehenden Botschaften erst zeitlich Verzögert an die Cypro-Datenbank weitergereicht werden. Bei der Einstellung des Zeit-Intervalls gilt es also zwischen Entlastung des Datenbank-Servers und zeitnaher Datenweitergabe abzuschätzen, dies ist natürlich vor allem von der Anzahl der empfangenen Daten und der generellen Leistungsfähigkeit der Servers abhängig.

Betrieb in hochfrequenten NachrichtensystemenDie HL7-Schnittstelle ist für den stabileren Betrieb in hochfrequenten HL7-Nachrichten-Systemen( >= 1 Nachricht / 5 Sekunden, entspricht 3000-4000 Nachrichten/Tag) ausgerichtet. Um in diesen Betriebs-Modus zu wechseln, wählen Sie „Thread für den Empfang der HL7-Nachricht vom Thread für die Speicherung in der Cypro-Datenbank entkoppeln (empfohlen für hochfrequente Nachrichten-Systeme - >= 1 Nachricht / 5 Sekunden)“ in den Cypro-Optionen (Rubrik „HL7“- Seite „HL7-Client“). Bei diesem Modus wird die eingehende HL7-Nachricht nicht mehr im Arbeitsspeicher zwischengespeichert, sondern sofort als HL7-Rohdaten in die HL7-Datenbank gespeichert und dann nach dem mit der Option „Die eingehenden HL7-Botschaften immer nach diesem Zeit-Intervall in die HL7- bzw. die Cypro-Datenbank eintragen“ definierten Zeitintervall ausgelesen, verarbeitet und in die Cypro-Datenbank eingebaut. Diese Option dient dazu den Server-Rechner zu entlasten, damit nicht ständige Schreibzugriffe auf die Festplatte entstehen (Vorgabe : 1 Minute).

Ein zeitverzögertes Accept-Acknowledgement ist nicht notwendig. Sie können den Vorgabewert (60 Sekunden) auf „0” setzen. Das zeitverzögertes Accept-Acknowledgement dient dazu die HL7-Schnittstelle zu entlasten, wenn die Option für den Betrieb in hochfrequenten HL7-Nachrichten-Systemen deaktiviert ist, da die Krankenhaus-HL7-Server sofort nach Empfang der ACK-Meldung eine neue HL7-Botschaft versenden.

Wir empfehlen diesen Betriebs-Modus nicht nur für hochfrequente Nachrichten-Systeme, sondern auch für alle anderen einzustellen.

Achtung:Bei dieser Option wird von der Cypro-HL7-Schnittstelle kein Application-Acknowledgement gesendet, eine entsprechende Option auf der Seite „Allgemeines" der HL7-Optionen wird ignoriert.

Um in diesen Betriebsmodus zu wechseln, ist ein Neustart der HL7-Schnittstelle erforderlich.




Die HL7-Datenbank

Die HL7-Schnittstelle nimmt die Daten aller im Krankenhaus aufgenommen Patienten entgegen. Die onkologisch behandelten Patienten sind also nur ein Teil all dieser Patienten. Aus diesem Grund empfiehlt es sich die Cypro-Datenbank mit den onkologischen Patienten von der HL7-Datenbank mit allen Patienten abzutrennen und getrennte Datenbanken zu verwenden. Um eine getrennte (externe) Datenbank für die HL7-Daten zu verwenden, legen Sie diese in den Optionen auf der Seite „HL7“-„Datenablage“ fest und kreuzen Sie „Die externe HL7-Datenbank anstatt der Cypro-Datenbank verwenden“ an. Die Vorgabe Datenbank für eine externe Datenbank ist die Datei „Cypro_HL7.Cyp“ im Ordner „Database“ des Cypro-Installations-Ordners. Sie können diese Datenbank aber, genauso wie die Cypro-Datenbank „Cypro.Cyp“ auch in einen anderen Ordner legen.

Werden getrennte Datenbanken verwendet, so kann die HL7-Datenbank auch auf einem externen „HL7-Server-Rechner“ installiert sein. In diesem Fall gibt es im Cypro-Netzwerk, dann zwei aktive Firebird-Datenbank-Server. So kann die CPU-Last einfach auf zwei getrennte Systeme verteilt werden. Entscheidend für die Geschwindigkeit der HL7-Schnittstelle ist zwar zum einen auch der Rechner auf dem die HL7-Schnittstelle läuft, aber vor allem der Rechner, auf dem sich die HL7- bzw. die Cypro-Datenbank befindet. Wenn es zwischen diesen Rechnern eine nur langsame Netzwerk-Verbindung gibt, ist natürlich dies das geschwindigkeits-entscheidende Moment.

Die Log-Datei

Cypro schreibt standardmäßig beim Starten, Beenden, Aktivieren, Deaktivieren, bei einer Änderung der Konfiguration (Port, Server-IP-Adresse, Aktualisierungszeit, Datenbank, Betriebsmodus) und bei jedem Fehler einen Eintrag in eine Log-Datei. Dieses Verhalten kann hier verändert werden. Die Log-Datei befindet sich im Cypro-Installations-Ordner („HL7.log“).

Den Verlege-Status eines Patienten erkennen

Das Verlegen eines Patienten wird bei HL7 durch eine A02-Botschaft signalisiert. Cypro kann jedoch auch bei jeder anderen HL7-Botschaft kontrollieren, ob der Patient verlegt worden ist. Wählen Sie diese Option, wenn nicht sicher ist, das Verlegungen auch über andere Botschaften stattfinden können. Wenn Sie aber sicher wissen, das Verlegungen nur mit A02-Botschaften signalisiert werden, dann schalten Sie diese Option aus. Die Schnittstelle spart somit bei jeder HL7-Botschaft das Auslesen der „alten“ Station und das Vergleichen mit der „neuen“. In Cypro bedeutet „Verlegen“ aber nicht nur eine Stations-Verlegung, sondern auch eine „Änderung“ des behandelnden Arztes. Werden durch A02-Botschaften nur Stations- aber keine „Arzt-Verlegungen“ abgedeckt, so aktivieren Sie die Option, bei allen HL7-Botschaften auf Verlegungen zu prüfen. Beim Verlegen eines Patienten wird in Cypro nicht nur Arzt und Station für den Patienten geändert, sondern auch Arzt und Station aller Rezepte für den Patienten ab dem Verlegungstag.




Optionen im laufenden Betrieb der Schnittstelle ändern

Im laufenden Betrieb der HL7-Schnittstelle kann die Datenbank-Verbindung nicht neu gesetzt werden, alle anderen Einstellungen aber schon. Möchten Sie eine bestehende Datenbank-Verbindung trennen und die Schnittstelle an eine andere Datenbank anbinden, dann müssen Sie die HL7-Schnittstelle beenden und dann neu starten.

Wenn keine Verbindung zum Krankenhaus-HL7-Server oder zur Cypro-Datenbank hergestellt werden kann, dann wird das Options-Programm automatisch gestartet und die entsprechenden Einstellungen können getroffen werden.




Die Inbetriebnahme der Schnittstelle

Voraussetzungen für die Inbetriebnahme der Schnittstelle

Cypro findet alle Patienten in der HL7-Patienten-Verwaltung nur nach Patienten-ID. Um bestehende Patienten nachträglich in die HL7-Schnittstelle einzutragen ist es erforderlich in der Cypro-Patienten-Verwaltung die „Patienten-ID im Krankenhaus-Informations-System (KIS)“ für alle Patienten einzutragen und die Patienten dann in die HL7-Patienten-Verwaltung einzutragen. Dabei wird aber nur Name, Vorname, Geburtsdatum und Patienten-ID aus Cypro in die HL7-Verwaltung übernommen, keine Arzt-, Versicherungs-, Stations- und Aufnahmedaten (diese Daten wurden alle manuell eingefügt und entstammen nicht dem Krankenhaus-Informations-System). Dies reicht jedoch aus, um eine automatische Verknüpfung zwischen HL7- und Cypro-Patienten-Verwaltung über die Cypro-interne ID zu erstellen. Es ist dringend erforderlich die Patienten-ID richtig einzutragen, da ansonsten die Aktualisierung nicht richtig erfolgen kann.

Zum Einfügen eines „Cypro-Patienten“ in die HL7-Patienten-Verwaltung gehen Sie bitte in die Cypro-Patienten-Verwaltung und klicken auf den Schalter „in HL7-Verwaltung einfügen“. Sie finden diesen Schalter in der Statusleiste rechts neben der Suchfeld-Auswahl. Ein Patient kann nur in die HL7-Patientenverwaltung eingefügt werden, wenn die Patienten-ID des KIS eingetragen ist. Sie sollten diese deswegen anzeigen (Optionen: Seite „Allgemeines“-„Allgemeines“- „auch die Patienten-Kennung des KIS eintragen“).

Bereits in der HL7-Patienten-Verwaltung vorhandene Patienten werden nicht neu eingetragen, ebenso wird ein Patient nicht eingetragen, wenn es in der HL7-Patienten-Verwaltung bereits einen anderen Patienten mit der gleichen Patienten-ID gibt (in diesem Fall wäre die Patienten-ID des einzutragenden Patienten falsch). Sie können das Eintragen in die HL7-Patienten-Verwaltung auch für alle Cypro-Patienten auf einmal vornehmen. Klicken Sie dazu im Menü „Patient“ in der Hauptansicht auf den Eintrag „in HL7-Verwaltung einfügen“. Cypro ermittelt nun alle Patienten, bei denen eine Patienten-ID angegeben wurde und trägt diese in die HL7-Patienten-Verwaltung ein. Es gilt jedoch auch hier das bereits Erwähnte: schon vorhanden Patienten werden nicht doppelt eingetragen und es erfolgt keine Eintragung, wenn es bereits einen anderen Patienten mit gleicher Patienten-ID gibt.

Während das Einfügen der bestehenden Patienten auch „nach und nach“ erfolgen kann (automatische Aktualisierungen finden dann aber nicht statt) ist es vor Inbetriebnahme der Schnittstelle dringend erforderlich die ID-Kennung für die Ärzte und die Abkürzungen für Krankenhaus, Abteilung und Station einzutragen. Es müssen keine neuen Stationen eingetragen werden, dies ist nur für bestehende Einträge erforderlich. Geschieht dies nicht, so fügt die HL7-Schnittstelle automatisch neue Stationen in die Stations-Verwaltung von Cypro ein, da keine Stationen mit der entsprechenden Abkürzung gefunden werden können. Im Grunde sind dies dann aber doppelte Einträge.



Die Inbetriebnahme derSchnittstelle

Konfiguration von Cypro für HL7

Neben Angabe der HL7-Datenbank (siehe „Die HL7-Datenbank”), benötigt Cypro lediglich die Angabe folgender Informationen:

● Sind in einem Krankenhaus-Verbund Stations- und Abteilungs-Kürzel Krankenhaus-übergreifend eindeutig oder gelten Sie nur für das jeweils zugehörige Krankenhaus ?

● Werden Stationen für verschiedene Abteilungen belegt ?

● Sind leer Vornamen bei der Eingabe von Patienten erlaubt ?

● Sind Arzt-ID-Kennung und Stations-Kürzel als Pflichtfelder einzugeben

Dies sollte man auf jeden Fall setzen, beachten Sie dazu auch Kapitel “Wie werden Daten von Cypro gefunden?“

● Welche Standard-Such-Kriterien sollen beim Anzeigen der HL7-Patienten benutzt werden ?




Die HL7-Schnittstelle starten, beenden und überwachen

Das Dienst-Status-Informations-Programm dient zur Überwachung der HL7-Schnittstelle, des Cypro-Servers und des automatischen Backups. Zum Starten der Dienst-Status-Information wählen Sie den Punkt „Dienst Status Informationen“ aus der Gruppe „Cypro“ des Windows-Startmenüs. Nach dem Programmstart wird das Dienst-Status-Informations-Programm zu einem Symbol minimiert und als farbige Kugel links neben der Uhrzeit in der Windows-Task-Leiste angezeigt. Mit diesem Programm können Sie die einzelnen Dienste installieren, deinstallieren, starten und beenden, sowie alle Optionen einstellen (Eintrag „Dienst starten und beenden” im Kontextmenü des Symbols für das Dienst-Status-Informations-Programm). Mit „Installieren“ ist hier nicht die Installation von der Cypro-CD gemeint, sondern die Registrierung als Windows-Dienst im Betriebssystem. Das Beenden eines Dienstes gilt nur für die aktuelle Windows-Sitzung. Nach einem Neustart wird der Dienst wieder gestartet. Wenn Sie einen Cypro-Dienst dauerhaft beenden möchten, so müssen Sie den Dienst entweder deinstallieren oder in der Windows-Dienste-Verwaltung manuell deaktivieren. Die Dienst-Einstellungen können nur dann vorgenommen werden, wenn Sie über Administrator-Rechte verfügen (das gilt nicht für die Dienst-Optionen).




Sie können einstellen, welcher Dienst überwacht werden soll. Klicken Sie dazu mit der rechten Maustaste auf das Symbol des Dienst-Status-Informations-Programms und dann auf den Eintrag „Optionen“.

Das Dienst-Status-Informations-Programm verwendet folgendes Farbschema:

Graue Kugel : Keine Dienste werden überwacht

Rote Kugel : Kein überwachter Dienst ist gestartet oder aktiv

Gelbe Kugel : Einige der überwachten Dienste sind gestartet und aktiv

Grüne Kugel : Alle überwachten Dienst sind gestartet und aktiv

Sie können das Dienst-Status-Informations-Programm genauso wie den Cypro-Schnellstarter auch automatisch mit Windows starten. Wählen Sie dazu den Eintrag „automatisch starten“ aus dem Kontextmenü (Rechtsklick auf das „Kugel“-Symbol).

Alle hier beschrieben Einstellungen finden sie auch im Menü des Schalter „Dienste“ der Cypro-Schnellstart-Leiste.




Eintragen von Daten in Cypro

Wie werden HL7-Daten in die Cypro-Datenbank eingefügt?

Sobald ein HL7-Patient als Cypro-Patient eingefügt wurde, werden alle ankommenden HL7-Daten in die Cypro-Datenbank eingetragen. Neue Patienten über HL7 werden NICHT automatisch in die Cypro-Datenbank eingefügt.

Cypro verwendet innerhalb der Cypro-Datenbank zwei getrennte Bereiche zur Verwaltung der HL7- und der Cypro-Patienten. Werden HL7-Botschaften an die Cypro-HL7-Schnittstelle gesendet, so werden diese zunächst in die HL7-Patienten-Verwaltung aufgenommen. Wenn ein solcher Patient allerdings als Cypro-Patient vorliegt, werden im Anschluss alle Daten auch an die Cypro-Patienten-Verwaltung übergeben. Wird ein Patient in Cypro verändert, so hat dies keinerlei Auswirkung auf die HL7-Patienten-Verwaltung, ebenso werden Löschvorgänge in Cypro nicht an die HL7-Patienten-Verwaltung übergeben.

Beispiel:Der Patienten Udo Mustermann mit der Patienten-ID „123456“ existiert als „HL7-Patient“ in der HL7-Patienten-Verwaltung und wird nun in Cypro als „Cypro-Patient“ eingefügt. Cypro liest nun alle Werte für diesen Patienten aus (Patienten-Informationen, wie Name, Vorname, Geburtsdatum, Arzt, Station. Krankenkasse, Aufnahme- und Entlassungsdaten) und trägt diese in die Cypro-Datenbank ein. Noch nicht existierende Ärzte, Stationen und Krankenkassen werden automatisch in die Cypro-Datenbank eingefügt. Da die übertragenen Stations-, Abteilungs- und Krankenhaus-Informationen über HL7 nur Abkürzungen sind, trägt Cypro als Bezeichnung ebenfalls die Abkürzung ein. Die Bezeichnung kann später vom Benutzer in Cypro geändert werden.

Der Patient wurde am „31.01.2004“ aufgenommen und ist nicht entlassen. Dieser Patient wird nun in der Cypro-Patienten-Verwaltung entlassen (Datum=“03.02.2004“). Diese Information wird von Cypro aber weder an die HL7-Patienten-Verwaltung noch an das Krankenhaus-Aufnahme-System weitergereicht. Über die HL7-Schnittstelle wird nun ebenfalls das Entlassungsdatum gesendet. Dieses ist aber der „02.02.2004“, so das die Information in Cypro aktualisiert wird. Wird der Patient nun aus Cypro gelöscht, so bleibt er weiterhin in der HL7-Patienten-Verwaltung bestehen, so dass er später mit allen inzwischen angefallenen Daten wieder in Cypro eingefügt werden kann. Bei gelöschten Patienten wird also nur die Verbindung zwischen HL7-Patienten-Verwaltung und Cypro-Patienten-Verwaltung getrennt.




Speichern der empfangenen HL7-BotschaftenBei der Konfiguration der Schnittstelle für den Betrieb in hochfrequenten HL7-Nachrichten-Systemen werden auch die empfangenen Botschaften und nicht nur die aufbereiteten Werte gespeichert. Dies ist dann sinnvoll, wenn man erfahren möchte, ob und wann eine spezielle Botschaft an Cypro gesendet wurde. Wird die HL7-Schnittstelle beendet und danach neu gestartet, werden zunächst die noch nicht abgearbeiteten HL7-Botschaften aus der HL7-Datenbank ausgelesen und in die Cypro-Datenbank eingetragen. Gleichzeitig werden aber weiterhin die gesendeten HL7-Botschaften empfangen und verarbeitet. Es kommt so zu keinem Verlust von HL7-Botschaften

Ist diese Option deaktiviert, so verbleiben die Botschaften nur bis zur Verarbeitung temporär im Arbeitsspeicher. Wenn die HL7-Schnittstelle beendet wird, werden die ausstehenden, noch nicht in der Cypro-Datenbank gespeicherten, Botschaften lokal gespeichert. Beim nächsten Start der Schnittstelle, werden zunächst die HL7-Botschaften aus der lokalen Datei („Maintenance.*“ im „Database“-Ordner der Cypro-Installation) ausgelesen und in die Cypro-Datenbank eingetragen. Auch hier kommt es zu keinem Verlust von HL7-Botschaften, da ebenfalls weiterhin die gesendeten HL7-Botschaften empfangen und verarbeitet werden.

Wie werden die HL7-Daten ausgewertet?

Cypro wertet bei der Aufbereitung der HL7-Nachrichten die übermittelte Bewegungs-Nummer aus.

Wurde eine neue Bewegungs-Nummer übertragen oder bezieht sich die HL7-Botschaft auf die aktuelle Bewegungs-Nummer, so werden neben Arzt, Versicherungs- und Aufnahmedaten auch Patientendaten aktualisiert (zu den Patienten-Daten gehören neben Name, Anschrift, Geburtsdatum u.a. auch die Stationsinformationen). Bei einer alten Bewegungs-Nummer werden nur Aufnahme- und Entlassungsdaten verarbeitet.

Cypro geht beim Auswerten der empfangenen Daten immer grundsätzlich von folgendem aus:

1. Die empfangenden Informationen können in Cypro schon manuell eingegeben sein.

2. Der Patient kann in Cypro schon existieren (er wurde manuell eingegeben), ohne als HL7-Patient deklariert zu sein.

Im einzelnen geschieht folgendes:Cypro sucht die Daten mit der übertragenden Bewegungs-Nummer. Werden solche Daten gefunden, dann werden sie mit den neuen Daten aktualisiert. Werden keine Daten gefunden, dann sucht Cypro nach relevanten Kenngrößen, z.B. die Aufnahmenummer bei Aufnahme- und Entlassungsdaten.

Die Daten einer bestehenden Aufnahme werden jedoch nur dann immer aktualisiert, wenn der Eintrag über die Bewegungs-Nummer gefunden wurde. Eine alte Bewegungs-Nummer kann niemals die Daten einer Aufnahme mit neuer Bewegungs-Nummer aktualisieren. Unabhängig davon werden aber immer die Aufnahmenummer angepasst, wenn folgendes gilt:




1. Die Aufnahme-Nummer einer bestehenden Aufnahme mit einer alten Bewegungs-Nummer wird geändert. Existiert ein Entlassungs-Eintrag mit der selben Bewegungs-Nummer (das kann aber normalerweise nie sein, da eine Entlassung ein unabhängiger Vorgang ist), so wird die Aufnahme-Nummer der Entlassung ebenfalls geändert.

2. Die Aufnahme-Nummer einer bestehenden Aufnahme mit einer alten Bewegungs-Nummer wird geändert. Existiert kein Entlassungs-Eintrag mit der selben Bewegungs-Nummer, aber ein Entlassungs-Eintrag mit der selben „alten“ Aufnahme-Nummer, so wird die Aufnahme-Nummer der Entlassung ebenfalls geändert, aber niemals andere Daten, wie z.B. Entlassungszeit.

3. Die Aufnahme-Nummer einer bestehenden Entlassung mit einer alten Bewegungs-Nummer wird geändert. Existiert ein Aufnahme-Eintrag mit der selben Bewegungs-Nummer (das kann aber normalerweise nie sein, da eine Aufnahme ein unabhängiger Vorgang ist), so wird die Aufnahme-Nummer der Aufnahme ebenfalls geändert.

4. Die Aufnahme-Nummer einer bestehenden Entlassung mit einer alten Bewegungs-Nummer wird geändert. Existiert kein Aufnahme-Eintrag mit der selben Bewegungs-Nummer, aber ein Aufnahme-Eintrag mit der selben „alten“ Aufnahme-Nummer, so wird die Aufnahme-Nummer der Aufnahme ebenfalls geändert, aber niemals andere Daten, wie z.B. Aufnahmezeit.

Detaildaten wie Arzt und Versicherung sind unabhängig von der Bewegungs-Nummer und werden extern verwaltet. Cypro fügt nicht nur neue Versicherungen ein, sondern kann auch bestehende ändern (Änderung von Name und Kassen-Nr.), wobei aber immer nur eine Änderung zur Zeit möglich ist, da als Kenngröße für die Identifizierung einer Krankenkasse der Name und die Kassen-Nummer dienen. Bei einem Arzt dient als Identifizierung die Arzt-ID-Kennung. Wird Name und Vorname bei einem bestehenden Arzt geändert, so hat dies Auswirkungen auf alle Patienten. Der neue Arzt-Name wird nun nicht nur für den einen Patienten, sondern bei allen Patienten, die von diesem Arzt behandelt werden, angezeigt.

Warum benötigt Cypro eine Bewegungs-Nummer?

Auf SAP-basierende Informations-Systeme können „historische“ Nachrichten aussenden. So können z.B. ältere Nachrichten erst zeitlich nach den aktuellen Nachrichten gesendet werden. Um diese Nachrichten zeitlich sortieren zu können, werden Bewegungs-Nummern verwendet. Hiermit wird natürlich auch die Relevanz der Nachricht beschrieben. Patienten-Informationen aus älteren Nachrichten werden so verworfen, Aufnahmedaten aber verwendet. Mit Hilfe von Bewegungs-Nummern ist es auch möglich ganz gezielt ältere Nachrichten-Sätze zu verändern.

Bei Krankenhaus-Informations-Systemen ohne „historische“ Nachrichten werden in der Regel keine Bewegungs-Nummern verwendet. In diesem Fall verwenden Sie die Option. „Keine Bewegungs-Nummer des Krankenhaus-Informations-Systems verwenden, sondern eigene Bewegungs-Nummern generieren“ (Optionen- Rubrik „HL7“-Seite „Allgemeines“), Cypro generiert so eigene Bewegungs-Nummern.

Cypro benötigt zu korrekten Verarbeitung der HL7-Botschaften Bewegungs-Nummern, die im System eindeutig sind. Es darf keine Bewegungs-Nummer geben, die für einen anderen Vorgang, einem anderen Patienten oder einer anderen Aufnahme verwendet wird.




HL7-Botschaften ohne Bewegungsnummer

Cypro geht davon aus, dass es im Krankenhaus-Informationssystem Patienten gibt, die noch nicht in der Cypro-HL7-Patientenverwaltung eingetragen sind. Wird eine HL7-Nachricht an Cypro gesendet und ist der Patient noch nicht in der Cypro-Datenbank eingetragen, so wird dieser bei jeder Nachricht nachgetragen, auch z.B. bei A02 (Patient verlegen) - oder A13 (Entlassung stornieren) -Nachrichten.

Für jeden Vorgang ist aber eine Bewegungsnummer notwendig. Cypro kann auch eigene Bewegungsnummern erzeugen, dies ist aber normalerweise nur für Systeme vorgesehen, die keine eigenen Bewegungsnummern erzeugen.

Eine Besonderheit sind Botschaften, bei denen nur das PID-Segment übertragen wird. Bei einer solchen Botschaft wird keine Bewegungsnummer gesendet. Dies kommt immer vor, wenn auch das PV1-Segment nicht gefüllt ist und liegt i.d.R. daran, dass SAP IS-H je nach gewähltem Menüzweig des Anwenders und seiner Schnelligkeit ein SAP-Event „NP0201“ generiert, welches nur Patientendaten-Änderungen (ohne HL7-PV1 und Bewegungsnummer) oder auch Patienten- und Falldaten-Änderungen (mit HL7-PV1 und mit Bewegungsnummer) zulässt.

Bei einer solchen Botschaft ohne HL7-PV1 und Bewegungsnummer geht Cypro wie folgt vor:

Wenn der Patient bereits in der HL7-Verwaltung von Cypro enthalten ist, wird der Datenstamm aktualisiert, die Bewegungsnummer aber nicht. Historische Nachrichten können weiterhin erkannt werden.

Wenn der Patient noch nicht in der HL7-Verwaltung von Cypro enthalten ist, wird der Datenstamm aktualisiert, die Bewegungsnummer aber nicht. Cypro generiert eine eigene negative Bewegungsnummer, damit diese nicht mit den späteren Bewegungsnummern des SAP-Systems „kollidiert“. Eine darauffolgende Nachricht mit Bewegungsnummer führt immer zu einer Aktualisierung des Datenstamms, da zu diesem Zeitpunkt eine historische Nachricht noch nicht erkannt werden kann.

Anmerkung:Cypro ignoriert normalerweise historische Nachrichten in Bezug auf die Patientendaten (Name, Geburtsdatum, Anschrift), aber nicht für Aufnahmedaten.

Historische Nachrichten in einem Krankenhaus-Verbund

Die HL7-Schnittstelle unterstützt das korrekte Erkennen von historischen Nachrichten in einem Krankenhaus-Verbund ohne einen einheitlichen Zahlenraum für Bewegungsnummern.

In SAP-Systemen können historische HL7-Nachrichten versendet werden. Historische Daten sind Daten, die zeitlich älter sind als die aktuellen. Cypro erkennt diese historischen Nachrichten anhand der versendeten Bewegungsnummer. Bei historischen Nachrichten werden nur die Aufnahmedaten verwendet, die Patientendaten (Name, Versicherung, Station,...) werden ignoriert.




In einem Krankenhaus-Verbund ohne einen einheitlichen Zahlenraum für Bewegungsnummern lassen sich historische Daten nicht ohne weiteres erkennen, da bei einer Verlegung des Patienten von einem Krankenhaus in ein anderes ein neuer Zahlenraum für Bewegungsnummern gültig wird.

Beispiel für nicht „System-eindeutige" Bewegungsnummern :Ein Patient liegt im Krankenhaus „11“, die Aufnahmenummer ist „1101", die letzte Bewegungsnummern ist „001". Der Patient wird nun verlegt in das Krankenhaus „10“. Er wird dort neu aufgenommen mit der Aufnahmenummer „1001", die Bewegungsnummern ist „001".

Cypro bildet bei Bewegungsnummern, die nicht „System-eindeutig" sind, sondern nur für die verwendeten Aufnahmen gelten, eine interne Cypro-Bewegungsnummer aus Aufnahme-Nummer und Bewegungsnummer. Die Cypro-Bewegungsnummer für den Patienten vor der Verlegung ist somit „1101001" und die Cypro-Bewegungsnummer für den Patienten nach der Verlegung ist „1001001".

Beim Vergleich der Bewegungsnummern (die Bewegungsnummer nach der Verlegung ist kleiner als die vor der Verlegung) erscheint es so, als ob es sich bei der Verlegung um einen historischen Vorgang handelt, somit werden die Patientendaten (und auch die neue Station) des Patienten ignoriert, nicht aber die Aufnahmenummer.

Um auch solche Daten korrekt als NICHT-historisch erkennen zu können, deaktivieren Sie die Option „In einem Krankenhaus-Verbund gibt es einen einheitlichen Zahlenraum für Bewegungs-Nummern“ (Rubrik „HL7“- Seite „HL7-Client“). Standardmäßig ist diese Option bereits deaktiviert.

Wenn die Bewegungsnummern nicht „System-eindeutig" sind, sondern nur für die verwendeten Aufnahmen gelten, darf diese Option nur dann verwendet werden, wenn ein einheitlicher Zahlenraum für die Aufnahme-Nummern benutzt wird.

Bei einem einheitlicher Zahlenraum beginnen alle Werte von einem gemeinsamen Startwert aus und sind fortlaufend.

Beispiele:Nicht „System-eindeutige" Bewegungsnummer (interne Cypro-Bewegungsnummer ist zusammengesetzt aus Aufnahme-Nummer und Bewegungsnummer) mit einheitlichem Zahlenraum.

Krankenhaus = „11", Aufnahme = „1101", Bewegung = „1101001"


Nicht „System-eindeutige" Bewegungsnummer ohne einheitlichen Zahlenraum.



Im unten stehenden Fall, gibt es für die beiden Krankenhäuser unterschiedliche Startwerte für die Aufnahme-Nummer.




Deaktivieren Sie in diesem Fall die Option „In einem Krankenhaus-Verbund gibt es einen einheitlichen Zahlenraum für Bewegungs-Nummern“ und aktivieren Sie sie für den oben stehenden Fall.

Wenn Cypro eigene Bewegungsnummern verwendet, wird diese Option ignoriert.

Diese Option hat natürlich auch nur dann Auswirkung, wenn es in einem Krankenhaus-Verbund zu Verlegungen zwischen den einzelnen Krankenhäusern kommt.

Wie werden Daten von Cypro gefunden?

Cypro findet einen Patienten in der HL7-Patienten-Verwaltung immer nur über dessen Patienten-ID und in der Cypro-Patienten-Verwaltung über die interne Cypro-Patienten-ID. Ein Arzt und eine Station wird jedoch immer nur über dessen ID-Kennung gefunden. Wird die Arzt-ID-Kennung aus Cypro gelöscht oder verändert, dann geht Cypro davon aus das auch ein gleichnamiger Arzt eine andere Person ist und fügt diesen neu ein. Die Verknüpfung zwischen Patient aus der HL7-Patienten-Verwaltung und der Cypro-Patienten-Verwaltung geschieht über die interne Cypro-ID, so dass man hier die „Patienten-ID“ nachträglich ändern kann. Das ist natürlich nicht sinnvoll, da dies ein falscher Wert wäre.

Da die HL7-Schnittstelle von einem dualen Eingabe-System ausgeht (Eingabe einmal über das HL7-System und einmal über Cypro), kontrolliert die Schnittstelle auch bei neuen Werten, ob dieser Eintrag nicht doch schon in Cypro vorhanden ist und aktualisiert dann den „Cypro-Eintrag“, obwohl ein Neu-Einfügen vom HL7-System gefordert wird.




Aktualisierung bestehender Daten

Automatische Aktualisierung der eingefügten Patienten

Die HL7-Schnittstelle erhält laufend Daten vom Krankenhaus-Informations-System und reicht diese an alle Patienten in der HL7-Patienten-Verwaltung weiter. Wenn Sie „HL7-Patienten“ in den Cypro-Daten-Stamm eingefügt haben, werden die Daten aus dem Krankenhaus-Informations-System auch an die „Cypro-Patienten“ weitergereicht. Über die HL7-Schnittstelle werden folgende Patientendaten aktualisiert:

Name, Vorname, Geburtsdatum, Anschrift, Staatsangehörigkeit, Station, Arzt, Aufnahmen, Krankenkasse.

Die HL7-Schnittstelle kann folgende Aktionen durchführen:

Patient neu aufnehmen

Patient verlegen

Patient entlassen

Patientdaten ändern

Neuaufnahme stornieren

Verlegung stornieren

Entlassung stornieren

Beispiel:Sie haben einen Patienten „Mustermann“ aus der HL7-Verwaltung in die Cypro-Daten eingefügt. Dieser erscheint mit allen bislang aus dem Krankenhaus-Informations-System erhaltenen Daten (Name, Vorname, Geburtsdatum, Anschrift, Staatsangehörigkeit, Station, Aufnahmen). Wird dieser Patient nun z.B. entlassen, so ist dies auch direkt in Cypro mit Zeitpunkt sichtbar.




Automatische Aktualisierung bei eigener Bearbeitung

Sie können die Patientendaten auch selbst bearbeiten. Die HL7-Schnittstelle wird Ihre Änderungen allerdings bei Eintreffen von neuen HL7-Nachrichten wieder überschreiben.

Beispiel:Sie haben die Anschrift des Patienten geändert von „Neue Strasse 17“ auf „Hauptstrasse 18“. Eine HL7-Nachricht trifft ein und macht Ihre Änderungen wieder rückgängig.

Selbst eingefügte Aufnahmen in der Aufnahmeliste des Patienten, werden nicht ohne weiteres von der HL7-Schnittstelle aktualisiert.

● Wenn jedoch die Aufnahme (Nummer, Datum) einer bestehenden Aufnahme, die durch die HL7-Schnittstelle eingefügt wurde, geändert wird, so werden die Änderungen von neuen HL7-Nachrichten wieder überschrieben.

● Dies gilt auch für die Aufnahme-/Entlassungs-Zeit einer nicht durch HL7 eingefügten Aufnahme, wenn die Aufnahme-Nummer der „eigenen“ Aufnahme und die aus der HL7-Nachricht gleich sind.

● Die HL7-Schnittstelle unterbindet das Löschen von Aufnahmen, wenn zu einer Aufnahme bereits Arztbriefe oder Herstellungen zugeordnet sind. In der Aufnahme-Liste wird dies durch eine rötliche Hintergrundfarbe angezeigt.

Eigene Aufnahmen erscheinen mit einem roten Symbol, durch HL7 eingefügte Aufnahmen erscheinen ohne Symbol.

Aktualisierung von eigenen Aufnahmen

Bei Cypro-Systemen mit einer HL7-Schnittstelle, werden die Aufnahmedaten nicht mehr manuell eingepflegt, sondern automatisch über die Schnittstelle eingetragen. Wenn das zugrunde liegende Krankenhaus-Informations-System die Aufnahmedaten verspätet liefert, kann ein Patient zum Herstellungsdatum noch entlassen bzw. noch nicht aufgenommen sein. Eine Herstellung ist dann nicht möglich und die Aufnahme müsste manuell eingepflegt werden.

Es ist in Cypro aber auch möglich, Patienten einzugeben, ohne diese aufzunehmen. Genauso kann für nicht aufgenommene Patienten hergestellt werden.

Falls dies so nicht geschehen soll und nur für aufgenommene Patienten hergestellt werden soll, muss der Patient in Cypro manuell aufgenommen werden. Die korrekte Aufnahme-Nummer ist dann nicht bekannt und es muss eine „eigene“ Aufnahme-Nummer verwendet werden.




Die HL7-Schnittstelle bemerkt eine eigene manuelle Aufnahme (angezeigt mit einem roten Symbol in der Patienten-Aufnahme-Liste) und überschreibt die LETZTE eigene Aufnahme unabhängig von der Aufnahme-Nummer mit einer neu eintreffenden „HL7-Aufnahme“. Das gilt aber nicht für Stornierungen von Aufnahmen (A11-Nachricht in HL7), d.h. eigene Aufnahmen werden nicht gelöscht.

In den Cypro-Optionen kann eingestellt werden, ob diese Art der Daten-Aktualisierung generell stattfinden soll, und ob Stornierungen von Entlassungen (A13-Nachricht in HL7) genauso wie Stornierungen von Aufnahmen dabei nicht beachtet werden soll (Optionen - Seite „HL7“–„Spezielles”).

Wenn eine eigene Aufnahme unabhängig von den Einstellungen in den Cypro-Optionen nicht durch die nächste HL7-Nachricht überschrieben werden soll, so kann man sie maskieren (Patienten-Verwaltung – Seite „Aufnahmedaten“ - Schalter „Änderung maskieren“). Die Aufnahme erscheint jetzt mit einem grünen Symbol. Mit Klick auf den Schalter „Maskierung aufheben“ wird die Maskierung wieder entfernt.

Zusammenfassung:Cypro zeigt eigene Aufnahmen mit einem roten Symbol an, eigene maskierte Aufnahmen erscheinen mit einem grünen Symbol, durch die HL7-Schnittstelle eingefügte Aufnahmen werden ohne Symbol angezeigt. Wenn durch die HL7-Schnittstelle eingefügte Aufnahmen manuell geändert werden (Aufnahmenummer, Aufnahmedatum, Entlassen), so wird diese Aufnahme mit einen Türkis-Symbol angezeigt.

Dieses Farbsymbol ist in der Patienten-Verwaltung auf der Seite „Aufnahmedaten“ und auf der Seite „Allgemeines“ links neben der Aufnahme-Nummer sichtbar.

Aktualisierung von selbst eingegeben Patienten

Wenn Sie einen Patienten mit Patienten-ID eingeben, aber nicht in die HL7-Daten einfügen (Patienten-Verwaltung – Seite „Allgemeindaten“ - Schalter „in HL7-Verwaltung einfügen“), dann wird dieser automatisch in die HL7-Daten-Verwaltung eingetragen und von der HL7-Schnittstelle aktualisiert, wenn eine HL7-Nachricht für einen Patienten mit gleicher Patienten-ID, unabhängig vom Namen, eintrifft. Der Patient mit dieser Patienten-ID darf aber noch nicht in der HL7-Verwaltung vorhanden sein. Deswegen empfiehlt es sich immer eigene Patienten mit korrekter Patienten-ID selbst in die HL7-Patienten-Verwaltung einzufügen.

Beispiel:Sie fügen einen Patienten „Mustermann“ mit der Patient-ID „123456789“ in Cypro ein. Bei der nächsten HL7-Nachricht für den Patienten mit der ID „123456789“ wird der Cypro-Patient in die HL7-Verwaltung eingefügt und automatisch von HL7 aktualisiert, d.h., das Name, Vorname, etc, von HL7 überschrieben werden.




Wenn Sie für einen Patienten herstellen möchten, der noch nicht im Krankenhaus-Informations-System vorhanden ist, dann müssen sie ihn selbst in Cypro eingegeben. Die Patienten-ID ist dann nicht bekannt. Lassen Sie in diesem Fall die Patienten-ID leer oder fügen Sie die Cypro-ID ein. Die HL7-Schnittstelle fügt diesen Patienten automatisch in die HL7-Patienten-Verwaltung ein, wenn eine HL7-Nachricht für einen Patienten mit gleichem Namen, Vornamen, Geburtsdatum, Krankenhaus, Abteilung und Station eintrifft und wenn der Cypro-Patient keine Patienten-ID besitzt oder als Patienten-ID die Cypro-ID eingetragen ist. Der HL7-Patient aus der HL7-Nachricht darf noch nicht in der HL7-Patienten-Verwaltung enthalten sein.




Die Arbeit mit der HL7-Schnittstelle

Durch die HL7-Schnittstelle entfällt das manuelle Eingeben von Patienten, sowie das Aufnehmen und Entlassen in Cypro. Dies ist aber auch weiterhin möglich. In diesem Kapitel sind die in den vorherigen Kapiteln beschriebenen Vorgangsweisen zur Arbeit mit der HL7-Schnittstelle zusammengefasst.

Einfügen eines Patienten in die HL7-Patienten-Verwaltung

Klicken Sie auf den Schalter „in HL7-Verwaltung einfügen“ in der Patienten-Verwaltung.

Alternativ können Sie auch den Menüpunkt „alle Patienten in HL7 einfügen“ im Menü „Patient“ der Hauptansicht. Hierdurch werden alle noch nicht in die HL7-Verwaltung aufgenommen Patienten dort eingefügt.

Achtung: Die einzufügenden Patienten müssen eine korrekte Patienten-ID besitzen. Fügen Sie keine Patienten mit inkorrekter Patienten-ID ein.

Sie brauchen neue Patienten, nur dann in die HL7-Patienten-Verwaltung einzutragen, wenn Sie Patienten manuell ohne HL7-Schnittstelle in Cypro eingetragen haben.

Einfügen eines Patienten aus der HL7-Verwaltung

Um einen Patienten aus der HL7-Verwaltung in Cypro einzufügen, wird der Dialog „HL7-Patienten [F2]“ aus der Patienten-Verwaltung verwendet. Der entsprechende Schalter befindet sich auch im Dialog „Patient bearbeiten“ und „Neuer Patient“.Die Standard-Suchkriterien der HL7-Patienten-Liste und der erweiterten Suche können in denCypro-Optionen eingestellt werden (Seite „HL7“-„Cypro“). Sie können aber auch von der Patienten-Verwaltung und aus den Dialogen „HL7-Patienten“ und „erweiterte Suche“ schnell auf diese Optionen zugreifen. Dazu befindet sich in den genannten Dialogen ein Schalter „Optionen“.

Für den Dialog „HL7-Patienten“ kann neben den Standard-Suchkriterien, eingestellt werden, ob Patienten kombiniert werden dürfen. Für die erweiterte Suche können nur die Standard-Suchkriterien eingestellt werden. Das neue Standard-Suchkriterium ist nun „Name, beginnt mit ...“.




Im Dialog „HL7-Patienten“ werden nur die Schalter angezeigt, deren Funktion momentan zulässig ist. Aus der Hauptansicht ausgeführt sind alle Funktionen zulässig:

● Patient einfügen (Schalter „Diesen Patienten einfügen“)

● Daten des eingefügten Patienten bearbeiten (Schalter „Daten bearbeiten“)

● HL7-Patienten mit dem aktuellen Patienten der Hauptansicht kombinieren (Schalter „Diese Patienten kombinieren“)

● HL7-Patienten mit dem aktuellen Patienten der Hauptansicht kombinieren und dann die Patienten-Daten bearbeiten (Schalter „Patienten kombinieren + ändern“)

Aus der Patienten-Verwaltung aufgerufen, können nur die Daten des eingefügten Patienten bearbeitet und der HL7-Patient mit dem aktuellen Patienten der Patienten-Verwaltung kombiniert und anschließend bearbeitet werden. Sichtbare Schalter sind also:

● Schalter „Daten bearbeiten“

● Schalter „Patienten kombinieren + ändern“

Aus „Patientdaten ändern“ und aus „Neuer Patient“ aufgerufen (wenn der neue Patient gespeichert ist), kann nur der HL7-Patient mit dem aktuellen Patienten der Patienten-Verwaltung kombiniert und anschließend bearbeitet werden. Sichtbare Schalter sind also:

● Schalter „Patienten kombinieren + ändern“

Vorgehensweise zum Einfügen eines Patienten aus HL7

1. Klicken Sie auf den Schalter „HL7-Patienten“ in der Hauptansicht. Sie finden einen solchen Eintrag auch als Menüpunkt im Menü „Patient“ oder in der Patienten-Verwaltung (nicht bei „Patientdaten ändern“). Hier finden Sie diesen Befehl auch im Menü des Schalters „Patienten-Suche“.

2. Geben Sie in der oberen Liste Suchkriterien für den „HL7-Patienten“ ein. Diese Kriterien sind genauso einzufügen, wie die Kriterien in der Cypro-Statistik.

Standardmäßig werden hier immer „Name“, „Vorname“ und „Geburtsdatum“ anzeigt, Wünschen Sie weitere Kriterien, so klicken Sie auf den Plusschalter und dann in das Feld „Feld“. Nun wird die Liste aller möglichen Kriterien angezeigt. Wählen Sie das gewünschte Kriterium aus und geben dann als Freitext im Feld „Wert“ den Such-Wert ein. Spezielle Bedingungen können im Feld „Bedingung“ eingegeben werden. Ein leerer Eintrag bedeutet immer „gleich“. Mehrere Kriterien können mit bestimmten Verknüpfungen verbunden werden (Feld „Verknüpfung“). Ein leerer Eintrag bedeutet hier „UND“. Wenn Sie ein Kriterium wieder löschen möchten, dann markieren Sie den Eintrag und klicken dann auf den Minus-Schalter. Sie können auch vordefinierte Kriterien-Paare einfügen. Klicken Sie dazu auf den Schalter mit dem Datengitter neben dem X-Symbol.




3. Wenn Sie alle Kriterien ausgefüllt haben, dann klicken Sie auf den Schalter „diese Patienten anzeigen“ oder betätigen den ENTER-Schalter. Cypro sucht nun in der HL7-Patienten-Verwaltung nach allen Patienten, die diese Kriterien erfüllen.

Möchten Sie alle Patienten aus der HL7-Patienten-Verwaltung anzeigen, dann klicken Sie auf den Schalter „Alle Patienten anzeigen“.

4. Wenn Sie mehrere Patienten gefunden haben, können Sie entweder die Kriterien weiter einschränken oder den Patienten aus der Liste manuell auswählen.

Sie können die Liste der gefundenen Patienten nach bestimmten Kriterien (z.B. Name, Geburtsdatum) sortieren. Klicken Sie dazu auf den Sortier-Schalter links über der Patientenliste.Sie können auch in der Patienten-Liste nach bestimmten Einträgen suchen. Geben Sie dazu den Wert in das Suchfeld über der Patientenliste ein und wählen Sie in der Liste rechts daneben das Feld, in dem gesucht werden soll.

5. Möchten Sie einen Patienten aus der Patienten-Liste in Cypro überführen, dann klicken Sie nun auf „Diesen Patienten einfügen“ oder auf „Patientdaten ändern“. Sie können einen Patienten auch mit Doppelklick auf den Listeneintrag einfügen. Beim Einfügen eines Patienten wird der Dialog verlassen und der neue Patient wird zum aktuellen Patienten in der Patientenliste der Hauptansicht. Mit „Patientdaten ändern“ wird in die Patienten-Verwaltung von Cypro zum Bearbeiten des eingefügten Patienten gewechselt.

Achtung:Wenn Sie die HL7-Verwaltung von der Patienten-Verwaltung aus aufgerufen haben,können Sie nur im „Bearbeitungs-Modus“ bleiben. Der Schalter „Diesen Patienten einfügen“ wird nicht angezeigt.

Achtung:In der HL7-Patienten-Liste werden nur die Patienten angezeigt, die aus der HL7-Patienten-Verwaltung noch nicht in die Cypro-Patienten-Verwaltung eingefügt wurden. Wenn ein eingefügter „HL7-Patient“ in Cypro wieder gelöscht wird, dann wird der Patient in der HL7-Patienten-Liste zum Neu-Einfügen wieder angezeigt.

Es wird nur die aktuelle Aufnahme-Nummer angezeigt, ebenso sucht das Kriterium „Aufnahme-Nummer“ nur nach der aktuellen Aufnahme-Nummer. Wenn ein Patient entlassen ist, dann ist die Aufnahme-Nummer leer, obwohl ein Aufnahme und Entlassungs-Satz mit ausgefüllter Aufnahme-Nummer besteht.

Die Schnellsuche in Cypro (ALT-F3 in der Hauptansicht oder entsprechender Menüeintrag im Menü „Patient“) ist mit der HL7-Patienten-Verwaltung verknüpft. Wenn die Schnellsuche keinen Patienten finden kann, dann wechselt Cypro mit den gewählten Kriterien der Schnellsuche in den Dialog “HL7-Patienten“. Zuvor fragt Cypro natürlich, ob jetzt bei den HL7-Patienten gesucht werden soll.




Patienten aus Cypro mit Patienten aus HL7 kombinieren

Sie können die Daten von Patienten aus Cypro mit den aus der HL7-Patienten-Verwaltung zusammenfassen. Dabei werden alle Daten des Cypro-Patienten (Name, Vorname, Geburtsdatum, Anschrift, Station...) überschrieben. Die Aufnahmen des Cypro-Patienten werden bei einer gleichen Aufnahme-Nummer überschrieben, ansonsten bleiben die Aufnahmen des Cypro-Patienten bestehen und die des HL7-Patienten werden eingefügt.

Der Cypro-Patient darf nicht von der HL7-Schnittstelle eingefügt worden sein, der HL7-Patient darf nicht als andere Cypro-Patient eingefügt worden sein oder mit einem anderen Cypro-Patienten kombiniert worden sein.

Nach dem Kombinieren ist der Cypro-Patient in die HL7-Patienten-Verwaltung eingefügt und wird anschließend von der HL7-Schnittstelle bei Eintreffen von HL7-Nachrichten automatisch aktualisiert.

Sie können die Möglichkeit, Patienten kombinieren zu können, in den Optionen deaktivieren (Optionen - Seite „HL7“ – „Cypro”), dies ist standardmäßig der Fall.

ACHTUNG:Das Kombinieren überschreibt alle Patienten-Daten des aktuellen Patienten. Dies ist genauso, als ob Sie alle Daten des Patienten neu überschreiben würden.

Vorgehensweise zum Kombinieren von Patienten

1. Klicken Sie auf den Schalter „HL7-Patienten“ in der Hauptansicht. Sie finden einen solchen Eintrag auch als Menüpunkt im Menü „Patient“ oder in der Patienten-Verwaltung.

2. Geben Sie in der oberen Liste Suchkriterien für den „HL7-Patienten“ ein. Diese Kriterien sind genauso einzufügen, wie die Kriterien in der Cypro-Statistik.

3. Wenn Sie alle Kriterien ausgefüllt haben, dann klicken Sie auf den Schalter „diese Patienten anzeigen“ oder betätigen den ENTER-Schalter. Cypro sucht nun in der HL7-Patienten-Verwaltung nach allen Patienten, die diese Kriterien erfüllen. Möchten Sie alle Patienten aus der HL7-Patienten-Verwaltung anzeigen, dann klicken Sie auf den Schalter „Alle Patienten anzeigen“.

4. Wenn Sie mehrere Patienten gefunden haben, können Sie entweder die Kriterien weiter einschränken oder den Patienten aus der Liste manuell auswählen.

5. Möchten Sie einen Patienten aus der Patienten-Liste in Cypro überführen, dann klicken Sie nun auf „Diese Patienten kombinieren“ oder auf „Patienten kombinieren + ändern“. Beim Kombinieren von Patienten wird der Dialog verlassen, ohne den aktuellen Patienten in der Hauptansicht zu wechseln. Mit „Patienten kombinieren + ändern“ wird in die Patienten-Verwaltung von Cypro zum Bearbeiten des kombinierten Patienten gewechselt.




Verhindern, dass die HL7-Schnittstelle eigene Aufnahmen, automatisch mit neuen Werten überschreibt

Wählen Sie in den Cypro-Optionen den Punkt „Aktualisierung eigener Aufnahmen/Patienten“ - „Eigene Aufnahmen durch die nächste eintreffende HL7-Botschaft aktualisieren“ ab (Seite „HL7“ - „Spezielles“).

Alternativ können Sie auch eine spezielle Aufnahme von der Aktualisierung ausschließen, Dazu wählen Sie die Aufnahme in der Aufnahme-Liste der Patienten-Verwaltung und klicken auf den Schalter „Änderung maskieren“. Die Aufnahme erscheint jetzt mit einem grünen Symbol. Mit Klick auf den Schalter „Maskierung aufheben“ wird die Maskierung wieder entfernen.

Verhindern, dass die HL7-Schnittstelle eigene Patienten, automatisch mit neuen Werten überschreibt

Wählen Sie in den Cypro-Optionen den Punkt „Selbst eingegebene Patienten ohne Patienten-ID oder mit Cypro-ID als Patienten-ID, automatisch mit einem HL7-Patienten verknüpfen, wenn Name, Vorname, Geburtstag, Krankenhaus, Abteilung und Station vollständig übereinstimmen“ ab (Seite „HL7“ - „Spezielles“).




HL7-Testdaten

Im folgenden sehen Sie beispielhafte HL7-Botschaften, so wie sie von Cypro erwartet werden.

Die Bewegungs-Nummer wird vom Krankenhaus-Informations-System übertragen (PV1.1) und das Krankenhaus wird in einem 2-stelligen Code als Bestandteil von Abteilung und Station übertragen.

Einen Patienten mit einer A01-Botschaft aufnehmen:

MSH|^~\&|SAP_ISH|0011|CYPRO|CYPRO|20040603163103||ADT^A01|01341624|P|2.2|||AL||DE

EVN|A01|200406031632

PID|||0039546724||Mustermann^Hans||19111111|M|||Alte Strasse 27^^Musterhausen^^22453^ DE||0179/1234567|0178/12345678||||||||||||DE

PV1|0127895||110102^^^1101||||0000600787^Tester^Hans A.^^^^Dr.med.||||||||||||1121976002|||||||||||||||||||||||||20040603160000

IN1|||123456789|AOK Hamburg||||||||||||||||||||||||||||||||078565|

Die Daten eines bestehenden Patienten mit einer A08-Botschaft aktualisieren:


EVN|A08|200406041632

PID|||0039546724||Mustermann^Hans||19111111|M|||Neue Strasse 17^^Musterhausen^^22453^ DE||0179/1234567|0178/12345678||||||||||||DE

PV1|0127896||110102^^^1101||||0000600787^Tester^Hans A.^^^^Dr.med.||||||||||||1121976002|||||||||||| |||||||||||||20040603160000

IN1|||123456789|AOK Hamburg||||||||||||||||||||||||||||||||078565|

Einen Patienten mit einer A02-Botschaft verlegen:


EVN|A02|200406051632


PV1|0127897||110503^^^1105||||0000600787^Tester^Hans A.^^^^Dr.med.||||||||||||1121976002|||||||||||| |||||||||||||20040603160000

IN1|||123456789|AOK Hamburg||||||||||||||||||||||||||||||||078565|



HL7-Testdaten

Einen Patienten mit einer A03-Botschaft entlassen:


EVN|A03|200406161632


PV1|0127898||110102^^^1101||||0000600787^Tester^Hans A.^^^^Dr.med.||||||||||||1121976002|||||||||||| |||||||||||||20040603160000|200406161625

IN1|||123456789|AOK Hamburg||||||||||||||||||||||||||||||||078565|



HL7-Testdaten

Die HL7-Schnittstelle in Cypro · Die HL7-Schnittstelle in Cypro ... Trainings- (Test-) und...

Documents

Transcript of Die HL7-Schnittstelle in Cypro · Die HL7-Schnittstelle in Cypro ... Trainings- (Test-) und...