DICOMInput 节点

使用 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 节点图标

在消息流中使用此节点

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 节点所发送的所有 DICOM XML 消息。但是,仅使用此模式中定义的其中一种复杂类型来构造每种类型的 DICOM XML 消息。使用 DICOM 复杂类型来定义从 DICOMInput 节点输出终端发送的 DICOM XML 消息。
有关此模式的更多信息,请参阅 DICOM 消息模式
DICOM 事务
DICOMInput 节点将 DICOM 图像存储在文件系统中。使用每个 DICOM 图像中的元数据来创建要写入 MQ 队列的 XML 消息。DICOMInput 节点使用 MQOutput 节点从队列中读取 XML 消息,并将这些消息传播到外层消息流。因此,每个 DICOM 图像有两个不同的事务,一个事务用于将 XML 消息写入队列,另一个事务用于从该队列中读取 XML 消息并将这些消息传播到外层消息流。您可以通过活动日志条目和服务跟踪来监视这些事务。

活动日志条目

下表详细描述 DICOMInput 节点所写的活动日志条目,并且示例中使用了下列名称:
  • BROKERAEDICOMInput 应用程序实体的名称
  • SOURCEAE 是发送 DICOM 图像的应用程序实体的名称
  • hostname:1111 是接收 DICOMInput 节点的主机名和端口号
  • hostname:1112 是远程应用程序实体的主机名和端口号
条件 描述 类型 示例 建议
开始接收 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 节点

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

在用户界面中,所有必须输入值(未定义缺省值)的必需属性均以星号标记。

终端和属性

下表描述了 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) 文件以进行部署时,可以更改该属性的值)。

下表描述了 DICOMInput 节点的“描述”属性。
属性 M C 缺省值 描述
节点名 DICOMInput 节点的名称。
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。
下表描述了 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 子目录中删除。
下表描述了 DICOMInput 节点的“高级”属性。
属性 M C 缺省值 描述
排除 DICOM 属性 7FE00010 这是以逗号分隔的 DICOM 标记列表。这些标记不会在 DICOM XML 消息中通过消息流传递。缺省值 7FE00010 是用于像素数据的标准 DICOM 标记。
注: 可以将其他 DICOM 标记添加到此列表中,例如添加 00420011,这是用于 DICOM 结构化报告 (SR) 中封装的数据的 DICOM 标记。
DICOM 可配置服务名称   这是可选的可配置服务名称。这个可配置服务包含节点提供给 SCU 使用的表示上下文。如果这个可配置服务不存在,或者不是有效的 DICOM 可配置服务,那么消息流启动时将出错。如果没有为此节点设置任何可配置服务,那么将使用表示上下文的缺省集合。
下表描述了 DICOMInput 节点的“存储落实”属性。
属性 M C 缺省值 描述
将存储落实响应发送到的端口 1112 这是一个可选端口号,用于将存储落实响应消息交付给发送 DICOM 图像的 SCU。如果此字段为空,那么此节点将不接受存储落实请求,也不发送存储落实响应消息。
连接超时(秒) 60 这是此节点等待连接到 SCU 的时间长度(以秒为单位)。
注: 如果配置了用于交付存储落实响应消息的端口号,那么必须为此属性输入值。
声明 | 商标 | 下载 | 资料库 | 支持 | 反馈

Copyright IBM Corporation 2011, 2014Copyright IBM Corporation 2011, 2014.

        
        最近一次更新时间
        最近一次更新时间 : 2014-03-20 23:38:24


参考主题参考主题 | V3.0.0.0 | ha05010