Utilisez un noeud DICOMFindMove pour interroger un noeud SCP distant sur les patients, les études, les séries et les images, et pour déplacer les résultats d'une requête sur une entité d'application, comme un noeud DICOMInput.
Le noeud DICOMFindMove est un noeud SCU (Service Class User) pour les classes de service Query et Retrieve. Le noeud possède deux fonctionnalités étroitement liées. La première consiste à interroger un noeud SCP (Service Class Provider) distant sur les patients, les études, les séries et les images par le biais d'une commande DICOM C-FIND. Les critères de recherche sont spécifiés dans un message XML qui est propagé vers le terminal d'entrée du noeud. Le résultat de la requête est propagé vers le terminal de sortie du noeud. La deuxième fonctionnalité du noeud DICOMFindMove consiste à déplacer les résultats d'une requête vers une entité d'application à l'aide d'une commande DICOM C-MOVE. La destination d'une commande move peut être un noeud DICOMInput configuré dans IBM® Integration Bus, un DICOM PACS (Picture Archiving Communications System) ou tout autre noeud DICOM SCP.
Le noeud DICOMFindMove est contenu dans le tiroir Healthcare de la palette de noeuds de flux de messages et il est représenté dans IBM Integration Toolkit par l'icône suivante :
Un exemple d'utilisation du noeud DICOMFindMove est présenté dans le modèle intégré Healthcare : Service Web vers DICOM dans la catégorie Healthcare de la vue Patterns Explorer.
Les fonctionnalités de requête et de déplacement sont combinées dans un noeud car elles sont étroitement liées dans DICOM. Une commande move est logiquement une commande find suivie d'une copie des résultats vers une destination désignée. Une fois les opérations move terminées, un message de résultat est propagé vers le terminal de sortie du noeud DICOMFindMove. Ce message inclut les détails de la réussite et de l'échec de la commande move. Il dénombre les transferts, les avertissements, les échecs, les informations d'erreur et une zone de statut. Si cette dernière contient une valeur autre que zéro, l'opération move ne s'est pas terminée avec succès.
La norme DICOM définit deux types de requête désignées comme racines. Ces racines, patient et étude sont utilisés par le noeud DICOMFindMove pour identifier et extraire les données.
Pour chaque combinaison de racine et de niveau, le noeud DICOMFindMove définit les attributs de recherche pris en charge et un ensemble minimal d'attributs devant être renvoyés par le noeud SCP. Pour plus d'informations sur les attributs pris en charge, voir Racine de requête de patient et Racine de requête d'étude.
Les attributs renvoyés sont propagés par le noeud dans les messages de résultats provenant du terminal de sortie. Une requête peut renvoyer un grand nombre de résultats, mais ces derniers sont propagés sous la forme d'un message de résultats unique à partir du noeud DICOMFindMove. Les fournisseurs peuvent prendre en charge des attributs supplémentaires à utiliser comme critères de recherche dans le message de requête XML. Le noeud DICOMFindMove permet à ces attributs supplémentaires d'être configurés dans le message de requête XML, mais ils ne sont pas documentés par le noeud (étant propres au fournisseur). La norme DICOM exige que tous les attributs de recherche fournis soient également renvoyés en réponses. Pour plus d'informations sur le schéma des messages de requête et de réponse, voir Schéma de message 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>
Voici un exemple de message de résultats renvoyé au noeud DICOMFindMove. Pour le détail des étiquettes DICOM, voir : 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>
Condition | Description | Type | Exemple | Recommandations |
---|---|---|---|---|
Démarrage de l'extraction de la requête | Une requête DICOM est en cours de préparation en vue de son envoi à une entité d'application distante. Remarque : Une commande de requête DICOM est appelée dans DICOM sous la forme d'une commande C-FIND.
|
Information BIP12068 | Starting DICOM C-FIND operation (BROKERAE, REMOTEAE1, hostname:11112) | Aucune action n'est nécessaire |
Fin de l'extraction de la requête | La requête DICOM (commande C-FIND) a abouti et des résultats sont prêts à être traités. Les messages de résultats sont convertis en XML et propagés ensuite vers le flux de messages qui les contient. | Information BIP12068 | Finished DICOM C-FIND operation (BROKERAE, REMOTEAE1, hostname:11112) | Aucune action n'est nécessaire |
Echec de l'extraction de la requête | La requête DICOM a échoué (commande C-FIND). Une erreur est générée par le noeud DICOMFindMove. | Erreur BIP12070 | Failed DICOM C-FIND operation (BROKERAE, REMOTEAE1, hostname:11112) | Vérifiez la connectivité du réseau entre le noeud d'intégration et le noeud SCP distant. Assurez-vous que le message de requête est correct en fonction de la racine étude et du niveau étude. Vérifiez que le message de requête contient les zones clés requises pour la racine étude et le niveau étude indiqués. Vérifiez que les noms d'entité d'application et les numéros de port correspondent également au noeud SCP distant. Vérifiez que ce dernier est en ligne et prêt à accepter les connexions et les transferts de données. Pour plus d'informations sur l'erreur, consultez le détail de l'exception. |
Démarrage de la commande Move | Une image DICOM est copiée vers une entité d'application de destination. Remarque : Cette opération est connue dans DICOM sous la forme d'une commande C-MOVE.
|
Information BIP12068 | Starting DICOM C-Move operation(BROKERAE,
REMOTEAE1, REMOTEAE2, 1, 5) où : 1 est l'index de l'image DICOM en cours. 5 est le nombre total d'images DICOM à déplacer. |
Aucune action n'est nécessaire |
Fin de la commande Move | Une commande DICOM C-MOVE a abouti. Remarque : Si la destination de la commande C-MOVE est un noeud d'intégration, cette entrée de journal d'activité ne garantit pas que les images DICOM ont été traitées.
|
Information BIP12068 | Finished DICOM C-Move operation(BROKERAE,
REMOTEAE1, REMOTEAE2, 1, 5) où : 1 est l'index de l'image DICOM en cours. 5 est le nombre total d'images DICOM à déplacer. |
Aucune action n'est nécessaire |
Echec de la commande Move | Une commande DICOM Move (command C-MOVE) a échoué. Une erreur est générée par le noeud DICOMFindMove. | Erreur BIP12070 | Warnings or failures reported from DICOM C-MOVE operation (BROKERAE,REMOTEAE1,REMOTEAE2,hostname:11112) | Vérifiez la connectivité du réseau entre le noeud d'intégration et le noeud SCP distant. Assurez-vous que la destination de la commande Move est valide et configurée sur le noeud SCP distant. Vérifiez que les données déplacées peuvent être acceptées par le noeud SCP de destination de la commande Move. Assurez-vous que le message de requête est correct en fonction de la racine étude et du niveau étude. Vérifiez que le message de requête contient les zones clés requises pour la racine étude et le niveau étude indiqués. Vérifiez que les noms d'entité d'application et les numéros de port correspondent également au noeud SCP distant. Vérifiez que ce dernier est en ligne et prêt à accepter les connexions et les transferts de données. Pour plus d'informations sur l'erreur, consultez le détail de l'exception. |
Après avoir ajouté une instance d'un noeud DICOMFindMove à un flux de messages, vous pouvez la configurer
Toutes les propriétés obligatoires pour lesquelles vous devez entrer une valeur (celles qui ne comportent pas de valeur par défaut) sont marquées par un astérisque.
Terminal | Description |
---|---|
Entrée | Terminal d'entrée qui accepte un message pour traitement par le noeud. |
Sortie | Terminal de sortie vers lequel un message de résultats est acheminé si une requête aboutit. |
Pas de correspondance | Terminal de sortie vers lequel un message de résultats est acheminé si une requête aboutit mais qu'aucun résultat n'est renvoyé. Le message propagé à partir de ce terminal est un message de résultats standard mais qui ne contient pas d'éléments de résultats DICOM. |
Les tableaux suivants décrivent les propriétés du noeud. La colonne ayant l'en-tête O indique si la propriété est obligatoire (marquée d'un astérisque si vous devez obligatoirement entrer une valeur si aucune valeur par défaut n'est définie). La colonne ayant l'en-tête C indique si la propriété est configurable (vous pouvez modifier la valeur lors de l'ajout du flux de messages au fichier BAR à des fins de déploiement).
Propriété | O | C | Portée par défaut | Description |
---|---|---|---|---|
Nom du noeud | Oui | Non | DICOMFindMove | Nom du noeud. |
Description abrégée | Non | Non | Courte description du noeud. | |
Description détaillée | Non | Non | Texte qui décrit à quoi sert le noeud dans le flux de messages. |
Propriété | O | C | Portée par défaut | Description |
---|---|---|---|---|
Caractéristiques de la connexion | Oui | Oui | localhost:2222 | Nom d'hôte et port du noeud SCP de l'entité d'application auquel se connecte le noeud. |
Titre de l'entité d'application | Oui | Oui | BROKERAE | Nom de ce noeud final SCU DICOM. Chaîne de texte comportant jusqu'à 16 caractères qui permet d'identifier les entités d'application lorsqu'elles se connectent. |
Titre de l'entité d'application à distance | Oui | Oui | REMOTEAE | Nom du noeud final SCP DICOM auquel le noeud se connecte et envoie des requêtes. |
Propriété | O | C | Portée par défaut | Description |
---|---|---|---|---|
Annuler après ce nombre de réponses | Non | Oui | 99 | Le noeud ne reçoit plus de résultats une fois que ce nombre de messages de réponse a été reçu. Ce paramètre empêche les requêtes de grande taille de monopoliser le noeud SCP. |
Délai d'attente de la connexion (secondes) | Oui | Oui | 60 | Durée pendant laquelle le noeud attend l'établissement d'une connexion au noeud SCP. |
Offrir uniquement une syntaxe de transfert little endian VR implicite | Non | Oui | Non sélectionné | Indique si le noeud doit se connecter au noeud SCP en utilisant le paramètre par défaut DICOM uniquement une syntaxe de transfert little endian VR implicite. |
Priorité d'opération | Oui | Oui | NORMAL | Priorité pour le transfert de l'image vers le noeud SCP. Il n'est pas obligatoire que l'application de réception agisse sur cette priorité. |