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 控制台中，再次点击验证身份验证。
Epic 报告称重定向 URI 不匹配。 完全按照设置重定向 URI 中的说明注册两个重定向 URI。
Epic 在登录期间显示“OAuth 2.0 请求无效”。 每个 Epic 登录链接只能使用一次，因此重新加载登录窗口会显示此错误。关闭窗口，然后重新开始登录，而无需重新加载。如果错误仍然存在，请检查应用是否具有所请求范围的 API。
Epic 获得 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 数据存储区，重新添加，然后再次向连接器授权。

后续步骤