FHIRlink
Microsoft FHIRlink 會在建置在 Microsoft Azure 服務上的醫療保健應用程式與 FHIR 伺服器之間建立直接連線,無需從 Microsoft Dataverse 複製資料。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft Cloud for Healthcare |
| URL | https://www.microsoft.com/en-us/industry/health/microsoft-cloud-for-healthcare |
| microsoftcloudforhealthcare@service.microsoft.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft Cloud for Healthcare |
| 網站 | https://www.microsoft.com/en-us/industry/health/microsoft-cloud-for-healthcare |
| 隱私策略 | https://privacy.microsoft.com/en-us/privacystatement |
| 類別 | 資料 |
Microsoft FHIRlink 會在以 Microsoft Azure 服務和 FHIR 服務為基礎的醫療保健應用程式之間建立直接連線,無需從 Microsoft Dataverse 複製資料。
FHIRlink 可降低在 Power Platform 和 Azure 上建置低程式碼/無程式碼應用程式的複雜性和成本,因為開發人員可以直接針對 FHIR 服務建置應用程式,而不必在系統之間複製資料。 將 Power Automate 流程、Power Platform 畫布應用程式和 Azure Logic Apps 連線到各種 FHIR 服務,並直接在 FHIR 資源上執行建立、擷取、更新和刪除作業。
如需如何設定和使用 FHIRlink 連接器的詳細資訊,請流覽 Microsoft Learn 網站上的 設定 FHIRlink 連接器 。
支援的服務提供者
Microsoft FHIRlink 連接器可與:
- Azure Health Data Services FHIR 服務 - Azure Health Data Services 是雲端式解決方案,可協助您從不同來源和格式收集、儲存及分析健康情況資料。
- 適用於 HL7® FHIR® 的 Google Cloud™ Healthcare API 服務 - Google 的 FHIR API。
- Fhir® 上的 Epic® - Epics 的 FHIR API 服務。
先決條件
您將需要以下內容才能繼續:
- Microsoft Azure 訂用帳戶和 Azure Health Data Services FHIR® 服務實例,或
- 適用於 HL7® FHIR® 的 Google Cloud 訂閱和 Google Cloud™ Healthcare API 服務,或
- FHIR® 訂閱的 Epic®
每個服務都需要系統管理存取權,才能設定必要的應用程式註冊,以進行驗證,以及設定具有適當 FHIR 服務存取權的使用者帳戶。
FHIR、® Google 和 Epic® 分別是 Health Level Seven International 和 Epic Systems Corporation 擁有的註冊商標。 在此頁面上使用這些商標並不構成 Health Level Seven International 或 Epic Systems 的認可。
正在建立連線
連接器支援下列驗證類型:
| 自備 Epic® on FHIR® 應用程式 | 使用您自己的 Epic® on FHIR® 應用程序登錄。 | 所有區域 | 不可共享 |
| 自備 Google 應用程式 | 使用您自己的 Google 應用程式登入。 | 所有區域 | 不可共享 |
| 使用預設的 Microsoft Azure 共用應用程式 | 使用標準 Microsoft Azure 應用程式登入。 | 所有區域 | 不可共享 |
| 預設值 [已棄用] | 此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。 | 所有區域 | 不可共享 |
自備 Epic® on FHIR® 應用程式
驗證 ID:byoa-epic
適用:所有地區
使用您自己的 Epic® on FHIR® 應用程序登錄。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| FHIR® API URL 上的 Epic® | 字串 | FHIR® API URL 上的 Epic®。 例如,'https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4' | 對 |
| 用戶端識別碼 | 字串 | 您的 Epic® on FHIR® 應用程式的用戶端 (或應用程式) 識別碼。 | 對 |
| 用戶端密碼 | securestring | Epic® on FHIR® 應用程式的用戶端密碼。 | 對 |
| 授權 URL | 字串 | 提供您的 Epic® on FHIR® 授權 URL | 對 |
| 權杖 URL | 字串 | 提供您的 Epic® on FHIR® 權杖 URL | 對 |
| 權杖重新整理 URL | 字串 | 提供 Epic® on FHIR® 權杖重新整理 URL | 對 |
自備 Google 應用程式
身份驗證 ID:byoa-google
適用:所有地區
使用您自己的 Google 應用程式登入。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 適用於 HL7® FHIR® 端點 URL 的 Google Cloud™ Healthcare API 服務 | 字串 | 適用於 HL7® FHIR® 端點 URL 的 Google Cloud™ Healthcare API 服務。 例如,'https://healthcare.googleapis.com/{{fhirservicepath}}/fhir' | 對 |
| 用戶端識別碼 | 字串 | Google 應用程式的用戶端 (或應用程式) ID。 | 對 |
| 用戶端密碼 | securestring | Google 應用程式的用戶端密碼。 | 對 |
使用預設的 Microsoft Azure 共用應用程式
驗證識別碼:azure-shared-app
適用:所有地區
使用標準 Microsoft Azure 應用程式登入。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Azure Health Data Services FHIR 服務端點 URL | 字串 | Azure Health Data Services FHIR 服務端點 URL。 例如,'https://{{fhirservicename}}.fhir.azurehealthcareapis.com' | 對 |
| Azure Health Data Services FHIR 服務資源 URI | 字串 | Microsoft Entra ID 中用來識別目標 FHIR 服務資源的識別碼。 通常針對 Azure Health Data Services FHIR 服務,URI 類似於 'https://{{fhirservicename}}.fhir.azurehealthcareapis.com' | 對 |
預設值 [已棄用]
適用:所有地區
此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 依類型列出資源 |
列出指定資源類型的資源項目。 |
| 修補資源 |
依識別碼修補資源 |
| 刪除資源 |
依識別碼刪除資源 |
| 取得資源 |
依識別碼取得資源 |
| 建立資源 |
建立指定類型的新資源 |
| 更新或建立資源 |
更新或建立指定類型的資源 |
| 檢索所有患者信息 |
檢索與患者相關的所有信息 |
依類型列出資源
列出指定資源類型的資源項目。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資源類型
|
resourceType | True | string |
透過 restful 介面公開的資源類型。 |
|
_id
|
_id | string |
指定要搜尋的資源識別碼。 |
|
|
_elements
|
_elements | string |
要傳回為資源一部分的元素名稱的逗點分隔清單。 |
|
|
_般
|
_sort | string |
指定應傳回的順序結果。 |
|
|
_算
|
_count | number |
數字,以限制每頁回應的比對結果。 |
|
|
_括
|
_include | string |
根據跨參考文獻的以下鏈接,包括其他資源。 |
|
|
_revinclude
|
_revinclude | string |
根據跨參考的下列反向連結,包含其他資源。 |
|
|
_總
|
_total | string |
指定要求結果總數的精確度。 |
|
|
_摘要
|
_summary | string |
根據預先定義的層級,僅傳回部分資源。 |
|
|
其他參數
|
additionalParameters | string |
提供以查詢字串表示的其他 FHIR 查詢參數,這可以包含頁面權杖和進階搜尋篩選。 範例: |
修補資源
依識別碼修補資源
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資源類型
|
resourceType | True | string |
透過 restful 介面公開的資源類型。 |
|
資源識別碼
|
id | True | string |
要執行作業的資源識別碼 |
|
內容類型
|
contentType | True | string |
承載內容類型 |
|
修補程式資源類型
|
resourceType | string |
FHIR 修補程式資源的資源類型。 |
|
|
作業清單
|
parameter |
要對指定資源執行的作業清單。 |
刪除資源
依識別碼刪除資源
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資源類型
|
resourceType | True | string |
透過 restful 介面公開的資源類型。 |
|
資源識別碼
|
id | True | string |
要執行作業的資源識別碼 |
取得資源
依識別碼取得資源
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資源類型
|
resourceType | True | string |
透過 restful 介面公開的資源類型。 |
|
資源識別碼
|
id | True | string |
要執行作業的資源識別碼 |
建立資源
建立指定類型的新資源
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資源類型
|
resourceType | True | string |
透過 restful 介面公開的資源類型。 |
|
FHIR 資源 JSON
|
body | True | string |
包含 FHIR 資源 JSON 資料的承載。 |
更新或建立資源
更新或建立指定類型的資源
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資源類型
|
resourceType | True | string |
透過 restful 介面公開的資源類型。 |
|
資源識別碼
|
id | True | string |
要執行作業的資源識別碼 |
|
If-Match
|
If-Match | string |
If-Match 要求標頭。 |
|
|
FHIR 資源 JSON
|
body | True | string |
包含 FHIR 資源 JSON 資料的承載。 |
檢索所有患者信息
檢索與患者相關的所有信息
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
病患識別碼
|
patientId | True | string |
您要擷取資訊之病患資源的識別碼。 |