跳转到主要内容
FHIR 端口允许你通过推送或拉取 FHIR 中的数据,将 FHIR 集成到工作流中。

核心功能

  • 支持快速医疗保健互操作性资源(FHIR)标准,用于合规的医疗数据交换
  • 集成 RESTful API 与医疗特定的数据格式,处理患者记录、观察结果和临床数据
  • 支持标准数据库操作(Select、Lookup、Upsert 和存储过程)以进行数据操作
按照以下步骤将 知行之桥 连接到 FHIR。

建立连接

允许 知行之桥 端口从 FHIR 数据库中使用数据,首先需要建立一个到 FHIR 的连接。有以下两种方式:
  • 添加一个 FHIR 端口到工作流中,然后点击连接下拉框旁边的创建按钮。
  • 打开 知行之桥 系统设置页面,然后打开连接选项卡。点击创建,选择 FHIR 并下一步创建。
  • 这仅仅是第一次创建的时候需要。
  • 到 FHIR 的连接可以被多个端口重复利用。

输入连接配置

在打开的连接配置对话框,进行如下步骤:
  1. 提供需要的信息:
    • 名称 — 连接的名称。填一个期望的值。
    • 类型 — 默认设置为 FHIR。
    • Connection Type — 你要使用的 FHIR API 实现。选项有 Generic(用于 FHIR API 的任何自定义实现)、Azure、AWS 和 Google。
    • Auth Scheme — 用于连接的身份验证方案。选项有 None(默认选项)、OAUTH、Azure AD 和 AwsRootKeys。
    • URL — 要使用的 FHIR 服务器的 URL。
  2. 根据你选择的身份验证方案创建连接:
    • None — 不使用任何身份验证。
    • OAUTH — 输入你的 OAuth 客户端 ID 和 OAuth 客户端密码。
    • AzureAD — 输入你的 OAuth 客户端 ID 和 OAuth 客户端密码。
    • AwsRootKeys — 输入你的 AWS 访问密钥和 AWS 密钥。
  3. 如果需要,点击高级来打开高级配置。这在大多数情况下不需要。
  4. 点击连接来确保这个连接可以正常连接到 FHIR 服务器。如果发生错误,请再次排查。
  5. 点击创建连接来保存连接。
  6. 在连接下拉选单中选择刚刚创建的连接。
  7. 点击保存变更。

选择一个操作

与 FHIR 建立连接后,你必须选择 FHIR 端口将执行的操作。下表概述了每个操作及其在 知行之桥 工作流中的所属位置。

高级选项卡

高级选项卡上的许多设置是从你正在使用的数据源动态加载的,因此本文档不对其进行说明。你可以在我们网站的在线帮助文件页面上找到适用于你的数据源的详细信息。 以下描述的选项适用于所有数据源。

消息

高级设置

高级设置 是依赖任意数据库驱动(例如 Database、CData 和 API 端口)连接到各种数据源的端口的通用设置。

其他设置

其他设置 适用于特定使用场景。

代理设置

这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下,本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。

设置描述
代理类型基于代理的防火墙使用的协议。
代理主机基于代理的防火墙的名称或 IP 地址。
代理端口基于代理的防火墙的 TCP 端口。
代理用户用于通过基于代理的防火墙进行身份验证的用户名。
代理密码用于对基于代理的防火墙进行身份验证的密码。
身份验证方案保留默认值 None 或选择以下身份验证方案之一:Basic、Digest、Proprietary 或 NTLM。

自动化选项卡

自动化设置

与端口自动处理文件相关的设置。

性能

与端口资源分配相关的设置。

告警选项卡

与配置告警相关的设置。 在执行服务级别协议(SLA)之前,你需要设置电子邮件告警通知。默认情况下,知行之桥 使用告警选项卡上的全局设置。若要为此端口使用其他设置,请开启覆盖全局设置。 默认情况下,错误告警已启用,这意味着每当发生错误时都会发送电子邮件。若要关闭,请取消选中启用复选框。 输入主题(必填),然后可选填入以逗号分隔的收件人电子邮件列表。

SLA 选项卡

与配置服务级别协议(SLA)相关的设置。 SLA 允许你配置期望工作流中端口发送或接收的数据量,并设置期望在该时间范围内满足该数据量。知行之桥 会在 SLA 未满足时发送电子邮件警告用户,并将 SLA 标记为_风险中_,表示如果 SLA 不久内仍未满足,将被标记为_已违反_。这给用户一个机会介入,确定 SLA 未满足的原因,并采取适当的行动。如果 SLA 在风险期结束时仍未满足,SLA 将被标记为已违反,并再次通知用户。 要定义 SLA,开启预期数据量,然后点击设置选项卡。 空 SLA 配置
  • 如果你的端口具有单独的发送和接收操作,请使用单选按钮指定 SLA 涉及的方向。
  • 在窗口的至少预期部分:
    • 设置你期望处理的最小事务数(数据量)
    • 使用每字段指定时间范围
    • 指示 SLA 何时生效。如果选择从…开始,请填写日期和时间字段。
    • 勾选你希望 SLA 生效的星期几的复选框。如有必要,使用下拉菜单选择每天。
  • 在窗口的**设置状态为”风险中”**部分,指定 SLA 何时应标记为风险中。
    • 默认情况下,在 SLA 违反之前不会发送通知。若要更改此设置,勾选发送”风险中”通知。
以下示例显示了一个为端口配置的 SLA,该端口预计每天周一至周五接收 1000 个文件。如果在时间段结束前 1 小时仍未收到 1000 个文件,则发送风险通知。 SLA 配置示例
如有必要,你可以关闭 SLA 告警。这在维护窗口期间很有用。在导航栏中点击设置,然后导航到告警 > 常规告警。点击铅笔图标进行编辑,并取消勾选 SLA 告警设置。

宏

在文件命名策略中使用宏可以提升组织效率并加深对数据的了解。通过在文件名中融入宏,你可以动态包含标识符、时间戳和消息头信息等相关信息,为每个文件提供有价值的上下文。这有助于确保文件名反映对你的组织重要的详细信息。 知行之桥 支持以下宏,所有宏均使用以下语法:%Macro%。

示例

有些宏(如 %Ext% 和 %ShortDate%)不需要参数,而其他宏需要参数。所有带参数的宏均使用以下语法:%Macro:argument% 以下是一些带参数的宏示例:
  • %Header:headername%:其中 headername 是消息上消息头的名称。
  • %Header:mycustomheader% 解析为输入消息上设置的 mycustomheader 消息头的值。
  • %Header:ponum% 解析为输入消息上设置的 ponum 消息头的值。
  • %RegexFilename:pattern%:其中 pattern 是正则表达式模式。例如,%RegexFilename:^([\w][A-Za-z]+)% 匹配并解析为文件名中的第一个词(不区分大小写,test_file.xml 解析为 test)。
  • %Vault:vaultitem%:其中 vaultitem 是保险库中某个项目的名称。例如,%Vault:companyname% 解析为保险库中存储的 companyname 项目的值。
  • %DateFormat:format%:其中 format 是接受的日期格式(详情请参见日期格式示例)。例如,%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% 解析为文件的日期和时间戳。
你还可以创建更复杂的宏,如以下示例所示:
  • 在一个文件名中组合多个宏:%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
  • 在宏外部包含文本:MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
  • 在宏内部包含文本:%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%