# Klinik gösterge panelleri için HL7 v2 ve FHIR

> Bir HL7 v2 ORU^R01 laboratuvar mesajından bir gösterge paneli kutucuğuna: Aralıklar ve bayraklarla FHIR Gözlemleri, imzalı webhook'lar, yinelenenler yok — ve neden bunun yatak başı izleme olmadığı.

Source: https://developers.anpheros.com/tr/guides/clinical-dashboard-hl7-fhir

**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.

<!-- visual:dashboard-pipeline -->

## 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 |

<!-- visual:dashboard-mock -->

## Mesajı İçe Aktarma ve Yanıt Verme

Oluşturduğunuz (veya bir izne sahip olduğunuz) bir hasta için mesajı gönderin:

```ts
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:

```ts
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.

<!-- visual:cta-dashboard -->

## İlgili Konular

- [Laboratuvar sonuçları API'si: HL7 v2, FHIR ve LOINC](https://developers.anpheros.com/tr/guides/lab-results-api)
- [Bir FHIR kaydına laboratuvar sonuçlarının nasıl aktarılacağı](https://developers.anpheros.com/tr/guides/import-lab-results-fhir)
- [Laboratuvar bağlayıcısı](https://developers.anpheros.com/tr/guides/lab-connector): uç nokta referansı
- [FHIR ve HL7 v2: pratik farklar](https://developers.anpheros.com/tr/guides/fhir-vs-hl7-v2)
- [FHIR ile uzaktan hasta izleme](https://developers.anpheros.com/guides/remote-patient-monitoring-fhir)
- [Webhook'lar](https://developers.anpheros.com/tr/guides/webhooks)