HL7 MLLP 端口 - 知行之桥文档

Health Level-7 是一套医院和其他医疗保健提供者使用的临床数据传输标准。HL7 MLLP 端口支持与 MLLP 作为传输协议结合生成和解析 HL7 文档。

核心功能

使用基于 MLLP（最小低层协议）传输的 HL7 进行医疗数据交换
内置 MLLP 服务端功能，支持 SSL/TLS 加密
提供 HL7 与 XML 格式之间的双向 HL7 文档转换
支持 MSH 报文头验证，具备可配置的应用程序和设施标识符
自动回执处理，具备重试和重发功能以确保可靠交付

总览

HL7 MLLP 端口提供两组功能：

通过 MLLP 传输协议进行文件传输
根据 HL7 EDI 标准解析并生成 EDI 文档

HL7 MLLP 连接在两个位置进行配置。使用将知行之桥标识为 HL7 和 MLLP 实体的设置来配置 HL7 MLLP 个人设置。然后使用每个贸易伙伴的 HL7 和 MLLP 详细信息配置单独的 HL7 MLLP 端口。当 HL7 MLLP 端口收到来自贸易伙伴的入站消息时，它会验证 HL7 标识详细信息，以确认文档是从预期各方发送的或发送到预期各方的。然后，它将文档转换为 XML，以便在知行之桥流程中进一步处理。当 HL7 MLLP 端口向贸易伙伴发送文件时：

XML 文件在发送之前被转换为 HL7
HL7 文件按原样发送

知行软件强烈建议将 HL7 MLLP 端口与 XML Map 端口结合使用，以确保输入和输出 XML 的格式正确。有关详细信息，请参阅与 XML Map 端口一起使用。

个人设置

必须先配置 HL7 MLLP 配置文件，然后才能与各个 HL7 MLLP 端口建立连接。单击顶部菜单栏上的 个人设置，然后单击 HL7 MLLP 选项卡。

HL7 MLLP 配置文件选项

服务器配置

托管本地 MLLP 服务器的设置。

设置	描述
端口	监听传入 MLLP 连接的端口。
使用 SSL/TLS	是否要求传入连接将 SSL/TLS 加密用于传输安全。
TLS 服务器证书	用于验证 TLS/SSL 服务器身份的公钥证书。如果目标服务器使用 TLS/SSL，请将此字段设置为标识该服务器的证书。如果服务器的证书不可用，可以将此设置留空以允许底层 OS/JVM 执行证书验证，或将其设置为 `Any Certificate` 以隐式信任服务器的身份。（仅当选中使用 SSL/TLS 时，才会显示此字段。）

HL7 个人 ID

设置	描述
应用程序命名空间 ID（MSH3.1）	标识 HL7 协议交换的本地命名空间的应用程序 ID。
应用程序通用 ID（MSH3.2）	HL7 协议交换的本地应用程序通用 ID。
应用程序通用 ID 类型（MSH3.3）	为本地应用程序通用 ID 提供上下文的类型限定符。
设施命名空间 ID（MSH4.1）	标识 HL7 协议交换的本地命名空间的设施 ID。
设施通用 ID（MSH4.2）	HL7 协议交换的本地设施通用标识。
设施通用 ID 类型（MSH4.3）	一个类型限定符，用于为本地设施通用标识提供上下文。

其他设置

很少需要修改的设置。

设置	描述
空闲超时	服务器允许客户端在连接终止之前保持非活动状态的时间（以秒为单位）。

日志

用于管理日志创建和存储的设置。

设置	描述
日志级别	端口生成的日志的详细程度。当请求支持时，请将其设置为 Debug。
日志轮换间隔	创建新日志文件之前等待的天数。
日志删除间隔	删除旧日志文件之前等待的天数。

杂项

特殊设置适用于特定用例。

设置	描述
其他设置	允许在以分号分隔的列表中配置隐藏的端口设置，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用这些设置。

端口配置

配置全局 HL7 MLLP 个人设置后，请在工作流页面上为每个贸易伙伴创建和配置单独的 HL7 MLLP 端口。

设置

端口设置

与端口核心操作相关的设置。

