|
<< Klicken Sie, um das Inhaltsverzeichnis anzuzeigen >> Navigation: »Kein übergeordnetes Thema« FELIX (HL7 Schnittstelle) |
FELIX gehört nicht zum Standardlieferumfang von EMIL und muss als Zusatzlizenz über ITC erworben werden. Ohne Aktivierung über einen gültigen Lizenzcode arbeitet die Schnittstelle nicht auf dem Server, kann aber dennoch konfiguriert und manuell getestet werden.
FELIX verbindet EMIL mit Klinikinformationssystemen und Kliniklabors über HL7, HCM und xDT. Übertragen wird dateibasiert oder im Netzwerk per MLLP (Minimal Lower Layer Protocol, im HL7-Umfeld üblich).
•Eingangskanäle: HL7 V2 (ADT sowie ORU für Zahlen- und Textbefunde), HCM (z. B. SAP ISH*), xDT (z. B. BDT, LDT, GDT) für Sonderfälle.
•Ausgangskanäle: HL7 MDM (freigegebene Arztbriefe als eingebettete PDFs, Base64-kodiert, an das Archiv), HL7 ORU (Befundnachrichten bei Änderung von im Dictionary markierten Items) und HL7 BAR (Haupt-, Neben- und Dauerdiagnosen). Details: Ausgangsnachrichten (MDM/ORU/BAR).
Sie öffnen die FELIX-Verwaltung über Administration|ITC-FELIX. Sie erscheint mit einem eigenen Ribbon-Reiter FELIX (12) und gliedert sich in den Kanalbaum (1) links und den Kanaleditor mit Script-Entwicklungsumgebung rechts.

