顺利处理 FHIR 流程

了解 FHIRModels 如何为所有 FHIR 资源创建本机数据模型，如何提供数据验证从而增强资源完整性，并防止在 FHIR 规范的多个版本中创建结构无效的资源。无论你是要处理从 HealthKit 获得的临床数据还是直接从临床系统获取的数据，FHIRModels 都能让操纵 FHIR 更简单。

资源

相关视频

WWDC21

探索可验证的健康记录

WWDC20

下载

（你好 WWDC 2020）

你好欢迎参加 WWDC （顺利处理 FHIR 流程）你好我叫 Pascal 我今天要讲的是如何顺利处理 FHIR 流程你可能已经知道自 2018 年初起健康 app 开始支持快捷式医疗服务互操作资源将临床数据下载到你的电话上此类资源有个更广为人知的名字即 FHIR

这一功能的实现需要归功于 HL7 和 SMART 团队制定的开放标准健康 app 所利用的正是这一系列标准

来回顾一下吧对我们而言一切始于健康 app 健康 app 会直接与健康服务提供商的 API 建立安全连接

然后将 FHIR 数据直接下载到 iOS 设备上

这些数据被安全存储到 HealthKit 中使来自多个机构的数据得以聚合然后你便可以通过 HealthKit API 来访问这些数据了

下载结束时经过整理的临床数据会干净地呈现在健康 app 中（健康记录）现在我们来看一看你的 app 是如何获取这些 FHIR 数据并配合它进行工作的

首先你的 app 会要求用户授权

用户需要经过三个画面的引导来完成授权流程

第一个画面显示的是有关授予访问权限时所需内容的一般信息接着是你在 app 的 Info.plist 中提供的解释性文本同时附上了隐私政策的链接

没错我们会审核你的隐私政策

在这个药物清单 app 的简单例子里它只要求获得访问药物的权限这符合我们的数据使用原则即“与你的需求成正比” 最后在默认状态下只有设备内现有的数据才会与你的 app 分享因此你每一次查询 FHIR 数据时都要请求授权以便确保用户有机会在适用情况下向你的 app 授予访问新数据的权限如果没有需要授权的内容则表格不会出现

关于此流程的更多详情请参见我们 2018 年的 WWDC 讲座（使用 HealthKit 访问健康数据）现在你的 app 已经有权限访问临床健康记录了下面我们就来进一步了解一下 FHIR 数据这是一个简化版的 FHIR 处方资源里面有各种各样的字段类型简单的字符串只能采取特定值的字符串所谓的代码

以类似 ISO-8601 的格式呈现在字符串中的日期与时间诸如布尔数据和数字等其他基元类型以及由图元组成的复杂嵌套结构

在此之前如果你想处理本机格式的 FHIR 数据那么你必须要自己去编写 Swift 可编码如果你只想查看特定的数据元素并且你知道这些数据是统一的这个过程似乎还是很简单的在这个例子里你只想查看某个处方的状态、日期和它所涉及的药物

但很快你就会意识到 FHIR 资源的深度、复杂性甚至其数量之繁多只要你去深入探究这个处方资源的完整定义没错你应该不会想要自己一个人完成如此繁重的建模工作

那么我们怎样才能帮助你处理 FHIR 数据呢？

下面要介绍的是 FHIRModel FHIRModel 是一种开源 Swift 套件可以通过 GitHub 下载它可以让你提交问题请求特性提供一般性的反馈意见它对多个 FHIR 版本均提供了支持并为其中一个版本内的所有资源提供了数据模型

编码和解码时会强制要求资源完整性以免你创建出结构性无效的资源

它会进行日期/时间解析通过枚举来强制执行代码字段通过枚举来强制执行 value 多态属性除此之外还有很多

当然我们会随时对该套件进行更新让它能支持新版本的 FHIR 和 Swift

该套件自带 DSTU2、R4 和最新构建版本的资料库我们会随时为新出现的版本添加支持

该套件由 CareKit 的朋友们联合主管可以通过 GitHub 下载

下面我们来讲一下 FHIR

这串代码讲的是在通过 HealthKit API 获取临床数据后如何利用这些数据建构一套成熟的 FHIR 数据模型首先从 FHIRModel 套件中导入 HealthKit 和 DSTU2 资料库

