DICOMOutput 节点

使用 DICOMOutput 节点可以接收 DICOM XML 消息、将 DICOM XML 消息中的元数据与文件系统中存储的像素数据组合以及将生成的 DICOM 图像发送到 SCP。

用途

DICOMOutput 节点是“存储”Service Class User (SCU) 节点。此节点从 DICOM XML 消息中获取元数据,并将该元数据与文件系统中的扫描图像(像素数据)以及任何其他未包含在 DICOM XML 消息中的属性组合。然后,使用 DICOM C-STORE 命令将结果发送到 Service Class Provider (SCP) 应用程序,例如 DICOM 图片归档通信系统 (PACS)。

DICOMOutput 节点包含在消息流节点选用板的 Healthcare 抽屉中,在 IBM® Integration Toolkit 中由以下图标表示:

DICOMOutput 节点图标

在消息流中使用此节点

DICOMOutput 节点在其输入终端上接收 DICOM XML 消息。DICOM XML 消息将与文件系统中存储的扫描图像(像素数据)进行重新组合,生成的 DICOM 图像将发送到目标 SCP。目标 SCP 通过节点属性进行配置,此配置在本地环境中不可覆盖。同一 DICOM 图像可以多次发送到同一个目标 SCP。目标 SCP 可以检查 SOP 标识(此标识唯一地标识 DICOM 图像),以确定是否已接收该 DICOM 图像。

如果 DICOM 图像传输成功,那么 DICOM XML 消息将传播到 DICOMOutput 节点的输出终端,以便在消息流中进一步处理。如果 DICOM 图像传输失败,那么将生成错误。

DICOM XML 消息中的元数据与扫描图像(像素数据)组合的过程称为“编码”。节点配置提供了用于更改 DICOM 图像编码的选项。因此,DICOMInput 节点所接收的 DICOM 图像的编码可能与发送到目标应用程序的 DICOM 图像的编码不同。

DICOM 标准有一项要求,即,在连接两个应用程序实体时,对其进行标识。此标识通过应用程序实体标题 (AET) 实现,该标题是长度可达 16 个字符的文本字符串。您必须为 DICOMOutput 节点配置它自己的 AET,并为它所连接的 SCP 配置 AET。除非目标 SCP 的 AET 与 DICOMOutput 节点中配置的值完全匹配,否则 DICOMOutput 节点无法进行连接。当消息到达 DICOMOutput 节点的输入终端时,与目标 SCP 的连接即建立。如果无法建立连接,那么将生成错误。
注: DICOMOutput 节点不会在两次消息传输之间保持连接。
存储落实

可以将 DICOMOutput 节点配置为,请求作为其 DICOM 图像发送目标的 SCP 返回存储落实响应消息。可以为 DICOMOutput 节点配置一个端口,用于接收这些异步响应消息。如果未配置此端口,那么此节点不会请求返回存储落实响应。如果配置了此端口,那么直至接收到存储落实响应消息之后,此节点才会将消息传播到其输出终端。另外,您还可以配置超时,用于定义等待存储落实响应消息的最大时间长度。如果在此时间内未接收到响应,那么将生成错误。

处理目录

您可以为 DICOMOutput 节点配置文件系统上的一个目录,用于处理 DICOM 图像(将 XML 消息中的元数据与像素数据重新组合)。此目录在处理目录节点属性中指定。除非您使用的是多实例配置,否则此目录不可由任何其他节点使用。在多实例配置中,在主动代理和被动 集成节点 上配置了同一个消息流。在任意时间,只有一个消息流处于活动状态,并且,激活消息流时,被动 DICOMOutput 节点的状态由此共享文件系统目录提供。

