تمرين - إنشاء خرائط بيانات لواجهات برمجة تطبيقات Dataverse Healthcare

  • 10 دقائق

في التدريبات السابقة، قمت بإنشاء جداول وأعمدة وعلاقات Dataverse التي تمثل إصدارا علائقيا من مورد ServiceRequest Fast Healthcare Interoperability Resource (FHIR). يتضمن التمرين جداول التوسعة وعمليات البحث عبر الجداول متعددة.

الخطوة التالية هي إنشاء خرائط بيانات للجداول الجديدة بحيث يتم توفيرها لواجهات برمجة تطبيقات Dataverse Healthcare، وهي أداة لاستيعاب البيانات في نموذج بيانات الرعاية الصحية ل Dataverse. واجهات برمجة تطبيقات Dataverse Healthcare هي واجهة برمجة تطبيقات مخصصة يمكن الوصول إليها من مثيلك تقبل حزم FHIR لاستيعاب البيانات في Dataverse.

في هذا التمرين، يمكنك إنشاء خرائط بيانات جديدة، وتوفير قواعد لاستيعاب حزم FHIR في الجداول الجديدة.

المتطلبات المسبقه

تحتاج إلى تلبية المتطلبات الأساسية التالية:

  • تم تثبيت الإصدار التجريبي من Microsoft for Healthcare مع مجموعة أدوات تكامل البيانات.

  • يتم نشر نموذج البيانات في المثيل الخاص بك.

  • الوصول إلى أدوات المطور التي تسمح لك باستدعاء نقاط نهاية REST API.

  • يتم منح حقوق مسؤول النظام للمستخدم على مثيل Microsoft Dataverse. لمزيد من المعلومات، راجع إعداد بيئة تدريب Microsoft للرعاية الصحية.

خرائط الكيان والسمات

يتم تضمين قواعد تحويل موارد FHIR إلى Dataverse في مجموعة أدوات تكامل البيانات كسجلات قابلة للتحرير. تقوم هذه السجلات بتعيين موارد FHIR إلى جداول Dataverse كسجلات خريطة الكيان. لكل مخطط كيان، هناك سلسلة من سجلات خريطة السمات ذات الصلة التي تلتقط قيم عنصر مورد FHIR الفردية.

توفر مجموعة أدوات تكامل البيانات عددا كبيرا من خرائط الكيان والسمات الموجودة، ولكن نظرا لأن جداول طلب الخدمة جديدة، فأنت بحاجة إلى إنشاء خرائط إضافية. لمزيد من المعلومات حول Entity and Attribute maps، راجع إدارة بيانات FHIR باستخدام مجموعة أدوات تكامل البيانات. للحصول على تفاصيل وأمثلة حول عملية إنشاء خرائط الكيان والسمات، راجع تكوين خرائط الكيان وتكوين خرائط السمات.

إنشاء خرائط الكيانات

