Format data PHR

Data Personal Health Records (PHR) disimpan dalam format HL7 FHIR.

PHR mendukung versi Fast Health Interoperable Resources (FHIR) berikut:

Jenis Referensi Medis

FHIR terdiri dari serangkaian komponen modular yang disebut resource. Kumpulan resource FHIR dan kategori terkait yang didukung didasarkan secara kasar pada bagian Ringkasan Pasien Internasional.

Referensi ini dipetakan ke kategori data di Health Connect, yang disebut sebagai Jenis Referensi Medis di API. Resource pengamatan dipetakan berdasarkan konten seperti kode Logical Observation Identifiers Names and Codes (LOINC) dan kategori FHIR.

Pengamatan yang tidak termasuk dalam kategori ini tidak akan ditulis ke Health Connect.

Tabel 1: Jenis Referensi Medis Health Connect
Jenis Referensi Medis Health Connect Resource FHIR
Alergi AllergyIntolerance
Kondisi Ketentuan
Laboratorium

Pengamatan

  • Kategori FHIR laboratory
Pengobatan Medication, MedicationRequest, MedicationStatement
Detail pribadi Pasien
Detail praktisi Praktisi, PeranPraktiki
Kehamilan

Pengamatan

  • Kode LOINC kehamilan
Prosedur Prosedur
Histori sosial

Pengamatan

  • Kode LOINC Histori Sosial
  • Kategori FHIR social-history
Vaksinasi Imunisasi
Kunjungan Pertemuan, Lokasi, Organisasi
Tanda-tanda vital

Pengamatan

  • Kode LOINC Tanda-Tanda Vital
  • Kategori FHIR vital-signs

Referensi pasien

Health Connect dimaksudkan untuk menyimpan data PHR untuk satu individu saja saat ini. Oleh karena itu, semua resource FHIR yang ditulis harus milik orang yang sama.

Tidak jarang beberapa resource FHIR Patient ada dalam sistem untuk satu individu. Sebaiknya aplikasi merekonsiliasi data dan menulis satu resource Pasien ke Health Connect. Namun, hal ini tidak diterapkan untuk mengakomodasi berbagai struktur organisasi yang mungkin ada.

Validasi data

PHR API menerima resource FHIR yang valid dari versi yang didukung, dan Health Connect melakukan beberapa validasi untuk mengonfirmasi bahwa spesifikasi FHIR untuk setiap versi yang didukung diikuti.

Pemeriksaan validasi yang ditandai sebagai Segera hadir belum diterapkan, tetapi akan ada dalam rilis mendatang. Sebaiknya kembangkan berdasarkan semua pemeriksaan validasi yang tercantum untuk mempertahankan kompatibilitas dengan rilis mendatang.

Tabel 2: Validasi Health Connect terhadap data FHIR
Level Pemeriksaan Validasi
JSON valid Data mematuhi format JSON.
FHIR yang didukung

Versi FHIR yang dideklarasikan oleh aplikasi penulisan didukung. Versi FHIR berikut didukung oleh Health Connect:

  • 4.0.1
  • 4.3.0
FHIR yang didukung

Jenis resource FHIR yang dicatat dalam instance resource didukung. Jenis resource FHIR berikut didukung oleh Health Connect:

  • AllergyIntolerance
  • Ketentuan
  • Interaksi
  • Imunisasi
  • Lokasi
  • Obat
  • MedicationRequest
  • MedicationStatement
  • Pengamatan
  • Organisasi
  • Pasien
  • Praktisi
  • PractitionerRole
  • Prosedur
