std.hl7.results

Result Reporting — parst und erzeugt ORU^R01- (Unsolicited Observation Result) und OUL^R22-Nachrichten (Unsolicited Specimen Oriented Observation Result). Dekodiert einzelne OBX-Beobachtungen und NTE-Kommentare sowie den übergeordneten Befundkopf (OBR/PID) in klare Structs.

import std.hl7.results;
import std.alloc;

// ORU^R01 parsen
var report: int64 := alloc(HL7_RPT_SIZE);
Hl7OruParse(msgBuf, msgLen, report);

// Erste OBX-Beobachtung parsen (manuell Segment suchen)
var obxSeg: int64 := // ... OBX-Segment-Zeiger
var obx: int64 := alloc(HL7_OBX_SIZE);
Hl7ObxParse(obxSeg, obxSegLen, obx);

// Kritischen Wert prüfen
if (peek64(obx + HL7_OBX_ISCRIT) == 1) {
    // Sofortmeldung an Arzt (Panikwert: HH/LL/AA/CC)
}

// Korrigierten Befund erkennen
if (peek64(obx + HL7_OBX_ISCORR) == 1) {
    // Vorherigen Befund im Archiv ersetzen
}

free(obx, HL7_OBX_SIZE);
free(report, HL7_RPT_SIZE);

• std.hl7.core
• std.alloc

Ein OBX-Segment entspricht einer Laborbeobachtung (Messwert, Text, Bild-Referenz …). Alle Felder zeigen in den Originalpuffer (Zero-Copy).

Abnormal-Flags (OBX-8):

Beobachtungsstatus (OBX-11):

Enthält die übergeordneten Informationen einer ORU/OUL-Nachricht — nicht die einzelnen Beobachtungen (die stehen in OBX und müssen separat über Hl7ObxParse geparst werden).

import std.hl7.results;
import std.alloc;

fn processLabResult(msgBuf: int64, msgLen: int64): void {
    // Befundkopf parsen
    var report: int64 := alloc(HL7_RPT_SIZE);
    Hl7OruParse(msgBuf, msgLen, report);

    var patId:   int64 := peek64(report + HL7_RPT_PAT_ID);
    var service: int64 := peek64(report + HL7_RPT_SERVICE);
    var obsDt:   int64 := peek64(report + HL7_RPT_OBS_DT);

    // OBX-Segmente manuell aus Nachricht extrahieren und parsen
    // (OBX-Segmente beginnen mit CR+'OBX|')
    var obx: int64 := alloc(HL7_OBX_SIZE);

    // ... OBX-Segment-Zeiger und Länge ermitteln (z. B. per Segment-Scanner) ...
    // Hl7ObxParse(obxSegPtr, obxSegLen, obx);

    // Panikwert-Behandlung
    if (peek64(obx + HL7_OBX_ISCRIT) == 1) {
        var val:  int64 := peek64(obx + HL7_OBX_VALUE);
        var flag: int64 := peek64(obx + HL7_OBX_ABNFLAG);
        // Arzt sofort benachrichtigen ...
    }

    // Korrektur-Befund
    if (peek64(obx + HL7_OBX_ISCORR) == 1) {
        // Vorherigen Befund im KIS überschreiben ...
    }

    // Gegenbefund als ORU schreiben
    var outBuf: int64 := alloc(4096);
    var outLen: int64 := Hl7OruWrite(report, obx, outBuf, 4096);
    // Weiterleiten ...

    free(outBuf, 4096);
    free(obx, HL7_OBX_SIZE);
    free(report, HL7_RPT_SIZE);
}

• ORU vs. OUL: ORU^R01 ist der verbreitete allgemeine Befundtyp (Laborbefunde, Mikrobiologie, Pathologie). OUL^R22 ist probenorientiert — es gibt ein Ergebnis pro Probe statt pro Auftrag.
• Mehrere OBX-Segmente: Eine ORU-Nachricht enthält typischerweise viele OBX-Segmente (eines pro Laborparameter). Hl7OruParse füllt nur den Kopf — alle OBX müssen über Hl7ObxParse in Schleife geparst werden.
• Panikwerte: Kritische Abnormal-Flags (HH/LL/AA/CC in OBX-8) lösen ISCRIT=1 aus. Das Krankenhausinformationssystem (KIS) muss diese sofort an den zuständigen Arzt melden.
• Korrektur-Befunde: OBX-11 = 'C' (Corrected) oder 'W' (Wrong) setzt ISCORR=1. Ein korrigierter Befund muss vorherige vorläufige Befunde im Archiv ersetzen.
• LOINC und UCUM: OBX-3 enthält typischerweise einen LOINC-Code (Untersuchungsidentifikation); OBX-6 enthält UCUM-Einheiten. Die Unit speichert diese als rohe Zeichenketten ohne Lookup.
• NTE-Kommentare: NTE-Segmente folgen direkt nach dem OBX, dem sie zugeordnet sind. Hl7NteParse extrahiert nur NTE-3 (Freitext); andere NTE-Felder werden ignoriert.

Letzte Aktualisierung: 2026-06-16