Zum Hauptinhalt springen

Rezept: HL7-ADT-Nachrichten in FHIR empfangen

Ziel: Ein Krankenhaussystem sendet Aufnahmemeldungen (HL7 v2 ADT) an Tietai. Ein Workflow empfängt jede Meldung, wandelt sie in FHIR Patient und Encounter um und schreibt sie auf Ihren FHIR-Server.

Sie benötigen: etwa 30 Minuten, die Berechtigung zum Erstellen von Workflows, eine FHIR R4 Server-URL und ein Zugriffstoken sowie jemanden auf Krankenhausseite, der HL7 an einen Host und Port senden kann.

Ein Krankenhaussystem sendet eine HL7-Nachricht an den Workflow-Engine-MLLP-Server auf Port 2575. Dieser findet die gespeicherten Workflows mithilfe eines hl7-Listener-Knotens, führt den Workflow aus und sendet eine Bestätigung zurück. Der Workflow wandelt die Nachricht in ein Transaktionsbündel um und speichert es mit fhir-crud.

Was Sie bekommen und was Sie nicht bekommen​

Dies wurde auf dem realen Motor mit einer synthetischen ADT^A01-Meldung ausgeführt:

ErgebnisDetail
PatientIdentifikator (die MRN aus PID-3), Name, Geburtsdatum, Geschlecht
EncounterKlasse IMP (stationär), Status in-progress, Standort PV1-3, verknüpft mit dem Patienten
Not convertedDie Kontaktdaten des nächsten Angehörigen (NK1), die Besuchsnummer, Details zum Ereignis (EVN), Allergien und Diagnosen. Der Lauf meldet NK1 von unmapped_segments.

Kennen Sie diese Grenzen, bevor Sie sich darauf verlassen:

  • Jede Nachricht erzeugt neue Ressourcen. Jeder Eintrag ist eine POST. Es gibt keine Übereinstimmung mit einem bestehenden Patienten, keine Aktualisierung, und der Begegnungsstatus ist immer in-progress.
  • Eine Entlassung (A03) schließt den Patientenkontakt nicht ab, eine Aktualisierung (A08) erzeugt einen zweiten Patientenkontakt, und das erneute Senden derselben Nachricht führt zu einer Duplizierung.
  • Beginnen Sie zunächst nur mit der Zulassung (filter_event = A01) und fügen Sie Ihren eigenen Abgleich- oder Aktualisierungsschritt hinzu, bevor Sie andere Veranstaltungen akzeptieren.

