MedTech hizmeti FHIR hedef eşlemesine genel bakış

Makale
11/08/2023

Bu makalede, MedTech hizmeti FHIR® hedef eşlemesine genel bir bakış sağlanır.

MedTech hizmeti, Azure portalı veya Azure Resource Manager 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 normalleştirilmiş verilerin FHIR Gözlemlerine nasıl eşlenmiş olduğunu 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.

FHIR hedef eşleme temelleri

FHIR hedef eşlemesi, bir cihaz iletisinden ayıklanan normalleştirilmiş verilerin FHIR Gözlemine nasıl eşlendiğini denetler.

Zaman içindeki bir nokta için mi yoksa bir saatlik bir süre içinde mi gözlem oluşturulmalıdır?
Gözleme hangi kodların eklenmesi gerekir?
Değer SampledData veya Quantity olarak mı gösterilmelidir?

Bu veri türlerinin tümü FHIR hedef eşleme yapılandırma denetimleridir.

Cihaz verileri normalleştirilmiş bir veri modeline dönüştürüldükten sonra, normalleştirilmiş veriler bir FHIR Gözlemine dönüştürülmek üzere toplanır. Gözlem türü SampledData ise, veriler cihaz tanımlayıcısına, ölçüm türüne ve zaman aralığına göre gruplandırılır (zaman aralığı 1 saat veya 24 saat olabilir). Bu gruplandırma çıktısı, söz konusu veri türünün zaman aralığını temsil eden tek bir FHIR Gözlemine dönüştürülmesi için gönderilir. Diğer Gözlem türleri (Quantity, CodeableConcept ve String) verileri gruplandırılmaz, ancak bunun yerine her ölçüm zamandaki bir noktayı temsil eden tek bir Gözleme dönüştürülür.

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 ileti işleme aşamalarına genel bakış.

Bu diyagram, MedTech hizmeti içindeki dönüştürme aşamasında neler olduğunu gösteren bir çizim sağlar.

Dekont

Bu diyagramdaki FHIR Gözlemi tam kaynak değildir. FHIR Gözleminin tamamı için bu genel bakışta örnek bölümüne bakın.

CollectionFhir

CollectionFhir, MedTech hizmeti FHIR hedef eşlemesi tarafından kullanılan kök şablon türüdür. CollectionFhir, dönüştürme aşamasında kullanılan tüm şablonların listesidir. CollectionFhir içinde bir veya daha fazla şablon tanımlayabilirsiniz ve her normalleştirilmiş ileti tüm şablonlara göre değerlendirilir.

CodeValueFhir

CodeValueFhir şu anda FHIR hedef eşlemesinde desteklenen tek şablondur. Kodları, geçerlilik süresini ve gözlemin değerini tanımlamanızı sağlar. Birden çok değer türü desteklenir: SampledData, CodeableConcept, Quantity ve String. Bu yapılandırılabilir değerlerle birlikte, Gözlem kaynağının tanımlayıcısı ve uygun Cihaz ve Hasta kaynaklarına bağlanma otomatik olarak işlenir.

Ö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.

Öğe	Tanım	Gerekli
Typename	Bu şablonun bağlanması gereken ölçü türü. Not: Bu öğesine sahip `typeName`en az bir cihaz eşleme şablonu olmalıdır. `typeName` öğesi, bir FHIR hedef eşleme şablonunu bir veya daha fazla cihaz eşleme şablonuna bağlamak için kullanılır. Aynı `typeName` öğeye sahip cihaz eşleme şablonları, aynı `typeName`olan bir FHIR hedef eşleme şablonuyla değerlendirilen normalleştirilmiş veriler oluşturur.	Doğru
periodInterval	Oluşturulan gözlemin temsil etmesi gereken süre. Desteklenen değerler 0 (örnek), 60 (saat), 1440 (gün) değerleridir.	Gözlem türü SampledData olduğunda True; Diğer Gözlem türleri için yoksayılır.
Kategori	Oluşturulan gözlem türünü sınıflandırmak için herhangi bir sayıda CodeableConcepts .	Yanlış
Kodları	Oluşturulan gözleme uygulanacak bir veya daha fazla Kodlama .	Doğru
codes[].code	öğesinde bir Kodlama kodu `codes` .	Doğru
codes[].system	öğesinde `codes` bir Kodlama için sistem.	Yanlış
codes[].display	öğesindeki bir Kodlama için `codes` görüntü.	Yanlış
value	Gözlemde ayıklanıp temsil edilen değer. öğesinin içerdiği öğeler `value` hakkında daha fazla bilgi için bkz . Değer türleri.	Öğe kullanılmadığında `components` true (Gözlem türü CodebleConcept değilse, bu durumda bu öğe yalnızca 'gerekli değildir' değil, aynı zamanda yoksayılır).
Bileşen	Gözlem üzerinde oluşturulacak bir veya daha fazla bileşen.	Bunun yerine öğesi kullanılmadığında `value` true.
components[].codes	Bileşene uygulanacak bir veya daha fazla Kodlama .	Yanlış
components[].value	Ayıklanıp bileşende temsil edilen değer. öğesinin içerdiği öğeler `components[].value` hakkında daha fazla bilgi için bkz . Değer türleri.	`components` Öğe kullanıldığında true (Gözlem türü CodebleConcept değilse, bu durumda bu öğe yalnızca 'gerekli değildir' değil, aynı zamanda yoksayılır).

