شرح خوادم المصطلحات في FHIR: $lookup، $validate-code، $expand، $translate و $subsumes، مع أمثلة للطلبات

إجابة مختصرة: خادم المصطلحات هو خادم FHIR متخصص في الأكواد. يقوم بتخزين أنظمة الأكواد (SNOMED CT، LOINC، ICD-10، UCUM، جداول HL7 الخاصة) ومجموعات القيم (مجموعات فرعية مسماة لغرض معين: أكواد العلامات الحيوية، مواد الحساسية) وخرائط المفاهيم (ترجمات بين الأنظمة)، ويستجيب من خلال عمليات قياسية: $lookup (ماذا يعني هذا الكود؟)، $validate-code (هل هذا الكود مسموح به هنا؟)، $expand (قائمة الأكواد في مجموعة القيم هذه، مع إمكانية التصفية حسب النص)، $translate (ما هو هذا الكود في النظام الآخر؟) و**$subsumes** (هل A نوع من B؟). تقوم التطبيقات باستدعائه بدلاً من شحن نسخ من المصطلحات، والتي تكون كبيرة، مرخصة، ويتم تحديثها عدة مرات في السنة.

الموارد

يعمل خادم المصطلحات الخاص بـ FHIR مع ثلاثة موارد. يُعلن CodeSystem عن نظام ترميز بواسطة عنوان URL معياري وإصدار، مع مفاهيمه أو ملاحظة بأن المحتوى موجود في مكان آخر؛ يُعرّف ValueSet مجموعة فرعية هادفة من الرموز من خلال قواعد التركيب وتوسيع محسوب اختياري؛ يسجل ConceptMap العلاقات من المصدر إلى الهدف بين الأنظمة مع ما يعادل كل تعيين.

