使用 DICOMFindMove 节点可以在远程 SCP 中查询患者、研究、序列和图像,并可以将查询结果返回给 DICOMInput 节点之类的应用程序实体。
DICOMFindMove 节点是“查询”和“检索”Service Class User (SCU) 节点。此节点具有两项紧密相关的功能。第一项功能是,使用 DICOM C-FIND 命令在远程 Service Class Provider (SCP) 中查询患者、研究、序列和图像。搜索条件在传播到节点输入终端的 XML 消息中指定。查询结果将传播到此节点的输出终端。DICOMFindMove 节点的第二项功能是,使用 DICOM C-MOVE 命令将查询结果移动到应用程序实体。移动命令的目标可以是在 IBM® Integration Bus、DICOM 图片归档通信系统 (PACS) 或任何其他 DICOM SCP 中配置的 DICOMInput 节点。
DICOMFindMove 节点包含在消息流节点选用板的 Healthcare 抽屉中,在 IBM Integration Toolkit 中由以下图标表示:
在模式资源管理器视图中,Healthcare 类别中的 Healthcare:Web 服务到 DICOM 内置模式显示了有关 DICOMFindMove 节点使用方法的示例。
查询功能和移动功能在 DICOM 中紧密相关,因此组合在一个节点中。在逻辑上,移动命令是先执行查找,然后将结果发送到指定目标的命令。移动操作完成后,会将一条结果消息传播到 DICOMFindMove 节点的输出终端。此结果消息包含有关移动命令成功与否的详细信息。此结果消息包含已完成的传输的计数、警告、故障、错误信息和状态字段。如果状态字段包含任何除零以外的值,那么表明移动操作未能成功完成。
DICOM 标准定义了两类查询,这些查询称为“根”。DICOMFindMove 节点使用这些根(患者和研究)来标识和检索数据。
对于根与级别的每种组合,DICOMFindMove 节点定义了支持的搜索属性以及 SCP 应该返回的最小属性集。有关支持的属性的信息,请参阅患者查询根和研究查询根。
此节点将通过输出终端在结果消息中传播所返回的属性。一个查询可以返回多个结果,但这些结果将作为单一结果消息从 DICOMFindMove 节点传播。供应商可能支持在 XML 查询消息中使用其他属性作为搜索条件。DICOMFindMove 节点允许在 XML 查询消息中配置这些附加属性,但因为这些属性特定于供应商,所以此节点未记录这些属性。DICOM 标准要求所有提供的搜索属性也在响应中返回。有关查询消息和响应消息的模式的信息,请参阅 DICOM 消息模式。
<DICOM:FindMove xmins:DICOM="http://com.ibm.healthcare/DICOM">
<QueryRoot>STUDY</QueryRoot>
<QueryLevel>STUDY</Querylevel>
<MoveDestination>BROKERAE</MoveDestination>
<OperationPriority>NORMAL</OperationPriority>
<Match>
<Attribute Tag="PatientName">FEROVIX</Attribute>
<Attribute Tag="AccessionNumber">1210490</Attribute>
</Match>
<Return>
</Return>
</DICOM:FindMove>
以下是返回到 DICOMFindMove
节点的结果消息的示例。要获取有关
DICOM 标记的详细信息,请参阅:DICOM Tags。<DICOM:Results xmins:DICOM="http://com.ibm.healthcare/DICOM">
<DICOM>
<Attribute Tag="00080005"VR="CS">ISO_IR 100</Attribute>
<Attribute Tag="00080016"VR="UI">1.2.840.10008.5.1.4.1.1.2</Attribute>
<Attribute Tag="00080018"VR="UI">1.3.12.2.1107.5.1.4.54203.30000004093016410718700003864</Attribute>
<Attribute Tag="00080052"VR="CS">IMAGE</Attribute>
<Attribute Tag="00080054"VR="AE">PACS</Attribute>
<Attribute Tag="00080056"VR="CS">ONLINE</Attribute>
<Attribute Tag="0020000D"VR="UI">1.3.12.2.1107.5.1.4.54203.30000004093013443132800000021</Attribute>
<Attribute Tag="0020000E"VR="UI">1.3.12.2.1107.5.1.4.54203.30000004093016410718700003676</Attribute>
<Attribute Tag="00200013"VR="IS">188</Attribute>
<Attribute Tag="00880130"VR="SH"/>
<Attribute Tag="00880140"VR="UI"/>
<MoveResults>
<Completed>1</Completed>
<Failed>0</Failed>
<Warnings>0</Warnings>
<Status>0</Status>
<ErrorID>0</ErrorID>
<ErrorComment/>
</MoveResults>
</DICOM>
</DICOM:Results>
条件 | 描述 | 类型 | 示例 | 建议 |
---|---|---|---|---|
开始查询检索 | 正在准备将 DICOM 查询发送到远程应用程序实体。
注: 在 DICOM 中,将 DICOM 查询命令称为 C-FIND 命令。
|
参考 BIP12068 | Starting DICOM C-FIND operation (BROKERAE, REMOTEAE1, hostname:11112) | 无需执行任何操作。 |
结束查询检索 | DICOM 查询(C-FIND 命令)已完成,所有结果都已准备好进行处理。结果消息将转换为 XML,然后传播到外层消息流。 | 参考 BIP12068 | Finished DICOM C-FIND operation (BROKERAE, REMOTEAE1, hostname:11112) | 无需执行任何操作。 |
查询检索失败 | DICOM 查询失败(C-FIND 命令)。DICOMFindMove 节点生成了错误。 | 错误 BIP12070 | Failed DICOM C-FIND operation (BROKERAE, REMOTEAE1, hostname:11112) | 请检查 集成节点 与远程 SCP 之间的网络连接。
请根据研究根和级别检查查询消息是否正确。 请检查查询消息是否包含所指定查询根和级别的必需键字段。 请检查应用程序实体名称和端口号是否与远程 SCP 完全匹配。 请检查远程 SCP 是否处于联机状态并准备好接受连接和数据传输。 请检查异常详细信息,以获取有关该错误的更多信息。 |
开始移动 | 正在将 DICOM 图像复制到目标应用程序实体。
注: 在 DICOM 中,将此操作称为 C-MOVE 命令。
|
参考 BIP12068 | Starting DICOM C-Move operation(BROKERAE,
REMOTEAE1, REMOTEAE2, 1, 5) 其中: 1 是当前 DICOM 图像的索引。 5 是待移动的 DICOM 图像的总数。 |
无需执行任何操作。 |
结束移动 | DICOM C-MOVE 命令已成功完成。
注: 如果 C-MOVE 的目标是 集成节点,那么此活动日志条目并不保证已处理 DICOM 图像。
|
参考 BIP12068 | Finished DICOM C-Move operation(BROKERAE,
REMOTEAE1, REMOTEAE2, 1, 5) 其中: 1 是当前 DICOM 图像的索引。 5 是待移动的 DICOM 图像的总数。 |
无需执行任何操作。 |
移动失败 | DICOM 移动(C-MOVE 命令)失败。DICOMFindMove 节点生成了错误。 | 错误 BIP12070 | Warnings or failures reported from DICOM C-MOVE operation (BROKERAE,REMOTEAE1,REMOTEAE2,hostname:11112) | 请检查 集成节点 与远程 SCP 之间的网络连接。
请检查移动目标是否有效以及是否在远程 SCP 上配置了此目标。 请检查移动目标 SCP 能否接受所移动的数据。 请根据研究根和级别检查查询消息是否正确。 请检查查询消息是否包含所指定查询根和级别的必需键字段。 请检查应用程序实体名称和端口号是否与远程 SCP 完全匹配。 请检查远程 SCP 是否处于联机状态并准备好接受连接和数据传输。 请检查异常详细信息,以获取有关该错误的更多信息。 |
将 DICOMFindMove 节点的实例添加到消息流后,可以对其进行配置。
所有必须输入值(未定义缺省值)的必需属性均以星号标记。
终端 | 描述 |
---|---|
In | 接受节点处理的消息的输入终端。 |
Out | 这是查询成功时结果消息所路由到的输出终端。 |
No match | 这是查询成功但未返回任何结果时结果消息所路由到的输出终端。从此终端传播的消息是常规结果消息,但其中未包含任何 DICOM 结果元素。 |
下表描述了此节点的属性。标题为 M 的列指示属性是否为必需(如果在未定义缺省值时必须输入值,那么将以星号标记);标题为 C 的列指示属性是否可配置(将消息流添加到 BAR 文件以进行部署时,可以更改该属性的值)。
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
节点名 | 是 | 否 | DICOMFindMove | 节点的名称。 |
简短描述 | 否 | 否 | 节点的简要描述。 | |
详细描述 | 否 | 否 | 描述消息流中节点用途的文本。 |
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
连接详细信息 | 是 | 是 | localhost:2222 | 这是此节点所连接的应用程序实体 SCP 的主机名和端口。 |
应用程序实体标题 (AET) | 是 | 是 | BROKERAE | 此 DICOM SCU 端点的名称。这是长度可达 16 个字符的文本字符串,用于在连接应用程序实体时对其进行标识。 |
远程应用程序实体标题 (AET) | 是 | 是 | REMOTEAE | 这是此节点所连接并向其发送查询的 DICOM SCP 端点的名称。 |
属性 | M | C | 缺省值 | 描述 |
---|---|---|---|---|
在达到下列响应次数后取消 | 否 | 是 | 99 | 此节点将在接收到此数目的响应消息后停止接收结果。此设置用于避免大型查询独占 SCP。 |
连接超时(秒) | 是 | 是 | 60 | 这是此节点等待与 SCP 建立连接的时间长度。 |
只提供隐式 VR 小尾数法传输语法 | 否 | 是 | 未选中 | 指定此节点是否应使用 DICOM 缺省设置隐式 VR 小尾数法编来连接到 SCP。 |
操作优先级 | 是 | 是 | NORMAL | 这是以 SCP 为目标的图像传输的优先级。接收应用程序不必以此优先级工作。 |