PHR - Android 架構 API

Health Connect Jetpack SDK 通常用於透過包裝 Health Connect API 來簡化整合作業,但 Jetpack 尚未提供 PHR,因此必須使用底層 Android 架構 API。

由於這些 API 仍在開發中,因此仍有部分限制,且無法完全使用某些元件。

  • 個人健康記錄存取權的 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 自動衍生。
    • 如前所述,初始類型集合