失敗せずにFHIRを扱う

FHIRModelsが、すべてのFHIRリソースにネイティブデータを作成する方法、リソースの整合性を確実にし、FHIRスペックの複数のバージョンにわたり構造的に無効なリソースが作成されるのを防ぐ方法をお伝えします。診療データをHealthKitから入手しても、診療システムから直接入手しても、FHIRModelsがあればFHIRの扱いが容易になります。

リソース

関連ビデオ

WWDC21

検証可能な医療記録の詳細

WWDC20

ダウンロード

こんにちは　ようこそWWDCへ “失敗せずにFHIRを扱う” パスカルです　このセッションは “失敗せずにFHIRを扱う”です 2018年の初めからHealthアプリケーションは医療情報交換の標準規格に対応しており “FHIR”というこの規格に基づき臨床データをダウンロードできます

これはHL７とSMARTチームによるオープン規格のおかげで実現しました

すべての始まりはHealthアプリケーションです HealthはヘルスプロバイダーのAPIへ安全な接続を確立し FHIRデータをiOS端末に直接ダウンロードします

HealthKit内に安全に保管されるデータは複数の機関から集められますそしてHealthKit API経由でこれらは入手できます

ダウンロードするとHealthアプリケーション上に臨床データが並んで表示されます

ではアプリケーションでFHIRデータを取得して扱う方法を見てみましょうまずアプリケーションはユーザーにアクセス許可を要求します

ユーザーは３つの画面で許可を求められます１つ目の画面ではアクセス許可に伴う一般的な情報が表示されます

次にアプリケーションのInfo.plistに入れた説明文がプライバシーポリシーへのリンクと共に表示されますプライバシーポリシーは私たちがレビューしますこの投薬リストアプリケーションの単純な例では薬剤へのアクセスのみが要求されます “必要なデータのみにアクセスする”という原則に従っているのですアプリケーションとデフォルトで共有できるのは端末に既存のデータのみです FHIRデータを問い合わせる度にアクセス許可を要求してください新しいデータへのアクセスをユーザーが許可するようにするのです許可の必要がない場合シートは表示されません

このプロセスの詳細は 2018年のWWDCをご覧ください

臨床ヘルスレコードにアクセス可能になったら次はFHIRデータを見てみましょうこれはFHIR処方箋リソースの簡略版で様々なフィールドタイプがありますシンプルな文字列やコードという特定の値だけの文字列日付と時間の ISO 8601 1に似た書式の文字列ブール値や数値など他のプリミティブ型があり複雑な入れ子構造が成されています以前はネイティブ形式でFHIRデータを扱う際 Swift Codableを書き込む必要がありました特定のデータ要素を見るだけでデータが均一なら簡単そうに思えます例えばここでは処方箋の状況日付薬剤を見たいだけです

しかしFHIRリソースの深さや複雑さそして数の多さにすぐ気づくでしょうこちらが処方箋リソースの定義すべてですご自身でこのモデルを作りたくはないでしょう

ではFHIRデータの使用を助ける FHIRModelsを紹介しますこれはGithubで入手可能なオープンソースのSwiftパッケージです問題の報告や機能のリクエストフィードバックを送ることができます複数のFHIRリリースに対応しており全リソースのデータモデルがありますエンコードとデコードのリソース完全性が強制され構造的に無効なリソース作成を防ぎます日付と時間のパースやコードフィールドを強制するenum value xの多相プロパティを強制するenumなどです新しいFHIRとSwiftリリースでパッケージは最新の状態を保ちますパッケージにはDSTU２やＲ４最新ビルドリリースのライブラリが含まれます新しいリリースが出たらサポートは追加されます

これはCareKitと共に Githubで入手可能です

ではFHIRを使ってみましょう

HealthKit APIで得た臨床データから本格的なFHIRデータモデルを取得する方法ですまずFHIRModelsパッケージから HealthKitとDSTU２ライブラリをインポート HealthKitからHKClinicalRecordと付随するfhirResourceを得ます fhirResourceの型は調べれば分かります

リソースのJSONデータをパースして MedicationOrderインスタンスを受け取るとノートを出力できます

少し難しくなりますが複雑な入れ子構造から投薬量の指示とそのデータ範囲を一緒に表示しましょう

まずTimingRepeatに extensionを書き込みますこれはFHIRModelsにある型です bounds periodの startとendの日付を拡張します実際にはNull許容型のチェックや確実なDateFormatterなどもっと拡張性を持たせた方がよいでしょう次に処方箋の投薬量の全指示をマッピングします新しいextensionを使ってこれらの指示が有効だった日付範囲のものにprefixを付けます

色々なリリースが使用されているのも FHIRの面白さです 2014年の秋ドラフト第１弾のDSTU１が試験的にリリースされましたその後これまでにメジャーリリースが３回ありました

まもなくリリース５が出る予定ですしかし新しいリリースの発行時に既存のAPIは自動更新されません人気の高いDSTU２のサポートがあと数年は望まれることでしょうでは FHIRModelsで複数のFHIRリリースに対応する方法ですまずFHIRModelsから適切なライブラリをインポートサポートしたい全FHIRリリースの値を持つ FHIRRelease enumがあるとしてリリースを切り替え適切なモデル型でJSONデコーダを使いますここではDSTU２にはMedicationOrderをＲ４にはMedicationRequestを使いますそれぞれに適したプロパティにして抽出したい値に達します FHIRModelsでは他にも多くのことが可能です

FHIRModelsは複雑なFHIRリソースや FHIRリリースの扱いも手助けします HealthKit APIで得た臨床データを扱うにはこのパッケージをご使用ください “What's new in CareKit”をご覧になれば CareKitとFHIRでのケアアプリケーションの作成方法が分かりますもちろん独自のFHIRアプリケーションの強化にもこのパッケージをご活用ください

ライブラリのクローンを作成しプロジェクトに追加してコードの探索を始めましょう問題の報告やフィードバック質問をお寄せくださいサンプルアプリケーションを入手すれば HealthKit APIを用いたアプリケーションでの FHIRModelsの統合方法が分かりますまた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)"
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。