从 HealthKit 中取得 HKClinicalRecord 以及和它相关联的 HK fhirResource 你可以查看 HK fhirResource 以确认它的类型

解析该资源的 JSON 数据在此情况我们要接收一个 MedicationOrder 实例然后你便可以打印 note 语句了

我们来让它变得更复杂一点用一个深层嵌套结构将剂量说明与和它相关的日期范围一起呈现出来

首先编写一个 TimingRepeat 的扩展 TimingRepeat 是 FHIRModel 所提供的一个类型我们想提取这段限定时期的开始日期和结束日期

在现实世界中最好让它的适用范围变得更加广泛例如检查可空类型使用一个好的旧日期 formatter 等

然后映射该处方剂量说明的全部内容

使用你的新扩展来给这些说明加上一个日期范围作前缀这个日期范围代表这些说明的有效期

FHIR 还有一个有趣的地方那就是目前人们所使用的版本不一 2014 年秋天发布了首个标准草案也就是 DSTU1 供开发者们试用（FHIR 的各个版本）之后又陆续发布了三个主要版本这是截止到目前的情况

很快第五版也将面世然而正如我之前所提到的当新版本发布时现有的 API 并不会自动更新你很可能会想要为比较流行的版本多提供几年的支持特别是 DSTU2

那么我们就来看一看如何通过 FHIRModel 来为多个 FHIR 版本提供支持吧

首先从 FHIRModel 中导入合适的资源库

然后假设你有一个 FHIRRelease 枚举里面有你想要支持的所有 FHIR 版本需要用到的数值请先切换版本然后再使用 JSON 解码器辅以合适的模型类型我们对 DSTU2 使用 MedicationOrder 对 R4 使用 MedicationRequest 最后浏览相应的属性以便抵达你想要提取的数值通过 FHIRModel 能够做到的事情还远远不止于此

一句话总结 FHIRModel 可以帮助你处理复杂的 FHIR 资源甚至各个 FHIR 版本

在处理通过 HealthKit API 获取的临床数据时请使用该套件

此外也请看一看《Carekit 有哪些更新》了解一下如何搭配使用 FHIR 和 CareKit 来构建护理类的 app

或是利用这个套件来增强你自己的独立 FHIR app

你能做的有以下这些克隆整个资料库将它添加到你的项目里然后开始探索代码

提交问题哪怕你只是想提供反馈意见或是提出一些疑问

获取我们的样例 app 它会告诉你如何将 FHIRModel 与一个使用 HealthKit API 的 app 相整合

你可以访问 chat.fhir.org 来进一步了解 FHIR 和发表你自己的意见

感谢观看祝你代码写得愉快

4:32 - Use FHIRModels with Health Records FHIR data from HealthKit

// Use with Health Records FHIR data from HealthKit
import HealthKit
import ModelsDSTU2

// Grab HKClinicalRecord from HealthKit API
let clinicalRecord: HKClinicalRecord
let resource = clinicalRecord.fhirResource!

// Print the prescription note
let decoder = JSONDecoder()
let prescription = try decoder.decode(MedicationOrder.self, from: resource.data)
print("\(prescription.note)")

5:04 - Use FHIRModels with Health Records FHIR data from HealthKit, part 2

// Make using "TimingRepeat" period dates easier by writing an extension
extension TimingRepeat {
    var periodDisplayString: String? {
        if case .period(let period) = bounds {
            return "\(period.start) - \(period.end)"
        }
        return nil
    }
}

// Collect all dosage instructions on medication prescriptions
let instructions: [String] = prescription.dosageInstruction?.map { dosage in
    guard let period = dosage.timing?.repeat?.periodDisplayString else {
        return "\(dosage.text)"
    }
    return "\(period): \(dosage.text)"
}

6:20 - Supporting multiple FHIR releases

// Supporting multiple releases
import ModelsDSTU2
import ModelsR4

let decoder = JSONDecoder()
let release: FHIRRelease
let data: Data

let note: String? = nil
switch release {
case .dstu2:
    let model = try decoder.decode(ModelsDSTU2.MedicationOrder.self, from: data)
    note = model.note?.value?.string
case .r4:
    let model = try decoder.decode(ModelsR4.MedicationRequest.self, from: data)
    note = model.note?.compactMap({ $0.text.value?.string }).joined(separator: "\n")
default:
    note = "Unsupported FHIR release \(release)"
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。