Bevor Sie beginnen​

  1. Berechtigungen. Sie können Tiet · Studio → Workflows öffnen.
  2. FHIR-Server. Sie haben seine Basis-URL (zum Beispiel https://fhir.example-hospital.org/r4) und ein Bearer-Token.
  3. Netzwerk. Die Workflow-Engine empfängt HL7-Daten über einen serverweiten Port (standardmäßig 2575, vom Administrator auf MLLP_PORT festgelegt). Die Krankenhausschnittstelle sendet an <your-hydra-host>:2575. Die Einstellung listen_port des Listeners muss mit diesem Serverport übereinstimmen, da der Workflow darüber zugeordnet wird. Die Einstellung listen_host wird nicht verwendet: Die Bindungsadresse ist ebenfalls serverweit.
  4. Die Namen der Absender. Fragen Sie nach der sendenden Anwendung und Einrichtung (MSH-3 und MSH-4); Sie können danach filtern.
Jeder gespeicherte Listener-Workflow empfängt jede Nachricht an diesem Port.

Der Server leitet jede eingehende Nachricht an alle gespeicherten Workflows weiter, die einen Knoten mit der ID hl7-listener auf dem entsprechenden Port enthalten. Die Suche berücksichtigt weder, ob der Workflow bereitgestellt oder aktiv ist, noch zu welcher Organisation er gehört. Lassen Sie keinen Test-Workflow gespeichert, während Live-Datenverkehr fließt, und bitten Sie Ihren Administrator, zu bestätigen, dass kein anderer gespeicherter Workflow auf Ihrem Port lauscht.

Erstellen Sie den Workflow​

1. Erstelle es​

  1. Öffne Tiet · Studio → Workflows und wähle New Workflow.
  2. Suchen Sie im Tab Palette nach jedem der unten aufgeführten Knoten und ziehen Sie ihn auf die Arbeitsfläche. Wählen Sie einen Knoten aus, um ihn im Tab Inspector zu bearbeiten (Display name unter Identity, die Einstellungen unter Node Settings; die Einstellungen des Zuhörers sind auf die Tabs Connection, Filtering, Security, Ack und Advanced verteilt).

2. Konfigurieren Sie die vier Knoten.​

hl7-listener (HL7-Listener) empfängt die Nachricht und sendet die Empfangsbestätigung.

EinstellungWertAnmerkungen
listen_port2575Muss mit dem MLLP-Port des Servers übereinstimmen.
filter_message_typeADTIgnorieren Sie alles, was nicht ADT ist.
filter_eventA01Nur Eintrittskarten. Lassen Sie dieses Feld leer, um alle Veranstaltungen zuzulassen (beachten Sie die oben genannten Einschränkungen).
filter_sending_applicationz. B. EPICOptional
filter_sending_facilityz. B. GENHOSPOptional
ack_modeautoDer Empfänger antwortet nach dem Durchlauf: AA (akzeptiert), AE (Durchlauf fehlgeschlagen) oder AR (vor der Verarbeitung abgelehnt). manual bewirkt, dass der Durchlauf den Code setzt; none sendet keine Bestätigung.
nack_on_filterfalseSiehe die untenstehende Fehlertabelle.
allowed_ipsz. B. 10.0.0.0/24Optional: Nur Verbindungen aus dem Krankenhausnetzwerk akzeptieren

hl7-to-fhir (HL7 zu FHIR) benötigt keine Einstellungen. Wählen Sie default_timezone (z. B. Europe/Madrid), wenn die Nachrichtenzeitstempel keine Zeitzone enthalten. Der Typ wird anhand von MSH-9 erkannt und ein Objekt result zurückgegeben, das das Bundle in fhir_bundle enthält.

transform, benannt Pick the Bundle, nimmt das Bundle aus diesem Objekt heraus, sodass der Schreibknoten ein Bundle und nicht dessen Wrapper erhält.

EinstellungWert
Transformation Type (transformation_type)extract
Mappings (mappings)Wähle dreimal Add field; gib in jeder Zeile die Target und die Source (dot path ok) ein: resourceType aus input.fhir_bundle.resourceType, type aus input.fhir_bundle.type, entry aus input.fhir_bundle.entry

fhir-crud (FHIR CRUD) schreibt das Bundle.

EinstellungWert
fhir_urlhttps://fhir.example-hospital.org/r4 (oder {{FHIR_URL}} bei einer nicht geheimen Variable)
operationtransaction
auth_tokenFügen Sie das Token in dieses Feld ein.
Wohin das Token geht

auth_token ist ein geheimes Feld: Fügen Sie das Token dort ein. Speichern Sie es nicht als als geheim gekennzeichnete Variable und schreiben Sie nicht {{FHIR_TOKEN}}: Eine geheime Variable wird nicht ersetzt, der Server würde also den Text Bearer {{FHIR_TOKEN}} empfangen. Für die URL ist eine nicht geheime Variable zulässig.

3. Verbinden Sie die Anschlüsse​

AusHafenZuHafen
HL7-Listenerraw_messageHL7 zu FHIRhl7_message
HL7 zu FHIRresultWählen Sie das Paketinput
Wählen Sie das PaketresultFHIR CRUDbundle

raw_message ist Text und hl7_message erwartet Text, daher werden sie verbunden. Verbindet man result direkt mit bundle, empfängt der Schreibknoten das Wrapper-Objekt und schlägt mit Fehler transaction input must be a Bundle, got resourceType=<nil> fehl. Deshalb ist der Extraktionsschritt notwendig.

4. Validieren und speichern​

Wählen Sie in der Symbolleiste Validate und anschließend Save (Sie werden nach einer Version gefragt; übernehmen Sie den Vorschlag). Der Workflow empfängt Nachrichten, sobald er gespeichert ist. Die Bereitstellung (das violette Menü rechts in der Symbolleiste, mit dem die gespeicherte Version in einer anderen Umgebung bereitgestellt wird) ist für den Empfang von Nachrichten nicht erforderlich und schränkt die empfangenen Nachrichten nicht ein.

Testen Sie es mit einer synthetischen Nachricht​

Verwenden Sie ausschließlich synthetische Daten. Diese Nachricht ist ein erfundenes Eingeständnis:

MSH|^~\&|EPIC|GENHOSP|TIETAI|HIP|20260915083000||ADT^A01^ADT_A01|SMP-A01-0001|P|2.5
EVN|A01|20260915083000|||USR100^Nurse^Maria
PID|1||MRN100001^^^GENHOSP^MR||Rivera^Elena^M||19750312|F|||742 Evergreen Terrace^^Springfield^IL^62704^USA||(217)555-0142||en|M
NK1|1|Rivera^Carlos|SPO^Spouse^HL70063||(217)555-0143
PV1|1|I|MED^301^A^GENHOSP|E|||2001^Smith^Anna^^^Dr|||MED||||7|||2001^Smith^Anna^^^Dr||V2026091501^^^GENHOSP^VN

HL7 trennt Segmente durch einen Wagenrücklauf, nicht durch einen Zeilenvorschub. Das Simulationstool im Repository sendet die Daten korrekt und wartet auf die Bestätigung.

# from the tietai-simulation-service folder
sim-cli hl7 send -H <your-hydra-host> -p 2575 --file samples/hl7v2/adt_a01_admit.hl7 -v

Eine Bestätigung von AA bedeutet, dass die Nachricht zur Verarbeitung angenommen wurde.

Ergebnis prüfen​

  1. Der Lauf. Öffnen Sie Tiet · Studio → Workflows → Monitor. Der Lauf für Ihren Workflow sollte anzeigen, dass alle vier Knoten erfolgreich waren.
  2. Die Daten. Öffnen Sie FHIR Server → Patients und suchen Sie nach identifier=MRN100001 (eine Suche mit = wird als FHIR-Suchparameter an den Server gesendet). Sie sollten die Patientin Rivera, Elena, weiblich, geboren am 12.03.1975, mit einem Encounter der Klasse IMP an Ort MED 301 A GENHOSP finden. Der Ehepartner ist nicht vorhanden, da NK1 nicht konvertiert wurde.

Wenn etwas schiefgeht​

SymptomUrsacheWas zu tun
Der Absender kann keine Verbindung herstellenAm Serverport lauscht kein Gerät, oder eine Firewall blockiert den Zugriff.Bitten Sie Ihren Administrator, die Meldung MLLP_PORT zu bestätigen und sicherzustellen, dass der Port vom Krankenhausnetzwerk aus geöffnet ist.
Der Absender erhält ARKein gespeicherter Workflow hat eine hl7-listener an diesem Port (die Standardantwort des Servers, wenn kein anderer Server lauscht); oder der Header ist unlesbar (MSH-9, MSH-10 oder MSH-12 fehlt); oder die Version ist nicht HL7 v2.x; oder der Workflow allowed_ips oder max_message_size hat die Nachricht abgelehnt; oder alle Listener haben sie herausgefiltert und einer setzt nack_on_filterSpeichern Sie den Workflow und prüfen Sie, ob listen_port dem Serverport entspricht. Prüfen Sie anschließend das MSH-Segment und die IP-Adresse des Absenders.
Der Absender erhält AA, aber es passiert nichts.Alle Empfänger haben die Nachricht herausgefiltert. Standardmäßig wird eine gefilterte Nachricht mit „AA“ bestätigt und ignoriert.Prüfen Sie filter_message_type, filter_event sowie den Absender- und den Einrichtungsnamen. Stellen Sie nack_on_filter auf true um stattdessen AR zu antworten, damit der Absender das Problem sieht.
Der Lauf schlägt am letzten Knoten fehl.Der FHIR-Schreibvorgang ist fehlgeschlagen.Öffnen Sie den Lauf in Monitor. fhir_url is required bedeutet, dass die URL leer ist; eine abgelehnte Anfrage bedeutet normalerweise, dass das Token oder die URL falsch ist.
transaction input must be a Bundle, got resourceType=<nil>Der Schreibknoten empfing das Wrapper-Objekt, nicht das Bundle.Überprüfen Sie Schritt Pick the Bundle und seine Zuordnungen.
INVALID_MSH_SEGMENT oder MISSING_HL7_MESSAGEDer Listener-Knoten hat keine Nachricht erhalten, oder das MSH-Segment fehlt oder enthält weniger als 10 Felder.Überprüfen Sie das MSH-Segment der Nachricht.
Der Absender erhält AR für eine große Nachricht.Die Nachricht befindet sich über dem Workflow-Level max_message_sizeDer Standardwert für die maximale Größe beträgt 1048576 Byte (1 MiB); 0 entfernt die Beschränkung pro Workflow. Der Server hat ebenfalls eine eigene Beschränkung.

Passe es an.​

  • Ergebnisse (ORU) oder Aufträge (ORM): hl7-to-fhir ordnet ORU auch Patient plus Beobachtung und Diagnosebericht und ORM Patient plus Serviceanfrage zu. Ändern Sie den Filter und behalten Sie die übrigen bei.
  • Reagiere auf das, was ankommt: Füge nach der Konvertierung einen condition Knoten hinzu (siehe Erstellen eines beliebigen Workflows), zum Beispiel um Aufnahmen an eine bestimmte Station weiterzuleiten.
  • Mehrere Krankenhäuser oder Standorte: Platzieren Sie an jedem Standort einen Listener mit Run on mesh.
  • Alternativ können Sie eine Connect-Pipe verwenden: Erstellen Sie eine Connect-Pipe, die HL7 über eine Pipe empfängt. Lesen Sie die Hinweise zur FHIR-Konvertierung, bevor Sie diesen Weg wählen.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..