يمكنك إنشاء خرائط كيان جديدة لطلب الخدمة وجداول التوسع ذات الصلة كما يلي:

  1. سجل الدخول إلى مثيل Dataverse وافتح تطبيق مجموعة أدوات تكامل البيانات .

  2. في جزء التنقل الأيمن، حدد Map Setup > Entity Maps.

  3. حدد جديد من شريط الأدوات.

  4. في صفحة New Update Service Entity Map ، أدخل التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    تمكين إعادة الكتابة إلى FHIR لا
    EntityName طلب الخدمة (fhir_servicerequest)
    مورد Azure FHIR طلب الخدمة
    توسيع لا

  5. حدد حفظ وإغلاق.

  6. حدد جديد من شريط الأدوات.

  7. في صفحة New Update Service Entity Map ، املأ التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    تمكين إعادة الكتابة إلى FHIR لا
    EntityName استبدال طلب الخدمة (fhir_servicerequestreplaces)
    مورد Azure FHIR طلب الخدمة
    توسيع نعم
    سمة الرابط الرئيسي طلب الخدمة (fhir_servicerequestid)

  8. حدد حفظ وإغلاق.

  9. وبالمثل، أضف خرائط الكيان التالية عن طريق تكرار الخطوات من 6 إلى 8.

    فئة طلب الخدمة

    الخاصية Value
    تعطيل لا
    تمكين إعادة الكتابة إلى FHIR لا
    EntityName فئة طلب الخدمة (fhir_servicerequestcategory)
    مورد Azure FHIR طلب الخدمة
    توسيع نعم
    سمة الرابط الرئيسي طلب الخدمة (fhir_servicerequestid)

    رمز موقع طلب الخدمة

    الخاصية Value
    تعطيل لا
    تمكين إعادة الكتابة إلى FHIR لا
    EntityName رمز موقع طلب الخدمة (fhir_servicerequestlocationcode)
    مورد Azure FHIR طلب الخدمة
    توسيع نعم
    سمة ارتباط رئيسية طلب الخدمة (fhir_servicerequestid)

    مرجع موقع طلب الخدمة

    الخاصية Value
    تعطيل لا
    تمكين إعادة الكتابة إلى FHIR لا
    EntityName مرجع موقع طلب الخدمة (fhir_servicerequestlocationreference)
    مورد Azure FHIR طلب الخدمة
    توسيع نعم
    سمة الارتباط الأصل طلب الخدمة (fhir_servicerequestid)

    رمز سبب طلب الخدمة

    الخاصية Value
    تعطيل لا
    تمكين إعادة الكتابة إلى FHIR لا
    EntityName رمز سبب طلب الخدمة (fhir_servicerequestreasoncode)
    مورد Azure FHIR طلب الخدمة
    توسيع نعم
    سمة الارتباط الأصل طلب الخدمة (fhir_servicerequestid)

    معرف

    الخاصية Value
    تعطيل لا
    تمكين إعادة الكتابة إلى FHIR لا
    EntityName المعرف (msemr_identifier)
    مورد Azure FHIR طلب الخدمة
    توسيع نعم
    سمة الرابط الرئيسي المورد الأصل (msemr_parentresourceid)

  10. تحقق من إنشاء مخطط كيان جديد لجدول طلب الخدمة وجداول التوسيع ذات الصلة.

    تظهر لقطة الشاشة خريطة الكيان التي تم إنشاؤها حديثا.

لقد قمت بإنشاء كافة خرائط الكيان التي محاذاة مورد FHIR والعناصر التابعة له مع جداول Dataverse. بعد ذلك، يمكنك البدء في إضافة خرائط السمات ذات الصلة.

إنشاء خرائط السمات

في هذا القسم، يمكنك إنشاء خرائط السمات الفردية لخرائط الكيان الجديدة. وهذا يعني إنشاء خريطة لكل عمود جدول Dataverse أو خريطة توسيع ذات صلة.

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

ومع ذلك، فإن الجزء الهام من كل مخطط سمة هو عمود خريطة عنصر FHIR . يمكنك توفير مقتطف JSON يحتوي على تفاصيل حول كيفية تحديد القيمة من FHIR JSON أثناء تحويلها. يستخدم مقتطف JSON هذا JPath لاسترداد القيم بشكل انتقائي من عناصر FHIR JSON.

يمكن العثور على مزيد من التفاصيل والأمثلة حول بناء الجملة هذا وإعدادات بيانات تعريف السمة الأخرى في المقالة تكوين خرائط السمات: يمكن العثور على مخطط عنصر FHIRوالأمثلة في أمثلة خريطة السمة.

طلب الخدمة

