使用 DICOMInput 节点可以接收来自 SCU 的 DICOM 图像、将 DICOM 图像存储在文件系统中以及以 XML 消息形式将 DICOM 图像中的元数据传播到消息流。
DICOMInput 节点是 Verification 和 Storage 服务类的 Service Class Provider (SCP) 节点。此节点通过接受 DICOM C-STORE 命令接收来自 Service Class User (SCU) 的 DICOM 图像。然后,您可以对扫描的图像(像素数据)的存储进行管理并从 DICOM 图像中抽取元数据,以便在集成解决方案中使用。
DICOMInput 节点包含在消息流节点选用板的 Healthcare 抽屉中,在 IBM® Integration Toolkit 中由以下图标表示:
DICOMInput 节点支持验证 SOP 类,因此可以向此节点发出诊断 ECHO 请求以验证网络连接。
通过使用可配置服务,可以为此节点配置可供 SCU 使用的表示上下文和传输语法组。有关为 DICOMInput 节点创建可配置服务的详细信息,请参阅配置 DICOMInput 节点所接受的表示上下文。如果没有为此节点设置任何可配置服务,那么将使用表示上下文的缺省集合。有关表示上下文的缺省集合的详细信息,请参阅 DICOMInput 节点所使用的缺省表示上下文。
系统将复制 DICOM 图像中的元数据,并以 XML 消息形式通过外层消息流进行传播。DICOM XML 消息包含对文件系统中存储的扫描图像(像素数据)的引用。在消息流中,可以对 DICOM XML 消息中的元数据进行变换,但是,如果两个图像包含相同的 SOP 实例,那么根据 DICOM 标准,它们在每个方面都必须完全相同。如果将消息流配置为更改 DICOM XML 消息中的某些元数据,那么还应更改 SOP 实例,以使 DICOM 图像成为唯一标识的不同 DICOM 图像。
向 DICOMInput 节点发送 DICOM 图像的 SCU 可能会请求返回存储落实响应消息。存储落实响应的目的是确认成功交付了 DICOM 图像。DICOMInput 节点先将 DICOM 图像写入文件系统,然后再发送存储落实响应消息。存储落实响应将通过另一个连接以异步方式从 DICOMInput 节点发送到 SCU。因此,必须为 DICOMInput 节点配置一个能够作为其存储落实响应消息发送目标的端口。
DICOMInput 节点通过使用 WebSphere MQ 消息队列来管理元数据从 DICOM 图像到消息流的过渡。您必须对 DICOMInput 节点的每个实例指定唯一的消息队列名,这是因为,无法在此节点的多个实例之间共享队列名。
您可以为 DICOMInput 节点配置文件系统上的一个目录,用于存储 DICOM 图像。除非您使用的是多实例配置,否则此目录不可由任何其他节点使用。在多实例配置中,在主动代理和被动 集成节点 上配置了同一个消息流。在任意时间,只有一个消息流处于活动状态,并且,激活消息流时,DICOMInput 节点的状态由此共享文件系统目录提供。
条件 | 描述 | 类型 | 示例 | 建议 |
---|---|---|---|---|
开始接收 | DICOM 图像到达 DICOMInput 节点。
注: 此活动日志条目并不表示已将 DICOM 图像落实到文件系统。
|
参考 BIP12068 | Received DICOM instance (BROKERAE,SOURCEAE,hostname:1111) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像对象标识 (OID)。 |
无需执行任何操作。 |
结束接收 | 已将 DICOM 图像存储在文件系统中。抽取了 DICOM 图像中的元数据。
注: 此活动日志条目并不表示外层消息流已对 DICOM 图像中的元数据进行处理。
|
参考 BIP12068 | Finished processing DICOM
instance (BROKERAE,SOURCEAE,hostname:1111) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。 |
无需执行任何操作。 |
启动存储队列 | 已接收到 DICOM 图像,并且正在将其存储到文件系统。 | 参考 BIP12068 | Storing received DICOM instance
on queue (BROKERAE) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。 |
无需执行任何操作。 |
结束队列存储 | 已接收到 DICOM 图像并将其存储到文件系统。已成功地将 DICOM 图像中的元数据作为 XML 消息写入消息队列。 | 参考 BIP12068 | Finished storing DICOM instance
on queue (BROKERAE) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。 |
无需执行任何操作。 |
存储队列失败 | 已接收到 DICOM 图像并将其存储到文件系统。无法将 DICOM 图像中的元数据写入消息队列。 | 错误 BIP12070 | Failed to store the DICOM
instance on the queue (BROKERAE) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。 |
请检查该队列是否存在。
请检查是否对该队列启用了写操作。 请检查 集成节点 对该队列是否具有写许可权。 |
开始发送存储落实响应 | DICOMInput 节点正在将存储落实响应消息发送到远程 SCU。 | 参考 BIP12068 | Sending storage commit response message (BROKERAE,SOURCEAE,hostname:1112) | 无需执行任何操作。 |
结束发送存储落实响应 | 已成功地将存储落实响应消息发送到远程 SCU | 参考 BIP12068 | Finished sending storage commit response message (BROKERAE,SOURCEAE,hostname:1112) | 无需执行任何操作。 |
发送存储落实响应失败 | DICOMInput 节点无法将存储落实响应消息发送到远程 SCU。 | 警告 BIP12069 | Failed to send storage commit response message (BROKERAE,SOURCEAE,hostname:1112) | 请检查 集成节点 与远程 SCP 之间的网络连接。
请检查应用程序实体名称和端口号是否与远程 SCU 完全匹配。 请检查远程 SCU 是否处于联机状态并准备好接受存储落实连接。 请检查异常详细信息,以获取有关该错误的更多信息。 |
归档 DICOM 图像 | DICOMInput 节点正在对 DICOM 图像进行归档。 | 参考 BIP12068 | Archiving DICOM instance from
DICOMInput node (BROKERAE) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。 |
无需执行任何操作。 |
删除 DICOM 图像 | 正在从 DICOMInput 归档中删除 DICOM 图像。 | 参考 BIP12068 | Deleting DICOM instance from
DICOMInput node archive (BROKERAE) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。 |
无需执行任何操作。 |
处理 DICOM 图像失败 | 由于 DICOM 图像中的元数据大于 4 MB,因此 DICOMInput 节点未处理 DICOM 图像。 | 错误 BIP12070 | Failed to process DICOM instance
because it is larger than 4MB (BROKERAE) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。 |
请通过使用 DICOMInput 节点的排除 DICOM 属性特性从消息中排除 DICOM 属性。 |
处理 DICOM 图像失败 | DICOMInput 节点未处理 DICOM 图像。 | 错误 BIP12070 | Failed to process DICOM instance
in the DICOMInput node (BROKERAE) 在活动日志中的 FILENAME 字段中记录了 DICOM 图像 OID。 |
请检查传播到 DICOMInput 节点的 Failure 终端的消息,以获取更多信息。 |
将 DICOMInput 节点的实例添加到消息流后,可以对其进行配置。
在用户界面中,所有必须输入值(未定义缺省值)的必需属性均以星号标记。
终端 | 描述 |
---|---|
Failure | 这是发生错误时消息所路由到的输出终端。 消息流中发生错误时,DICOMInput 节点将传播故障消息。此错误可能是由于未连接 DICOMInput 节点的 Catch 终端所致,也可能是由于消息流的捕获处理逻辑出错所致。原始 DICOM XML 消息将传播到 Failure 终端。 如果在 DICOM XML 消息传播到 Out 终端前发生内部处理错误,那么消息也将传播到 Failure 终端。另外,还将编写活动日志条目。DICOMInput 节点不会再次处理与该故障消息相关联的 DICOM 图像,但可以对其进行归档。 发生内部处理错误的原因可能是,对 DICOMInput 节点可以传播的 DICOM XML 消息大小有所限制。此节点不传播大于 4 MB 的 DICOM XML 消息。可以通过排除节点属性对 DICOM XML 消息大小进行限制(请参阅 DICOMInput 节点的“高级”选项卡上的排除 DICOM 属性特性)。 |
Out | 如果从 DICOM SCU 成功检索到 DICOM XML 消息,那么该消息将路由到此输出终端。 |
Catch | 如果下游发生错误,并且此节点捕获到该错误,那么 DICOM XML 消息将路由到此输出终端。仅当连接了此终端时,才会捕获到错误。 |
元素 | 描述 |
---|---|
SOPInstanceUID | 失败的 DICOM 图像的唯一标识。 |
FailureReason | 有关未能成功处理 DICOM 图像的原因的说明。 |
ErrorComment | 这是用于说明故障发生原因的附加信息(如果有)。 |
下表描述了此节点的属性。标题为 M 的列指示属性是否为必需(如果在未定义缺省值时必须输入值,那么将以星号标记);标题为 C 的列指示属性是否可配置(将消息流添加到 BAR 文件以进行部署时,可以更改该属性的值)。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
节点名 | 是 | 否 | DICOMInput | 节点的名称。 |
简短描述 | 否 | 否 | 节点的简要描述。 | |
详细描述 | 否 | 否 | 描述消息流中节点用途的文本。 |
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
连接详细信息 | 是 | 是 | 1111 | 这是侦听连接请求的端口。 |
应用程序实体标题 (AET) | 是 | 是 | BROKERAE | 此 DICOM SCP 端点的名称。这是长度可达 16 个字符的文本字符串,用于在连接应用程序实体时对其进行标识。 |
处理目录 | 是 | 是 | Input | 这是一个文件系统目录,节点可以使用此目录来处理入局 DICOM
图像。对于此节点,此目录必须唯一。
注: 如果此节点属性是相对目录名,例如 Output,那么此名称将追加到
IBM Integration Bus 工作路径之后以生成绝对目录。如果此节点属性包含绝对目录名,例如 C:\DICOM\Input,那么将直接使用此目录名作为文件系统位置。
|
队列名称 | 是 | 是 | DICOM | 这是可以由此节点用于内部处理的 WebSphere MQ 队列的名称。此队列不得由任何其他节点或应用程序使用。 |
在 DICOM 图像到达下列小时数后将其归档 | 是 | 是 | 72 | 在此小时数过后,DICOM 图像将从处理目录移入名为 Archive 的子目录。 |
在 DICOM 图像到达下列小时数后将其删除 | 是 | 是 | 72 | 在 DICOM 图像到达此小时数之后,将其从 Archive 子目录中删除。 |
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
排除 DICOM 属性 | 否 | 是 | 7FE00010 | 这是以逗号分隔的 DICOM
标记列表。这些标记不会在 DICOM XML
消息中通过消息流传递。缺省值 7FE00010 是用于像素数据的标准 DICOM 标记。
注: 可以将其他 DICOM 标记添加到此列表中,例如添加 00420011,这是用于 DICOM 结构化报告 (SR) 中封装的数据的 DICOM 标记。
|
DICOM 可配置服务名称 | 否 | 是 | 这是可选的可配置服务名称。这个可配置服务包含节点提供给 SCU 使用的表示上下文。如果这个可配置服务不存在,或者不是有效的 DICOM 可配置服务,那么消息流启动时将出错。如果没有为此节点设置任何可配置服务,那么将使用表示上下文的缺省集合。 |
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
将存储落实响应发送到的端口 | 否 | 是 | 1112 | 这是一个可选端口号,用于将存储落实响应消息交付给发送 DICOM 图像的 SCU。如果此字段为空,那么此节点将不接受存储落实请求,也不发送存储落实响应消息。 |
连接超时(秒) | 否 | 是 | 60 | 这是此节点等待连接到 SCU 的时间长度(以秒为单位)。
注: 如果配置了用于交付存储落实响应消息的端口号,那么必须为此属性输入值。
|