Değer türleri

Tüm CodeValueFhir şablonlarının value öğesi şu öğeleri içerir:

Öğe	Tanım	Gerekli
Valuetype	Değerin türü. Bu değer, değer türüne bağlı olarak "SampledData", "Quantity", "CodeableConcept" veya "String" olabilir.	Doğru
Valuename	Değerin adı.	CodeableConcept olmadığı sürece `valueType` True.

Bu değer türleri MedTech hizmeti FHIR hedef eşlemesinde desteklenir:

SampledData

SampledData FHIR veri türünü temsil eder. Gözlem ölçümleri, belirli bir noktada başlayan ve tanımlanan dönem kullanılarak ileriye doğru artan bir değer akışına yazılır. Değer yoksa, veri akışına bir E yazılır. Dönem, iki veya daha fazla değerin veri akışında aynı konumu kapsayabilecek şekilde olması durumunda en son değer kullanılır. SampledData kullanan bir gözlem güncelleştirildiğinde aynı mantık uygulanır. SampledData değer türüne sahip bir CodeValueFhir şablonu için, şablonun value öğesi aşağıdaki öğeleri içerir:

Öğe	Tanım	Gerekli
defaultPeriod	Kullanılacak milisaniye cinsinden varsayılan süre.	Doğru
Birim	SampledData'nın kaynağında ayarlanacağı birim.	Doğru

Miktar

Quantity FHIR veri türünü temsil eder. Bu tür tek, belirli bir noktaya gözlem oluşturur. Aynı cihaz tanımlayıcısını, ölçüm türünü ve zaman damgasını içeren yeni bir değer gelirse, önceki Gözlem yeni değere güncelleştirilir. Quantity değer türüne sahip bir CodeValueFhir şablonu için, şablonun value öğesi aşağıdaki öğeleri içerir:

Öğe	Tanım	Gerekli
Birim	Birim gösterimi.	Yanlış
kod	Birimin kodlanmış biçimi.	Yanlış
Sistem	Kodlanmış birim formunu tanımlayan sistem.	Yanlış

CodeableConcept

CodeableConcept FHIR veri türünü temsil eder. Normalleştirilmiş veri modelindeki değer kullanılmaz ve bunun yerine bu veri türü alındığında, gözlemin belirli bir zamanda kaydedildiğini temsil eden belirli bir kodla bir Gözlem oluşturulur. CodeableConcept değer türüne sahip bir CodeValueFhir şablonu için, şablonun value öğesi aşağıdaki öğeleri içerir:

Öğe	Tanım	Gerekli
text	Düz metin gösterimi.	Yanlış
Kodları	Oluşturulan gözleme uygulanacak bir veya daha fazla Kodlama .	Doğru
codes[].code	öğesinde bir Kodlama kodu `codes` .	Doğru
codes[].system	öğesinde `codes` bir Kodlama için sistem.	Yanlış
codes[].display	öğesindeki bir Kodlama için `codes` görüntü.	Yanlış

String

Dize FHIR veri türünü temsil eder. Bu tür tek, belirli bir noktaya gözlem oluşturur. Aynı cihaz tanımlayıcısını, ölçüm türünü ve zaman damgasını içeren yeni bir değer gelirse, önceki Gözlem yeni değere güncelleştirilir. Başka öğe tanımlanmadı.

Ö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.

Dekont

Bu örnek ve normalleştirilmiş ileti, MedTech hizmeti cihaz eşlemesine Genel Bakış'ın devamıdır.

Bu örnekte verileri yakalayan heartRate normalleştirilmiş bir ileti kullanıyoruz:

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

Dönüştürme aşaması için bu FHIR hedef eşlemesini kullanıyoruz:

{
  "templateType": "CollectionFhir",
  "template": [
    {
      "templateType": "CodeValueFhir",
      "template": {
        "codes": [
          {
            "code": "8867-4",
            "system": "http://loinc.org",
            "display": "Heart rate"
          }
        ],
        "typeName": "heartrate",
        "value": {
          "system": "http://unitsofmeasure.org",
          "code": "count/min",
          "unit": "count/min",
          "valueName": "hr",
          "valueType": "Quantity"
        }
      }
    }
  ]
}

Sonuçta elde edilen FHIR Gözlemi, dönüştürme aşamasından sonra şöyle görünür:

[
  {
    "code": {
      "coding": [
        {
          "system": {
            "value": "http://loinc.org"
          },
          "code": {
            "value": "8867-4"
          },
          "display": {
            "value": "Heart rate"
          }
        }
      ],
      "text": {
        "value": "heartrate"
      }
    },
    "effective": {
      "start": {
        "value": "2023-03-13T22:46:01.8750000Z"
      },
      "end": {
        "value": "2023-03-13T22:46:01.8750000Z"
      }
    },
    "issued": {
      "value": "2023-04-05T21:02:59.1650841+00:00"
    },
    "value": {
      "value": {
        "value": 78
      },
      "unit": {
        "value": "count/min"
      },
      "system": {
        "value": "http://unitsofmeasure.org"
      },
      "code": {
        "value": "count/min"
      }
    }
  }
]

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.