خرائط السمات القياسية

  1. في جزء التنقل الأيمن، حدد Map Setup > Entity Maps.

  2. افتح خريطة الكيان fhir_servicerequest.

  3. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

    تظهر لقطة الشاشة تحديد New Update Service Attribute Map من شريط أدوات subgrid.

  4. في صفحة New Update Service Attribute Map ، املأ التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة معرف Azure FHIR
    نوع الإجراء نسخ البيانات
    مخطط عنصر FHIR { "s":"$.id" }
    نوع عنصر FHIR string

    تظهر لقطة الشاشة خصائص وقيم معرف Attribute Azure FHIR (msemr_azurefhirid) الذي تم إدخاله في صفحة New Update Service Attribute Map.

  5. حدد حفظ وإغلاق.

    وبالمثل، أضف خرائط سمة الخدمة التالية.

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة مصادفة (fhir_encounter)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.encounter.reference","c":{"p":"encounter","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string

    تظهر لقطة الشاشة خصائص وقيم Attribute Encounter (fhir_encounter) التي تم إدخالها في صفحة New Update Service Attribute Map.

  6. كرر هذه الخطوات لأعمدة طلب الخدمة التالية. لكل مخطط سمة في القائمة، افترض:

    الخاصية Value
    تعطيل لا
    نوع الإجراء نسخ البيانات
    نوع عنصر FHIR string
    سمة FHIR المطلوبة اسم السمة مخطط عنصر FHIR
    نعم تاريخ آخر تحديث ل Azure FHIR {"s":"$.meta.lastUpdated"}
    نعم إصدار Azure FHIR {"s":"$.meta.versionId"}
    لا عدم التنفيذ {"s":"$.doNotPerform"}
    لا تم تأليفه في {"s":"$.authoredOn"}
    لا تعليمات المرضى {"s":"$.تعليمات_المريض"}
    لا حسب الحاجة المنطقية {"s":"$. asNeededBoolean"}
    لا نوع الجهة المنفذة
    لا رمز الكمية {"s":"$.quantityQuantity.code","c":{"p":"quantityQuantity","a":[{"value":"x"},{"المقارن":"x"},{"unit":"x"},{"system":"x"},{"code":"%"}]}}
    لا قيمة الكمية {"s":"$.quantityQuantity.value","c":{"p":"quantityQuantity","a":[{"value":"%"},{"المقارن":"x"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    لا مقارنة الكمية {"s":"$.quantityQuantity.comparator","c":{"p":"quantityQuantity","a":[{"value":"x"},{"المقارنة":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    لا وحدة الكمية {"s":"$.quantityQuantity.unit","c":{"p":"quantityQuantity","a":[{"value":"x"},{"comparator":"x"},{"unit":"%"},{"system":"x"},{"code":"x"}]}}
    لا معرّف الكمية {"s":"$.quantityQuantity.system","c":{"p":"quantityQuantity","a":[{"value":"x"},{"comparator":"x"},{"unit":"x"},{"system":"%"},{"code":"x"}]}}
    لا رمز Numerator لنسبة الكمية {"s":"$.quantityRatio.numerator.code","c":{"p":"quantityRatio.numerator","a":[{"value":"x"},{"المقارنة":"x"},{"unit":"x"},{"system":"x"},{"code":"%"}]}}
    لا قيمة Numerator لنسبة الكمية {"s":"$.quantityRatio.numerator.value","c":{"p":"quantityRatio.numerator","a":[{"value":"%"},{"المقارن":"x"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    لا مقارنة الأرقام لنسبة الكمية {"s":"$.quantityRatio.numerator.comparator","c":{"p":"quantityRatio.numerator","a":[{"value":"x"},{"comparator":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    لا وحدة العداد لنسبة الكمية {"s":"$.quantityRatio.numerator.unit","c":{"p":"quantityRatio.numerator","a":[{"value":"x"},{"comparator":"x"},{"unit":"%"},{"system":"x"},{"code":"x"}]}}
    لا Uri لنسبة الكمية {"s":"$.quantityRatio.numerator.system","c":{"p":"quantityRatio.numerator","a":[{"value":"x"},{"comparator":"x"},{"unit":"x"},{"system":"%"},{"code":"x"}]}}
    لا رمز مقام نسبة الكمية {"s":"$.quantityRatio.denominator.code","c":{"p":"quantityRatio.denominator","a":[{"value":"x"},{"المقارنة":"x"},{"unit":"x"},{"system":"x"},{"code":"%"}]}}
    لا قيمة مقام نسبة الكمية {"s":"$.quantityRatio.denominator.value","c":{"p":"quantityRatio.denominator","a":[{"value":"%"},{"المقارن":"x"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    لا مقارنة مقام نسبة الكمية {"s":"$.quantityRatio.denominator.comparator","c":{"p":"quantityRatio.denominator","a":[{"value":"x"},{"المقارنة":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    لا وحدة مقام نسبة الكمية {"s":"$.quantityRatio.denominator.unit","c":{"p":"quantityRatio.denominator","a":[{"value":"x"},{"comparator":"x"},{"unit":"%"},{"system":"x"},{"code":"x"}]}}
    لا مقام النسبة الكمية (Uri) {"s":"$.quantityRatio.denominator.system","c":{"p":"quantityRatio.denominator","a":[{"value":"x"},{"comparator":"x"},{"unit":"x"},{"system":"%"},{"code":"x"}]}}
    لا نطاق الكمية منخفض القيمة {"s":"$.quantityRange.low.value","c":{"p":"quantityRange.low","a":[{"value":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    لا وحدة قياس الحد الأدنى للكمية {"s":"$.quantityRange.low.unit","c":{"p":"quantityRange.low","a":[{"value":"x"},{"unit":"%"},{"system":"x"},{"code":"x"}]}}

مخططات السمات لأعمدة البحث التي تشير إلى Codeable

سمة FHIR المطلوبة اسم السمة مخطط عنصر FHIR
لا نطاق الكمية منخفض Uri {"s":"$.quantityRange.low.system","c":{"p":"quantityRange.low","a":[{"value":"x"},{"unit":"x"},{"system":"%"},{"code":"x"}]}}
لا التعليمات البرمجية المنخفضة لنطاق الكمية {"s":"$.quantityRange.low.code","c":{"p":"quantityRange.low","a":[{"value":"x"},{"unit":"x"},{"system":"x"},{"code":"%"}]}}
لا قيمة عالية لنطاق الكمية {"s":"$.quantityRange.high.value","c":{"p":"quantityRange.high","a":[{"value":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
لا وحدة عالية لنطاق الكمية {"s":"$.quantityRange.high.unit","c":{"p":"quantityRange.high","a":[{"value":"x"},{"unit":"%"},{"system":"x"},{"code":"x"}]}}
لا Uri عالي لنطاق الكمية {"s":"$.quantityRange.high.system","c":{"p":"quantityRange.high","a":[{"value":"x"},{"unit":"x"},{"system":"%"},{"code":"x"}]}}
لا رمز الحد الأعلى لنطاق الكمية {"s":"$.quantityRange.high.code","c":{"p":"quantityRange.high","a":[{"value":"x"},{"unit":"x"},{"system":"x"},{"code":"%"}]}}
خرائط سمات المفهوم القابلة للتعليمات البرمجية

تتطلب المفاهيم خطوة إضافية إلى خرائط البحث القياسية. تحتاج إلى تحديد قيمة نوع المفهوم القابل للتعليمات البرمجية ذات الصلة. هذه القيمة مشتقة من الاختيار العمومي المسمى أنواع المفاهيم القابلة للتعليمات البرمجية.

  1. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  2. في صفحة New Update Service Attribute Map ، املأ التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة حسب الضرورة مفهوم قابل للترميز (fhir_asneededcodeableconcept)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s": "$.asNeededCodeableConcept.coding[0].code", "c": {"p": "asNeededCodeableConcept.coding[0]", "a": [{"system": "http://snomed.info/sct"}, {"code": "%"}]} }
    نوع عنصر FHIR string
    نوع المفهوم القابل للتعليمات البرمجية طلب الخدمة حسب الحاجة

  3. حدد حفظ وإغلاق.

  4. وبالمثل، أضف مخطط السمة لخريطة السمة التالية:

    نوع الجهة المنفذة

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة الرمز (fhir_code)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s": "$.code.coding[0].code", "c": {"p": "code.coding[0]", "a": [{"system": "http://snomed.info/sct"}, {"code": "%"}]} }
    نوع عنصر FHIR string
    نوع المفهوم القابل للتعليمات البرمجية رمز الإجراء
اختيار خرائط السمات

تتطلب أعمدة طلب الخدمة مع نوع البيانات كخيار خطوات إضافية لإعداد خرائط قيمة السمة. خرائط قيمة السمة هي سجلات مرتبطة بخريطة سمة تعين كل قيمة واردة إلى قيمة اختيار مقابلة. على سبيل المثال، يتضمن نوع بيانات المقارنة في FHIR القيم المحتملة ل <،<=،>=، و >، وكلها ممثلة بقيمة اختيار.

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

  1. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  2. في صفحة New Update Service Attribute Map ، أدخل التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة مصادفة (fhir_encounter)
    نوع الإجراء نسخ البيانات
    مخطط عنصر FHIR {"s":"$.quantityQuantity.comparator","c":{"p":"quantityQuantity","a":[{"value":"x"},{"المقارنة":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    نوع عنصر FHIR string

  3. حدد حفظ.

  4. بمجرد الحفظ، تتوفر مجموعة جديدة من سجلات مخطط قيمة السمة في قسم خرائط القيمة.

    تظهر لقطة الشاشة مجموعة جديدة من سجلات مخطط قيمة السمة في قسم خرائط القيمة.

  5. في قسم "Value Maps "، أدخل القيم التالية لكل عمود Attribute Value map Attribute FHIR Value . يتم تضمين هذه القيم في مورد FHIR JSON.

    ملاحظة

    يعتمد عمود القيمة على البادئة التي تحددها عند إعداد Publisher، وتعتمد التسميات على الطريقة التي تقرر بها تمثيل تسمية الاختيار.

    تسمية مجموعة الخيارات قيمة FHIR للسمة
    < <
    <= <=
    >= >=
    > >

  6. كرر هذه الخطوات لخرائط سمة الاختيار المتبقية.

    سمة FHIR المطلوبة اسم السمة مخطط عنصر FHIR
    لا مقارنة الأرقام لنسبة الكمية {"s":"$.quantityRatio.numerator.comparator","c":{"p":"quantityRatio.numerator","a":[{"value":"x"},{"comparator":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    تسمية مجموعة خيارات قيمة FHIR للسمة
    < <
    <= <=
    >= >=
    > >
    سمة FHIR المطلوبة اسم السمة مخطط عنصر FHIR
    لا مقارنة مقام نسبة الكمية {"s":"$.quantityRatio.denominator.comparator","c":{"p":"quantityRatio.denominator","a":[{"value":"x"},{"المقارنة":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    تسمية مجموعة الخيارات قيمة FHIR للسمة
    < <
    <= <=
    >= >=
    > >
    سمة FHIR المطلوبة اسم السمة مخطط عنصر FHIR
    لا مقارنة مقام نسبة الكمية {"s":"$.quantityRatio.denominator.comparator","c":{"p":"quantityRatio.denominator","a":[{"value":"x"},{"المقارنة":"%"},{"unit":"x"},{"system":"x"},{"code":"x"}]}}
    تسمية OptionSet قيمة FHIR للسمة
    < <
    <= <=
    >= >=
    > >
    سمة FHIR المطلوبة اسم السمة مخطط عنصر FHIR
    نعم ‏الحالة {"s":"$.status"}
    تسمية مجموعة الخيارات قيمة FHIR للسمة
    مبدئي‬ draft
    نشط active
    قيد الانتظار قيد الاحتجاز
    مُبطل مُبطل
    اكتمل اكتمل
    تم إدخاله عن طريق الخطأ تم الإدخال عن طريق الخطأ
    ‏‏غير معروف ‏‏غير معروف
    سمة FHIR المطلوبة اسم السمة مخطط عنصر FHIR
    نعم عمد {"s":"$.intent"}
    تسمية مجموعة الخيارات قيمة FHIR للسمة
    اقتراح اقتراح
    Plan plan
    التوجيه التوجيه
    طلب order
    الطلب الأصلي الطلب الأصلي
    ترتيب رد الفعل ترتيب عكسي
    ترتيب التعبئة ترتيب التعبئة
    ترتيب المثيل ترتيب المثيل
    Option خيار
    سمة FHIR المطلوبة اسم السمة مخطط عنصر FHIR
    لا الأولوية {"s":"$.الأولوية"}
    تسمية لـ OptionSet قيمة FHIR للسمة
    الروتين الروتين
    مستعجل مستعجل
    اسرع مايمكن اسرع مايمكن
    Stat إحصائية
خرائط السمات متعددة الجداول

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

عند إنشاء مخطط السمة الجديد حدد عمود البحث عن اسم السمة، تحتاج إلى الخطوة الإضافية لتحديث قسم تفاصيل التكوين لتحديد مرجع الكيان الصحيح ومرجع مورد FHIR.

  1. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  2. في صفحة New Update Service Attribute Map ، أدخل التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة الموضوع [fhir_subject]
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان جهة اتصال
    مرجع مورد FHIR مريض

  3. حدد حفظ.

    تظهر لقطة الشاشة تفاصيل تكوين الخريطة لموضوع السمة (fhir_subject).

  4. كرر هذه الخطوات لإضافة أعمدة البحث متعددة الجداول التالية.

    الموضوعوالجهاز

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة الموضوع (fhir_subject)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان msemr_device
    مرجع مورد FHIR جهاز

    الموضوعوالمجموعة

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة الموضوع (fhir_subject)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان msemr_group
    مرجع مورد FHIR Group (المجموعة)

    الموضوعوالموقع

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة الموضوع (fhir_subject)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان msemr_location
    مرجع مورد FHIR Location

    الطالبوالجهاز

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة المطلِب (fhir_requester)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان msemr_device
    مرجع مورد FHIR جهاز

    الطالبوالحساب

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة المُقدم على الطلب (fhir_requester)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان الحساب
    مرجع مورد FHIR Organization

    الطالب والمريض

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة طالب الخدمة (fhir_requester)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان جهة اتصال
    مرجع مورد FHIR مريض

    المقدم والممارس

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة الجهة الطالبة (fhir_requester)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان جهة اتصال
    مرجع المصدر في نظام FHIR ممارس

    المطالب ودور الممارس

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة جهة الطلب (fhir_requester)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان msemr_practitionerrole
    مرجع مورد FHIR دور الممارس

    الطالب والشخص ذو الصلة

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة جهة الطلب (fhir_requester)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.subject.reference","c":{"p":"subject","a":[{"reference":"%%%"},{"type":"%%"}]}}
    نوع عنصر FHIR string
    تفاصيل التكوين
    مرجع الكيان msemr_relatedperson (شخص ذو صلة)
    مرجع مورد FHIR الأشخاص المرتبطون
خرائط سمة التوسيع

تربط خرائط السمات لجداول التوسيع عنصرًا من عناصر صفيف موارد FHIR بجداول التوسيع المقابلة لها في Dataverse. تتطلب خرائط السمة تكوينا مختلفا قليلا وقيمة مخطط عنصر FHIR. بدلا من مقتطف JSON، يجب أن يحتوي مخطط عنصر FHIR على اسم عنصر FHIR. على سبيل المثال، تمثل فئة طلب خدمة جدول التوسيع عنصر FHIR الذي يحل محل:

| يستبدل | Σ | 0..* | Reference(ServiceRequest) | ما هو الطلب الذي يحل محل |

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

  1. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  2. في صفحة New Update Service Attribute Map ، أدخل التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة غير قابل للتطبيق
    نوع الإجراء توسيع
    خريطة كيان التوسيع <fhir_servicerequestcategory -> طلب الخدمة
    مخطط عنصر FHIR باب
    نوع عنصر FHIR string
    تفاصيل التكوين ملاحظة: يجب ملء هذه القيم تلقائيا وقراءتها فقط
    اسم الكيان فئة طلب_خدمة_fhir
    مورد Azure FHIR طلب الخدمة

  3. حدد حفظ.

    تظهر لقطة الشاشة تفاصيل تكوين الخريطة للسمة غير قابلة للتطبيق.

  4. كرر هذه الخطوات لخرائط التوسيع التالية.

    رمز موقع طلب الخدمة

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة غير قابل للتطبيق
    نوع الإجراء توسيع
    خريطة كيان التوسيع <fhir_servicerequestlocationcode -> طلب الخدمة
    مخطط عنصر FHIR رمز الموقع
    نوع عنصر FHIR string
    تفاصيل التكوين ملاحظة: يجب ملء هذه القيم تلقائيا وقراءتها فقط
    اسم الكيان fhir_servicerequestlocationcode
    مورد Azure FHIR طلب الخدمة

    مرجع موقع طلب الخدمة

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة غير قابل للتطبيق
    نوع الإجراء توسيع
    خريطة كيان التوسيع < fhir_servicerequestlocationreference - > طلب الخدمة
    مخطط عنصر FHIR مرجع الموقع
    نوع عنصر FHIR string
    تفاصيل التكوين ملاحظة: يجب ملء هذه القيم تلقائيا وقراءتها فقط
    اسم الكيان fhir_مرجع_موقع_طلب_الخدمة
    مورد Azure FHIR طلب الخدمة

    رمز سبب طلب الخدمة

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة غير قابل للتطبيق
    نوع الإجراء توسيع
    خريطة كيان التوسيع <fhir_servicerequestreasoncode -> طلب الخدمة
    مخطط عنصر FHIR رمز السبب
    نوع عنصر FHIR string
    تفاصيل التكوين ملاحظة: يجب ملء هذه القيم تلقائيا وقراءتها فقط
    اسم الكيان fhir_servicerequestreasoncode
    مورد Azure FHIR طلب الخدمة

    طلب الخدمة يستبدل

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة غير قابل للتطبيق
    نوع الإجراء توسيع
    خريطة كيان التوسيع <fhir_servicerequestreplaces -> طلب الخدمة
    مخطط عنصر FHIR يستبدل
    نوع عنصر FHIR string
    تفاصيل التكوين ملاحظة: يجب ملء هذه القيم تلقائيا وقراءتها فقط
    اسم الكيان fhir_servicerequestreplaces
    مورد Azure FHIR طلب الخدمة

يجب إنشاء كافة مخططات السمات لجدول طلب الخدمة وخريطة الكيان fhir_servicerequest.

بعد ذلك، قمت بإعداد مخططات السمات لخرائط التوسيع.

فئة طلب الخدمة

  1. في جزء التنقل الأيمن، حدد Map Setup > Entity Maps.

  2. افتح خريطة الكيان fhir_servicerequestcategory.

  3. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  4. أدخل التفاصيل التالية.

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة الفئة (fhir_category)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s": "$.coding[0].code", "c": {"p": "coding[0]", "a": [{"system": "http://snomed.info/sct"}, {"code": "%"}]} }
    نوع عنصر FHIR string
    نوع المفهوم القابل للتعليمات البرمجية رموز فئة طلب الخدمة
    يستخدم في مطابقة السجلات نعم

  5. حدد حفظ.

رمز موقع طلب الخدمة

  1. في جزء التنقل الأيمن ضمن إعداد الخريطة، حدد Entity Maps.

  2. افتح خريطة الكيان fhir_servicerequestcategory.

  3. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  4. في صفحة New Update Service Attribute Map ، املأ التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة حسب الضرورة مفهوم قابل للترميز (fhir_asneededcodeableconcept)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s": "$.coding[0].code", "c": {"p": "coding[0]", "a": [{"system": "http://snomed.info/sct"}, {"code": "%"}]} }
    نوع عنصر FHIR string
    نوع المفهوم القابل للتعليمات البرمجية نوع دور موقع تسليم الخدمة
    يستخدم في مطابقة السجلات نعم

  5. حدد حفظ.

مرجع موقع طلب الخدمة

  1. في جزء التنقل الأيمن ضمن إعداد الخريطة، حدد Entity Maps.

  2. افتح خريطة الكيان fhir_servicerequestlocationreference.

  3. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  4. في صفحة New Update Service Attribute Map ، املأ التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة الموقع (msemr_location)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.reference","c":{"p":"$","a":[{"reference":"%"}]}}
    نوع عنصر FHIR string
    يستخدم في مطابقة السجلات نعم

رمز سبب طلب الخدمة

  1. في جزء التنقل الأيمن ضمن إعداد الخريطة، حدد Entity Maps.

  2. افتح خريطة الكيان fhir_servicerequestreasoncode.

  3. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  4. في صفحة New Update Service Attribute Map ، املأ التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة حسب الضرورة مفهوم قابل للترميز (fhir_asneededcodeableconcept)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s": "$.coding[0].code", "c": {"p": "coding[0]", "a": [{"system": "http://snomed.info/sct"}, {"code": "%"}]} }
    نوع عنصر FHIR string
    نوع المفهوم القابل للتعليمات البرمجية رمز سبب الإجراء
    يستخدم في مطابقة السجلات نعم

استبدال طلب الخدمة

  1. في جزء التنقل الأيمن ضمن إعداد الخريطة، حدد Entity Maps.

  2. افتح خريطة الكيان fhir_servicerequestreplaces.

  3. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  4. في صفحة New Update Service Attribute Map ، املأ التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة الموقع (fhir_servicerequest)
    نوع الإجراء مرجع FK
    مخطط عنصر FHIR {"s":"$.reference","c":{"p":"$","a":[{"reference":"%"}]}}
    نوع عنصر FHIR string
    يستخدم في مطابقة السجلات نعم

المعرف

  1. في جزء التنقل الأيمن ضمن إعداد الخريطة، حدد Entity Maps.

  2. افتح خريطة الكيان msemr_identifier مع تحديد مورد Azure FHIR من ServiceRequest.

  3. في قسم Related Attribute Maps ، حدد New Update Service Attribute Map من شريط أدوات subgrid.

  4. في صفحة New Update Service Attribute Map ، املأ التفاصيل التالية:

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة msemr_use
    نوع السمة قائمة الاختيار
    مخطط عنصر FHIR {"s":"$.استخدم"}
    نوع عنصر FHIR string
    يستخدم في مطابقة السجلات لا
    نوع الإجراء القيمة المعينة

  5. كرر الخطوات لخرائط السمات التالية.

    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة msemr_type
    نوع السمة Lookup
    مخطط عنصر FHIR {"s":"$.type.coding[0].code", "c":{"p":"type.coding[0]", "a":[{"system":"http://terminology.hl7.org/CodeSystem/v2-0203"}, {"code":"%"}]}}
    نوع عنصر FHIR string
    يستخدم في مطابقة السجلات لا
    نوع الإجراء مفهوم قابل للتعليمات البرمجية
    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة msemr_system
    نوع السمة سلسلة
    مخطط عنصر FHIR {"s":"$.system"}
    نوع عنصر FHIR string
    يستخدم في مطابقة السجلات لا
    نوع الإجراء نسخ البيانات
    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة نعم
    اسم السمة msemr_value
    نوع السمة سلسلة
    مخطط عنصر FHIR {"s":"$.value"}
    نوع عنصر FHIR string
    يستخدم في مطابقة السجلات نعم
    نوع الإجراء نسخ البيانات
    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة msemr_periodstart
    نوع السمة DateTime
    مخطط عنصر FHIR {"s":"$.period.start", "c":{"p":"period","a":[{"start":"%"},{"end":"x"}]}}
    نوع عنصر EFHIR string
    يستخدم في مطابقة السجلات لا
    نوع الإجراء نسخ البيانات
    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة msemr_periodend
    نوع السمة DateTime
    مخطط عنصر FHIR {"s":"$.period.end", "c":{"p":"الفترة","a":[{"start":"x"},{"end":"%"}]}}
    نوع عنصر EFHIR string
    يستخدم في مطابقة السجلات لا
    نوع الإجراء نسخ البيانات
    الخاصية Value
    تعطيل لا
    سمة FHIR المطلوبة لا
    اسم السمة msemr_assigner
    نوع السمة Lookup
    مخطط عنصر FHIR {"s":"$.assigner.reference", "c":{"p":"assigner", "a":[{"reference":"%%%"}, {"type":"%%"}]}}
    نوع عنصر EFHIR string
    يستخدم في مطابقة السجلات لا
    نوع الإجراء مرجع FK

التالي

لقد قمت بتحديث نموذج البيانات بجداول طلب الخدمة الجديدة وإضافة Entity و Attribute maps إلى البيئة. في التمرين التالي، سترسل نماذج من رسائل FHIR إلى واجهات برمجة تطبيقات Dataverse Healthcare وتختبر نموذج البيانات المحدث والخرائط.