1.Liste aller definierten Kommunikationskanäle, jeweils mit Name und Typ.
2.Editor für das Verarbeitungsscript des gewählten Kanals.
3.Inhalt der geladenen Testnachricht (HL7-Quelldaten) zum Testen des Scripts.
4.Variablen mit ihren Live-Werten während des Debuggens.
5.Ausgabe/Konsole mit Meldungen und dem Aufruf-Trace der Schnittstellenfunktionen.
6.Ribbon-Gruppe „Script-Debugger" (Ausführen, Script prüfen, Breakpoint setzen, Schritt hinein, Schritt über).
7.Roter Haltepunkt-Bullet im Editorrand; die gerade angehaltene Zeile ist blau markiert.
8.Grundeinstellungen des Kanals (Bezeichnung, Kanaltyp, Übergabepfad bzw. Bindung, Dateispezifikation).
9.Übertragungsart (dateibasiert oder Netzwerk/MLLP), Aktivierung, Zeichensatz und Acknowledge.
10.Globale, kanalübergreifende Optionen (Pufferdauer, automatische Bereinigung).
11.Ribbon-Gruppe „Schnittstellenkanal" (Neuer Kanal, Speichern, Kanal löschen, Testnachricht lesen, Standard-Script).
12.Ribbon-Reiter „FELIX".
Über die Ribbon-Gruppe „Schnittstellenkanal" (11) legen Sie mit Neuer Kanal einen Kanal an, übernehmen Änderungen mit Speichern und entfernen den markierten Kanal mit Kanal löschen. Ein Klick auf einen Eintrag im Baum (1) lädt den Kanal in den Editor.
Geben Sie jedem Kanal unter (8) eine aussagekräftige Bezeichnung, über die er im Baum leicht zu finden ist. Darunter wählen Sie den Kanaltyp: Inbound-Kanäle lesen Daten aus externen Quellen in die EMIL-Datenbank ein (z. B. HL7 aus KIS oder Labor), Outbound-Kanäle übergeben Daten aus EMIL an externe Systeme (z. B. freigegebene Briefe als MDM-Nachricht ans Klinikarchiv).
Unter (9) entscheiden Sie, ob die Daten auf diesem Kanal dateibasiert oder über Netzwerk/MLLP übertragen werden. Abhängig davon geben Sie unter (8) entweder einen Dateipfad mit Dateispezifikation (z. B. *.hl7) oder eine IP-Bindung mit Port an.
Ebenfalls unter (9) aktivieren Sie den Kanal und schalten den Zeichensatz zwischen ANSI und UTF8 um. Bei MLLP-Übertragung wählen Sie, ob Nachrichten mit einer normalen MLLP-Acknowledge-Sequenz oder einer HL7-Acknowledge-Nachricht quittiert werden. Diese Informationen erhalten Sie aus der Konfiguration der Gegenstelle.
Die Optionen unter (10) gelten kanalübergreifend für alle Kanäle.
FELIX übersetzt eingehende Nachrichten zunächst aus dem Quellformat (HL7, HCM oder xDT) in ein Zwischenformat und puffert sie beim Empfang in der Datenbank, damit ohne Verzögerung empfangen werden kann. Anschließend verarbeiten die Kanal-Scripts sie asynchron. Was danach mit einer Nachricht im Puffer geschieht, hängt vom Ausgang des Script-Laufs ab:
Ausgang des Script-Laufs |
Nachricht im Puffer |
Fehlerfrei verarbeitet, SaveAndClose aufgerufen |
Daten werden festgeschrieben, die Nachricht wird gelöscht. Im Kanaleditor bleibt sie mit SaveAndClose(debugging) als Testnachricht erhalten. |
Script endet ohne SaveAndClose und ohne Patientensuche, z. B. ein per exit bewusst verworfener Nachrichtentyp |
Wird sofort gelöscht. |
Patient nicht gefunden (FindSubject bzw. FindSubjectWithBirthdate liefert false), z. B. Befunde, die vor der Aufnahme eintreffen |
Bleibt im Puffer und wird alle drei Stunden erneut versucht. So werden Befunde auch dann zugeordnet, wenn der Patient erst nach Eintreffen der Nachricht angelegt wird. Nach Ablauf der Pufferdauer (siehe unten) wird sie gelöscht und im Protokoll vermerkt. |
Laufzeitfehler im Script |
Wie „Patient nicht gefunden"; der Fehler steht im Protokoll. |
FindOrCreateSubject verwirft die Akte: Die KIS-ID gehört zu einer Akte, bei der Vorname, Nachname und Geburtsdatum abweichen |
Wird gelöscht, Protokolleintrag „Dropping message for PID …" (siehe FELIX Scripts). |
Script lässt sich nicht kompilieren |
Bleibt unangetastet, bis der Script des Kanals korrigiert ist. Es geht nichts verloren. |
Mit Gepufferte Nachrichten nach … Tagen löschen legen Sie die Pufferdauer fest, Vorgabe 7 Tage. Nachrichten, die länger im Puffer liegen, werden automatisch entfernt und im Protokoll vermerkt; der Wert 0 schaltet diese Bereinigung ab (nicht empfohlen).
Mit Nicht „angefasste" Akten nach … Tagen löschen bestimmen Sie, nach wie vielen Tagen von FELIX angelegte Patientenakten wieder entfernt werden, in denen über den EMIL-Client keinerlei Eintragungen oder Änderungen vorgenommen wurden. Viele Sender filtern das gewünschte Patientenkollektiv nicht genau aus, sodass Akten entstehen, die nie geöffnet werden. Vorgabe sind 30 Tage.
Eingangskanäle werden über Scripts verarbeitet, weil es trotz exakter Standards (HL7, HCM) in der Praxis viele einrichtungsspezifische Konfigurationen und Erweiterungen bis hin zur semantischen Redefinition von Feldern gibt. Der Script ist das Zwischenglied zwischen der vorverarbeiteten Nachricht und der EMIL-Patientenakte. Bei Anlage eines Eingangskanals wird ein Vorgabescript geladen, das die meisten Fälle abdeckt. Halten sich Kliniksystem und -labor sauber an den HL7-Standard, muss er meist nicht angepasst werden.
Für Anpassungen sind Programmierkenntnisse in Pascal erforderlich; ein fehlerhafter Script führt zu einer Fehl- oder Nichtfunktion des Kanals. In komplexen Fällen können Sie den ITC-Service mit den Anpassungen beauftragen. Aufbau und Befehlsreferenz: FELIX Scripts und FELIX Befehlsreferenz. Testen: Script-Debugger.
Der Script-Editor (2) ist der zentrale Bereich der Verwaltung. Rechts daneben zeigt (3) den Inhalt einer geladenen, bereits vorverarbeiteten HL7- oder HCM-Nachricht. Nachrichten sind in Segmente unterteilt, die teils mehrfach vorkommen. Die Verarbeitung geschieht segmentweise mit der Funktion NextSegment. Innerhalb eines Segments lesen Sie Werte bestimmter Positionen mit GetData, die bei HL7 folgenden Aufbau haben:
Feldposition - Wiederholung - Subfeldposition - SubSubfeldposition, z. B. 3-1-2-1
Aus den HL7-Quelldaten (3) können Sie passende GetData-Kommandos per Ziehen und Ablegen direkt in den Script ziehen.
Bei HCM sind die Positionsbezeichnungen mit den Feldnamen identisch. Da das HCM-Format starr ist, verschieben Erweiterungen dort zwangsläufig die nachfolgenden Positionen, und die Vorverarbeitung schlägt fehl. Wurde Ihr HCM-Format erweitert, finden Sie bei HCM-Kanälen den zusätzlichen Reiter Strukturdaten für Parser, in dem Sie eigene Felddefinitionen einfügen können.
