使用 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 节点通过使用 Integration Explorer 消息队列来管理元数据从 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 | 这是可以由此节点用于内部处理的 Integration Explorer 队列的名称。此队列不得由任何其他节点或应用程序使用。 |
在 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 的时间长度(以秒为单位)。
注: 如果配置了用于交付存储落实响应消息的端口号,那么必须为此属性输入值。
|