個人健康記錄 (PHR) 資料會以 HL7 FHIR 格式儲存。
PHR 支援下列快速醫療照護互通資源 (FHIR) 版本：
醫療資源類型
FHIR 是由一組稱為「資源」的模組化元件組成。支援的 FHIR 資源組合和對應類別大致根據國際病患摘要章節。
這些資源會對應至 Health Connect 中的資料類別，在 API 中稱為醫療資源類型。觀察資源會根據內容 (例如 Logical Observation Identifiers Names and Codes (LOINC) 代碼和 FHIR 類別) 進行對應。
不屬於上述任何類別的觀察結果不會寫入 Health Connect。
| Health Connect 醫療資源類型 | FHIR 資源 |
|---|---|
| 過敏 | 過敏/不耐症 |
| 健康狀況 | Condition |
| 實驗室 | 觀察事項
|
| 藥物 | Medication、MedicationRequest、MedicationStatement |
| 個人資訊 | 病患 |
| 醫事人員詳細資料 | 醫事人員、醫事人員角色 |
| 懷孕 | 觀察事項
|
| 醫療程序 | 流程 |
| 個人社會史 | 觀察事項
|
| 疫苗 | 免疫接種 |
| 就醫記錄 | 接觸、地點、機構 |
| 生命徵象 | 觀察事項
|
病患資源
Health Connect 目前只會儲存單一使用者的個人健康記錄資料。因此，所有 FHIR 資源都應屬於同一個使用者。
在單一系統中，為單一個人提供多個 FHIR 病患資源並不少見。建議應用程式將資料進行對照，並將單一病患資源寫入 Health Connect。不過，這並未強制執行，以便因應可能存在的不同組織架構。
資料驗證
PHR API 會接受支援版本的有效 FHIR 資源，Health Connect 會執行一些驗證，確認每個支援版本都遵循 FHIR 規格。
標示為「即將推出」的驗證檢查項目尚未強制執行，但會在日後的版本中實施。建議您根據所有列出的驗證檢查進行開發，以便與日後版本相容。
| 等級 | 驗證檢查 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 有效的 JSON | 資料符合 JSON 格式。 | ||||||||
| 支援的 FHIR | 系統支援寫入應用程式宣告的 FHIR 版本。Health Connect 支援下列 FHIR 版本：
|
||||||||
| 支援的 FHIR | 支援在資源例項中記錄的 FHIR 資源類型。 Health Connect 支援下列 FHIR 資源類型：
|
||||||||
| 不重複的資源 ID | 資源的 ID 欄位值符合規則運算式規定。 | ||||||||
| 不重複的資源 ID | 資源不會與相同 MedicalDataSource 中其他相同資源類型的 FHIR 資源共用 ID。 |
||||||||
| 業務規則 | 不包含所含 FHIR 資源。包含的資源是巢狀在「父項」資源中的 FHIR 資源。當父項資源需要參照另一項資源，但系統沒有足夠資訊可將這項資源建立為獨立存在的獨立資源時，就會使用這些屬性。 | ||||||||
| 有效的基礎 FHIR | FHIR JSON 中的頂層欄位會出現在指定資源類型的 FHIR 規格中。 | ||||||||
| 有效的基礎 FHIR | 頂層欄位沒有 JSON 空值。 | ||||||||
| 有效的基礎 FHIR | 頂層必填欄位都已填妥。 | ||||||||
| 有效的基礎 FHIR | 頂層欄位若定義為 FHIR 中的重複元素，則會採用 JSON array 資料類型。 |
||||||||
| 有效的基礎 FHIR | 在 FHIR 中，頂層欄位 (包括 JSON array 中的元素) 定義為複雜類型，因此具有 JSON object 資料類型。 |
||||||||
| 有效的基礎 FHIR | 在 FHIR 中，定義為原始類型的頂層欄位 (包括 JSON array 中的元素) 具有正確的 JSON 資料類型。
|
||||||||
| 有效的基礎 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 R4 規格，未經轉換和已轉換的 FHIR 資料都可以寫入 Health Connect。建議您盡可能寫入轉換後的資料。但請注意以下幾點：
- 應用程式如果用途狹隘，可能會篩除生態系統中其他應用程式可為使用者創造價值的大量記錄。在這種情況下，編寫未轉換的 FHIR 可能會更完整。不過，請務必告知使用者您要分享這項更廣泛的資料集。
- 如果要合併來自不同來源的資料，您可以將資料寫入 Health Connect 中的單一
MedicalDataSource。您也必須為每個資源指派新的 ID，以免發生衝突，並更新資源參照，指向新的 ID。 - 將來自多個來源的資料合併至單一
MedicalDataSource可能會掩蓋資料來源。資料使用者通常需要瞭解資料來源，因此建議您為每個資源的meta.source欄位填入記錄的原始來源 (通常是 FHIR 基礎網址)。