Bagikan melalui

Gambaran umum pemetaan tujuan FHIR layanan MedTech

Penting

Mulai 26/2/2025, layanan MedTech tidak akan lagi tersedia di wilayah berikut: UK Barat, UAE Utara, Afrika Selatan Utara, Qatar Tengah.

Artikel ini memberikan gambaran umum tentang pemetaan tujuan FHIR® layanan MedTech.

Layanan MedTech memerlukan dua jenis pemetaan JSON yang ditambahkan ke layanan MedTech Anda melalui portal Microsoft Azure atau Azure Resource Manager API. 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 bagaimana data yang dinormalisasi dipetakan ke Pengamatan FHIR.

Nota

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

Dasar-dasar pemetaan tujuan FHIR

Pemetaan tujuan FHIR mengontrol bagaimana data yang dinormalisasi yang diekstrak dari pesan perangkat dipetakan ke dalam Pengamatan FHIR.

  • Haruskah pengamatan dibuat untuk titik waktu atau selama satu jam?
  • Kode apa yang harus ditambahkan ke pengamatan?
  • Haruskah nilai direpresentasikan sebagai SampledData atau Kuantitas?

Jenis-jenis data ini adalah semua opsi yang dikendalikan oleh konfigurasi pemetaan tujuan FHIR.

Setelah data perangkat diubah menjadi model data yang dinormalisasi, data yang dinormalisasi dikumpulkan untuk transformasi ke Pengamatan FHIR. Jika jenis Observasi adalah SampledData, data dikelompokkan sesuai dengan pengidentifikasi perangkat, jenis pengukuran, dan periode waktu (periode waktu dapat 1 jam atau 24 jam). Hasil pengelompokan ini dikirim untuk proses menjadi satu Pengamatan FHIR yang merepresentasikan periode waktu untuk jenis data tersebut. Untuk data Jenis pengamatan lainnya (Kuantitas, CodeableConcept , dan String) tidak dikelompokkan, tetapi sebaliknya setiap pengukuran diubah menjadi satu Pengamatan yang mewakili titik waktu.

Petunjuk / Saran

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

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

Contoh diagram tahap transformasi pesan perangkat layanan MedTech.

Nota

Pengamatan FHIR dalam diagram ini bukan sumber daya lengkap. Lihat Contoh dalam gambaran umum ini untuk seluruh Pengamatan FHIR.

CollectionFhir

CollectionFhir adalah jenis templat akar yang digunakan oleh pemetaan tujuan FHIR layanan MedTech. CollectionFhir adalah daftar semua templat yang digunakan selama tahap transformasi. Anda dapat menentukan satu atau beberapa templat dalam CollectionFhir, dengan setiap pesan yang dinormalisasi dievaluasi terhadap semua templat.

Diagram memperlihatkan templat pemetaan tujuan FHIR layanan MedTech dan arsitektur kode.

CodeValueFhir

CodeValueFhir saat ini adalah satu-satunya templat yang didukung dalam pemetaan tujuan FHIR. Ini memungkinkan Anda untuk menentukan kode, periode efektif, dan nilai pengamatan. Beberapa jenis nilai didukung: SampledData, CodeableConcept, Kuantitas, dan String. Seiring dengan nilai yang dapat dikonfigurasi ini, pengidentifikasi untuk sumber daya Observasi dan penautan ke sumber daya Perangkat dan Pasien yang tepat ditangani secara otomatis.

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, serta pengidentifikasi pasien dan. Jika pengidentifikasi ditentukan dan diekstrak dari payload data perangkat, pengidentifikasi tersebut ditautkan ke pengamatan jika ada peristiwa dalam layanan FHIR dengan pengidentifikasi tersebut. Jika pengidentifikasi pertemuan berhasil dinormalisasi, tetapi tidak ada FHIR Encounter dengan pengidentifikasi pertemuan tersebut, pengecualian FhirResourceNotFound dilemparkan. Untuk informasi selengkapnya tentang mengonfigurasi layanan MedTech Jenis resolusi, lihat Mengonfigurasi tab Tujuan.

Elemen Deskripsi Diperlukan
typeName Jenis pengukuran yang harus dikaitkan dengan templat ini. Catatan: Harus ada setidaknya satu templat pemetaan perangkat yang memiliki typeName yang sama. Elemen typeName ini digunakan untuk menautkan templat pemetaan tujuan FHIR ke satu atau beberapa templat pemetaan perangkat. Templat pemetaan perangkat dengan elemen yang sama typeName menghasilkan data yang dinormalisasi yang dievaluasi dengan templat pemetaan tujuan FHIR yang memiliki templat pemetaan tujuan yang sama typeName. Benar
periodInterval Periode waktu pengamatan yang dibuat harus mewakili. Nilai yang didukung adalah 0 (instans), 60 (satu jam), 1440 (sehari). True ketika jenis Observasi adalah SampledData; Diabaikan untuk jenis Pengamatan lainnya.
kategori Sejumlah berapa pun CodeableConcepts untuk mengklasifikasikan jenis pengamatan yang dibuat. Tidak benar
Kode Satu atau beberapa coding untuk diterapkan pada pengamatan. Benar
codes[].code Kode untuk Coding pada elemen codes. Benar
codes[].system Sistem untuk Coding dalam elemen codes. Tidak benar
codes[].display Tampilan untuk Coding di elemen codes. Tidak benar
value Nilai yang akan diekstrak dan diwakili dalam pengamatan. Untuk informasi selengkapnya tentang elemen yang dimuat value elemen, lihat Jenis nilai. Benar ketika components elemen tidak digunakan (kecuali jenis Observasi adalah CodebleConcept, dalam hal ini elemen ini tidak hanya 'tidak diperlukan' tetapi juga diabaikan).
komponen Satu atau beberapa komponen untuk diciptakan dalam pengamatan. Benar ketika value elemen tidak digunakan sebagai gantinya.
components[].codes Satu atau beberapa Codings untuk diterapkan ke komponen. Tidak benar
components[].value Nilai yang akan diekstrak dan diwakili dalam komponen. Untuk informasi selengkapnya tentang elemen yang dimuat components[].value elemen, lihat Jenis nilai. Benar ketika components elemen digunakan (kecuali jenis Observasi adalah CodebleConcept, dalam hal ini elemen ini tidak hanya 'tidak diperlukan' tetapi juga diabaikan).

