DICOMFindMove-Knoten

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.

Zweck
Verwendung dieses Knotens in einem Nachrichtenfluss
Abfragestämme
Aktivitätenprotokolleinträge
DICOMFindMove-Knoten konfigurieren
Terminals und Eigenschaften

Zweck

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:

Verwendung dieses Knotens in einem Nachrichtenfluss

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 erfordert die Identifikation von zwei Anwendungsentitäten, wenn diese eine Verbindung herstellen. Die Identifikation wird über einen Anwendungsentitätstitel (AET) erreicht, der als Textfolge mit bis zu 16 Zeichen angegeben wird. Der DICOMFindMove-Knoten muss mit einem eigenen Anwendungsentitätstitel und mit dem Anwendungsentitätstitel des SCP konfiguriert sein, zu dem er eine Verbindung herstellt. Der DICOMFindMove-Knoten stellt erst eine Verbindung her, wenn der Anwendungsentitätstitel des SCP genau dem Wert entspricht, der im DICOMFindMove-Knoten konfiguriert ist. Wenn die Verbindung nicht hergestellt werden kann, wird ein Fehler ausgegeben. Der Quellen-SCP für den Verschiebungsbefehl muss mit dem Hostnamen und der Portnummer des Ziels vorkonfiguriert sein, damit die DICOM-Bilder an ein anderes Ziel kopiert werden können.

Anmerkung: Der DICOMFindMove-Knoten definiert die Verbindungen von einer Nachrichtenübertragung zu einer anderen nicht als persistent.

Nachrichtenschema: Für die Beschreibung aller DICOM-XML-Nachrichten, die von den DICOM-Knoten gesendet und empfangen werden, wird ein einzelnes Schema verwendet. Allerdings wird nur einer der im Schema definierten komplexen Typen für die Strukturierung der einzelnen Nachrichtentypen verwendet. Mit dem komplexen Typ FindMove werden die beim Eingabeterminal des DICOMFindMove-Knotens empfangenen Nachrichten definiert, während mit dem komplexen Typ Results die Nachrichten definiert werden, die vom Ausgabeterminal des DICOMFindMove-Knotens gesendet werden.; Weitere Informationen zum Schema finden Sie unter DICOM-Nachrichtenschema.

DICOM-Transaktionen: Die Verarbeitung des DICOMFindMove-Knotens wird innerhalb der aktiven Transaktion für den Thread ausgeführt, der das DICOM-Bild verarbeitet. Wenn ein Fehler auftritt, gibt der DICOMFindMove-Knoten einen Fehler aus. Je nach Logik der Ausnahmebedingungsbehandlung im übergeordneten Nachrichtenfluss kann der Fehler dazu führen, dass die aktuelle Transaktion rückgängig gemacht wird.

Abfragestämme

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 Patientenstamm ermöglicht die folgenden Abfrageebenen.

Mit der Abfrage auf Patientenebene wird ein SCP im Hinblick auf Patientendaten abgefragt. Bei der Abfrage auf Patientenebene stehen mehrere Attribute zur Verfügung, die in der Abfrage verwendet werden können. Beispiele hierfür sind der Name, das Geschlecht und das Geburtsdatum des Patienten.
Mit der Abfrage auf Untersuchungsebene wird ein SCP im Hinblick auf Untersuchungen abgefragt, die für einen bestimmten Patienten durchgeführt wurden. Die Abfrage auf Untersuchungsebene muss das Attribut für die Patienten-ID und keine sonstigen Attribute enthalten. Optional kann die Suche mit weiteren Attributen eingegrenzt werden (zum Beispiel mit dem Attribut für das Untersuchungsdatum).
Mit der Abfrage auf Zeitreihenebene wird ein SCP im Hinblick auf die Zeitreihe innerhalb einer bestimmten Untersuchung abgefragt. Die Abfrage auf Zeitreihenebene muss die Benutzer-ID der Untersuchung enthalten. Optional kann die Suche mit weiteren Attributen eingegrenzt werden (zum Beispiel mit dem Attribut für die Modalität).
Mit der Abfrage auf Bildebene wird ein SCP im Hinblick auf bestimmte Bilder in einer Zeitreihe abgefragt. Eine Abfrage auf Bildebene muss die Benutzer-ID der Zeitreihe enthalten.

