AnpherosAnpheros PlatformDevelopers

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

HL7 v2 و FHIR للوحات المعلومات السريرية

من رسالة مختبر HL7 v2 ORU^R01 إلى بلاطة في لوحة المعلومات: ملاحظات FHIR مع نطاقات وعلامات، webhooks موقعة، لا تكرارات — ولماذا هذه ليست مراقبة بجانب السرير.

تحتاج لوحة المعلومات السريرية إلى النتائج كبيانات منظمة ومشفرة في اللحظة التي يتم الإبلاغ عنها فيها — الاختبار، القيمة، الوحدة، النطاق المرجعي، والعلامة — وليس ملفات PDF التي يجب قراءتها. لا تزال المختبرات ترسل معظم النتائج كرسائل HL7 v2 ORU^R01، بينما يسهل بناء لوحات المعلومات على ملاحظات FHIR R4. Anpheros يجلس بين الاثنين: يقوم نظام المختبر بنشر رسالة HL7 v2 (أو تقرير CSV أو JSON) عبر HTTPS، وتصبح كل نتيجة ملاحظة FHIR مع رمزها (LOINC عندما يرسلها المختبر)، وقيمتها، ونطاقها المرجعي، ويخبر خطاف الويب الموقع لوحة المعلومات الخاصة بك بوصول نتائج جديدة.

From the laboratory to a dashboard tile
  1. Laboratory systemSends an HL7 v2 ORU^R01 message or a CSV report
  2. Lab connectorPOST /v1/patients/{id}/labs/import over HTTPS
  3. FHIR ObservationsLOINC code, value, unit, reference range, H/L flag
  4. Signed webhookresource.created reaches your server, retried on failure
  5. Your dashboardReads the new results and updates the tile

ما يستقبله لوحة التحكم

يصبح كل مقطع OBX في الرسالة ملاحظة مخبرية واحدة:

حقل HL7 v2 OBX FHIR R4 Observation على لوحة التحكم
OBX-3 test code code (LOINC عندما يرسلها المختبر؛ يتم الاحتفاظ بالرمز المحلي كرمز المختبر) اسم الاختبار؛ LOINC يجعله قابلاً للمقارنة عبر المختبرات
OBX-5 value, OBX-6 unit valueQuantity (وحدة UCUM) الرقم ووحدته
OBX-7 reference range referenceRange النطاق الطبيعي
OBX-8 abnormal flag interpretation (H, L, …) العلامة الحمراء أو الزرقاء
OBX-14 time effectiveDateTime وقت أخذ العينة
What a dashboard can build from imported results (illustrative data)
Bed 4 · latest laboratory resultsreceived 08:42 · HL7 v2 ORU^R01
TestValueReferenceFlag
Potassium5.9 mmol/L3.5–5.1H
Creatinine1.1 mg/dL0.7–1.3—
Haemoglobin10.8 g/dL13.0–17.0L
Glucose104 mg/dL70–99H

استيراد رسالة والتفاعل معها

أرسل الرسالة لمريض قمت بإنشائه (أو مريض لديك صلاحية له):

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

بعد ذلك، اسمح للمنصة باستدعاء الواجهة الخلفية للوحة التحكم الخاصة بك بدلاً من استطلاعها:

await anpheros.webhooks.create('https://dashboard.example.org/anpheros/hook', { events: ['resource.created'] });

يتم توقيع كل تسليم (تحقق منه باستخدام verifyWebhookSignature من SDK) ويتم إعادة محاولة إرساله إذا لم يستجب الخادم الخاص بك. يحمل الحدث نوع المورد ومعرفه والمريض؛ اقرأ الملاحظات الجديدة وقم بتحديث المربع. يتم تخطي التقارير المعاد إرسالها، لذلك فإن المختبر الذي يعيد الإرسال عند انتهاء المهلة لا ينشئ صفوفًا مكررة على الشاشة.

اختيار HL7 v2 أو FHIR لكل رابط

الرابط الاستخدام السبب
المختبر ← طبقة البيانات HL7 v2 ORU^R01 (أو CSV/JSON) ما تصدره أنظمة المختبرات بالفعل؛ لا تغيير من جانبها
طبقة البيانات ← لوحة المعلومات FHIR R4 Observation + webhooks JSON مرمّز ومُدار بالإصدارات يمكن لواجهة المستخدم الأمامية قراءته مباشرة
لوحة المعلومات ← تطبيقات أخرى FHIR R4، بموافقة المريض معيار واحد لكل مستهلك

ما ليس هذا

أسئلة متكررة

هل يمكن للوحة المعلومات قراءة نتائج مختبر HL7 v2 مباشرة؟

يمكن ذلك، ولكن كل لوحة معلومات تحتاج بعد ذلك إلى محلل HL7 v2 الخاص بها، وربط الأكواد، وإزالة التكرار. التحويل مرة واحدة إلى FHIR R4 Observations مع أكواد LOINC يمنح كل شاشة نفس البيانات النظيفة.

ما مدى سرعة وصول النتائج المستوردة إلى لوحة المعلومات؟

يعود طلب الاستيراد عند تخزين Observations، ويتم وضع resource.created webhook في قائمة الانتظار لكل منها في نفس الوقت. تتم إعادة محاولة التسليم إذا كان نقطة النهاية الخاصة بك غير متاحة.

كيف يتم تمييز النتائج غير الطبيعية؟

يصبح OBX-8 هو interpretation الخاص بـ Observation (على سبيل المثال H أو L) و OBX-7 هو referenceRange الخاص به، بحيث يمكن للوحة المعلومات عرض كل من العلامة والنطاق الطبيعي.

هل يدعم Anpheros مراقبة العناية المركزة (ICU)؟

لا. يقوم بتخزين نتائج المختبر والنتائج السريرية ويخطر أنظمتك بالبيانات الجديدة؛ تظل المراقبة المستمرة بجانب السرير والإنذارات السريرية مع الأجهزة الطبية المعتمدة.

ذات الصلة

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Product updates by email

New features, guides and the end of the beta. One email a month at most.

Send me occasional Anpheros Platform updates by email (new features, API changes, guides). I'll confirm by email and can unsubscribe in one click from any email. Privacy