Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
HL7 v2 és FHIR klinikai műszerfalakhoz
Egy HL7 v2 ORU^R01 laborüzenettől egy műszerfal csempéjéig: FHIR megfigyelések (Observations) tartományokkal és jelzőkkel, aláírt webhookok, nincs ismétlődés – és miért nem ez az ágy melletti monitorozás.
Egy klinikai irányítópultnak a strukturált, kódolt adatok formájában érkező eredményekre van szüksége abban a pillanatban, amikor azokat jelentik – teszt, érték, mértékegység, referencia tartomány és jelző –, nem pedig PDF-ekre, amelyeket el kell olvasnia. A laboratóriumok továbbra is a legtöbb eredményt HL7 v2 ORU^R01 üzenetként küldik, míg az irányítópultokat a legegyszerűbb FHIR R4 Observations alapján felépíteni. Az Anpheros a kettő között helyezkedik el: egy laboratóriumi rendszer HTTPS-en keresztül közzéteszi a HL7 v2 üzenetet (vagy CSV vagy JSON jelentést), minden egyes eredmény FHIR Observation-né válik a kódjával (LOINC, ha a labor elküldi), értékével és referencia tartományával, és egy aláírt webhook tájékoztatja az irányítópultot az új eredmények érkezéséről.
- Laboratory systemSends an HL7 v2 ORU^R01 message or a CSV report
- Lab connectorPOST /v1/patients/{id}/labs/import over HTTPS
- FHIR ObservationsLOINC code, value, unit, reference range, H/L flag
- Signed webhookresource.created reaches your server, retried on failure
- Your dashboardReads the new results and updates the tile
Amit a műszerfal fogad
Az üzenet minden OBX szegmense egy laboratóriumi megfigyelést (Observation) eredményez:
| HL7 v2 OBX mező | FHIR R4 Observation | A műszerfalon |
|---|---|---|
| OBX-3 teszt kód | code (LOINC, ha a labor küldi; helyi kódként a labor kódja marad) |
Teszt neve; a LOINC teszi összehasonlíthatóvá a laborok között |
| OBX-5 érték, OBX-6 egység | valueQuantity (UCUM egység) |
A szám és az egysége |
| OBX-7 referencia tartomány | referenceRange |
A normál tartomány |
| OBX-8 abnormalitási jelző | interpretation (H, L, …) |
A piros vagy kék jelző |
| OBX-14 időpont | effectiveDateTime |
Mikor vették a mintát |
Üzenet importálása és reagálás rá
Küldje el az üzenetet egy általuk létrehozott (vagy Ön által birtokolt) beteg számára:
import { readFile } from 'node:fs/promises';
import { Anpheros, apiKey } from '@anpheros/sdk';
const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) }); // a sandbox key, sk_test_…
const message = await readFile('oru_r01.hl7', 'utf8');
const result = await anpheros.labs.importHl7(patientId, message, { sourceSystem: 'lab-lis' });
console.log(result); // created, skipped and unmapped counts
Ezután hagyja, hogy a platform a lekérdezés helyett a dashboard backendjét hívja meg:
await anpheros.webhooks.create('https://dashboard.example.org/anpheros/hook', { events: ['resource.created'] });
Minden kézbesítés alá van írva (ellenőrizze a verifyWebhookSignature segítségével az SDK-ból), és újra megpróbálkozik, ha a szervere nem válaszol. Az esemény tartalmazza az erőforrás típusát, azonosítóját és a beteget; olvassa el az új megfigyeléseket (Observations) és frissítse a csempét. Az újra küldött jelentéseket a rendszer kihagyja, így egy laboratórium, amely időtúllépés esetén újra továbbít, nem hoz létre duplikált sorokat a képernyőn.
HL7 v2 vagy FHIR kiválasztása minden kapcsolathoz
| Kapcsolat | Használat | Miért |
|---|---|---|
| Laboratórium → adatréteg | HL7 v2 ORU^R01 (vagy CSV/JSON) | Amit a laboratóriumi rendszerek már kibocsátanak; nincs változás az ő oldalukon |
| Adatréteg → irányítópult | FHIR R4 Observation + webhookok | Kódolt, verziózott JSON, amit a frontend közvetlenül tud olvasni |
| Irányítópult → más alkalmazások | FHIR R4, a beteg beleegyezése alapján | Egy szabvány minden fogyasztó számára |
Mi ez nem
- Nem intenzív ápolási monitor adatáradat. Az Anpheros laboratóriumi jelentéseket fogad HTTPS protokollon keresztül. Nem fogad folyamatos hullámformokat vagy eszközadatfolyamokat intenzív ápolási monitorokról, és nem riasztórendszer: a ellátást befolyásoló riasztásokhoz tanúsított klinikai rendszer szükséges.
- Nem MLLP interfész motor. Az üzenetek HTTPS protokollon érkeznek; ha a laboratóriuma csak MLLP-t beszél TCP-n keresztül, egy interfész motor továbbítja azokat.
- Egy HL7 v2 üzenettípus. ORU^R01 laboratóriumi eredményeket fogadunk; megrendeléseket (ORM/OML) és ADT üzeneteket nem.
Gyakran ismételt kérdések
Tud-e egy irányítópult közvetlenül HL7 v2 laboreredményeket olvasni?
Meg tudja, de minden irányítópultnak szüksége van saját HL7 v2 elemzőre, kódleképezésre és ismétlődések eltávolítására. Egyszeri konverzió FHIR R4 Observations-re LOINC kódokkal minden képernyőnek ugyanazt a tiszta adatot biztosítja.
Milyen gyorsan érnek el az importált eredmények az irányítópulthoz?
Az import kérés akkor tér vissza, amikor az Observations tárolásra kerülnek, és egyidejűleg resource.created webhook kerül sorra minden egyes eredményhez. A kézbesítés újra megpróbálkozik, ha az Ön végpontja nem elérhető.
Hogyan vannak megjelölve a rendellenes eredmények?
Az OBX-8 lesz az Observation interpretation-e (például H vagy L), és az OBX-7 a referenceRange-e, így az irányítópult mind a jelölést, mind a normál tartományt meg tudja jeleníteni.
Támogatja az Anpheros az intenzív osztályok monitorozását?
Nem. Laboratóriumi és klinikai eredményeket tárol, és értesíti rendszereit az új adatokról; a folyamatos ágy melletti monitorozás és a klinikai riasztások a tanúsított orvosi eszközökkel maradnak.
Kapcsolódó
- Lab eredmények API: HL7 v2, FHIR és LOINC
- Laboratóriumi eredmények importálása FHIR rekordba
- Lab összekötő: az endpoint referencia
- FHIR vs HL7 v2: gyakorlati különbségek
- Távoli betegmegfigyelés FHIR-rel
- Webhookok
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card