HL7消息编辑器的使用手册

REDISANT 提供互联网与物联网开发测试套件 #

互联网与中间件：

工业与物联网：

HL7消息编辑器的使用手册 #

HL7 Assistant 是用于浏览，编辑，验证HL7消息并与HL7应用程序交换数据的生产力工具。 HL7 Assistant的一些主要功能包括：

  • 查看 HL7 消息

    HL7 Assistant 使 HL7 消息易于阅读，您只需指向它们即可识别段和字段。无需费力查阅规范，节省您的时间和金钱。

  • 编辑 HL7 消息

    编辑 HL7 消息从未如此简单。HL7 Assistant 负责数据定位、格式化并自动添加分隔符。

  • 验证 HL7 消息

    HL7 Assistant 允许您轻松验证消息、管理配置文件、保存报告、调试和优化问题。

  • 发送/接收 HL7 消息

    HL7 Assistant 允许您模拟和测试与支持 TCP/IP 或串行连接的 HL7 系统的数据交换。

  • 将 HL7 消息导出到 JSON 和 XML

    HL7 Assistant 允许您将 HL7 消息导出到 JSON、XML 格式。

  • 消息定义和表格

    HL7 Assistant 提供所有版本的完整消息定义和HL7表格文档，为快速查询提供便利。

编辑消息 #

在顶部的快捷功能栏选择打开文件，选中要编辑的HL7文件（.hl7，可以包含多条消息，每条消息以空行分隔）。打开后将定位到文件中的第一条消息，如下图所示。

  • 可以通过在中间的滚动条处左右拖动，或者使用滚动条右侧的按钮来导航消息（定位到第一条、上一条、下一条、最后一条消息）。
  • 消息的编辑是双向的，你可以在上方的编辑器中编辑消息；也可以在下方的树型结构中编辑消息（通过双击Value列的单元格开始编辑）。在任何一个地方编辑，都会进行同步。
  • 将消息导出为XML格式。如下图所示，单击指定的按钮，即可将消息导出为XML格式（导出单条消息，或者导出全部消息，并且包含预览）
  • 将消息导出为JSON格式。如下图所示，单击指定的按钮，即可将消息导出为JSON格式（导出单条消息，或者导出全部消息，并且包含预览）

消息列表 #

消息列表中会展示当前文件中包含的所有消息，如下图所示。

  • 通过单击表头进行排序
  • 通过双击任意一行消息，在编辑器中打开改消息

监视消息 #

你可以通过路径监视每条消息中特定的字段、组件、子组件。如下图所示，点击加号可以添加新的监视项（在定位到不同的消息时，会更新监视项）。

消息的路径格式要求如下：

HL7 路径定义为：SEG[SEG_NUM]-F[REPEAT_NUM][[.C].S]

其中：

  • SEG 是由 3 个字符组成的段名称。例如 PID。
  • [SEG_NUM] 为段号，是一个整数值，且要求 SEG_NUM > 0 或 SEG_NUM = '*'。
    如果省略 [SEG_NUM]，则默认为 SEG[1]。
    如果 [SEG_NUM] = '*'，则搜索时包括所有匹配的段。
    例如，OBR[2] 表示第二个 OBR 段，而 OBR[1] 与 OBR 等效。
  • F 是一个整数值，且要求 F > 0。
    例如，PID-3 表示 PID 段中的第 3 个字段。
  • [REPEAT_NUM] 是字段重复次数，要求 REPEAT_NUM > 0 或 REPEAT_NUM = '*'。
    如果 REPEAT_NUM = '*'，则查询时包括所有重复的字段。
    如果省略 [REPEAT_NUM]，则默认为 F[1]。
  • C 为组件编号，要求 C > 0 或可省略。
    如果 C 省略，则字段中的所有组件（以 ‘^’ 分隔）均被包含。
    例如，PID-3 表示 PID-3.1 + PID-3.2 + PID-3.3 + … + PID-3.N。
  • S 为子组件编号，要求 S > 0 或可省略。
    如果 S 省略，则组件中的所有子组件（以 '&' 分隔）均被包含。
    如果 S 被省略，则默认为 S=1。
    例如，PID-3.2.3 表示 PID-3.2 组件的第三个子组件，而 PID-3.2 表示 PID-3.2.1 + PID-3.2.2 + PID-3.2.3 + … + PID-3.2.N。

