本指南适用于 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，然后才能写入资源。
MedicalDataSource 的属性：
- 显示名称（必需）- 面向用户的数据源显示名称，每个写入应用都有唯一标识。
FHIR 基准 URI（必需）- 对于来自 FHIR 服务器的数据，此字段应为 FHIR 基准网址（例如
https://example.com/fhir/）。多个数据源可以与同一 FHIR 基准网址相关联。如果数据由不含 FHIR 网址的应用生成，则此字段应为应用定义的唯一且易于理解的 URI（例如
myapp://..），该 URI 应指向数据的来源。例如，如果客户端应用支持深层链接，则此深层链接可用作 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 记录或更新现有 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 记录
系统可能会按 ID 删除 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)
)
)