消息模式
使用单一模式来描述 DICOM 节点所发送和接收的所有 DICOM XML 消息。但是,仅使用此模式中定义的其中一种复杂类型来构造每种类型的消息。使用 DICOM 复杂类型来定义到达输入终端以及从 DICOMOutput 节点输出终端发送的 DICOM XML 消息。
有关此模式的更多信息,请参阅 DICOM 消息模式
DICOM 事务
DICOMOutput 节点处理在处理 DICOM 图像的线程的活动事务内运行。如果出错,那么 DICOMOutput 节点将生成错误。根据外层消息流中的异常处理逻辑不同,此错误可能会导致当前事务回滚。

活动日志条目

下表详细描述 DICOMOutput 节点所写的活动日志条目,并且示例中使用了下列名称:
  • BROKERAEDICOMOutput 应用程序实体的名称。
  • REMOTEAE 是远程应用程序实体的名称。
  • hostname:2222 是远程应用程序实体的主机名和端口号。
条件 描述 类型 示例 建议
开始发送 正在准备将 DICOM 图像发送到远程应用程序实体。
注:DICOM 中,将发送 DICOM 图像称为 C-STORE 命令。
参考 BIP12068 Starting DICOM C-STORE operation (BROKERAE,REMOTEAE,hostname:2222)

在活动日志中的 FILENAME 字段中记录了 DICOM 图像对象标识 (OID)。

无需执行任何操作。
结束发送 已成功地将 DICOM 图像发送到远程应用程序实体。

如果启用了存储落实,那么此活动日志条目表示已接收到所请求的存储落实响应消息。

参考 BIP12068 Finished DICOM C-STORE operation (BROKERAE,REMOTEAE,hostname:2222)

在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。

无需执行任何操作。
发送失败 DICOM 发送失败(C-STORE 命令)。DICOMOutput 节点生成了错误。 错误 BIP12070 Failed DICOM C-STORE operation (BROKERAE,REMOTEAE,hostname:2222)

在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。

请检查 集成节点 与远程 SCP 之间的网络连接。

请检查传输的数据类型(SOP 类和传输语法)是否与远程 SCP 兼容。

请检查应用程序实体名称和端口号是否与远程 SCP 完全匹配。

请检查远程 SCP 是否处于联机状态并准备好接受连接和数据传输。

请检查错误详细信息,以获取有关该错误的更多信息。

开始发送存储落实请求 DICOMOutput 节点正在将存储落实请求消息发送到远程 SCP。 参考 BIP12068 Sending storage commit request message (BROKERAE,REMOTEAE,hostname:2222) 无需执行任何操作。
结束发送存储落实请求 已成功地将存储落实请求消息发送到远程 SCP。 参考 BIP12068 Finished sending storage commit request message (BROKERAE,REMOTEAE,hostname:2222) 无需执行任何操作。
发送存储落实请求失败 DICOMOutput 节点未能将存储落实请求消息发送到远程 SCP。 错误 BIP12070 Failed to send storage commit request message (BROKERAE,REMOTEAE,hostname:2222) 请检查 集成节点 与远程 SCP 之间的网络连接。

请检查远程应用程序是否支持存储落实 SOP 类。

请检查应用程序实体名称和端口号是否与远程 SCP 完全匹配。

请检查远程 SCP 是否处于联机状态并准备好接受连接和数据传输。

请检查错误详细信息,以获取有关该错误的更多信息。

发送存储落实请求超时 DICOMOutput 节点在配置的时间限制内未接收到存储落实响应消息。 错误 BIP12070 Timed out waiting for storage commit response message (BROKERAE,REMOTEAE,hostname:2222) 请检查 集成节点 与远程 SCP 之间的网络连接。

请检查远程应用程序是否支持存储落实 SOP 类。

请检查应用程序实体名称和端口号是否与远程 SCP 完全匹配。

请检查远程 SCP 是否处于联机状态并准备好接受连接和数据传输。

请检查错误详细信息,以获取有关该错误的更多信息。

归档 DICOM 图像 DICOMOutput 节点正在对 DICOM 图像进行归档。 参考 BIP12068 Archiving DICOM instance from DICOMOutput node (BROKERAE)

