MedTech hizmeti cihaz eşlemesine genel bakış

Makale
11/08/2023

Bu makalede MedTech hizmeti cihaz eşlemesine genel bir bakış sağlanır.

MedTech hizmeti, Azure portalı veya Azure Resource Manager (ARM) API'sini kullanarak MedTech hizmetinize eklenen iki tür JSON eşlemesi gerektirir. Cihaz eşlemesi ilk türdür ve MedTech hizmetine dahili, normalleştirilmiş bir veri nesnesine gönderilen cihaz verilerindeki eşleme değerlerini denetler. Cihaz eşlemesi, MedTech hizmetinin türleri, cihaz tanımlayıcılarını, ölçüm tarih saatlerini ve ölçüm değerlerini ayıklamak için kullandığı ifadeleri içerir. FHIR® hedef eşlemesi ikinci türdür ve FHIR Gözlemleri için eşlemeyi denetler.

Dekont

Cihaz ve FHIR hedef eşlemeleri, cihaz iletisi her işlendiğinde yeniden değerlendirilir. Her iki eşlemede yapılan tüm güncelleştirmeler hemen geçerli olur.

Cihaz eşleme temelleri

Cihaz eşlemesi, daha fazla değerlendirme için cihaz ileti verilerini iç, normalleştirilmiş bir biçimde ayıklamak için kullanılan ifade şablonları koleksiyonlarını içerir. Alınan her cihaz iletisi koleksiyondaki tüm ifade şablonlarına göre değerlendirilir. Bu değerlendirme, tek bir cihaz iletisinin FHIR hizmetinde birden çok FHIR Gözlemine eşlenebilen birden çok giden iletiye ayrılabileceği anlamına gelir.

Bahşiş

MedTech hizmetinin FHIR hizmetinde kalıcılık için cihaz ileti verilerini FHIR Gözlemlerine nasıl işlediği hakkında daha fazla bilgi için bkz . MedTech hizmeti cihaz veri işleme aşamalarına genel bakış.

Bu diyagram, MedTech hizmeti içindeki normalleştirme aşamasında neler olduğunu gösteren bir çizim sağlar.

Cihaz eşleme doğrulamaları

Normalleştirme işlemi, kullanım için kaydedilmesine izin vermeden önce cihaz eşlemesini doğrular. Bu öğeler cihaz eşleme şablonlarında gereklidir.

Cihaz eşleme

Öğe	CalculatedContent içinde gerekli	IotJsonPathContent içinde gerekli
Typename	Doğru	Doğru
typeMatchExpression	Doğru	Doğru
deviceIdExpression	Doğru	False ve tamamen yoksayıldı.
timestampExpression	Doğru	False ve tamamen yoksayıldı.
patientIdExpression	MedTech hizmetlerinin Çözüm türü Oluştur olarak ayarlandığında True; MedTech hizmetinin Çözüm türü Arama olarak ayarlandığında False.	MedTech hizmetinin Çözüm türü Oluştur olarak ayarlandığında True; MedTech hizmetinin Çözüm türü Arama olarak ayarlandığında False.
encounterIdExpression	Yanlış	Yanlış
correlationIdExpression	Yanlış	Yanlış
values[].valueName	Doğru	Doğru
values[].valueExpression	Doğru	Doğru
değerler[].required	Doğru	Doğru

Önemli

Çözüm türü, MedTech hizmetinin cihaz verilerini Cihaz kaynakları ve Hasta kaynaklarıyla nasıl ilişkilendirir belirtir. MedTech hizmeti, cihaz tanımlayıcılarını ve hasta tanımlayıcılarını kullanarak FHIR hizmetinden Cihaz ve Hasta kaynaklarını okur. Cihaz veri yükünden bir karşılaşma tanımlayıcısı belirtilir ve ayıklanırsa, bu tanımlayıcı ile FHIR hizmetinde bir karşılaşma varsa gözleme bağlanır. Karşılaşma tanımlayıcısı başarıyla normalleştirilirse, ancak bu tanımlayıcıyla bir FHIR Karşılaşması yoksa, bir FhirResourceNotFound özel durumu oluşturulur. MedTech hizmeti Çözümleme türünü yapılandırma hakkında daha fazla bilgi için bkz . Hedef sekmesini yapılandırma.

