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）	一个类型限定符，用于为本地设施通用标识提供上下文。

其他设置

很少需要修改的设置。

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

日志

杂项

端口配置

配置全局 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 分隔符

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

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

代理设置

高级设置

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

设置	描述
将描述生成为	将 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 端口跟踪已使用的控制号并递增该数字，以确保将来的运行不会重复数据。使用此按钮将计数器重置为初始状态，而不更改任何已配置的设置。

消息

日志

杂项

自动化

自动化设置

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

设置	描述
发送	到达端口的文件是否自动作为 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 端口一起使用

上传测试文件

宏

示例