在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。

无需执行任何操作。
删除 DICOM 图像 正在从 DICOMOutput 归档中删除 DICOM 图像。 参考 BIP12068 Deleting DICOM instance from DICOMOutput node archive (BROKERAE)

在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。

无需执行任何操作。

配置 DICOMOutput 节点

DICOMOutput 节点的实例添加到消息流后,可以对其进行配置。

所有必须输入值(未定义缺省值)的必需属性均以星号标记。

终端和属性

下表描述了 DICOMOutput 节点的终端。
终端 描述
In 接受节点处理的消息的输入终端。
Out 这是成功地将图像传输到目标 SCP 后,消息所路由到的输出终端。

下表描述了此节点的属性。标题为 M 的列指示属性是否为必需(如果在未定义缺省值时必须输入值,那么将以星号标记);标题为 C 的列指示属性是否可配置(将消息流添加到 BAR 文件以进行部署时,可以更改该属性的值)。

下表描述了 DICOMOutput 节点的“描述”属性。
属性 M C 缺省值 描述
节点名 DICOMOutput 节点的名称。
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。
下表描述了 DICOMOutput 节点的“基本”属性。
属性 M C 缺省值 描述
连接详细信息 localhost:2222 这是此节点所连接的应用程序实体 SCP 的主机名和端口。
应用程序实体标题 (AET) BROKERAE DICOM SCU 端点的名称。这是长度可达 16 个字符的文本字符串,用于在连接应用程序实体时对其进行标识。
处理目录 Output 这是一个文件系统目录,节点可以使用此目录来处理出局 DICOM 图像。对于此节点,此目录必须唯一。
注: 如果此节点属性是相对目录名,例如 Output,那么此名称将追加到 IBM Integration Bus 工作路径之后以生成绝对目录。如果此节点属性包含绝对目录名,例如 C:\DICOM\Output,那么将直接使用此目录名作为文件系统位置。
远程应用程序实体标题 (AET) REMOTEAE 这是此节点所连接的 DICOM SCP 端点的名称。
在发送 DICOM 图像下列小时数后将其归档 72 在此小时数过后,DICOM 图像将从处理目录移入名为 Archive 的子目录。
DICOM 图像到达下列小时数后将其删除 72 DICOM 图像到达此小时数之后,将其从 Archive 子目录中删除。
下表描述了 DICOMOutput 节点的“高级”属性。
属性 M C 缺省值 描述
连接超时(秒) 60 这是此节点等待连接到 SCP 的时间长度(以秒为单位)。
操作优先级 (LOW, NORMAL, HIGH) NORMAL 这是以 SCP 为目标的图像传输的优先级。接收应用程序不必以此优先级工作。
以显式长度对序列进行编码 未选中 指定是否以显式长度对 DICOM 图像中的序列进行编码。
以显式长度对序列项进行编码 未选中 指定是否以显式长度对 DICOM 图像中的序列项进行编码。
包含组长度属性 未选中 指定 DICOM 属性组是否具有指定的长度。
以显式长度对空的序列进行编码 选中 指定是否以显式长度对 DICOM 图像中的空序列进行编码。
以显式长度对空的序列项进行编码 选中 指定是否以显式长度对 DICOM 图像中的空序列项进行编码。
下表描述了 DICOMOutput 节点的“存储落实”属性。
属性 M C 缺省值 描述
等待存储落实响应的最大时间(秒) 60 这是等待存储落实响应消息的最大时间长度。如果在此时间段内未接收到响应,那么此节点将生成错误。
接收存储落实响应的端口 2223 这是用于接收存储落实响应消息的端口。如果此字段为空,那么此节点将不会请求返回存储落实响应消息。
Copyright IBM Corporation 2011, 2015Copyright IBM Corporation 2011, 2015.

        
        最近一次更新时间
        最近一次更新时间 : 2015-06-19 10:56:53


参考主题参考主题 | V4.0.0.0 | ha05020