Dekont

values[].valueName, values[].valueExpressionve values[].required öğeleri yalnızca dizide bir değer girdiniz varsa gereklidir. Hiçbir değerin eşlenmemiş olması geçerlidir. Bu öğeler, gönderilen telemetri bir olay olduğunda kullanılır.

Örneğin, bazı senaryolar FHIR hizmetinde değer içermeyen bir FHIR Gözlemi oluşturmayı gerektirebilir.

CollectionContent

CollectionContent, MedTech hizmeti cihaz eşlemesi tarafından kullanılan kök şablon türüdür. CollectionContent, normalleştirme aşamasında kullanılan tüm şablonların listesidir. MedTech hizmeti tarafından alınan her cihaz iletisi tüm şablonlara göre değerlendirilirken CollectionContent içinde bir veya daha fazla şablon tanımlayabilirsiniz.

Kullanım örneğinize bağlı olarak CollectionContent içinde şu şablon türlerini kullanabilirsiniz:

MedTech hizmet olay hub'ınıza doğrudan gönderilen cihaz iletileri için CalculatedContent . CalculatedContent JSONPath, JMESPath, JMESPath işlevlerini ve MedTech hizmeti özel işlevlerini destekler.

ve/veya

Azure IoT Hub üzerinden MedTech hizmet olay hub'ınıza yönlendirilen cihaz iletileri için IotJsonPathContent. IotJsonPathContent, JSONPath'i destekler.

Örnek

Bahşiş

MedTech hizmet cihazı ve FHIR hedef eşlemelerini oluşturma, güncelleştirme ve sorunlarını giderme konusunda yardım için MedTech hizmet Eşlemesi hata ayıklayıcısını kullanabilirsiniz. Eşleme hata ayıklayıcısı, Azure portalından çıkmak zorunda kalmadan satır içi ayarlamaları gerçek zamanlı olarak kolayca görüntülemenize ve yapmanıza olanak tanır. Eşleme hata ayıklayıcısı, normalleştirilmiş iletilere işlendikten ve FHIR Gözlemlerine dönüştürüldükten sonra nasıl görüneceklerini görmek için test cihazı iletilerini karşıya yüklemek için de kullanılabilir.

Bu örnekte, verileri yakalayan heartRate bir cihaz iletisi kullanıyoruz:

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

Bu cihaz eşlemesini normalleştirme aşaması için kullanıyoruz:

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

Sonuçta elde edilen normalleştirilmiş ileti, normalleştirme aşamasından sonra şöyle görünür:

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

MedTech hizmeti cihaz iletisini işlerken, CollectionContent içindeki şablonlar iletiyi değerlendirmek için kullanılır. typeMatchExpression, şablonun cihaz iletisinden normalleştirilmiş bir ileti oluşturmak için kullanılıp kullanılmayacağını belirlemek için kullanılır. typeMatchExpression değeri true olarak değerlendirilirse, cihaz iletisinden deviceIdExpressionJSON değerlerini bulup ayıklamak ve normalleştirilmiş bir ileti oluşturmak için , timestampExpressionve valueExpression değerleri kullanılır. Bu örnekte tüm ifadeler JSONPath'te yazılmıştır, ancak tüm ifadeleri JMESPath'te yazmak geçerli olacaktır. Hangi ifade dilinin en uygun olduğunu belirlemek şablon yazarına bağlıdır.

Bahşiş

Yaygın MedTech hizmeti dağıtım hatalarını düzeltme konusunda yardım için bkz . MedTech hizmet dağıtım hatalarını giderme.

MedTech hizmet hatalarını düzeltme konusunda yardım için bkz . MedTech hizmet günlüklerini kullanarak hataları giderme.