DICOMFindMove 节点

使用 DICOMFindMove 节点可以在远程 SCP 中查询患者、研究、序列和图像,并可以将查询结果返回给 DICOMInput 节点之类的应用程序实体。

用途

DICOMFindMove 节点是“查询”和“检索”Service Class User (SCU) 节点。此节点具有两项紧密相关的功能。第一项功能是,使用 DICOM C-FIND 命令在远程 Service Class Provider (SCP) 中查询患者、研究、序列和图像。搜索条件在传播到节点输入终端的 XML 消息中指定。查询结果将传播到此节点的输出终端。DICOMFindMove 节点的第二项功能是,使用 DICOM C-MOVE 命令将查询结果移动到应用程序实体。移动命令的目标可以是在 IBM® Integration BusDICOM 图片归档通信系统 (PACS) 或任何其他 DICOM SCP 中配置的 DICOMInput 节点。

DICOMFindMove 节点包含在消息流节点选用板的 Healthcare 抽屉中,在 IBM Integration Toolkit 中由以下图标表示:

DICOMFindMove 节点图标

在消息流中使用此节点

模式资源管理器视图中,Healthcare 类别中的 Healthcare:从 Web Service 到 DICOM 内置模式显示了有关 DICOMFindMove 节点使用方法的示例。

查询功能和移动功能在 DICOM 中紧密相关,因此组合在一个节点中。在逻辑上,移动命令是先执行查找,然后将结果发送到指定目标的命令。移动操作完成后,会将一条结果消息传播到 DICOMFindMove 节点的输出终端。此结果消息包含有关移动命令成功与否的详细信息。此结果消息包含已完成的传输的计数、警告、故障、错误信息和状态字段。如果状态字段包含任何除零以外的值,那么表明移动操作未能成功完成。

DICOM 标准有一项要求,即,在连接两个应用程序实体时,对其进行标识。此标识通过应用程序实体标题 (AET) 实现,该标题是长度可达 16 个字符的文本字符串。您必须为 DICOMFindMove 节点配置它自己的 AET,并为它所连接的 SCP 配置 AET。除非该 SCP 的 AET 与 DICOMFindMove 节点中配置的值完全匹配,否则 DICOMFindMove 节点无法进行连接。如果无法建立连接,那么将生成错误。要将 DICOM 图像复制到另一个目标,必须为移动命令的源 SCP 预先配置目标的主机名和端口号。
注: DICOMFindMove 节点不会在两次消息传输之间保持连接。
消息模式
使用单一模式来描述 DICOM 节点所发送和接收的所有 DICOM XML 消息。但是,仅使用此模式中定义的其中一种复杂类型来构造每种类型的消息。使用 FindMove 复杂类型来定义在 DICOMFindMove 节点输入终端上接收的消息,并使用 Results 复杂类型来定义从 DICOMFindMove 节点输出终端发送的消息。
有关此模式的更多信息,请参阅 DICOM 消息模式
DICOM 事务
DICOMFindMove 节点处理在处理 DICOM 图像的线程的活动事务内运行。如果出错,那么 DICOMFindMove 节点将生成错误。根据外层消息流中的异常处理逻辑不同,此错误可能会导致当前事务回滚。

查询根

DICOM 标准定义了两类查询,这些查询称为“根”。DICOMFindMove 节点使用这些根(患者和研究)来标识和检索数据。

患者根允许进行下列级别的查询。
  • 患者级查询用于在 SCP 中查询患者信息。患者级查询具有一组可以在查询中使用的属性,例如患者的姓名、性别和出生日期。
  • 研究级查询用于在 SCP 中查询指定患者的研究。研究级查询必须包含患者标识属性以及零个或零个以上用于进一步优化搜索的可选属性,例如研究日期。
  • 系列级查询用于在 SCP 中查询特定研究内的系列。系列级查询必须包含研究 UID 以及零个或零个以上用于进一步优化搜索的可选属性,例如医疗器械。
  • 图像级查询用于在 SCP 中查询系列中的特定图像。图像级查询必须包含系列 UID。
