Catatan Kesehatan Pribadi

Platform Health Connect menyediakan berbagai jenis data, yang sebagian besar mencakup kasus penggunaan kesehatan dan kebugaran, sehingga aplikasi di ekosistem Android dapat berbagi data tanpa memerlukan integrasi API satu-satu berbiaya tinggi. Catatan Kesehatan Pribadi (PHR) memperluas kemampuan ini untuk menyertakan data medis dasar dalam format Fast Healthcare Interoperability Resources (FHIR®), termasuk:

  • API untuk aplikasi yang menulis data medis.
  • Pengalaman browser yang ditampilkan kepada pengguna untuk data medis yang disimpan di Health Connect sebagai jenis data medis baru, beserta izin terperinci untuk mengizinkan pembacaan downstream.
  • API untuk aplikasi yang membaca data medis berdasarkan izin yang diberikan pengguna.
Ringkasan cara kerja Catatan Kesehatan Pribadi dengan Health Connect.
Gambar 1. Cara kerja Rekam Medis Pribadi dengan Health Connect.

PHR API tersedia melalui Android 16 SDK. Lihat Menyiapkan SDK Android 16 untuk mendapatkan petunjuk cara memulai.

Batasan

Karena API ini masih dalam pengembangan, masih ada beberapa batasan dan beberapa komponen tidak sepenuhnya tersedia.

  • Health Connect Jetpack SDK biasanya digunakan untuk menyederhanakan integrasi dengan menggabungkan Health Connect API, tetapi API ini belum tersedia, sehingga API framework Android yang mendasarinya harus digunakan.
  • Kebijakan Play untuk akses PHR masih dalam pengembangan, dan aplikasi mungkin perlu memenuhi persyaratan tambahan sebelum dapat dirilis di Play Store.
  • Beberapa fitur, seperti API berbasis log perubahan, belum dikembangkan untuk API PHR.

Format data PHR

Data PHR disimpan dalam format HL7 FHIR, yang awalnya hanya mendukung versi R4.

Validasi data

PHR API menerima resource FHIR R4 yang valid dan Health Connect akan melakukan beberapa validasi untuk memastikan bahwa spesifikasi FHIR R4 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 menghindari masalah pada rilis mendatang.

Tabel 1: Validasi Health Connect untuk 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 berisi 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 membuat resource mandiri ini 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 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
FHIR Dasar yang Valid Semua kolom wajib diisi tingkat teratas ada.

Kategori data

Kumpulan resource FHIR yang didukung dan kategori yang sesuai secara kasar didasarkan pada bagian International Patient Summary:

  • Kategori intoleransi alergi - berisi resource AllergyIntolerance.
  • Kategori kondisi - berisi resource Kondisi.
  • Kategori kunjungan - berisi resource Kontak, Lokasi, Organisasi.
  • Kategori Vaksin - berisi referensi Imunisasi.
  • Kategori detail pribadi - berisi resource Pasien.
  • Kategori detail praktisi - berisi referensi Praktisi, PraktisiPeran.
  • Kategori Prosedur - berisi resource Prosedur.
  • Kategori pengobatan - berisi resource Medication, MedicationRequest, MedicationStatement.

Referensi pengamatan dikategorikan berdasarkan kontennya:

  • Kehamilan - berdasarkan kode LOINC kehamilan.
  • Histori Sosial - berdasarkan kode LOINC Histori Sosial atau kategori FHIR "social-history".
  • Tanda-tanda Vital - berdasarkan kode LOINC tanda-tanda vital atau kategori FHIR "tanda-tanda vital".
  • Laboratorium - berdasarkan kategori FHIR "laboratorium".

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

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 tulis aplikasi untuk merekonsiliasi data dan menulis satu resource Pasien ke Health Connect. Namun, hal ini tidak diterapkan untuk mengakomodasi berbagai struktur organisasi yang mungkin ada.

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

Pengalaman pengguna

Informasi umum tentang pengalaman pengguna diberikan di bagian ini.

Izin

Meminta izin catatan medis baca atau tulis berperilaku mirip dengan layar izin Health Connect yang ada, tetapi layar catatan kesehatan terpisah akan ditampilkan:

izin

Penjelajahan data

Health Connect juga menyediakan visualisasi dan penjelajahan dasar data PHR yang disimpan, mirip dengan jenis data Health Connect yang ada.

penjelajahan