排查 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 连接中心请求升级。
  • 需要添加新的 FDI 记录。 Epic 分析师需要为小组访问创建新的 FDI 记录，以支持提供商和患者加入体验。 此外，必须将组访问 FDI 记录中的上下文令牌从 sessionId=%CSN% 更改为 sessionId=%CONFERENCEID%。 请联系 Epic 技术专家寻求帮助。
  • 如果在尝试此列表中的上述步骤后仍遇到此问题，可能需要更改租户设置。 请联系 Microsoft 支持部门，为 Teams EHR 连接器开具支持票证。 在票证中指示需要启用组设置。

提供商体验

当患者加入虚拟约会时，提供商不会收到 Teams 通知

通常可以通过训练来解决此问题。 当提供商启动虚拟约会时，会向提供商显示一条临时通知，以允许患者入院。 此通知仅短暂显示。

提供商还可以在屏幕顶部的会议控件中选择人员以查看参与者列表，然后在“在大厅中等待”下，选择参与者姓名旁边的绿色检查标记以允许他们加入。

患者体验

系统会提示患者下载 Teams 应用，而不是从 Web 浏览器加入。 我们希望患者无需安装 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) 的main医院
  3. 租户 ID (新租户) () 共享 EHR 连接器 (，例如区域分支机构、相关医疗机构或诊所)

虚拟桌面基础结构 (VDI) 支持

我的组织使用 Citrix 环境。 如何实现将其配置为使用 EHR 连接器？

可以将 Citrix 环境配置为将某些 URL 路由回本地计算机，而不是在虚拟机中启动。 例如，若要在 Teams 中启动虚拟约会，请配置“*.teams.microsoft.com”到本地计算机的所有流量。

若要了解详细信息，请参阅以下 Citrix 文档：