Jenis nilai

Semua elemen templat value CodeValueFhir berisi elemen-elemen ini:

Elemen Deskripsi Diperlukan
valueType Jenis nilai. Nilai ini adalah "SampledData", "Quantity", "CodeableConcept", atau "String" tergantung pada jenis nilai. Benar
valueName Nama nilai. Benar kecuali valueType adalah CodeableConcept.

Jenis nilai ini didukung dalam pemetaan tujuan FHIR layanan MedTech:

Data Tersampel

Mewakili jenis data SampledData FHIR. Pengukuran pengamatan dicatat dalam aliran nilai yang dimulai pada titik waktu tertentu dan kemudian bergerak maju sesuai dengan periode yang telah ditentukan. Jika tidak ada nilai, nilai E ditulis ke dalam aliran data. Jika periode waktu memungkinkan dua atau lebih nilai menempati posisi yang sama dalam aliran data, nilai terbaru digunakan. Logika yang sama diterapkan saat pengamatan menggunakan SampledData diperbarui. Untuk templat CodeValueFhir dengan jenis nilai SampledData, elemen templat value berisi elemen berikut:

Elemen Deskripsi Diperlukan
defaultPeriod Periode default dalam milidetik yang akan digunakan. Benar
satuan Unit yang akan diatur pada asal SampledData. Benar

Kuantitas

Mewakili jenis data Kuantitas FHIR. Jenis ini membuat satu, titik waktu, Pengamatan. Jika nilai baru tiba yang berisi pengidentifikasi perangkat, jenis pengukuran, dan tanda waktu yang sama, Pengamatan sebelumnya diperbarui ke nilai baru. Untuk templat CodeValueFhir dengan jenis nilai Kuantitas, elemen templat value berisi elemen berikut:

Elemen Deskripsi Diperlukan
satuan Representasi unit. Tidak benar
code Bentuk unit yang dikodekan. Tidak benar
sistem Sistem yang mendefinisikan bentuk unit berkode. Tidak benar

CodeableConcept

Mewakili jenis data CodeableConcept FHIR. Nilai dalam model data yang dinormalisasi tidak digunakan, dan sebaliknya ketika jenis data ini diterima, Observasi dibuat dengan kode tertentu yang mewakili bahwa pengamatan dicatat pada titik waktu tertentu. Untuk templat CodeValueFhir dengan jenis nilai CodeableConcept, elemen templat value berisi elemen berikut:

Elemen Deskripsi Diperlukan
text Representasi teks biasa. Tidak benar
Kode Satu atau beberapa Coding untuk diterapkan ke pengamatan yang dibuat. Benar
codes[].code Kode untuk Coding di dalam sebuah elemen codes. Benar
codes[].system Sistem untuk Coding dalam elemen codes. Tidak benar
codes[].display Tampilan untuk Coding pada elemen codes. Tidak benar

string

Mewakili jenis data String FHIR. Jenis ini membuat satu pengamatan pada titik waktu tertentu. Jika nilai baru tiba yang berisi pengidentifikasi perangkat, jenis pengukuran, dan tanda waktu yang sama, Pengamatan sebelumnya diperbarui ke nilai baru. Tidak ada elemen lain yang didefinisikan.

Contoh

Petunjuk / Saran

Anda dapat menggunakan layanan MedTech Pemetaan debugger 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 Microsoft 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.

Nota

Contoh dan pesan yang dinormalisasi ini adalah kelanjutan dari Gambaran Umum pemetaan perangkat layanan MedTech.

Dalam contoh ini, kita menggunakan pesan yang dinormalisasi untuk menangkap data heartRate.

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

Kami menggunakan pemetaan tujuan FHIR ini untuk tahap transformasi:

{
  "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"
        }
      }
    }
  ]
}

Pengamatan FHIR yang dihasilkan akan terlihat seperti ini setelah tahap transformasi:

[
  {
    "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"
      }
    }
  }
]

Petunjuk / Saran

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.

Langkah berikutnya

Ringkasan pemetaan perangkat layanan MedTech

Cara menggunakan template CalculatedContent dengan pemetaan perangkat layanan MedTech

#B0 Cara menggunakan templat IotJsonPathContent dengan pemetaan perangkat layanan MedTech #C1

Cara menggunakan fungsi kustomisasi dengan pemetaan perangkat layanan MedTech

Gambaran Umum sampel pemetaan berbasis skenario layanan MedTech

Nota

FHIR® adalah merek dagang terdaftar HL7 dan digunakan dengan izin HL7.