• CodeSystem يعلن عن نظام بواسطة عنوان URL الخاص به (http://snomed.info/sct, http://loinc.org, http://hl7.org/fhir/sid/icd-10)، وإصداره، إما مفاهيمه أو بيان بأن المحتوى موجود في مكان آخر (content: not-present للأنظمة المرخصة).
• ValueSet لديه compose (قواعد: تضمين جميع الأكواد من نظام، أكواد محددة، أو مرشح مثل أحفاد 404684003 اكتشاف سريري)، وعند حسابه، expansion (القائمة الفعلية). تشير الارتباطات في الملفات الشخصية إلى مجموعات القيم؛ انظر ملفات FHIR الشخصية والملحقات.
• ConceptMap يحتفظ بعلاقات المصدر ← الهدف مع تكافؤ (equivalent, wider, narrower, inexact, unmatched) واعتماديات اختيارية، لخرائط مثل SNOMED CT إلى ICD-10 أو أكواد المختبر المحلية إلى LOINC.

العمليات، مع الطلبات

يستجيب خادم المصطلحات الخاص بـ FHIR لخمس عمليات قياسية: $lookup تُرجع معنى رمز واحد، و$validate-code تتحقق مما إذا كان الرمز ينتمي إلى نظام أو مجموعة قيم، و$expand تسرد الرموز في مجموعة قيم، مع إمكانية تصفيتها حسب النص، و$translate تحول رمزًا إلى نظام آخر من خلال ConceptMap، و$subsumes تختبر ما إذا كان مفهوم ما هو نوع من مفاهيم أخرى.

$lookup: تفاصيل كود واحد.

GET /CodeSystem/$lookup?system=http://loinc.org&code=4548-4

يعيد مورد Parameters مع display ("Hemoglobin A1c/Hemoglobin.total in Blood")، وتعيينات بلغات أخرى، وخصائص (لـ LOINC المحاور الستة؛ لـ SNOMED CT الآباء والعلاقات التعريفية).

$validate-code: هل الكود موجود في النظام، أو في مجموعة القيم؟

GET /ValueSet/$validate-code?url=http://hl7.org/fhir/ValueSet/observation-vitalsignresult&system=http://loinc.org&code=8480-6

يعيد result: true مع العرض، أو false مع رسالة. الخوادم التي تتحقق من صحة الموارد تستدعي هذا لكل عنصر مرتبط.

$expand: الأكواد في مجموعة قيم، مع تصفية نصية لصناديق البحث.

GET /ValueSet/$expand?url=http://hl7.org/fhir/ValueSet/condition-code&filter=diabetes&count=20

يعيد ValueSet مع قائمة expansion.contains: الكود، النظام، العرض. هذه هي الطريقة التي يعمل بها بحث التشخيص في EHR ضد SNOMED CT دون الاحتفاظ بـ 360,000 مفهوم محليًا.

$translate: عبور حدود النظام.

GET /ConceptMap/$translate?url=https://lab.example.org/ConceptMap/local-to-loinc&system=https://lab.example.org/codes&code=GLU&targetsystem=http://loinc.org

يعيد التطابقات مع تكافؤها. نفس العملية تخدم خرائط SNOMED CT → ICD-10 حيث يستضيفها الخادم.

$subsumes: أسئلة التسلسل الهرمي.

GET /CodeSystem/$subsumes?system=http://snomed.info/sct&codeA=73211009&codeB=44054006

يجيب على subsumes (داء السكري هو سلف لداء السكري من النوع 2)، subsumed-by، equivalent أو not-subsumed. يستخدم دعم القرار لطرح سؤال هل هذا الشرط أي نوع من أنواع داء السكري؟ دون سرد كل نوع فرعي.

الاستجابات هي موارد Parameters: قائمة بأجزاء مسماة، وليست كائنًا عاديًا، مما يفاجئ المتصلين لأول مرة.

الخوادم التي ستلتقي بها

خوادم المصطلحات التي تُقابل في الممارسة العملية غالبًا هي tx.fhir.org، الخادم المرجعي العام لـ HL7 الذي يستخدمه مدققها؛ Ontoserver من CSIRO، خادم تجاري يدعم العديد من البرامج الوطنية؛ Snowstorm من SNOMED International، مفتوح المصدر ومخصص لـ SNOMED CT؛ خوادم FHIR العامة مثل HAPI FHIR وFirely Server مع عمليات المصطلحات؛ والخوادم الوطنية التي تديرها وكالات الصحة.

المحتوى هو الجزء الصعب: SNOMED CT يتطلب ترخيصًا خارج الدول الأعضاء، LOINC يتطلب قبول شروطه، تختلف إصدارات ICD-10 الوطنية ولها توزيعها الخاص. يمنحك الخادم العمليات؛ لا يزال يتعين عليك الحصول على المحتوى وتحميله بشكل قانوني.

كيف تستخدمه التطبيقات

تستخدم التطبيقات خادم المصطلحات للتحقق من صحة الرموز والوحدات عند الكتابة، ولتشغيل مربعات البحث من خلال $expand مع مرشح نصي ومجموعة قيم، ولعرض الأسماء الرسمية من خلال $lookup، ولتعيين الرموز المحلية إلى LOINC أو SNOMED CT إلى ICD-10 من خلال $translate، وللتفكير في التسلسلات الهرمية من خلال $subsumes ولغة قيود التعبير الخاصة بـ SNOMED CT.

• التحقق عند الكتابة: رفض ملاحظة (Observation) لا يوجد بها كود LOINC أو وحدة UCUM غير صالحة، مع رسالة تحدد المشكلة.
• صناديق البحث: $expand مع filter لاختيار التشخيص والإجراء والدواء، مقيدة بمجموعة قيم حتى يرى الأطباء المفاهيم ذات الصلة فقط.
• العرض: $lookup لعرض الاسم الرسمي والترجمات بدلاً من تخزين سلاسل العرض التي تصبح قديمة.
• الربط: $translate لتحويل أكواد المختبر المحلية إلى LOINC عند الاستيراد (كيفية ربط أكواد المختبر المحلية بـ LOINC) أو SNOMED CT إلى ICD-10 للتقارير (SNOMED CT مقابل ICD-10).
• الاستدلال: $subsumes و لغة قيود التعبير (ECL) الخاصة بـ SNOMED (مدعومة بواسطة Ontoserver و Snowstorm من خلال مرشحات $expand) لتحديد المجموعات والقواعد حسب التسلسل الهرمي.

قم بالتخزين المؤقت بشكل مكثف (تتغير المصطلحات مرتين في السنة، وليس مرتين في اليوم)، وثبت الإصدارات في بيئة الإنتاج، وعامل تعطل الخادم على أنه تحقق متدهور بدلاً من سبب لرفض كل عملية كتابة.

في Anpheros

تقوم منصة Anpheros بالتحقق من صحة أكواد LOINC ووحدات UCUM التي تقبلها للملاحظات وأكواد ATC للأدوية مقابل المصطلحات التي توفرها (مجموعة فرعية من LOINC وفهرس WHO ATC)، وتوثق واجهة برمجة تطبيقات المصطلحات على موقع المطورين. لتصفح SNOMED CT أو ICD-10 بالكامل، فإنها تشير إلى المتصفحات الرسمية بدلاً من إعادة توزيع المحتوى المرخص.

الصفحات ذات الصلة

• شرح ملفات FHIR الشخصية والملحقات
• كيفية ربط أكواد المختبر المحلية بـ LOINC
• SNOMED CT مقابل ICD-10
• CodeableConcept و Coding في FHIR
• وحدات UCUM في نتائج المختبر
• واجهة برمجة تطبيقات المصطلحات الطبية (موقع المطورين)

المصادر

• HL7 FHIR R4: خادم المصطلحات
• HL7 FHIR R4: ValueSet $expand
• HL7 FHIR R4: ConceptMap $translate
• HL7 FHIR R4: CodeSystem $lookup
• خادم مصطلحات HL7 tx.fhir.org
• Snowstorm (SNOMED International, GitHub)
• Ontoserver (CSIRO)

الأسئلة الشائعة

هل أحتاج إلى خادم مصطلحات لاستخدام FHIR؟

ليس لنظام صغير بقائمة أكواد ثابتة. بمجرد التحقق من صحة الأكواد من أنظمة كبيرة، أو تقديم بحث سريري، أو الترجمة بين الأنظمة، فإن خادم المصطلحات يوفر عليك شحن وتحديث المصطلحات بنفسك.

هل يمكنني استخدام tx.fhir.org في بيئة الإنتاج؟

لا. إنه خادم HL7 المرجعي لأدوات التحقق والاختبار، مع عدم وجود ضمانات للخدمة وقيود ترخيص على بعض المحتوى. قم بتشغيل الخادم الخاص بك أو استخدم خادمًا وطنيًا أو تجاريًا.

ما هو ECL؟

لغة قيود التعبير الخاصة بـ SNOMED CT، وهي صيغة استعلام لمجموعات المفاهيم (على سبيل المثال << 73211009 لداء السكري وجميع أنواعه الفرعية). الخوادم التي تدعمها تقبل ECL في مرشحات ValueSet و $expand.

كيف أعرف أي إصدار من SNOMED CT لدى الخادم؟

اسأل CodeSystem (GET /CodeSystem?url=http://snomed.info/sct) واقرأ إصداره، الذي يشفر الإصدار وتاريخ الإصدار (على سبيل المثال http://snomed.info/sct/900000000000207008/version/20260301). قم بتثبيته في طلباتك عندما تكون النتائج قابلة للتكرار.

Anpheros Platform

جرّبه مجانًا في بيئة الاختبار

أول طلب FHIR خلال 5 دقائق. واجهة برمجة تطبيقات HL7 FHIR R4 مع موافقة المريض مدمجة: جربها في بيئة الاختبار، ثم اربط تطبيقك الخاص أو نظام عيادتك.

أنشئ بيئة اختبار مجانيةاقرأ أدلة المطورين →

مجاني · 30 مريضًا اصطناعيًا · دون بطاقة

بقلم

فريق Anpheros

تبني Anpheros سجلًا طبيًا يتحكم فيه المريض ويمكن مشاركته مع أي عيادة، على منصة HL7 FHIR R4، مقرها في الاتحاد الأوروبي. تساعدك هذه الأدلة على فهم وتنظيم صحتك؛ ولا تغني عن استشارة طبيبك.

عن Anpheros →