使用 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 节点在其输入终端上接收 DICOM XML 消息。DICOM XML 消息将与文件系统中存储的扫描图像(像素数据)进行重新组合,生成的 DICOM 图像将发送到目标 SCP。目标 SCP 通过节点属性进行配置,此配置在本地环境中不可覆盖。同一 DICOM 图像可以多次发送到同一个目标 SCP。目标 SCP 可以检查 SOP 标识(此标识唯一地标识 DICOM 图像),以确定是否已接收该 DICOM 图像。
如果 DICOM 图像传输成功,那么 DICOM XML 消息将传播到 DICOMOutput 节点的输出终端,以便在消息流中进一步处理。如果 DICOM 图像传输失败,那么将生成错误。
将 DICOM XML 消息中的元数据与扫描图像(像素数据)组合的过程称为“编码”。节点配置提供了用于更改 DICOM 图像编码的选项。因此,DICOMInput 节点所接收的 DICOM 图像的编码可能与发送到目标应用程序的 DICOM 图像的编码不同。
可以将 DICOMOutput 节点配置为,请求作为其 DICOM 图像发送目标的 SCP 返回存储落实响应消息。可以为 DICOMOutput 节点配置一个端口,用于接收这些异步响应消息。如果未配置此端口,那么此节点不会请求返回存储落实响应。如果配置了此端口,那么直至接收到存储落实响应消息之后,此节点才会将消息传播到其输出终端。另外,您还可以配置超时,用于定义等待存储落实响应消息的最大时间长度。如果在此时间内未接收到响应,那么将生成错误。
您可以为 DICOMOutput 节点配置文件系统上的一个目录,用于处理 DICOM 图像(将 XML 消息中的元数据与像素数据重新组合)。此目录在处理目录节点属性中指定。除非您使用的是多实例配置,否则此目录不可由任何其他节点使用。在多实例配置中,在主动代理和被动代理上配置了同一个消息流。在任意时间,只有一个消息流处于活动状态,并且,激活消息流时,被动 DICOMOutput 节点的状态由此共享文件系统目录提供。
条件 | 描述 | 类型 | 示例 | 建议 |
---|---|---|---|---|
开始发送 | 正在准备将 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) | 请检查 IBM Integration
Bus 与远程 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 节点的实例添加到消息流后,可以对其进行配置。
所有必须输入值(未定义缺省值)的必需属性均以星号标记。
终端 | 描述 |
---|---|
In | 接受节点处理的消息的输入终端。 |
Out | 这是成功地将图像传输到目标 SCP 后,消息所路由到的输出终端。 |
下表描述了此节点的属性。标题为 M 的列指示属性是否为必需(如果在未定义缺省值时必须输入值,那么将以星号标记);标题为 C 的列指示属性是否可配置(将消息流添加到代理归档 (BAR) 文件以进行部署时,可以更改该属性的值)。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
节点名 | 是 | 否 | 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 子目录中删除。 |
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
连接超时(秒) | 是 | 是 | 60 | 这是此节点等待连接到 SCP 的时间长度(以秒为单位)。 |
操作优先级 (LOW, NORMAL, HIGH) | 是 | 是 | NORMAL | 这是以 SCP 为目标的图像传输的优先级。接收应用程序不必以此优先级工作。 |
以显式长度对序列进行编码 | 否 | 是 | 未选中 | 指定是否以显式长度对 DICOM 图像中的序列进行编码。 |
以显式长度对序列项进行编码 | 否 | 是 | 未选中 | 指定是否以显式长度对 DICOM 图像中的序列项进行编码。 |
包括组长度属性 | 否 | 是 | 未选中 | 指定 DICOM 属性组是否具有指定的长度。 |
以显式长度对空的序列进行编码 | 否 | 是 | 选中 | 指定是否以显式长度对 DICOM 图像中的空序列进行编码。 |
以显式长度对空的序列项进行编码 | 否 | 是 | 选中 | 指定是否以显式长度对 DICOM 图像中的空序列项进行编码。 |
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
等待存储落实响应的最大时间(秒) | 否 | 是 | 60 | 这是等待存储落实响应消息的最大时间长度。如果在此时间段内未接收到响应,那么此节点将生成错误。 |
接收存储落实响应的端口 | 否 | 是 | 2223 | 这是用于接收存储落实响应消息的端口。如果此字段为空,那么此节点将不会请求返回存储落实响应消息。 |