نظرة عامة على تعيين جهاز خدمة MedTech

مقالة
11/08/2023

توفر هذه المقالة نظرة عامة على تعيين جهاز خدمة MedTech.

تتطلب خدمة MedTech نوعين من تعيينات JSON التي تتم إضافتها إلى خدمة MedTech من خلال مدخل Microsoft Azure أو واجهة برمجة تطبيقات Azure Resource Manager (ARM). تعيين الجهاز هو النوع الأول ويتحكم في قيم التعيين في بيانات الجهاز المرسلة إلى خدمة MedTech إلى كائن بيانات داخلي تمت تسويته. يحتوي تعيين الجهاز على تعبيرات تستخدمها خدمة MedTech لاستخراج الأنواع ومعرفات الأجهزة ووقت القياس وقيمة (قيم) القياس. تعيين وجهة FHIR® هو النوع الثاني ويتحكم في تعيين ملاحظات FHIR.

إشعار

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

أساسيات تعيين الجهاز

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

تلميح

لمزيد من المعلومات حول كيفية معالجة خدمة MedTech لبيانات رسالة الجهاز في ملاحظات FHIR لاستمرارها في خدمة FHIR، راجع نظرة عامة على مراحل معالجة بيانات جهاز خدمة MedTech.

يوفر هذا الرسم التخطيطي رسما توضيحيا لما يحدث أثناء مرحلة التطبيع داخل خدمة MedTech.

عمليات التحقق من صحة تعيين الجهاز

تتحقق عملية التسوية من صحة تعيين الجهاز قبل السماح بحفظه للاستخدام. هذه العناصر مطلوبة في قوالب تعيين الجهاز.

تعيين الجهاز

العنصر	مطلوب في CalculatedContent	مطلوب في IotJsonPathContent
Typename	صواب	صواب
typeMatchExpression	صواب	صواب
deviceIdExpression	صواب	خطأ وتجاهل تماما.
تعبير الطابع الزمني	صواب	خطأ وتجاهل تماما.
patientIdExpression	صواب عند تعيين نوع الدقة لخدمات MedTech إلى إنشاء؛ خطأ عند تعيين نوع الحل لخدمة MedTech إلى بحث.	صواب عند تعيين نوع الحل لخدمة MedTech إلى إنشاء؛ خطأ عند تعيين نوع الحل لخدمة MedTech إلى بحث.
encounterIdExpression	خطأ	خطأ
correlationIdExpression	خطأ	خطأ
values[].valueName	صواب	صواب
values[].valueExpression	صواب	صواب
القيم[].مطلوبة	صواب	صواب

هام

يحدد نوع الدقة كيفية ربط خدمة MedTech لبيانات الجهاز بموارد الجهاز وموارد المريض. تقرأ خدمة MedTech موارد الجهاز والمريض من خدمة FHIR باستخدام معرفات الجهاز ومعرفات المرضى. إذا تم تحديد معرف مواجهة واستخراجه من حمولة بيانات الجهاز، فإنه يرتبط بالملاحظة إذا كان هناك مواجهة على خدمة FHIR بهذا المعرف. إذا تم تسوية معرف المصادفة بنجاح، ولكن لا يوجد FHIR Encounter مع معرف المصادفة هذا، يتم طرح استثناء FhirResourceNotFound. لمزيد من المعلومات حول تكوين نوع دقة خدمة MedTech، راجع تكوين علامة التبويب الوجهة.

إشعار

values[].valueName, values[].valueExpressionالعناصر و values[].required مطلوبة فقط إذا كان لديك إدخال قيمة في الصفيف. من الصالح عدم تعيين أي قيم. يتم استخدام هذه العناصر عندما يكون القياس عن بعد الذي يتم إرساله حدثا.

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

عنصر تحكم المجموعة

CollectionContent هو نوع القالب الجذر المستخدم بواسطة تعيين جهاز خدمة MedTech. CollectionContent هي قائمة بجميع القوالب المستخدمة أثناء مرحلة التسوية. يمكنك تعريف قالب واحد أو أكثر داخل CollectionContent، مع تقييم كل رسالة جهاز تتلقاها خدمة MedTech مقابل جميع القوالب.

يمكنك استخدام أنواع القوالب هذه داخل CollectionContent اعتمادا على حالة الاستخدام الخاصة بك:

CalculatedContent لرسائل الجهاز المرسلة مباشرة إلى مركز أحداث خدمة MedTech. يدعم CalculatedContent وظائف JSONPath وJMESPath وJMESPath وخدمة MedTech المخصصة.

و/أو

IotJsonPathContent لرسائل الجهاز التي يتم توجيهها من خلال Azure IoT Hub إلى مركز أحداث خدمة MedTech. يدعم IotJsonPathContent مسار JSON.

مثال

تلميح

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

في هذا المثال، نستخدم رسالة جهاز تلتقط heartRate البيانات:

{
  "heartRate": "78",
  "endDate": "2023-03-13T22:46:01.8750000",
  "deviceId": "device01"
}

نحن نستخدم تعيين الجهاز هذا لمرحلة التطبيع:

{
  "templateType": "CollectionContent",
  "template": [
    {
      "templateType": "CalculatedContent",
      "template": {
        "typeName": "heartrate",
        "typeMatchExpression": "$..[?(@heartRate)]",
        "deviceIdExpression": "$.matchedToken.deviceId",
        "timestampExpression": "$.matchedToken.endDate",
        "values": [
          {
            "required": true,
            "valueExpression": "$.matchedToken.heartRate",
            "valueName": "hr"
          }
        ]
      }
    }
  ]
}

ستبدو الرسالة التي تمت تسويتها الناتجة كما يلي بعد مرحلة التسوية:

[
  {
    "type": "heartrate",
    "occurrenceTimeUtc": "2023-03-13T22:46:01.875Z",
    "deviceId": "device01",
    "properties": [
      {
        "name": "hr",
        "value": "78"
      }
    ]
  }
]

عندما تقوم خدمة MedTech بمعالجة رسالة الجهاز، يتم استخدام القوالب في CollectionContent لتقييم الرسالة. typeMatchExpression يتم استخدام لتحديد ما إذا كان يجب استخدام القالب لإنشاء رسالة تمت تسويتها من رسالة الجهاز أم لا. typeMatchExpression إذا تم تقييم إلى true، فسيتم deviceIdExpressiontimestampExpressionاستخدام القيم و و valueExpression لتحديد موقع قيم JSON واستخراجها من رسالة الجهاز وإنشاء رسالة تمت تسويتها. في هذا المثال، تتم كتابة جميع التعبيرات في JSONPath، ومع ذلك، سيكون من الصالح كتابة جميع التعبيرات في JMESPath. الأمر متروك لمؤلف القالب لتحديد لغة التعبير الأكثر ملاءمة.

تلميح

للمساعدة في إصلاح أخطاء توزيع خدمة MedTech الشائعة، راجع استكشاف أخطاء توزيع خدمة MedTech وإصلاحها.

للمساعدة في إصلاح أخطاء خدمة MedTech، راجع استكشاف الأخطاء وإصلاحها باستخدام سجلات خدمة MedTech.