คู่มือนี้ใช้ได้กับ Health Connect เวอร์ชัน 1.1.0-beta02 ขึ้นไป
หากต้องการเขียนข้อมูลทางการแพทย์โดยใช้เวชระเบียนใน Health Connect ให้ทำตามขั้นตอนต่อไปนี้
- ตรวจสอบความพร้อมใช้งานของฟีเจอร์
- ขอสิทธิ์เขียน
- สร้างแหล่งข้อมูล (
MedicalDataSource) - เขียนแหล่งข้อมูลทางการแพทย์ (
MedicalResource)
ความพร้อมใช้งานของฟีเจอร์
หากต้องการตรวจสอบว่าอุปกรณ์ของผู้ใช้รองรับเวชระเบียนใน Health Connect หรือไม่ ให้ตรวจสอบความพร้อมใช้งานของFEATURE_PERSONAL_HEALTH_RECORD ในไคลเอ็นต์ โดยทำดังนี้
if (healthConnectClient
.features
.getFeatureStatus(
HealthConnectFeatures.FEATURE_PERSONAL_HEALTH_RECORD
) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
// Feature is available
} else {
// Feature isn't available
}
สิทธิ์ที่จำเป็น
การเขียนข้อมูลทางการแพทย์ได้รับการปกป้องโดยสิทธิ์ต่อไปนี้
android.permission.health.WRITE_MEDICAL_DATA
ประกาศสิทธิ์เหล่านี้ใน Play Console สำหรับแอปของคุณ รวมถึงในไฟล์ Manifest ของแอป
<application>
<uses-permission
android:name="android.permission.health.WRITE_MEDICAL_DATA" />
</application>
คุณมีหน้าที่รับผิดชอบในการประกาศสิทธิ์ที่เหมาะสมทั้งหมดที่คุณตั้งใจจะใช้ในอุปกรณ์และแอปของคุณ นอกจากนี้ คุณควรตรวจสอบด้วยว่าผู้ใช้ได้ให้สิทธิ์แต่ละรายการแล้วก่อนใช้งาน
ขอสิทธิ์จากผู้ใช้
หลังจากสร้างอินสแตนซ์ไคลเอ็นต์แล้ว แอปของคุณจะต้องขอสิทธิ์จากผู้ใช้ ผู้ใช้ต้องได้รับอนุญาตให้ให้สิทธิ์หรือปฏิเสธสิทธิ์ได้ทุกเมื่อ
โดยสร้างชุดสิทธิ์สำหรับประเภทข้อมูลที่จำเป็น ตรวจสอบว่าได้ประกาศสิทธิ์ในชุดสิทธิ์ในไฟล์ Manifest ของ Android ก่อน
// Create a set of permissions for required data types
import androidx.health.connect.client.permission.HealthPermission.Companion.PERMISSION_WRITE_MEDICAL_DATA
val PERMISSIONS =
setOf(
PERMISSION_WRITE_MEDICAL_DATA
)
ใช้ getGrantedPermissions เพื่อดูว่าแอปของคุณได้รับสิทธิ์ที่จำเป็นแล้วหรือยัง หากไม่มี ให้ใช้ createRequestPermissionResultContract เพื่อขอสิทธิ์เหล่านั้น หน้าจอแสดงสิทธิ์ของ Health Connect จะปรากฏขึ้น
// Create the permissions launcher
val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()
val requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
if (granted.containsAll(PERMISSIONS)) {
// Permissions successfully granted
} else {
// Lack of required permissions
}
}
suspend fun checkPermissionsAndRun(healthConnectClient: HealthConnectClient) {
val granted = healthConnectClient.permissionController.getGrantedPermissions()
if (granted.containsAll(PERMISSIONS)) {
// Permissions already granted; proceed with inserting or reading data
} else {
requestPermissions.launch(PERMISSIONS)
}
}
เนื่องจากผู้ใช้สามารถให้หรือเพิกถอนสิทธิ์ได้ทุกเมื่อ แอปของคุณจึงต้องตรวจสอบสิทธิ์ทุกครั้งก่อนใช้งานและจัดการสถานการณ์ที่สิทธิ์หายไป
แหล่งข้อมูล
MedicalDataSource ใน Health Connect แสดงถึงแหล่งข้อมูลที่แสดงต่อผู้ใช้ เช่น องค์กรด้านการดูแลสุขภาพ โรงพยาบาล หรือ API
ระบบจะจัดระเบียบเวชระเบียนที่จัดเก็บไว้ใน Health Connect เป็นMedicalDataSource ซึ่งช่วยให้สามารถแยกเวชระเบียนของบุคคลเดียวกันที่มาจากแหล่งที่มาต่างๆ เช่น API หรือระบบการดูแลสุขภาพ
โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อสร้างระเบียน MedicalDataSource
- หากระเบียนทั้งหมดมาจากแหล่งที่มาเดียวกัน ให้สร้าง
MedicalDataSource1 รายการ - หากระเบียนมาจากหลายแหล่งที่มา คุณสามารถสร้าง
MedicalDataSourceรายการเดียวได้ในกรณีต่อไปนี้- ระบบจะปรับยอดข้อมูล
- ระเบียนทั้งหมดมีชุดค่าผสมที่ไม่ซ้ำกันของประเภททรัพยากร FHIR และรหัสทรัพยากร FHIR ภายใน
MedicalDataSourceจะมีระเบียนของประเภททรัพยากร FHIR ที่มีรหัสทรัพยากร FHIR ได้เพียงรายการเดียว
- หรือสร้าง
MedicalDataSourceสำหรับแหล่งข้อมูลแต่ละแหล่งเพื่อป้องกันไม่ให้รหัสซ้ำกัน
เวชระเบียนทั้งหมดต้องเชื่อมโยงกับ MedicalDataSource ดังนั้นจึงต้องสร้างเวชระเบียนก่อนเขียนทรัพยากร
คุณสมบัติของ MedicalDataSource:
- ชื่อที่แสดง (ต้องระบุ) - ชื่อที่แสดงต่อผู้ใช้สำหรับแหล่งข้อมูล ซึ่งระบุโดยไม่ซ้ำกันต่อแอปการเขียน
URI ฐานของ FHIR (ต้องระบุ) - สำหรับข้อมูลที่มาจากเซิร์ฟเวอร์ FHIR ข้อมูลนี้ควรเป็น URL ฐานของ FHIR (เช่น
https://example.com/fhir/) แหล่งข้อมูลหลายแหล่งสามารถเชื่อมโยงกับ URL ฐานของ FHIR เดียวกันได้หากข้อมูลสร้างขึ้นโดยแอปที่ไม่มี URL ของ FHIR ข้อมูลนี้ควรเป็น URI ที่ไม่ซ้ำกันและเข้าใจได้ซึ่งกำหนดโดยแอป (เช่น
myapp://..) ที่ชี้ไปยังแหล่งที่มาของข้อมูลตัวอย่างเช่น หากแอปไคลเอ็นต์รองรับการทำ Deep Link คุณสามารถใช้ Deep Link นี้เป็น URI ฐานของ FHIR ได้ URI มีความยาวสูงสุดได้ 2,000 อักขระ
ชื่อแพ็กเกจ (ป้อนข้อมูลโดยอัตโนมัติ) - แอปที่เขียนข้อมูล
เวอร์ชัน FHIR (ต้องระบุ) - เวอร์ชัน FHIR ต้องเป็นเวอร์ชันที่รองรับ
สร้างระเบียน MedicalDataSource
สร้างระเบียนสำหรับองค์กรหรือหน่วยงานด้านการดูแลสุขภาพแต่ละแห่งที่แอปของคุณลิงก์อยู่
// Create a `MedicalDataSource`
// Note that `displayName` must be unique across `MedicalDataSource`s
// Each `MedicalDataSource` is assigned an `id` by the system on creation
val medicalDataSource: MedicalDataSource =
healthConnectClient.createMedicalDataSource(
CreateMedicalDataSourceRequest(
fhirBaseUri = Uri.parse("https://fhir.com/oauth/api/FHIR/R4/"),
displayName = "Test Data Source",
fhirVersion = FhirVersion(4, 0, 1)
)
)
ลบระเบียน MedicalDataSource
ตัวอย่างก่อนหน้านี้จะแสดง id โดยระบบเมื่อสร้าง หากต้องการลบระเบียน MedicalDataSource ให้อ้างอิง id เดียวกันนั้น ดังนี้
// Delete the `MedicalDataSource` that has the specified `id`
healthConnectClient.deleteMedicalDataSourceWithData(medicalDataSource.id)
แหล่งข้อมูลทางการแพทย์
MedicalResource ใน Health Connect แสดงถึงทรัพยากร FHIR (ซึ่งมีเวชระเบียน) พร้อมกับข้อมูลเมตา
คุณสมบัติของ MedicalResource:
- DataSourceId (ต้องระบุ) - แหล่งข้อมูลตามที่อธิบายไว้สำหรับ
MedicalDataSource - เวอร์ชัน FHIR (ต้องระบุ) - เวอร์ชัน FHIR ต้องเป็นเวอร์ชันที่รองรับ
- ทรัพยากร FHIR (ต้องระบุ) อินสแตนซ์ทรัพยากร FHIR ที่เข้ารหัส JSON
- ประเภททรัพยากรทางการแพทย์ (ป้อนข้อมูลโดยอัตโนมัติ) - หมวดหมู่ที่แสดงต่อผู้ใช้ของทรัพยากร ซึ่งแมปกับสิทธิ์ที่แสดงต่อผู้ใช้
เตรียมทรัพยากร FHIR ใน JSON
ก่อนเขียนแหล่งข้อมูลทางการแพทย์ลงใน Health Connect ให้เตรียมระเบียนทรัพยากร FHIR ในรูปแบบ JSON จัดเก็บ JSON แต่ละรายการในตัวแปรของตัวเองเพื่อแทรกเป็นทรัพยากรทางการแพทย์
หากต้องการความช่วยเหลือเกี่ยวกับรูปแบบ FHIR JSON โปรดดูตัวอย่างข้อมูลที่องค์กร HL7 มีให้
แทรกหรืออัปเดตระเบียน MedicalResource
ใช้ UpsertMedicalResourceRequest เพื่อแทรกใหม่หรืออัปเดตระเบียน MedicalResource ที่มีอยู่สำหรับ MedicalDataSource ดังนี้
// Insert `MedicalResource`s into the `MedicalDataSource`
val medicalResources: List<MedicalResource> =
healthConnectClient.upsertMedicalResources(
listOf(
UpsertMedicalResourceRequest(
medicalDataSource.id,
medicalDataSource.fhirVersion,
medicationJsonToInsert // a valid FHIR json string
)
)
)
// Update `MedicalResource`s in the `MedicalDataSource`
val updatedMedicalResources: List<MedicalResource> =
healthConnectClient.upsertMedicalResources(
listOf(
UpsertMedicalResourceRequest(
medicalDataSource.id,
medicalDataSource.fhirVersion,
// a valid FHIR json string
// if this resource has the same type and ID as in `medicationJsonToInsert`,
// this `upsertMedicalResources()` call will update the previously inserted
// `MedicalResource`
updatedMedicationJsonToInsert
)
)
)
ตัวอย่างทรัพยากร FHIR
ในตัวอย่างก่อนหน้านี้ ตัวแปร medicationJsonToInsert แสดงสตริง JSON ของ FHIR ที่ถูกต้อง
ตัวอย่างลักษณะของ JSON ดังกล่าวมีดังนี้ โดยใช้ AllergyIntolerance เป็นประเภททรัพยากร FHIR ซึ่งจะแมปกับประเภททรัพยากรทางการแพทย์ของ FHIR_RESOURCE_TYPE_ALLERGY_INTOLERANCE ในเวชระเบียน
{
"resourceType": "AllergyIntolerance",
"id": "allergyintolerance-1",
"criticality": "high",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "91936005",
"display": "Penicillin allergy"
}
],
"text": "Penicillin allergy"
},
"recordedDate": "2020-10-09T14:58:00+00:00",
"asserter": {
"reference": "Patient/patient-1"
},
"lastOccurrence": "2020-10-09",
"patient": {
"reference": "Patient/patient-1",
"display": "B., Alex"
}
...
}
ลบระเบียน MedicalResource
ระบบอาจลบบันทึก MedicalResource รายการตามรหัสต่อไปนี้
// Delete `MedicalResource`s matching the specified `dataSourceId`, `type` and `fhirResourceId`
healthConnectClient.deleteMedicalResources(
medicalResources.map { medicalResource: MedicalResource ->
MedicalResourceId(
dataSourceId = medicalDataSource.id,
fhirResourceType = medicalResource.id.fhirResourceType,
fhirResourceId = medicalResource.id.fhirResourceId
)
}
)
หรือจะลบออกภายในวันที่ medicalResourceType ก็ได้
// Delete all `MedicalResource`s that are in any pair of provided `dataSourceIds` and
// `medicalResourceTypes`
healthConnectClient.deleteMedicalResources(
DeleteMedicalResourcesRequest(
dataSourceIds = setOf(medicalDataSource.id),
medicalResourceTypes = setOf(MEDICAL_RESOURCE_TYPE_MEDICATIONS)
)
)