本指南与 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 管理中心为您的应用以及应用的清单中声明这些权限
<application>
<uses-permission
android:name="android.permission.health.WRITE_MEDICAL_DATA" />
</application>
您有责任声明您打算在设备和应用中使用的所有适当权限。您还应在使用前检查每个权限是否已获得用户授权。
向用户请求权限
创建客户端实例后，您的应用需要向用户请求权限。用户必须能够随时授予或拒绝权限。
为此，请为所需的数据类型创建一组权限。请确保集合中的权限首先在您的 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)
}
}
由于用户可以随时授予或撤销权限，因此您的应用需要定期检查已授予的权限，并处理权限丢失的情况。
数据源
Health Connect 中的 MedicalDataSource 表示面向用户的数据源，例如医疗机构、医院或 API。
存储在 Health Connect 中的医疗记录被组织到 MedicalDataSource 中。这允许将来自不同来源（例如 API 或医疗保健系统）的同一用户的医疗记录分开。
如果所有记录都源自同一来源，则写入应用只需创建一个 MedicalDataSource。如果记录源自多个来源，如果数据已协调并且所有记录都具有 FHIR 资源类型和 FHIR 资源 ID 的唯一组合，则应用仍然可以创建单个 MedicalDataSource。否则，应为每个数据源创建一个 MedicalDataSource。
所有医疗记录都必须与 MedicalDataSource 关联，因此必须在写入资源之前创建它。
MedicalDataSource 的属性
- 显示名称（必填）- 面向用户的数据源显示名称，每个写入应用都是唯一标识的。
FHIR 基本 URI（必填）- 对于来自 FHIR 服务器的数据，这应该是 FHIR 基本 URL（例如，
https://example.com/fhir/）。多个数据源可以与同一个 FHIR 基本 URL 关联。如果数据由没有 FHIR URL 的应用生成，则这应该是由应用定义的唯一且可理解的 URI（例如，
myapp://..），指向数据源。例如，如果客户端应用支持深层链接，则此深层链接可用作 FHIR 基本 URI。URI 的最大长度为 2000 个字符。
软件包名称（自动填充）- 写入数据的应用。
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)
医疗资源
Health Connect 中的 MedicalResource 表示一个 FHIR 资源（其中包含医疗记录）以及元数据。
MedicalResource 的属性
- DataSourceId（必填）- 如
MedicalDataSource所述的数据源。 - FHIR 版本（必填）- FHIR 版本。必须是支持的版本。
- FHIR 资源（必填）JSON 编码的 FHIR 资源实例。
- 医疗资源类型（自动填充）- 资源的面向用户的类别，映射到面向用户的权限。
以 JSON 格式准备 FHIR 资源
在将医疗资源写入 Health Connect 之前，请以 JSON 格式准备您的 FHIR 资源记录。将每个 JSON 存储在自己的变量中，以便作为医疗资源插入。
如果您需要 FHIR JSON 格式的帮助，请参考 HL7 组织提供的示例数据。
插入或更新 MedicalResource 记录
使用 UpsertMedicalResourceRequest 为 MedicalDataSource 插入新记录或更新现有 MedicalResource 记录
// 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 表示有效的 FHIR JSON 字符串。
以下是该 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 记录可以通过 ID 删除
// 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)
)
)