PHR - Android 框架 API

Health Connect Jetpack SDK 通常用于通过封装 Health Connect API 来简化集成,但 Jetpack 中尚不提供 PHR,因此必须使用底层 Android 框架 API。

由于这些 API 仍处于开发阶段,因此仍存在一些限制,并且部分组件尚未完全提供。

  • 有关 PHR 访问权限的 Play 政策仍在制定中,应用可能需要满足额外要求才能在 Play 商店中发布。
  • 某些功能(例如基于更新日志的 API)尚未针对 PHR API 开发。

如果您希望使用 Jetpack 将 PHR 集成到您的应用中,我们建议您等到 Jetpack 中提供 PHR 后再进行集成,与此同时,您可以使用这些资料了解 PHR。

MedicalDataSource

存储在 Health Connect 中的医疗记录会整理到 MedicalDataSource 中。这样,系统就可以将来自不同来源(例如 API 或医疗保健系统)的同一个人的医疗记录分开。

如果所有记录都来自同一来源,写入应用只需创建一个 MedicalDataSource。如果记录来自多个来源,只要这些数据已协调一致且所有记录都具有唯一的 FHIR 资源类型和 FHIR 资源 ID 组合,应用仍可以创建单个 MedicalDataSource。否则,应为每个数据源创建 MedicalDataSource

所有医疗记录都必须与 MedicalDataSource 相关联,因此必须先创建 MedicalDataSource,然后才能写入资源。

MedicalDataSource 的属性:

  • 显示名称(必需)- 面向用户的数据源显示名称,每个写入应用都有唯一标识。
  • FHIR 基准 URI(必需)- 对于来自 FHIR 服务器的数据,此字段应为 FHIR 基准网址(例如 https://example.com/fhir/)。如果数据由不含 FHIR 网址的应用生成,则此字段应为应用定义的唯一且易于理解的 URI(例如 myapp://..),指向数据的来源。

    例如,如果客户端应用支持应用深层链接,则此深层链接可用作 FHIR 基本 URI。URI 的最大长度为 2000 个字符。

  • 软件包名称(自动填充)- 写入数据的应用。

  • FHIR 版本(必需)- FHIR 版本。支持 4.0.1 版和 4.3.0 版。

  • 多个数据源可以与同一 FHIR 基准网址相关联。

  • 在一个数据源中,所有医疗记录的 FHIR 资源类型和 FHIR 资源 ID 组合都应是唯一的。

MedicalResource

MedicalResource 表示存储在 Health Connect 中的 FHIR 资源。

MedicalResource 的属性:

  • DataSourceId(必需)- 数据源,如 MedicalDataSource 中所述。
  • FHIR 版本(必需)- FHIR 版本。支持 4.0.1 和 4.3.0 版。
  • FHIR 资源(必需)- JSON 编码的 FHIR 资源实例。
  • 医疗资源类型(自动填充)- 面向用户的资源类别,会映射到面向用户的权限。
    • 系统会在插入时填充此字段,并由 Health Connect 自动派生。
    • 前面介绍了初始类型集。