Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
ربط HL7 v2 بـ FHIR
ربط المقطع بالمورد (Segment-to-resource) والحقل OBX بالحقل (field-by-field) من HL7 v2 ORU^R01 إلى FHIR R4، الفخاخ التي تعطل التكاملات، ومحول يمكنك استدعاؤه عبر HTTPS.
يعني تعيين HL7 v2 إلى FHIR تحويل كل مقطع من رسالة v2 مفصولة بأنابيب إلى موارد FHIR R4: PID إلى Patient، و OBR إلى DiagnosticReport (أو ServiceRequest)، وكل OBX إلى Observation، مع نقل الرموز والوحدات والنطاقات والأوقات حقلًا بحقل. تنشر HL7 دليل تنفيذ V2 إلى FHIR الرسمي مع خرائط المفاهيم للمقاطع الشائعة. تقدم هذه الصفحة التعيين العملي لنتائج المختبر (ORU^R01)، والفخاخ التي تكسر عمليات التكامل الحقيقية، ومحول يمكنك استدعاؤه عبر HTTPS: موصل مختبر Anpheros.
- MSHSeparators, message type, message id → MessageHeader or provenance
- PIDPatient identity → Patient (or, in Anpheros, the patient in the URL)
- OBRThe order and report → DiagnosticReport, report id and date
- OBXOne result each → Observation with LOINC, value, range, flag
- FHIR recordCoded, versioned resources your apps can read
تحويل المقطع إلى مورد
| مقطع HL7 v2 | ما يحمله | مورد FHIR R4 | في موصل Anpheros للمختبر |
|---|---|---|---|
| MSH | الفواصل، النظام المرسل، نوع الرسالة، معرف الرسالة | MessageHeader (أو provenance) |
تُقرأ الفواصل من MSH؛ يتم التحقق من النوع لـ ORU^R01؛ يتم الاحتفاظ بمعرف الرسالة للتتبع |
| PID | معرفات المريض، الاسم، تاريخ الميلاد، الجنس | Patient |
غير مستخدم: المريض هو المريض الموجود في عنوان URL للطلب، لذلك لا يمكن للرسالة الكتابة في سجل خاطئ |
| PV1 | الزيارة | Encounter |
غير مستخدم |
| ORC / OBR | الطلب والتقرير: معرف الملء/المكان، التاريخ | ServiceRequest، DiagnosticReport |
OBR-3 (أو OBR-2) هو معرف التقرير، OBR-7 هو التاريخ الافتراضي |
| OBX | نتيجة واحدة | Observation |
ملاحظة مختبر واحدة لكل OBX |
| NTE | ملاحظة نصية حرة | Observation.note |
غير مستخدم |
حقل OBX حقلاً بحقل
| حقل OBX | عنصر FHIR Observation | ملاحظات |
|---|---|---|
| نوع قيمة حقل OBX-2 (NM, SN, ST, CWE) | اختيار من value[x] |
NM و SN تصبح valueQuantity؛ النص يبقى نصًا |
معرف حقل OBX-3 code^text^system |
code.coding |
LN في OBX-3.3 تعني LOINC؛ الأنظمة الأخرى هي الرمز المحلي للمختبر |
| قيمة حقل OBX-5، وحدة حقل OBX-6 | valueQuantity.value، .unit / .code (UCUM) |
يجب تحليل <5 و 6,4 بعناية |
| النطاق المرجعي لحقل OBX-7 | referenceRange.low / .high |
3.5-5.1، <200، >40 |
| علامة الشذوذ لحقل OBX-8 | interpretation |
H, L, HH, LL, A, N |
| حالة الملاحظة لحقل OBX-11 | status |
F → نهائي، C → معدل، P → مبدئي، I → مسجل |
| وقت الملاحظة لحقل OBX-14 | effectiveDateTime |
غالبًا ما تفتقر أوقات v2 إلى المنطقة الزمنية؛ يتطلب FHIR واحدة |
تحويل رسالة بطلب واحد
curl -X POST "https://platform.anpheros.com/v1/patients/$PID/labs/import" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: x-application/hl7-v2+er7" \
-H "Idempotency-Key: $(uuidgen)" \
--data-binary @oru_r01.hl7
تسرد الإجابة عدد الملاحظات (Observations) التي تم إنشاؤها، وعددها التي تم تخطيها لكونها مستوردة بالفعل، والعلامات (markers) التي لم يكن من الممكن تعيينها، والملاحظات الجديدة مع رموزها. تحصل كل منها على معرف ثابت مشتق من التقرير، والاختبار، والوقت، والقيمة، بحيث لا يؤدي مختبر يعيد إرسال نفس الرسالة إلى إنشاء نسخ مكررة.
فخاخ تعيق التكاملات الحقيقية
- المناطق الزمنية. لا يحتوي
20261002074500على إزاحة؛ حدد المنطقة الزمنية للمرسل بوضوح. - الرموز المحلية. احتفظ بالرمز الخاص بالمختبر عندما لا يوجد LOINC؛ لا تتجاهله أبدًا.
- إعادة الإرسال. بدون معرف ثابت لكل نتيجة، تصبح إعادة المحاولة مكررة.
- التصحيحات. OBX-11
Cهو تصحيح؛ قرر ما إذا كان سيحل محل النتيجة القديمة أو يضيف إليها، وقم بتمييز النتيجة القديمة. - القيم غير الرقمية. تتطلب
positive،<5،6,4قواعد صريحة، وليس تخمينًا.
ما لا يقوم به الموصل
يقبل نتائج المختبر من نوع ORU^R01 عبر HTTPS. لا يستقبل رسائل ADT أو رسائل الطلبات، ولا يتحدث MLLP عبر TCP (يمكن لمحرك واجهة أمامي إعادة التوجيه)، ولا ينشئ DiagnosticReport، ولا يطابق المرضى من PID.
أسئلة متكررة
كيف يتم تعيين HL7 v2 إلى FHIR؟
قطعة بقطعة: PID إلى Patient، PV1 إلى Encounter، ORC/OBR إلى ServiceRequest و DiagnosticReport، OBX إلى Observation، NTE إلى notes. دليل تنفيذ HL7 V2 إلى FHIR يحدد خرائط المفاهيم على مستوى الحقول.
هل يوجد محول HL7 v2 إلى FHIR؟
نعم. تقوم محركات الواجهة والمكتبات مفتوحة المصدر بتحويل الرسائل؛ بالنسبة لنتائج المختبر، يقوم موصل مختبر Anpheros بتحويل رسالة ORU^R01 إلى FHIR R4 Observations في طلب HTTPS واحد ويخزنها في سجل المريض.
ما هي أنواع رسائل HL7 v2 التي يقبلها Anpheros؟
ORU^R01 لنتائج المختبر. تحصل الرسالة من نوع آخر على تحذير، ويتم قراءة مقاطع OBX الخاصة بها فقط؛ ADT، والطلبات، والرسائل الأخرى غير مدعومة.
كيف يتم تمثيل علامات HL7 v2 غير الطبيعية في FHIR؟
يصبح OBX-8 Observation.interpretation باستخدام رموز HL7 ObservationInterpretation (H, L, HH, LL, A, N).
مواضيع ذات صلة
- واجهة برمجة تطبيقات نتائج المختبر: HL7 v2، FHIR و LOINC
- FHIR مقابل HL7 v2: فروقات عملية
- كيفية استيراد نتائج المختبر إلى سجل FHIR
- HL7 v2 و FHIR للوحات المعلومات السريرية
- موصل المختبر
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card