針對 Microsoft Teams EHR 連接器設定和設定進行疑難排解

  • 發行項
  • 適用於:
    Microsoft Teams, Microsoft 365 for frontline workers

本文提供如何針對 Microsoft Teams 電子健康記錄 (EHR) 連接器的常見設定和設定問題進行疑難排解的指引。 使用它來協助解決當您設定 EHR 連接器以與 Oracle Health EHR 或 Epic EHR 系統整合時可能會遇到的封鎖程式。

FHIR URL 無法運作

當我嘗試設定 EHR 連接器時，收到「FHIR URL 無效」錯誤

此問題可能會在下列案例中發生：

  • FHIR 基底 URL 缺少 DSTU2 擴充功能，且您使用的是 Teams 1.1 或 1.2 版。
  • FHIR 基底 URL 缺少 R4 擴充功能，且您使用的是 Teams 1.3 版。

請連絡 Epic 技術專家以提供完整的 FHIR 基底 URL。

我是 Epic 分析師，當我嘗試核准 FHIR URL 時，收到 Epic 的「OAUTH2」錯誤

如果 Epic 實例中未設定金鑰，或 Epic 未完成 OAuth 設定，就會發生此問題。 請連絡 Epic 技術專家。

我是 Epic 分析師，當我嘗試在 EHR 連接器設定入口網站中核准 FHIR URL 時，我無法使用 Epic 認證登入 Epic

您的許可權必須在 Epic 中變更。 請連絡 Epic 技術專家以檢查並更新您的許可權。

無法啟動虛擬約會

我第一次設定 EHR 連接器，而病患無法從病患入口網站啟動虛擬約會

以下是您可能會遇到此問題的一些常見原因，以及如何解決此問題。

Epic 中的 FDI 記錄不符合 EHR 連接器設定入口網站中的值

啟動 URL 和內容權杖必須從 EHR 連接器設定入口網站 複製到 Epic 中的 FDI 記錄。 請連絡貴組織的 Epic 分析師，確認已正確複製值。 請記住，在某些情況下，允許從 EHR 連接器設定入口網站複製 FDI 記錄之後操作它們。

FDI 記錄不會在正確的 Epic 環境中更新

Epic 中測試和生產環境的 FHIR 基底 URL 不同。 檢查以確定 FDI 記錄反映正確環境的值。

您使用的是生產環境，而且沒有生產授權

您的組織至少必須有一個作用中授權Microsoft Cloud for Healthcare、Microsoft Teams EHR 連接器附加元件或 Microsoft Teams EMR 連接器附加元件。 對於 Oracle Health 客戶，測試也需要授權。

使用者在啟動虛擬約會時收到「找不到租使用者設定」錯誤，即使我們所有的 FHIR 基底 URL 都已正確設定

如果使用者不小心使用測試 FHIR 基底 URL 在 EHR 生產環境中啟動虛擬約會，就會發生此問題，反之亦然。

若要解決此問題：

  • 請確定生產 FHIR 基底 URL 僅用於在生產環境中啟動虛擬約會。
  • 讓測試 FHIR 基底 URL 僅用於在測試環境中啟動虛擬約會。

群組造訪

我的組織中的群組造訪無法運作

目前，只有 Epic 支援群組造訪。

以下是您在與 Epic 整合時可能會遇到此問題的一些常見原因，以及如何解決此問題。

  • 您使用的 Teams 版本不正確。 群組造訪至少需要 Teams 1.2 版，而且必須在 Epic Connection Hub 中要求升級。
  • 必須新增新的 FDI 記錄。 Epic 分析師必須為群組造訪建立新的 FDI 記錄，以支援提供者和病患加入體驗。 此外，您必須將群組中的內容權杖從 流覽 FDI 記錄變更為 sessionId=%CSN%sessionId=%CONFERENCEID% 。 請連絡 Epic 技術專家以取得協助。
  • 如果您在嘗試此清單中的先前步驟之後仍然遇到此問題，則可能需要變更您的租使用者設定。 請連絡Microsoft 支援服務以開啟 Teams EHR 連接器的支援票證。 在票證中指出必須啟用群組設定。

