Mit einem DICOMFindMove-Knoten können Sie einen fernen SCP nach Patienten, Untersuchungen, Zeitreihen und Bildern abfragen und die Abfrageergebnisse auf eine Anwendungsentität wie beispielsweise auf einen DICOMInput-Knoten verschieben.
Der DICOMFindMove-Knoten ist ein Serviceklassenbenutzer (Service Class User, SCU) für die Serviceklassen 'Abfragen' und 'Abrufen'. Der Knoten verfügt über zwei Funktionen, die eng miteinander verknüpft sind. Die erste Funktion ermöglicht die Abfrage eines fernen SCP (Service Class Provider, Serviceklassenprovider) im Hinblick auf Patienten, Untersuchungen, Zeitreihen und Bilder mit dem DICOM-Befehl C-FIND. Die Suchkriterien werden in einer XML-Nachricht angegeben, die an das Eingabeterminal des Knotens weitergegeben wird. Das Ergebnis der Abfrage wird an das Ausgabeterminal des Knotens weitergeleitet. Die zweite Funktion des DICOMFindMove-Knotens ermöglicht das Verschieben der Abfrageergebnisse an eine Anwendungsentität mit dem DICOM-Befehl C-MOVE. Das Ziel eines Verschiebungsbefehls kann ein in IBM® Integration Bus konfigurierter DICOMInput-Knoten, ein DICOM-Bildablage- und -Kommunikationssystem (Picture Archiving and Communication System, PACS) oder ein beliebiger anderer DICOM-SCP sein.
Der DICOMFindMove-Knoten befindet sich im Ablagefach Healthcare der Nachrichtenflussknotenpalette und wird im IBM Integration Toolkit durch folgendes Symbol dargestellt:
Ein Beispiel für die Verwendung des DICOMFindMove-Knotens wird im integrierten Muster Healthcare: Web-Service an DICOM in der Kategorie Healthcare in der Ansicht Musterexplorer gezeigt.
Die Abfrage- und Verschiebungsfunktionen werden in einem Knoten kombiniert, da sie in DICOM eng miteinander verknüpft sind. Ein Verschiebungsbefehl ist logisch ein Suchbefehl, auf den das Kopieren der Ergebnisse an eine benannte Zieladresse folgt. Sobald die Verschiebeoperationen abgeschlossen sind, wird eine Ergebnisnachricht an das Ausgabeterminal des DICOMFindMove-Knotens weitergegeben. Die Ergebnisnachricht enthält Details zum Erfolg oder Fehlschlag des Verschiebungsbefehls. Die Ergebnisnachricht enthält die Anzahl abgeschlossener Übertragungen, Warnungen, Fehler, Fehlerinformationen und ein Statusfeld. Wenn das Statusfeld einen anderen Wert als null enthält, wurde die Verschiebeoperation nicht erfolgreich ausgeführt.
Der DICOM-Standard definiert zwei Abfragetypen, die als "Stämme" bezeichnet werden. Diese Stämme (Patient und Untersuchung) werden vom DICOMFindMove-Knoten für die Ermittlung und den Abruf von Daten verwendet.
Der DICOMFindMove-Knoten definiert für jede Kombination aus Stamm und Ebene die unterstützten Suchattribute und eine Mindestgruppe der Attribute, die vom SCP zurückgegeben werden sollen. Lesen Sie die Abschnitte Patientenabfragestamm und Untersuchungsabfragestamm, die Informationen zu den unterstützten Attributen enthalten.
Die zurückgegebenen Attribute werden vom Knoten in den Ergebnisnachrichten über das Ausgabeterminal weitergegeben. Eine Abfrage kann viele Ergebnisse liefern, die jedoch in Form einer einzelnen Ergebnisnachricht vom DICOMFindMove-Knoten weitergegeben werden. Verschiedene Hersteller können zusätzliche Attribute unterstützen, die als Suchkriterien in der XML-Abfragenachricht verwendet werden können. Der DICOMFindMove-Knoten ermöglicht zwar die Konfiguration dieser zusätzlichen Attribute in der XML-Abfragenachricht, sie werden vom Knoten jedoch nicht dokumentiert (da sie herstellerspezifisch sind). Der DICOM-Standard erfordert, dass alle angegebenen Suchattribute in Antworten ebenfalls aufgelistet werden. Im Abschnitt DICOM-Nachrichtenschema finden Sie Informationen zu dem Schema für die Abfrage- und Antwortnachrichten.
<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>
Es folgt das Beispiel einer Ergebnisnachricht, die an den DICOMFindMove-Knoten zurückgegeben wird. Im folgenden Abschnitt finden Sie Details zu den DICOM-Tags: 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>
Bedingung | Beschreibung | Typ | Beispiel | Empfehlungen |
---|---|---|---|---|
Beginn des Abfrageabrufs | Eine DICOM-Abfrage wird zum Senden an eine ferne Anwendungsentität vorbereitet. Anmerkung: Ein DICOM-Abfragebefehl ist in DICOM als C-FIND-Befehl bekannt.
|
Information BIP12068 | DICOM C-FIND-Operation wird gestartet (BROKERAE, REMOTEAE1, hostname:11112) | Es ist keine Aktion erforderlich. |
Beendigung des Abfrageabrufs | Die DICOM-Abfrage (Befehl C-FIND) ist abgeschlossen und vorhandene Ergebnisse können verarbeitet werden. Die Ergebnisnachrichten werden in XML umgewandelt und anschließend an den übergeordneten Nachrichtenfluss weitergegeben. | Information BIP12068 | DICOM C-FIND-Operation abgeschlossen (BROKERAE, REMOTEAE1, hostname:11112) | Es ist keine Aktion erforderlich. |
Abfrageabruf fehlgeschlagen | Die DICOM-Abfrage ist fehlgeschlagen (Befehl C-FIND). Vom DICOMFindMove-Knoten wird ein Fehler ausgegeben. | Fehler BIP12070 | DICOM C-FIND-Operation fehlgeschlagen (BROKERAE, REMOTEAE1, hostname:11112) | Überprüfen Sie die Netzkonnektivität zwischen dem Broker und dem fernen SCP. Vergewissern Sie sich anhand des Untersuchungsstamms und der Ebene, dass die Abfragenachricht korrekt ist. Vergewissern Sie sich, dass die Abfragenachricht die vorausgesetzten Schlüsselfelder für den angegebenen Abfragestamm und die Ebene enthält. Vergewissern Sie sich, dass die Anwendungsentitätsnamen und -portnummern genau dem fernen SCP entsprechen. Vergewissern Sie sich, dass der ferne SCP online und zum Akzeptieren von Verbindungen und Datenübertragungen bereit ist. Überprüfen Sie die Ausnahmebedingungsdetails auf weitere Informationen zum Fehler. |
Beginn der Verschiebung | Ein DICOM-Bild wird gerade an eine Zielanwendungsentität kopiert. Anmerkung: Diese Operation wird in DICOM als C-MOVE-Befehl bezeichnet.
|
Information BIP12068 | DICOM C-MOVE-Operation wird gestartet (BROKERAE,
REMOTEAE1, REMOTEAE2, 1, 5) Dabei gilt Folgendes: 1 ist der Index des aktuellen DICOM-Bilds. 5 ist die Gesamtzahl der zu verschiebenden DICOM-Bilder. |
Es ist keine Aktion erforderlich. |
Beendigung der Verschiebung | Ein DICOM-Befehl des Typs C-MOVE wurde erfolgreich ausgeführt. Anmerkung: Wenn ein Broker das Ziel des C-MOVE-Befehls ist, bedeutet dieser Eintrag im Aktivitätenprotokoll nicht unbedingt, dass die DICOM-Bilder verarbeitet wurden.
|
Information BIP12068 | DICOM C-MOVE-Operation abgeschlossen (BROKERAE,
REMOTEAE1, REMOTEAE2, 1, 5) Dabei gilt Folgendes: 1 ist der Index des aktuellen DICOM-Bilds. 5 ist die Gesamtzahl der zu verschiebenden DICOM-Bilder. |
Es ist keine Aktion erforderlich. |
Verschiebung fehlgeschlagen | Eine DICOM-Verschiebung (Befehl C-MOVE) ist fehlgeschlagen. Vom DICOMFindMove-Knoten wird ein Fehler ausgegeben. | Fehler BIP12070 | Warnungen oder Fehlerberichte von DICOM C-MOVE-Operation (BROKERAE,REMOTEAE1,REMOTEAE2,hostname:11112) | Überprüfen Sie die Netzkonnektivität zwischen dem Broker und dem fernen SCP. Überprüfen Sie, ob das Ziel der Verschiebung gültig und auf dem fernen SCP konfiguriert ist. Vergewissern Sie sich, dass die zu verschiebenden Daten vom Ziel-SCP der Verschiebung akzeptiert werden können. Vergewissern Sie sich anhand des Untersuchungsstamms und der Ebene, dass die Abfragenachricht korrekt ist. Vergewissern Sie sich, dass die Abfragenachricht die erforderlichen Schlüsselfelder für den angegebenen Abfragestamm und die Ebene enthält. Vergewissern Sie sich, dass die Anwendungsentitätsnamen und -portnummern genau dem fernen SCP entsprechen. Vergewissern Sie sich, dass der ferne SCP online und zum Akzeptieren von Verbindungen und Datenübertragungen bereit ist. Überprüfen Sie die Ausnahmebedingungsdetails auf weitere Informationen zum Fehler. |
Nachdem Sie eine Instanz eines DICOMFindMove-Knotens in einem Nachrichtenfluss hinzugefügt haben, können Sie ihn konfigurieren.
Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Stern markiert.
Terminal | Beschreibung |
---|---|
Eingabe | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Ausgabe | Das Ausgabeterminal, an das eine Ergebnisnachricht weitergeleitet wird, wenn eine Abfrage erfolgreich war. |
Keine Übereinstimmung | Das Ausgabeterminal, an das eine Ergebnisnachricht weitergeleitet wird, wenn eine Abfrage erfolgreich ist, jedoch keine Ergebnisse zurückgegeben werden. Die von diesem Terminal weitergegebene Nachricht ist eine reguläre Ergebnisnachricht, die jedoch keine DICOM-Ergebniselemente enthält. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Stern, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn zu implementieren).
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Ja | Nein | DICOMFindMove | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Kurzbeschreibung des Knotens | |
Ausführliche Beschreibung | Nein | Nein | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Verbindungsdetails | Ja | Ja | localhost:2222 | Der Hostname und der Port für den SCP der Anwendungsentität, zu dem der Knoten eine Verbindung herstellt. |
Anwendungsentitätstitel (AET) | Ja | Ja | BROKERAE | Der Name für diesen DICOM-SCU-Endpunkt. Eine Textfolge mit bis zu 16 Zeichen, mit der Anwendungsentitäten identifiziert werden können, wenn sie eine Verbindung herstellen. |
Titel der fernen Anwendungsentität (AET) | Ja | Ja | REMOTEAE | Der Name des DICOM-SCP-Endpunkts, mit dem sich der Knoten verbindet und an den er Abfragen sendet. |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Nach dieser Anzahl von Antworten abbrechen | Nein | Ja | 99 | Nach dem Empfang dieser Anzahl von Antwortnachrichten stoppt der Knoten den Empfang weiterer Ergebnisse. Diese Einstellung verhindert eine Vereinnahmung des SCP durch umfangreiche Abfragen. |
Verbindungszeitlimit (Sekunden) | Ja | Ja | 60 | Die Zeit, die der Knoten auf die Herstellung einer Verbindung zum SCP wartet. |
Nur implizite VR Little Endian-Übertragungssyntax anbieten | Nein | Ja | Nicht ausgewählt | Gibt an, ob der Knoten unter Verwendung der standardmäßigen DICOM-Einstellung der impliziten VR Little Endian-Codierung eine Verbindung zum SCP herstellen soll. |
Priorität der Operation | Ja | Ja | NORMAL | Die Priorität für die Übertragung des Bildes an den SCP. Die empfangende Anwendung muss sich nicht unbedingt an diese Priorität halten. |