设置	描述
端口 ID	端口的静态唯一标识符。
端口类型	显示端口名称及其功能描述。
端口描述	可选字段，用于对端口及其在工作流中的角色进行自由格式描述。
远程主机	远程主机的主机名或 IP 地址。
端口	用于侦听传入 MLLP 连接的端口。
版本	正在使用的 MLLP 版本。
连接超时	端口在抛出超时错误之前等待连接响应的时间长度（以秒为单位）。
使用 SSL/TLS	是否要求传入连接使用 SSL/TLS 加密以确保传输安全。

HL7 配置

与消息头相关的设置。将 HL7 文档转换为 XML 时，将根据这些设置验证文档头；从 XML 生成 HL7 文档时，这些设置用于生成文档头。

设置	描述
应用程序命名空间 ID（MSH5.1）	结合其他 5.X 元素，标识 HL7 交换机远程端的应用程序。
应用程序通用 ID（MSH5.2）	结合其他 5.X 元素，标识 HL7 交换机远程端的应用程序。
应用程序通用 ID 类型（MSH5.3）	结合其他 5.X 元素，标识 HL7 交换机远程端的应用程序。
设施命名空间 ID（MSH6.1）	结合其他 6.X 元素，标识 HL7 交换机远程端的设施。
设施通用 ID（MSH6.2）	结合其他 6.X 元素，标识 HL7 交换机远程端的设施。
设施通用 ID 类型（MSH6.3）	结合其他 6.X 元素，标识 HL7 交换机远程端的设施。

ACK

与生成和请求 ACK 相关的设置。

设置	描述
ACK 类型	确认是否应生成并请求。

样本文件选项卡

高级设置

EDI 分隔符

指定用哪些字符分隔元素、段等。

设置	描述
数据元素分隔符	分隔文档中各个数据元素的字符。
组件元素分隔符	分隔文档中复合数据结构内元素的字符。
段终止符	指示文档中段结尾的字符。
转义字符	释放（转义）下一个字符的字符，覆盖其通常的含义。只要前面有释放字符，允许保留字符在文档中显示为数据。
重复字符	表示元素值重复的字符。
后缀	附加到段终止符以区分段。

代理设置

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

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

高级设置

先前类别中未包含的设置。

设置	描述
将描述生成为	将 HL7 转换为 XML 时，可以提供 HL7 段和元素的描述作为 HL7 数据的上下文。使用此下拉列表可以选择是否将此上下文添加为 XML 注释或 XML 属性。
处理延迟	放置在交易选项卡中的文件处理延迟的时间量（以秒为单位）。这是一个旧版设置。最佳实践是使用文件端口来管理本地文件系统，而不是此设置。
严格模式验证	检测到以下情况时，端口是否提示应忽略、警告或失败：重复计数超过允许的数目，缺少必需的元素或段，限定符和代码值无效，不允许的元素长度以及无效的元素值。
本地文件命名方案	为端口输出消息分配文件名的方案。可以在文件名中使用宏来动态包含标识符和时间戳等信息。更多信息，请参阅宏。
TLS 已启用协议	建立传出连接时支持的 TLS/SSL 协议列表。最佳实践是仅使用 TLS 协议。SSL v2 和 SSL v3 被认为存在漏洞，只有在贸易伙伴不支持更高版本时才应使用。请注意，TLS v1.3 尚未被普遍采用，如果目标服务器不支持它，可能会被拒绝。
验证标识符	选中后，端口将确保已翻译文档中的标识符与端口配置中指定的标识符匹配。
重复文件操作	当端口收到控制号已见过的消息（重复）时应如何处理。设置为 `Ignore` 时，端口静默跳过重复并继续处理。设置为 `Warn` 时，端口处理文件但返回警告。设置为 `Fail` 时，端口不接受文件并返回错误。
上传 Schema	使用此选项上传 schema 并将其安装在端口的 Schema 文件夹中。如果 schema 已存在，系统会询问是否要覆盖。
重置状态	EDI 端口跟踪已使用的控制号并递增该数字，以确保将来的运行不会重复数据。使用此按钮将计数器重置为初始状态，而不更改任何已配置的设置。

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置	描述
保存到已发送文件夹	选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案	端口根据选定的时间间隔对已发送文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在已发送文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