提供者體驗

當病患加入虛擬約會時，提供者不會收到 Teams 通知

這通常可以透過定型來解決。 當提供者啟動虛擬約會時，會向提供者顯示暫時通知以准許病患。 此通知只會短暫出現。

提供者也可以在畫面頂端的會議控制項中選取 [人員]，以查看參與者清單，然後在大廳的 [等候]底下，選取參與者名稱旁邊的綠色核取記號來准許他們。

病患體驗

系統會提示患者下載 Teams 應用程式，而不是從網頁瀏覽器加入。 我們希望病患從網頁瀏覽器加入，而不需要安裝 Teams

請連Microsoft 支援服務並開啟 Teams EHR 連接器的支援票證。 在票證中指出必須開啟網頁瀏覽器聯結設定。 這項變更必須由 Teams EHR 連接器小組完成。

開啟網頁瀏覽器加入設定之後，病患就可以在瀏覽器中加入虛擬約會，而不需要安裝 Teams。

在虛擬約會從約會內結束之後，病患可以將聊天訊息傳送給 Teams 中的提供者。 如何封鎖此功能？

此案例可能會因為數個原因而發生。

提供者離開約會，但未結束

如果提供者離開約會，但未結束約會，而且病患仍留在約會中，則兩者都可以繼續聊天。 若要防止病患傳送聊天訊息，提供者必須選取 [在 Teams 中 結束會議 ] 以結束約會。

網頁瀏覽器加入設定已關閉，同時也是您組織員工的病患會使用其工作認證加入 Teams 應用程式

如果病患是貴組織的員工，而且他們使用其工作認證透過 Teams 應用程式加入約會，他們就會以貴組織的成員身分加入約會，而不是以來賓身分加入約會。 這表示即使在約會結束後，他們還是可以傳送聊天訊息。

若要避免這種情況，您可以執行下列其中一個動作：

  • 請連Microsoft 支援服務並開啟 Teams EHR 連接器的支援票證。 在票證中指出必須開啟網頁瀏覽器聯結設定。 這項變更必須由 Teams EHR 連接器小組完成。
  • 訓練員工在以病患身分參加約會時，不要使用其工作認證登入 Teams。

管理員體驗

我無法存取 EHR 連接器設定入口網站，或我只能查看現有的設定，而且無法新增新的設定

您沒有 EHR 連接器設定入口網站的系統管理員存取權。 快速檢查您是否可以存取 Teams 系統管理中心。 如果您無法存取 Teams 系統管理中心，則沒有系統管理員許可權。

請連絡組織中的系統管理員，以授與您系統管理員存取權，或在入口網站中設定整合。

我的組織想要與網路中的其他組織共用 EHR 連接器整合

如果您想要共用 FHIR 基底 URL，請使用您想要在 TeamsForHealthcare 共用的 FHIR 基底 URL 傳送電子郵件給我們，並提供下列資訊：

  1. 要共用的 FHIR 基底 URL
  2. 裝載 EHR 連接器之父/初始 Microsoft 租使用者的租使用者識別碼 (，例如裝載 EHR)
  3. 租使用者識別碼 (將共用 EHR 連接器 (的新租使用者 () 的) ，例如區域分公司、相關醫療辦公室或臨床)

虛擬桌面基礎結構 (VDI) 支援

我的組織使用 Citrix 環境。 如何?將它設定為使用 EHR 連接器？

您可以設定 Citrix 環境，將特定 URL 路由傳送回本機電腦，而不是在虛擬機器中啟動。 例如，若要在 Teams 中啟動虛擬約會，請設定 「*.teams.microsoft.com」 到本機電腦的所有流量。

若要深入瞭解，請參閱下列 Citrix 檔：