研究根与患者根相似,但不具有患者级查询。研究根允许进行下列级别的查询。
  • 研究级查询用于在 SCP 中查询指定患者的研究。没有必需属性,但存在许多可选属性,其中包括研究日期、研究时间、患者姓名、患者标识和患者性别。
    注: 可以将此研究级查询视作患者根中研究级查询与患者级查询的合并。可以使用研究级查询在给定一些基本搜索条件(例如患者姓名和研究日期)的情况下搜索某位患者的所有研究。通过使用患者根,您需要两个单独的查询实现同一结果。第一个查询是用于查找患者标识的患者级查询,第二个查询是用于查找该患者的研究的研究级查询。
  • 系列级查询用于在 SCP 中查询特定研究内的系列。系列级查询必须包含研究 UID 以及零个或零个以上用于进一步优化搜索的可选属性,例如医疗器械。
  • 图像级查询用于查询系列中的特定图像。图像级查询必须包含系列 UID。

对于根与级别的每种组合,DICOMFindMove 节点定义了支持的搜索属性以及 SCP 应该返回的最小属性集。有关支持的属性的信息,请参阅患者查询根研究查询根

此节点将通过输出终端在结果消息中传播所返回的属性。一个查询可以返回多个结果,但这些结果将作为单一结果消息从 DICOMFindMove 节点传播。供应商可能支持在 XML 查询消息中使用其他属性作为搜索条件。DICOMFindMove 节点允许在 XML 查询消息中配置这些附加属性,但因为这些属性特定于供应商,所以此节点未记录这些属性。DICOM 标准要求所有提供的搜索属性也在响应中返回。有关查询消息和响应消息的模式的信息,请参阅 DICOM 消息模式

以下是 DICOMFindMove 节点查询消息的示例,在此示例中,XML 消息包含移动目标 AET。
<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>

活动日志条目

下表详细描述 DICOMFindMove 节点所写的活动日志条目,并且示例中使用了下列名称:
  • BROKERAE 是发送应用程序实体的名称。
  • REMOTEAE1 是查询所发送到的远程应用程序实体的名称。
  • REMOTEAE2DICOM 图像所复制到的应用程序实体的名称。
  • hostname:11112 是查询所发送到的远程应用程序实体的主机名和端口号。
条件 描述 类型 示例 建议
开始查询检索 正在准备将 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 节点

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

所有必须输入值(未定义缺省值)的必需属性均以星号标记。

终端和属性

下表描述了 DICOMFindMove 节点的终端。
终端 描述
In 接受节点处理的消息的输入终端。
Out 这是查询成功时结果消息所路由到的输出终端。
No match 这是查询成功但未返回任何结果时结果消息所路由到的输出终端。从此终端传播的消息是常规结果消息,但其中未包含任何 DICOM 结果元素。

下表描述了此节点的属性。标题为 M 的列指示属性是否为必需(如果在未定义缺省值时必须输入值,那么将以星号标记);标题为 C 的列指示属性是否可配置(将消息流添加到代理归档 (BAR) 文件以进行部署时,可以更改该属性的值)。

下表描述了 DICOMFindMove 节点的“描述”属性。
属性 M C 缺省值 描述
节点名 DICOMFindMove 节点的名称。
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。
下表描述了 DICOMFindMove 节点的“基本”属性。
属性 M C 缺省值 描述
连接详细信息 localhost:2222 这是此节点所连接的应用程序实体 SCP 的主机名和端口。
应用程序实体标题 (AET) BROKERAE DICOM SCU 端点的名称。这是长度可达 16 个字符的文本字符串,用于在连接应用程序实体时对其进行标识。
远程应用程序实体标题 (AET) REMOTEAE 这是此节点所连接并向其发送查询的 DICOM SCP 端点的名称。
下表描述了 DICOMFindMove 节点的“高级”属性。
属性 M C 缺省值 描述
在达到下列响应次数后取消 99 此节点将在接收到此数目的响应消息后停止接收结果。此设置用于避免大型查询独占 SCP。
连接超时(秒) 60 这是此节点等待与 SCP 建立连接的时间长度。
只提供隐式 VR 小尾数法传输语法 未选中 指定此节点是否应使用 DICOM 缺省设置“隐式 VR 小尾数法编码”来连接到 SCP。
操作优先级 NORMAL 这是以 SCP 为目标的图像传输的优先级。接收应用程序不必以此优先级工作。
声明 | 商标 | 下载 | 资料库 | 支持 | 反馈

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

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


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