ID resource unik Resource memiliki kolom ID dengan nilai yang memenuhi persyaratan ekspresi reguler.
ID resource unik Resource tidak memiliki ID yang sama dengan resource FHIR lain dari jenis resource yang sama dari MedicalDataSource yang sama.
Aturan Bisnis Tidak menyertakan resource FHIR yang dimuat. Resource yang dimuat adalah resource FHIR yang disusun bertingkat dalam resource "induk". Resource ini digunakan saat resource induk perlu mereferensikan resource lain, tetapi sistem tidak memiliki informasi yang memadai untuk membuatnya sebagai resource mandiri dengan keberadaan independen.
FHIR Dasar yang Valid Kolom tingkat teratas dalam JSON FHIR ada dalam spesifikasi FHIR untuk jenis resource tertentu.
FHIR Dasar yang Valid Kolom tingkat atas tidak memiliki nilai null JSON.
FHIR Dasar yang Valid Semua kolom wajib diisi tingkat teratas ada.
FHIR Dasar yang Valid Kolom tingkat teratas yang ditentukan sebagai elemen berulang di FHIR memiliki jenis data array JSON.
FHIR Dasar yang Valid Kolom tingkat atas (termasuk elemen dalam array JSON) yang ditentukan sebagai Jenis kompleks di FHIR memiliki jenis data object JSON.
FHIR Dasar yang Valid Kolom tingkat atas (termasuk elemen dalam array JSON) yang ditentukan sebagai Jenis primitif di FHIR memiliki jenis data JSON yang benar.
Jenis data FHIR Jenis data JSON
integer, unsignedInt, positiveInt, decimal angka
boolean boolean
instant, time, date, dateTime, string, code, markdown, id uri, url, oid, uuid, canonical, integer64, base64Binary angka
Segera hadir
FHIR Dasar yang Valid Kolom level teratas yang ditentukan sebagai Jenis primitif di FHIR memenuhi persyaratan ekspresi reguler. Segera hadir
FHIR Dasar yang Valid Ekstensi ke jenis Primitive ada dalam spesifikasi FHIR dan memiliki jenis data object JSON.
FHIR Dasar yang Valid Tidak lebih dari satu kolom yang dicatat untuk Kolom pilihan (fieldname[x]).Misalnya, effectiveDateTime dan effectivePeriod tidak dapat ada dalam instance resource yang sama.
FHIR Dasar yang Valid Jenis data kompleks berisi kolom dan jenis data yang cocok dengan spesifikasi FHIR. Segera hadir
FHIR Dasar yang Valid Elemen backbone (dan elemen dalam jenis kompleks) berisi kolom dan jenis data yang cocok dengan spesifikasi FHIR. Segera hadir
FHIR Dasar yang Valid Kolom value[x] elemen ekstensi adalah jenis yang valid dan berisi konten sesuai dengan jenis data tersebut. Elemen ekstensi dapat disertakan dalam resource apa pun untuk mewakili informasi tambahan yang bukan bagian dari spesifikasi dasar. Elemen ini berisi kolom url yang ditautkan ke definisi ekstensi, dan kolom value[x] yang berisi nilai ekstensi. value[x] harus berasal dari daftar jenis data yang diterima. Segera hadir

Data FHIR yang ditransformasi

Beberapa aplikasi mengubah data FHIR untuk memenuhi persyaratannya sendiri. Contoh:

  • Menggabungkan data dari berbagai sumber (biasanya FHIR API).
  • Memetakan kode ke terminologi global (misalnya, SNOMED, LOINC, ICD) dan menstandarkan unit.
  • Menggabungkan dan menghapus duplikat data.
  • Memperbaiki masalah pemformatan atau kualitas data lainnya.
  • Memfilter data berdasarkan aturan bisnis khusus aplikasi.

Data FHIR yang tidak ditransformasi dan ditransformasi dapat ditulis ke Health Connect, asalkan mematuhi spesifikasi FHIR R4. Sebaiknya tulis data yang telah ditransformasi jika memungkinkan. Namun, perhatikan pertimbangan berikut:

  • Aplikasi dengan kasus penggunaan yang sempit dapat memfilter sejumlah besar data yang dapat digunakan aplikasi lain dalam ekosistem untuk menciptakan nilai bagi pengguna. Dalam situasi seperti ini, sebaiknya tulis FHIR yang tidak ditransformasi yang lebih lengkap. Namun, pastikan untuk memberi tahu pengguna bahwa set data yang lebih luas ini dibagikan.
  • Jika menggabungkan data yang berasal dari sumber yang berbeda, Anda dapat menulis data ke satu MedicalDataSource di Health Connect. Anda juga harus menetapkan ID baru ke setiap resource untuk menghindari bentrok, dan memperbarui referensi resource agar menunjuk ke ID baru.
  • Menggabungkan data dari beberapa sumber ke dalam satu MedicalDataSource dapat menyembunyikan asal data. Karena sering kali berguna bagi konsumen data untuk memahami asal data, sebaiknya isi kolom meta.source untuk setiap resource dengan sumber asli data (biasanya URL dasar FHIR).