Der Untersuchungsstamm ähnelt dem Patientenstamm, enthält jedoch keine Abfrage auf Patientenebene. Der Untersuchungsstamm ermöglicht die folgenden Abfrageebenen.

Mit der Abfrage auf Untersuchungsebene wird ein SCP im Hinblick auf Untersuchungen abgefragt, die für einen bestimmten Patienten durchgeführt wurden. Es sind keine obligatorischen Attribute festgelegt, es stehen jedoch viele optionale Attribute zur Verfügung, mit denen unter anderem das Datum und die Uhrzeit der Untersuchung sowie der Name, die ID und das Geschlecht des Patienten abgefragt werden können.
Anmerkung: Sie können diese Abfrage auf Untersuchungsebene als eine Zusammenführung der Abfragen auf Untersuchungs- und Patientenebene aus dem Patientenstamm betrachten. Mit der Abfrage auf Untersuchungsebene können Sie über einige einfache Suchkriterien (zum Beispiel Patientenname und Untersuchungsdatum) alle Untersuchungen suchen, die für einen Patienten durchgeführt wurden. Beim Patientenstamm benötigen Sie zwei separate Abfragen, um dasselbe Ergebnis zu erzielen. Bei der ersten Abfrage handelt es sich um eine Abfrage auf Patientenebene, mit der eine Patienten-ID gesucht wird, während die zweite Abfrage eine Abfrage auf Untersuchungsebene ist, mit der die Untersuchungen für den betreffenden Patienten gesucht werden.
Mit der Abfrage auf Zeitreihenebene wird ein SCP im Hinblick auf die Zeitreihe innerhalb einer bestimmten Untersuchung abgefragt. Die Abfrage auf Zeitreihenebene muss die Benutzer-ID der Untersuchung enthalten. Optional kann die Suche mit weiteren Attributen eingegrenzt werden (zum Beispiel mit dem Attribut für die Modalität).
Mit der Abfrage auf Bildebene wird eine Abfrage bestimmter Bilder in einer Zeitreihe durchgeführt. Eine Abfrage auf Bildebene muss die Benutzer-ID der Zeitreihe enthalten.

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.

Es folgt das Beispiel einer Abfragenachricht eines DICOMFindMove-Knotens, die den Anwendungsentitätstitel des Verschiebungsziels in die XML-Nachricht einschließt.

<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>

Aktivitätenprotokolleinträge

In der folgenden Tabelle werden die vom DICOMFindMove-Knoten geschriebenen Aktivitätenprotokolleinträge im Detail aufgeführt. In den Beispielen werden die folgenden Namen verwendet:

BROKERAE ist der Name der sendenden Anwendungsentität.
REMOTEAE1 ist der Name der fernen Anwendungsentität, an die Abfragen gesendet werden.
REMOTEAE2 ist der Name der Anwendungsentität, an die die DICOM-Bilder kopiert werden.
hostname:11112 gibt den Hostnamen und die Portnummer der fernen Anwendungsentität an, an die Abfragen gesendet werden.

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.

DICOMFindMove-Knoten konfigurieren

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.

Terminals und Eigenschaften

Die DICOMFindMove-Knotenterminals werden in der folgenden Tabelle beschrieben.

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).

In der folgenden Tabelle werden die Beschreibungseigenschaften für den DICOMFindMove-Knoten beschrieben.

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

In der folgenden Tabelle werden die grundlegenden Eigenschaften für den DICOMFindMove-Knoten beschrieben.

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.

In der folgenden Tabelle werden die erweiterten Eigenschaften für den DICOMFindMove-Knoten beschrieben.

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.

Letzte Aktualisierung: : 2014-09-29 15:49:33

Referenzthema | Version 3.0.0.1 | ha05030