消息验证 #

消息可能包含错误，使用消息格式验证器可以快速定位其中的错误并改正。你可以自定义要验证哪些可能出现的错误。如下图所示。

对于每个错误，都会在编辑器中用红色波浪线标示出来，并且双击下面的列表项可以快速定位到该错误项。

发送消息 #

如果HL7服务器端已经准备好接收消息，则可以通过消息发送器将消息批量发送到服务端。

  • 单击发送消息按钮，打开发送窗口，在发送窗口中，你可以使用默认的配置文件进行发送（向127.0.0.1:21110发送消息），或者你也可以自定义新的配置文件（点击“添加新的配置文件”按钮）。
  • 发送消息时，你可以选择发送当前在编辑器中显示的消息，也可以发送消息文件中的所有消息，也可以指定发送消息的范围。
  • 点击“确定”按钮，即可开始发送消息。
  • 通过单击任务列表中的某一项，可以查看当前任务正在发送的消息（消息列表），或者查看消息的原始报文（通信细节）。

编辑发送配置文件 #

点击“编辑配置文件”按钮，即可编辑当前配置文件，可以编辑的参数包括：

  • 名称：配置文件的别名，方便记忆
  • 服务器IP地址：向哪台服务器发送消息
  • 服务器端口号：向哪个端口发送消息
  • 读取确认消息：发送一条消息后是否等待服务器返回ACK消息
  • 编码格式：发送消息时使用的编码格式
  • 帧定界：消息的前缀和后缀字节
  • 跳过不带MSH的消息：是否发送不带MSH段的消息
  • 消息被拒后停止发送

接收消息 #

启动HL7服务器，可以接收来自客户端发送的消息。

  • 单击“启动服务器”按钮，可以启动服务器，开始准备接收来自客户端的消息。
  • 你可以使用默认的接收配置文件，或者也可以自定义新的接收配置文件。
  • 左侧列表显示接收任务，右侧列表显示接收任务包含的所有收到的消息和原始报文。

编辑接收配置文件 #

点击“编辑配置文件”按钮，即可编辑当前配置文件，可以编辑的参数包括：

  • 名称：配置文件的别名，方便记忆
  • 服务器IP地址：绑定到哪个网卡（注意使用127.0.0.1时，只有运行在同一台电脑上的客户端可以连接。如果要让网络上的其他客户端也能连接，请使用电脑的实际IP地址，通过在控制台运行 ipconfig 命令查看）
  • 服务器端口号：绑定到的端口号
  • 确认：向客户端发送确认消息
  • 编码格式：发送消息时使用的编码格式
  • 帧定界：消息的前缀和后缀字节
  • 存储数据：将接收到的消息保存到本地文件中

ipconfig 命令示例

PS C:\Users\14027> ipconfig
Windows IP 配置
.... 省略部分内容 ....
无线局域网适配器 WLAN:
   连接特定的 DNS 后缀 . . . . . . . :
   IPv4 地址 . . . . . . . . . . . . : 192.168.31.166 <-- IP地址
   子网掩码  . . . . . . . . . . . . : 255.255.255.0
   默认网关. . . . . . . . . . . . . : 192.168.31.1
PS C:\Users\14027>

时间线 #

使用时间线，你可以查看消息的吞吐量，如下图所示。

消息比对 #

使用消息比对功能，可以快速定义两个消息之间的差异，如下图所示。

消息字典 #

使用消息字典工具，你可以快速查看不同的HL7版本中的消息格式定义。

  • 所有的消息类型以及描述
  • 每条消息包含的段、字段、组件、子组件的格式定义，以及描述、最大和最小出现次数、所在的章节

表字典 #

使用表字典工具，你可以快速查看不同的HL7版本中的表定义。

  • 所有的表编号和描述
  • 表中的值，描述

版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。 原文链接：https://blog.redisant.cn/