Gambaran umum pemetaan perangkat layanan MedTech

Artikel
11/08/2023

Artikel ini memberikan gambaran umum tentang pemetaan perangkat layanan MedTech.

Layanan MedTech memerlukan dua jenis pemetaan JSON yang ditambahkan ke layanan MedTech Anda melalui API portal Azure atau Azure Resource Manager (ARM). Pemetaan perangkat adalah jenis pertama dan mengontrol nilai pemetaan dalam data perangkat yang dikirim ke layanan MedTech ke objek data internal yang dinormalisasi. Pemetaan perangkat berisi ekspresi yang digunakan layanan MedTech untuk mengekstrak jenis, pengidentifikasi perangkat, waktu tanggal pengukuran, dan nilai pengukuran. Pemetaan tujuan FHIR® adalah jenis kedua dan mengontrol pemetaan untuk Pengamatan FHIR.

Catatan

Pemetaan tujuan perangkat dan FHIR dievaluasi ulang setiap kali pesan perangkat diproses. Setiap pembaruan pada salah satu pemetaan akan segera berlaku.

Dasar-dasar pemetaan perangkat

Pemetaan perangkat berisi kumpulan templat ekspresi yang digunakan untuk mengekstrak data pesan perangkat ke dalam format internal yang dinormalisasi untuk evaluasi lebih lanjut. Setiap pesan perangkat yang diterima dievaluasi terhadap semua templat ekspresi dalam koleksi. Evaluasi ini berarti bahwa satu pesan perangkat dapat dipisahkan menjadi beberapa pesan keluar yang dapat dipetakan ke beberapa Pengamatan FHIR dalam layanan FHIR.

Tip

Untuk informasi selengkapnya tentang cara layanan MedTech memproses data pesan perangkat ke dalam Pengamatan FHIR untuk persistensi dalam layanan FHIR, lihat Gambaran Umum tahap pemrosesan data perangkat layanan MedTech.

Diagram ini memberikan ilustrasi tentang apa yang terjadi selama tahap normalisasi dalam layanan MedTech.

Validasi pemetaan perangkat

Proses normalisasi memvalidasi pemetaan perangkat sebelum memungkinkannya disimpan untuk digunakan. Elemen-elemen ini diperlukan dalam templat pemetaan perangkat.

Pemetaan perangkat

Elemen	Diperlukan dalam CalculatedContent	Diperlukan di IotJsonPathContent
typeName	Benar	Benar
typeMatchExpression	Benar	Benar
deviceIdExpression	Benar	Salah dan diabaikan sepenuhnya.
timestampExpression	Benar	Salah dan diabaikan sepenuhnya.
patientIdExpression	Benar ketika jenis Resolusi layanan MedTech diatur ke Buat; False saat jenis Resolusi layanan MedTech diatur ke Pencarian.	Benar ketika jenis Resolusi layanan MedTech diatur ke Buat; False saat jenis Resolusi layanan MedTech diatur ke Pencarian.
encounterIdExpression	Salah	Salah
correlationIdExpression	Salah	Salah
values[].valueName	Benar	Benar
values[].valueExpression	Benar	Benar
values[].required	Benar	Benar

Penting

Jenis Resolusi menentukan bagaimana layanan MedTech mengaitkan data perangkat dengan sumber daya Perangkat dan sumber daya Pasien. Layanan MedTech membaca sumber daya Perangkat dan Pasien dari layanan FHIR menggunakan pengidentifikasi perangkat dan pengidentifikasi pasien. Jika pengidentifikasi pertemuan ditentukan dan diekstrak dari payload data perangkat, pengidentifikasi ditautkan ke pengamatan jika ada pertemuan pada layanan FHIR dengan pengidentifikasi tersebut. Jika pengidentifikasi pertemuan berhasil dinormalisasi, tetapi tidak ada FHIR Encounter dengan pengidentifikasi pertemuan tersebut, pengecualian FhirResourceNotFound akan dilemparkan. Untuk informasi selengkapnya tentang mengonfigurasi jenis Resolusi layanan MedTech, lihat Mengonfigurasi tab Tujuan.

Catatan

Elemen values[].valueName, values[].valueExpression, dan values[].required hanya diperlukan jika Anda memiliki entri nilai dalam array. Adalah sah untuk tidak memiliki nilai yang dipetakan. Elemen-elemen ini digunakan ketika telemetri yang dikirim adalah peristiwa.

Misalnya, beberapa skenario mungkin memerlukan pembuatan Pengamatan FHIR dalam layanan FHIR yang tidak berisi nilai.

CollectionContent

CollectionContent adalah jenis templat akar yang digunakan oleh pemetaan perangkat layanan MedTech. CollectionContent adalah daftar semua templat yang digunakan selama tahap normalisasi. Anda dapat menentukan satu atau beberapa templat dalam CollectionContent, dengan setiap pesan perangkat yang diterima oleh layanan MedTech sedang dievaluasi terhadap semua templat.

Anda dapat menggunakan jenis templat ini dalam CollectionContent tergantung pada kasus penggunaan Anda:

CalculatedContent untuk pesan perangkat yang dikirim langsung ke hub peristiwa layanan MedTech Anda. CalculatedContent mendukung fungsi JSONPath, JMESPath, JMESPath, dan fungsi kustom layanan MedTech.

dan/atau

IotJsonPathContent untuk pesan perangkat yang dirutekan melalui Azure IoT Hub ke hub peristiwa layanan MedTech Anda. IotJsonPathContent mendukung JSONPath.

Contoh

Tip

Anda dapat menggunakan debugger Pemetaan layanan MedTech untuk bantuan membuat, memperbarui, dan memecahkan masalah perangkat layanan MedTech dan pemetaan tujuan FHIR. Debugger Pemetaan memungkinkan Anda untuk dengan mudah melihat dan membuat penyesuaian sebaris secara real time, tanpa harus meninggalkan portal Azure. Debugger Pemetaan juga dapat digunakan untuk mengunggah pesan perangkat pengujian untuk melihat bagaimana tampilannya setelah diproses menjadi pesan yang dinormalisasi dan diubah menjadi Pengamatan FHIR.

Dalam contoh ini, kita menggunakan pesan perangkat yang mengambil heartRate data:

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

Kami menggunakan pemetaan perangkat ini untuk tahap normalisasi:

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

Pesan yang dinormalisasi yang dihasilkan akan terlihat seperti ini setelah tahap normalisasi:

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

Saat layanan MedTech memproses pesan perangkat, templat di CollectionContent digunakan untuk mengevaluasi pesan. typeMatchExpression digunakan untuk menentukan apakah templat harus digunakan untuk membuat pesan yang dinormalisasi atau tidak dari pesan perangkat. typeMatchExpression Jika mengevaluasi ke true, maka deviceIdExpressionnilai , , timestampExpressiondan valueExpression digunakan untuk menemukan dan mengekstrak nilai JSON dari pesan perangkat dan membuat pesan yang dinormalisasi. Dalam contoh ini, semua ekspresi ditulis dalam JSONPath, namun, akan valid untuk menulis semua ekspresi di JMESPath. Terserah pembuat templat untuk menentukan bahasa ekspresi mana yang paling tepat.

Tip

Untuk bantuan memperbaiki kesalahan penyebaran layanan MedTech umum, lihat Memecahkan masalah kesalahan penyebaran layanan MedTech.

Untuk bantuan dalam memperbaiki kesalahan layanan MedTech, lihat Memecahkan masalah kesalahan menggunakan log layanan MedTech.