个人健康记录数据格式

个人健康记录 (PHR) 数据以 HL7 FHIR 格式存储。

PHR 支持以下快速医疗互操作性资源 (FHIR) 版本：

医疗资源类型

FHIR 由一组称为资源的模块化组件组成。支持的一组 FHIR 资源和相应的类别大致基于 International Patient Summary sections。

这些资源会映射到 Health Connect 中的数据类别，在 API 中称为医疗资源类型。观察资源是根据内容（例如逻辑观察标识符名称和代码 [LOINC] 代码和 FHIR 类别）进行映射的。

不属于上述任何类别的观察结果都不会写入 Health Connect。

表 1：Health Connect 医疗资源类型
Health Connect 医疗资源类型 FHIR 资源
过敏史 AllergyIntolerance
条件 条件
实验室

观察

  • laboratory FHIR 类别
用药 Medication、MedicationRequest、MedicationStatement
个人详细信息 患者
医师详细信息 Practitioner、PractitionerRole
妊娠情况

观察

  • 妊娠 LOINC 代码
医疗程序 流程
个人生活史

观察

  • 社交媒体历史记录 LOINC 代码
  • social-history FHIR 类别
疫苗接种 疫苗接种记录
就诊记录 接触、地点、组织
生命体征

观察

  • 生命体征 LOINC 代码
  • vital-signs FHIR 类别

患者资源

Health Connect 目前仅用于存储单个个人的个人健康记录数据。因此，编写的所有 FHIR 资源都应归同一人所有。

在系统中，对于单个个人，存在多个 FHIR 患者资源的情况并不少见。建议应用对数据进行协调，并将单个患者资源写入 Health Connect。不过，系统不会强制执行此规则，以适应可能存在的不同组织结构。

数据验证

PHR API 接受来自受支持版本的有效 FHIR 资源，Health Connect 会执行一些验证，以确认是否遵循每个受支持版本的 FHIR 规范。

标记为即将推出的验证检查尚未强制执行，但将在未来版本中推出。我们建议您根据所有列出的验证检查进行开发，以便与未来的版本保持兼容性。

表 2：Health Connect 对 FHIR 数据的验证
等级 验证检查
JSON 有效 数据符合 JSON 格式。
支持的 FHIR

支持由写入应用声明的 FHIR 版本。Health Connect 支持以下 FHIR 版本：

  • 4.0.1
  • 4.3.0
支持的 FHIR

支持在资源实例中记录的 FHIR 资源类型。 Health Connect 支持以下 FHIR 资源类型：

  • AllergyIntolerance
  • 条件
  • 邂逅
  • 疫苗接种记录
  • 位置
  • 药物
  • MedicationRequest
  • MedicationStatement
  • 观察
  • 组织机构
  • 患者
  • 医生
  • PractitionerRole
  • 流程
唯一资源 ID 资源的 ID 字段的值符合正则表达式要求。
唯一资源 ID 资源与同一 MedicalDataSource 中具有相同资源类型的其他 FHIR 资源不共用 ID。
业务规则 不包含包含的 FHIR 资源。 包含的资源是嵌套在“父”资源中的 FHIR 资源。当父级资源需要引用其他资源，但系统没有足够的信息将其创建为独立存在的独立资源时，就会使用此类资源。
有效的 FHIR 基准 FHIR JSON 中的顶级字段存在于给定资源类型的 FHIR 规范中。
有效的 FHIR 基准 顶级字段不含 JSON null 值。
有效的 FHIR 基准 顶级必填字段均已填写。
有效的 FHIR 基准 定义为 FHIR 中的重复元素的顶级字段具有 JSON array 数据类型。
有效的 FHIR 基准 在 FHIR 中定义为复杂类型的顶级字段（包括 JSON array 中的元素）具有 JSON object 数据类型。
有效的 FHIR 基准 在 FHIR 中定义为基元类型的顶级字段（包括 JSON array 中的元素）具有正确的 JSON 数据类型。
FHIR 数据类型 JSON 数据类型
整数、无符号整数、正整数、小数 数值
布尔值 布尔值
瞬时时间、时间、日期、日期时间、字符串、代码、Markdown、ID URI、网址、OID、UUID、规范化、整数 64、Base64 二进制 数值
敬请期待
有效的 FHIR 基准 在 FHIR 中定义为基元类型的顶级字段符合正则表达式要求。 即将推出
有效的 FHIR 基准 FHIR 规范中存在对基元类型的扩展，它们采用 JSON object 数据类型。
有效的 FHIR 基准 系统不会为选择字段 (fieldname[x]) 记录多个字段。例如，同一资源实例中不能同时存在 effectiveDateTime 和 effectivePeriod。
有效的 FHIR 基准 复杂数据类型包含与 FHIR 规范匹配的字段和数据类型。 即将推出
有效的 FHIR 基准 主干元素（以及复杂类型中的元素）包含与 FHIR 规范匹配的字段和数据类型。 即将推出
有效的 FHIR 基准 Extensions 元素 value[x] 字段是有效类型，并包含相应数据类型的内容。 扩展元素可包含在任何资源中，用于表示不属于基本规范的其他信息。它们包含一个指向扩展定义的字段 url，以及一个包含扩展值的字段 value[x]。value[x] 必须来自接受的数据类型的设定列表。 即将推出

转换后的 FHIR 数据

某些应用会转换 FHIR 数据，以满足自己的要求。例如：

  • 合并来自不同来源（通常是 FHIR API）的数据。
  • 将代码映射到全球术语（例如 SNOMED、LOINC、ICD）并标准化单位。
  • 整合和删除重复数据。
  • 解决格式或其他数据质量问题。
  • 根据应用专用业务规则过滤记录。

未转换和转换后的 FHIR 数据都可以写入 Health Connect，前提是它们符合 FHIR R4 规范。我们建议您尽可能写入转换后的数据。但请注意以下几点：

  • 用例较窄的应用可能会滤除生态系统中其他应用可以通过其创造用户价值的大量记录。在这种情况下，编写更完整的未转换 FHIR 可能很有用。不过，请务必告知用户您要共享这个更广泛的数据集。
  • 如果要合并来自不同来源的数据，您可以将数据写入 Health Connect 中的单个 MedicalDataSource。您还必须为每个资源分配新的 ID 以避免冲突，并更新资源引用以指向新 ID。
  • 将来自多个来源的数据合并到单个 MedicalDataSource 中可能会掩盖数据来源。由于数据使用者通常需要了解数据的来源，因此我们建议为每个资源的 meta.source 字段填充记录的原始来源（通常是 FHIR 基本网址）。