EHR コネクタMicrosoft Teamsセットアップと構成のトラブルシューティング

  • [アーティクル]
  • 適用対象:
    Microsoft Teams, Microsoft 365 for frontline workers

この記事では、Microsoft Teams Electronic Health Record (EHR) コネクタの一般的なセットアップと構成の問題をトラブルシューティングする方法について説明します。 これを使用して、 Oracle Health EHR または Epic EHR システムと統合するように EHR コネクタを設定して構成するときに発生する可能性がある障害を解決するのに役立ちます。

FHIR URL が機能しない

EHR コネクタを構成しようとすると、"FHIR URL が無効です" というエラーが表示される

この問題は、次のシナリオで発生する可能性があります。

  • FHIR ベース URL に DSTU2 拡張機能がないため、Teams バージョン 1.1 または 1.2 を使用しています。
  • FHIR ベース URL に R4 拡張機能がないため、Teams バージョン 1.3 を使用しています。

完全な FHIR ベース URL を指定するには、Epic テクニカル スペシャリストにお問い合わせください。

私は 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 Connector アドオン、または EMR コネクタ アドオンのアクティブ なライセンスMicrosoft Teams少なくとも 1 つ必要です。 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 のテクニカル スペシャリストにお問い合わせください。
  • この一覧の前の手順を試してもこの問題が引き続き発生する場合は、テナントの設定を変更する必要がある場合があります。 Teams EHR コネクタのサポート チケットを開くには、Microsoft サポートにお問い合わせください。 チケットで、グループ設定を有効にする必要があることを示します。

プロバイダー エクスペリエンス

患者が仮想予定に参加すると、プロバイダーは Teams 通知を受け取りません

多くの場合、これはトレーニングによって解決できます。 プロバイダーが仮想予定を開始すると、患者を許可する一時的な通知がプロバイダーに表示されます。 この通知は短時間だけ表示されます。

また、プロバイダーは、画面上部の会議コントロールで [ ユーザー ] を選択して参加者の一覧を表示し、[ ロビーで待機中] で、参加者の名前の横にある緑色のチェック マークをオンにして、参加者を許可することもできます。

患者エクスペリエンス

患者は、Web ブラウザーから参加するのではなく、Teams アプリをダウンロードするように求められます。 Teams をインストールすることなく、患者が Web ブラウザーから参加できるようにする

Microsoft サポートに問い合わせて、Teams EHR コネクタのサポート チケットを開きます。 Web ブラウザーの参加設定を有効にする必要があることをチケットで示します。 この変更は、Teams EHR コネクタ チームによって行う必要があります。

Web ブラウザーの参加設定を有効にした後、患者は Teams をインストールしなくても、ブラウザーで仮想予定に参加できます。

仮想予定が予定内から終了した後、患者は Teams のプロバイダーにチャット メッセージを送信できます。 これをブロックするにはどうすればよいですか?

このシナリオは、いくつかの理由で発生する可能性があります。

プロバイダーは予定を離れますが、終了しませんでした

プロバイダーが予定を終了したが終了せず、患者が予約に残っている場合、両方ともチャットを続けることができます。 患者がチャット メッセージを送信できないようにするには、プロバイダーが [Teams での 会議の終了 ] を選択して予定を終了する必要があります。

Web ブラウザーの参加設定がオフになり、組織の従業員でもある患者が、仕事の資格情報を使用して Teams アプリに参加します

患者が組織の従業員であり、仕事の資格情報を使用して Teams アプリを介して予定に参加する場合、ゲストとしてではなく、組織のメンバーとして予定に参加します。 つまり、予定が終了した後でもチャット メッセージを送信できます。

このシナリオを回避するには、次のいずれかのアクションを実行します。

  • Microsoft サポートに問い合わせて、Teams EHR コネクタのサポート チケットを開きます。 Web ブラウザーの参加設定を有効にする必要があることをチケットで示します。 この変更は、Teams EHR コネクタ チームによって行う必要があります。
  • 従業員が患者として予定に出席するときに、職場の資格情報を使用して Teams にサインインしないようにトレーニングします。

管理者エクスペリエンス

EHR コネクタ構成ポータルにアクセスできないか、既存の構成しか表示できず、新しい構成を追加できません

EHR コネクタ構成ポータルに管理者アクセス権がありません。 クイック チェックとして、 Teams 管理センターにアクセスできるかどうかを確認します。 Teams 管理センターにアクセスできない場合は、管理者アクセス許可がありません。

組織内の管理者に連絡して、管理者アクセス権を付与するか、ポータルで統合を設定します。

私の組織は、ネットワーク内の他の組織と EHR コネクタの統合を共有したいと考えています

FHIR ベース URL を共有する場合は、 TeamsForHealthcare で共有する FHIR ベース URL を次の情報と共にメールでお知らせください。

  1. 共有する FHIR ベース URL
  2. EHR コネクタをホストする親/初期 Microsoft テナントのテナント ID (EHR をホストするメイン病院など)
  3. EHR コネクタを共有する新しいテナントのテナント ID (地域支店、関連する医療事務所、クリニックなど)

Virtual Desktop Infrastructure (VDI) のサポート

組織で Citrix 環境を使用しています。 EHR コネクタを使用するように構成するにはどうすればよいですか?

特定の URL をローカル マシンにルーティングし、仮想マシンで起動しないように Citrix 環境を構成できます。 たとえば、Teams で仮想予定を起動するには、ローカル コンピューターへの "*.teams.microsoft.com" のすべてのトラフィックを構成します。

詳細については、次の Citrix ドキュメントを参照してください。