Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Klinik Panolar İçin HL7 v2 ve FHIR
Bir HL7 v2 ORU^R01 laboratuvar mesajından bir pano kutucuğuna: aralıklar ve bayraklarla FHIR Gözlemleri, imzalı webhook'lar, yinelenen yok — ve neden bu yatak başı izleme değil.
Bir klinik gösterge paneli, sonuçları raporlandığı anda yapılandırılmış, kodlanmış veriler olarak ister — test, değer, birim, referans aralığı ve bayrak — okuması gereken PDF'ler değil. Laboratuvarlar hala sonuçların çoğunu HL7 v2 ORU^R01 mesajları olarak gönderirken, gösterge panelleri en kolay FHIR R4 Gözlemleri üzerine inşa edilir. Anpheros ikisinin arasında yer alır: bir laboratuvar sistemi HL7 v2 mesajını (veya bir CSV veya JSON raporunu) HTTPS üzerinden yayınlar, her sonuç kodu (laboratuvar gönderdiğinde LOINC), değeri ve referans aralığı ile bir FHIR Gözlemi haline gelir ve imzalı bir webhook gösterge panelinize yeni sonuçların geldiğini bildirir.
- 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
Gösterge panelinin aldığı veriler
Mesajdaki her OBX segmenti, bir laboratuvar Gözlemi haline gelir:
| HL7 v2 OBX alanı | FHIR R4 Observation | Gösterge panelinde |
|---|---|---|
| OBX-3 test kodu | code (laboratuvar gönderdiğinde LOINC; yerel bir kod laboratuvarın kodu olarak saklanır) |
Test adı; LOINC, laboratuvarlar arasında karşılaştırılabilir hale getirir |
| OBX-5 değer, OBX-6 birim | valueQuantity (UCUM birimi) |
Sayı ve birimi |
| OBX-7 referans aralığı | referenceRange |
Normal aralık |
| OBX-8 anormal bayrağı | interpretation (H, L, …) |
Kırmızı veya mavi bayrak |
| OBX-14 zaman | effectiveDateTime |
Numunenin alındığı zaman |
Mesajı İçe Aktarma ve Yanıt Verme
Oluşturduğunuz (veya bir izne sahip olduğunuz) bir hasta için mesajı gönderin:
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
Ardından platformun yoklama yapmak yerine kontrol panelinizin arka ucunu çağırmasına izin verin:
await anpheros.webhooks.create('https://dashboard.example.org/anpheros/hook', { events: ['resource.created'] });
Her teslimat imzalanır (SDK'dan verifyWebhookSignature ile doğrulayın) ve sunucunuz yanıt vermezse yeniden denenir. Olay, kaynak türünü, kimliğini ve hastayı taşır; yeni Gözlemleri okuyun ve kutucuğu yenileyin. Yeniden gönderilen raporlar atlanır, bu nedenle zaman aşımı durumunda yeniden iletim yapan bir laboratuvar ekranda yinelenen satırlar oluşturmaz.
Her bağlantı için HL7 v2 veya FHIR seçimi
| Bağlantı | Kullanım | Neden |
|---|---|---|
| Laboratuvar → veri katmanı | HL7 v2 ORU^R01 (veya CSV/JSON) | Laboratuvar sistemlerinin zaten yaydığı format; onların tarafında değişiklik gerekmez |
| Veri katmanı → gösterge paneli | FHIR R4 Observation + web kancaları | Ön uç tarafınızın doğrudan okuyabileceği, kodlanmış, sürümlenmiş JSON |
| Gösterge paneli → diğer uygulamalar | FHIR R4, hastanın rızası dahilinde | Her tüketici için tek standart |
Bu Neler Değildir
- Yatak başı monitör akışı değildir. Anpheros, laboratuvar raporlarını HTTPS üzerinden kabul eder. Yoğun bakım monitörlerinden sürekli dalga formları veya cihaz akışları almaz ve bir alarm sistemi değildir: bakımı etkileyen uyarılar sertifikalı bir klinik sistem gerektirir.
- MLLP arayüz motoru değildir. Mesajlar HTTPS üzerinden gelir; laboratuvarınız yalnızca TCP üzerinden MLLP konuşuyorsa, öndeki bir arayüz motoru bunları iletir.
- Tek bir HL7 v2 mesaj türü. ORU^R01 laboratuvar sonuçları kabul edilir; siparişler (ORM/OML) ve ADT mesajları kabul edilmez.
Sıkça Sorulan Sorular
Bir pano HL7 v2 laboratuvar sonuçlarını doğrudan okuyabilir mi?
Okuyabilir, ancak her pano daha sonra kendi HL7 v2 ayrıştırıcısına, kod eşlemesine ve tekilleştirmesine ihtiyaç duyar. Bir kez FHIR R4 Observations'a LOINC kodlarıyla dönüştürmek, her ekranın aynı temiz veriye sahip olmasını sağlar.
İçe aktarılan sonuçlar panoya ne kadar hızlı ulaşır?
Gözlemler depolandığında içe aktarma isteği geri döner ve aynı anda her biri için bir resource.created webhook kuyruğa alınır. Uç noktanız kullanılamıyorsa teslimat denenir.
Anormal sonuçlar nasıl işaretlenir?
OBX-8, Observation'ın interpretation'u (örneğin H veya L) ve OBX-7 ise referenceRange'i olur, böylece pano hem işareti hem de normal bandı gösterebilir.
Anpheros ICU izlemeyi destekliyor mu?
Hayır. Laboratuvar ve klinik sonuçları depolar ve yeni veriler hakkında sistemlerinizi bilgilendirir; sürekli yatak başı izleme ve klinik alarmlar sertifikalı tıbbi cihazlarla kalır.
İlgili Konular
- Laboratuvar sonuçları API'si: HL7 v2, FHIR ve LOINC
- Bir FHIR kaydına laboratuvar sonuçlarının nasıl aktarılacağı
- Laboratuvar bağlayıcısı: uç nokta referansı
- FHIR ve HL7 v2: pratik farklar
- FHIR ile uzaktan hasta izleme
- Webhook'lar
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card