Epic EHR 設定

本頁面說明如何在建立 Epic EHR 資料儲存庫之前，註冊及設定 Epic 應用程式。貴機構註冊自己的 Epic 應用程式。Epic 分析師通常會完成這些步驟。

註冊 Epic 應用程式

在 Epic on FHIR 中註冊 Gemini Enterprise 應用程式，並在 Epic 環境中提供。請使用下列設定：

設定 值
應用程式目標對象 臨床醫事人員或管理員使用者
傳入 API 「啟用 Epic API」中列出的 R4 API
傳出 API 無
這個應用程式會註冊動態用戶端嗎？ 否
是否為機密用戶端 是
需要長期存取權 是
使用輪替更新權杖 是
JWK 集網址 留空
SMART on FHIR 版本 R4
SMART 範圍版本 SMART v1
FHIR ID 產生配置 對 USCDI FHIR 資源使用 64 個字元限制的 FHIR ID

貴組織對應用程式的永久存取權設定，會決定使用者授權的效期。結束後，使用者必須再次授權連接器。

設定重新導向 URI

在應用程式中，註冊下列兩個重新導向 URI (請務必與下方顯示的內容完全一致)：

  • https://vertexaisearch.cloud.google.com/oauth-redirect
  • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html

啟用 Epic API

在應用程式中，為下列 FHIR 資源啟用 R4 讀取和搜尋 API：Patient、Observation、Condition、MedicationRequest、AllergyIntolerance、DiagnosticReport、DocumentReference、Binary、Encounter、ServiceRequest、Coverage、Immunization 和 Procedure。

部分資源 (例如 Observation 和 Condition) 的每個類別 (例如實驗室和生命徵象) 都有獨立的 API。啟用要讓使用者查詢的類別。請勿啟用寫入 API。

如果未啟用 API，只有使用該 API 的動作會失敗。

取得用戶端 ID 和用戶端密鑰

Epic 會為應用程式核發非正式環境用戶端 ID 和正式環境用戶端 ID。請根據網址指向的 Epic 環境，使用相應的用戶端 ID。由於應用程式是機密用戶端，因此也具有用戶端密鑰。建立資料儲存庫時，請輸入用戶端 ID 和用戶端密鑰。

尋找 Epic 端點

如要建立資料儲存庫，您需要 Epic 環境中的三個網址：FHIR R4 基準網址、授權網址和權杖網址。Epic 分析師可以提供這些資訊。貴組織的 SMART 設定 (位於 FHIR_BASE_URL/.well-known/smart-configuration) 也會列出授權網址 (authorization_endpoint) 和權杖網址 (token_endpoint)。請將 FHIR_BASE_URL 替換為 FHIR R4 基準網址。

輸入每個網址時，請加上 https://，且結尾不要加上斜線。舉例來說，Epic 的公開沙箱使用下列網址：

網址 Epic 沙箱範例
FHIR R4 基準網址 https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
授權網址 https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
權杖網址 https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

疑難排解

下表列出常見問題和解決方法：

問題 解析度
控制台會顯示下列其中一則訊息：
  • 「Epic FHIR R4 網址必須是 https:// 網址，且結尾不得為斜線。」
  • 「Epic 授權網址必須是 https:// 網址，且結尾不得有斜線。」
  • 「Epic 權杖網址必須是 https:// 網址，且結尾不得有斜線。」
 輸入網址時，請加上 https://，且結尾不要加上斜線。
控制台顯示「無法取得更新權杖」。 在 Epic 應用程式中，選取「Is Confidential Client」和「Requires Persistent Access」，然後儲存變更。接著，在 Google Cloud 控制台中，再次點選「Verify Auth」(確認你的身分)。
Epic 回報重新導向 URI 不符。 請按照「設定重新導向 URI」一節中的說明，如實註冊兩個重新導向 URI。
Epic 在登入時顯示「OAuth 2.0 要求無效」。 每個 Epic 登入連結只能使用一次，因此重新載入登入視窗時，系統會顯示這則錯誤訊息。關閉視窗，然後重新登入，不要重新載入。如果錯誤持續發生，請確認應用程式具備要求範圍的 API。
史詩級回歸invalid_client。 用戶端 ID 或用戶端密鑰有誤、含有多餘空格，或屬於其他 Epic 環境。輸入網址指向環境的用戶端 ID 和用戶端密鑰。
登入視窗未返回 Gemini Enterprise，或登入後未授權連接器。 請關閉登入視窗，重新載入 Gemini Enterprise，然後再次授權連接器。
一個動作失敗，其他動作正常。 該動作的 Epic API 未啟用。請在應用程式中啟用，然後要求使用者再次授權連接器。
Gemini Enterprise 說：「很抱歉，您似乎沒有執行這項作業的權限。Please contact an administrator.」 使用者的 Epic 授權已結束。使用者再次授權連接器。
Gemini Enterprise 不會依姓名尋找病患。 請新增出生日期，或使用 MRN 或 Epic 病患 ID。
Gemini Enterprise 表示無法擷取部分記錄。 Epic 安全性會對使用者隱藏這些記錄。使用者只能查看 Epic 允許他們查看的記錄。
無法取得報告或附註的文字。 文件為 PDF 或連接器無法讀取的其他格式。在 Epic 中開啟文件。
只有一個應用程式授權失敗。 從應用程式中移除 Epic EHR 資料儲存庫，然後重新加入並再次授權連接器。

後續步驟