设置

描述

保存到已发送文件夹

选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。

已发送文件夹方案

端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置	描述
日志级别	指定要记录在端口日志目录中的信息类型： None - 不创建任何日志。 Error - 仅当端口遇到错误时才创建日志。 Warning - 仅当端口发出警告时才创建日志。 Info - 记录工作流的一般信息，包括任何错误和警告（如果适用）。 Debug - 记录成功和失败工作流的详细调试信息。 Trace - 记录成功和失败工作流的详细跟踪信息。请注意：Debug 和 Trace 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构	指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本	指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。

杂项

特殊设置适用于特定用例。

设置	描述
其他设置	允许在以分号分隔的列表中配置隐藏的端口设置，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用这些设置。

自动化

自动化设置

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

设置	描述
发送	到达端口的文件是否自动作为 HL7 或 XML 消息发送。
重试间隔	重试失败发送之前的分钟数。当服务器没有响应发送尝试，或者做出否定响应以表明未收到文件时，将触发重试。
最大尝试次数	端口处理输入文件的最大次数。成功取决于服务器成功确认和验证收据（同步请求时）。如果将此设置为 0，端口将无限期地重试该文件。
重新发送间隔	重新发送未确认消息之前的分钟数。当服务器收到文件但未在预期时间范围内提供异步 MDN 回执时，会触发重新发送。
最大尝试次数（异步）	当请求异步收据时，端口处理输入文件的最大次数。成功取决于服务器成功确认后在重新发送间隔内返回的异步收据。如果未返回成功的服务器确认，则会应用最大尝试次数。如果将此设置为 0，端口将无限期地重新发送文件。

性能

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

设置	描述
最大工作线程数	此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖高级设置页面的性能设置部分的默认设置。
最大文件数	分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖高级设置页面的性能设置部分的默认设置。

告警选项卡

SLA 选项卡

生成 HL7 文档

从 XML 生成 HL7 文件时，端口根据 HL7 MLLP 配置文件选项卡上的 HL7 个人 ID 以及端口中的 HL7 配置应用事务消息头。其余数据来自 XML 输入文件。有关生成适当的 XML 输入文件的详细信息，请参阅与 XML Map 端口一起使用。到达端口交易选项卡的文件将打包成 HL7 文档并通过 MLLP 发送出去。文件可以通过将文件直接拖放到磁盘上的文件夹路径中或通过将另一个知行之桥端口连接到流程中的 HL7 MLLP 端口来到达交易选项卡。

HL7 转换为 XML

将 HL7 文档转换为 XML 时，应用程序会根据 HL7 MLLP 配置文件选项卡上的 HL7 个人 ID 和端口中的 HL7 配置验证入站文档中的交换标题。从 HL7 文档生成的 XML 放置在交易选项卡中，以便在流程中传递以进行进一步处理。有关处理翻译后的 XML 的详细信息，请参阅与 XML Map 端口一起使用。

​核心功能

​总览

​个人设置

​HL7 MLLP 配置文件选项

​服务器配置

​HL7 个人 ID

​其他设置

​日志

​杂项

​端口配置

​设置

​端口设置

​HL7 配置

​ACK

​样本文件选项卡

​高级设置

​EDI 分隔符

​代理设置

​高级设置

​消息

​日志

​杂项

​自动化

​自动化设置

​性能

​告警选项卡

​SLA 选项卡

​生成 HL7 文档

​HL7 转换为 XML

​与 XML Map 端口一起使用

​上传测试文件

​宏

​示例

核心功能

总览

个人设置

HL7 MLLP 配置文件选项

服务器配置

HL7 个人 ID

其他设置

日志

杂项

端口配置

设置

端口设置

HL7 配置

ACK

样本文件选项卡

高级设置

EDI 分隔符

代理设置

高级设置

消息

日志

杂项

自动化

自动化设置

性能

告警选项卡

SLA 选项卡

生成 HL7 文档

HL7 转换为 XML

与 XML Map 端口一起使用

上传测试文件

宏

示例