เขียนข้อมูลทางการแพทย์

คู่มือนี้ใช้ได้กับ Health Connect เวอร์ชัน 1.1.0-beta02 ขึ้นไป

หากต้องการเขียนข้อมูลทางการแพทย์โดยใช้เวชระเบียนใน Health Connect ให้ทำตามขั้นตอนต่อไปนี้

  1. ตรวจสอบความพร้อมใช้งานของฟีเจอร์
  2. ขอสิทธิ์เขียน
  3. สร้างแหล่งข้อมูล (MedicalDataSource)
  4. เขียนแหล่งข้อมูลทางการแพทย์ (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

  • หากระเบียนทั้งหมดมาจากแหล่งที่มาเดียวกัน ให้สร้าง MedicalDataSource 1 รายการ
  • หากระเบียนมาจากหลายแหล่งที่มา คุณสามารถสร้าง 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)
    )
)