The Inobitec DICOM Viewer provides an HTTP RPC Service that allows you to execute commands. Now two commands are supported:
DownloadAndOpenStudy;
DisplayStudy.
DownloadAndOpenStudy — command allows you to download the study from the PACS Server to the Local Storage and then open it. When this command is received, the DICOM Viewer searches the required study in the Local Storage. If the study is in the Local Storage, then the DICOM Viewer opens its first series in flat images view mode. If the required study is not found in the Local Storage, the DICOM Viewer will send a download request to the PACS Server and after the start of the downloading files will open study in the flat images view mode.
The samples of configuration files and HTTP RPC service test pages are available in the HTTP_RPC_test_pages archive at: https://inobitec.com/downloads/dicomviewer/.
To execute the DownloadAndOpenStudy command using the C-GET or C-MOVE methods:
In the DICOM Viewer switch on the DICOM and HIS/HTTP services by selecting the Services option on the Network menu (for details, see Sections 13.1.1 and 13.1.2).
Send HTTP RPC request to open study by sendind POST request containing xml file in the special format (e.g. downloadAndOpenStudy.xml in the HTTP_RPC_test_pages folder).
Specify the following parameters in the downloadAndOpenStudy.xml file:
PatientID (optional) — ID of the patient whose study should be opened;
StudyInstanceUID=<StudyInstanceUID 1>\…\<StudyInstanceUID N> — list of UID of the studies to be opened. The parameter is mandatory if parameter AccessionNumber is not present;
AccessionNumber=<AccessionNumber 1>\…\<AccessionNumber N> — the list of study Accession Numbers to be opened. The parameter is mandatory if parameter StudyInstanceUID is not present;
AET — AE Title of the PACS Server;
IP — network address of the PACS Server;
port — DICOM port of the PACS Server;
CommandType (optional) — method to download images from the PACS Server to the DICOM Viewer. The values C-GET (by default), C-MOVE and WADO-RS can be used. If you use the C-MOVE method then the PACS Server must be configured appropriately.
If the DICOM Listener... (see Section 13.1.1) is disabled, data from the PACS Server can only be downloaded via C-GET. In this case, the SCU "CLIENT" value is transferred to the PACS Server by default.
The samples of HTTP RPC service configuration files are given in Section 20.3.3.
To execute the DownloadAndOpenStudy command via WADO Web service, proceed as follows:
In the DICOM Viewer, switch on the HIS/HTTP service by selecting the Services option on the Network menu (for details, see Section 13.1.2).
Send HTTP RPC request to open study by sendind POST request containing xml file in the special format (e.g. downloadAndOpenStudy.xml in the HTTP_RPC_test_pages folder).
The following additional parameters are provided in the downloadAndOpenStudy.xml file:
WadoServiceRootPath — path to the PACS Server internal service processing WADO-RS requests;
IsWadoSecured — enabling/disabling the https protocol for data exchange with the PACS Server when data are downloaded via WADO service. If the parameter value is true, then the https protocol is used for data exchange with the PACS Server; if the value is false, then the http protocol is used;
WadoPort — http- or https- port value (depending on the IsWadoSecured parameter value);
WadoAuthLogin — username for connection with the PACS Server;
WadoAuthPassword — password for connection with the PACS Server.
To execute the DownloadAndOpenStudy command via the WADO Web Service, the CommandType parameter must have the WADO-RS value.
The samples of HTTP RPC service configuration files are given in Section 20.3.3.
The list of UID studies to be loaded is transferred within the StudyInstanceUID parameter value of the HTTP RPC request. The list of study registration numbers is transferred within the AccessionNumber parameter value of the HTTP RPC request. In both cases, the lists of parameters are transferred in the same way as they are transferred in the command line (see Section 20.1).
The values of the StudyInstanceUID and AccessionNumber, parameters provided in the xml file must belong to the same study. If the StudyInstanceUID and AccessionNumber parameters do not belong to the same study, you will not be able to download the study.
The list of StudyInstanceUID and AccessionNumber parameters is composed as follows: the first StudyInstanceUID parameter value is matched by the first AccessionNumber parameter value, the second StudyInstanceUID parameter value is matched by the second AccessionNumber parameter value, etc.
You may search for and download a study using only the value of the AccessionNumber parameter. To do that, delete the values of thePatientID and StudyInstanceUID parameters from the downloadAndOpenStudy.xml file leaving only the AccessionNumber and the PACS Server parameters (AET, IP, and port).
If the AET, IP, and port values have not been provided, the study will be downloaded from the DICOM Server (PACS) set by default. If only one or two parameters out of three (AET, IP, and port) have been provided, the command is considered invalid.
Also you can use the test page (testpage.html in the HTTP_RPC_test_pages folder):
In the DICOM Viewer, switch on the DICOM and HIS/HTTP services by selecting the Services option on the Network menu (for details, see Sections 13.1.1 and 13.1.2).
Open the testpage.html file.
Fill in the following fields:
AET — AE Title of the PACS Server;
IP — network address of the PACS Server;
Port — DICOM port of the PACS Server;
StudyUID — UID of the study to be opened;
Destination IP — network address of the DICOM Viewer;
Destination port — HTTP port of the DICOM Viewer.
Click the "Send command" button.
DisplayStudy — command allows you to open study from the Local Storage. When this command is received, the DICOM Viewer searches the required study in the Local Storage. If the study is in the Local Storage, then the DICOM Viewer opens its first series in the flat images view mode. At the moment to obtain this command the study should already be stored in the Local Storage.
The samples of configuration files and HTTP RPC service test pages are available in the
HTTP_RPC_test_pages archive at: https://inobitec.com/downloads/dicomviewer/.
To execute DisplayStudy command:
In the DICOM Viewer, switch on the DICOM and HIS/HTTP services by selecting the Services option on the Network menu (for details, see Sections 13.1.1 and 13.1.2).
Send HTTP RPC request to open study by sendind POST request containing xml file in the special format (e.g. displayStudy.xml in the HTTP_RPC_test_pages folder).
Specify the following parameters in the displayStudy.xml file:
PatientID (optional) — ID of the patient whose study should be opened;
StudyInstanceUID=<StudyInstanceUID 1>\…\<StudyInstanceUID N> — list of UID of the studies to be opened.
Also you can use the display.bat test script from the HTTP_RPC_test_pages folder:
In the DICOM Viewer, switch on the DICOM and HIS/HTTP services by selecting the Services option on the Network menu (for details, see Sections 13.1.1 and 13.1.2).
Specify the following parameters in displayStudy.xml file:
PatientID (optional) — ID of the patient whose study should be opened;
StudyInstanceUID=<StudyInstanceUID 1>\…\<StudyInstanceUID N> — list of UID of the studies to be opened.
Execute the script in the comman line with the following parameters:
display.bat [ip] [port]
where:
ip — network address of the DICOM Viewer;
port — HTTP port of the DICOM Viewer.
The samples of HTTP RPC service configuration files are given in Section 20.3.3.
The list of UID studies to be loaded is transferred within the StudyInstanceUID parameter value of the HTTP RPC request. The list of parameters is transferred in the same way as it is transferred in the command line (see Section 20.1).
The templates for configuration files of HTTP RPC remote procedure call service are provided below.
"downloadAndOpenStudy.xml" for the C-MOVE method
<?xml version=";1.0"; encoding=";utf-8";?>
<methodCall>
<methodName>DownloadAndOpenStudy</methodName>
<params>
<param>
<value>
<struct>
<member>
<name>PatientID</name>
<value>
<string>
8211038be1bebb57fb131414a04818f4f5c8f25f4a02cccec2b0cc20
\...\8211038be1bebb57fb131414a04818f4f5c8f25f4a02cccec2b0cc21
</string>
</value>
</member>
<member>
<name>StudyInstanceUID</name>
<value>
<string>
1.2.276.0.7230010.3.1.2.1658924591.30288.1727881038.636
\...\1.2.276.0.7230010.3.1.2.1658924591.30288.1727881038.637
</string>
</value>
</member>
<member>
<name>AET</name>
<value>
<string>PACS_Inobitec</string>
</value>
</member>
<member>
<name>IP</name>
<value>
<string>192.168.0.235</string>
</value>
</member>
<member>
<name>port</name>
<value>
<string>3000</string>
</value>
</member>
<member>
<name>CommandType</name>
<value>
<string>C-MOVE</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodCall>
"downloadAndOpenStudy.xml" downloading data from the PACS server via WADO service
<?xml version=";1.0"; encoding=";utf-8";?>
<methodCall>
<methodName>DownloadAndOpenStudy</methodName>
<params>
<param>
<value>
<struct>
<member>
<name>PatientID</name>
<value>
<string>
8211038be1bebb57fb131414a04818f4f5c8f25f4a02cccec2b0cc20
\...\8211038be1bebb57fb131414a04818f4f5c8f25f4a02cccec2b0cc21
</string>
</value>
</member>
<member>
<name>StudyInstanceUID</name>
<value>
<string>
1.2.276.0.7230010.3.1.2.1658924591.30288.1727881038.636
\...\1.2.276.0.7230010.3.1.2.1658924591.30288.1727881038.637
</string>
</value>
</member>
<member>
<name>AET</name>
<value>
<string>PACS_Inobitec</string>
</value>
</member>
<member>
<name>IP</name>
<value>
<string>192.168.0.235</string>
</value>
</member>
<member>
<name>port</name>
<value>
<string>3000</string>
</value>
</member>
<member>
<name>WadoServiceRootPath</name>
<value>
<string>path/to/service</string>
</value>
</member>
<member>
<name>IsWadoSecured</name>
<value>
<string>false</string>
</value>
</member>
<member>
<name>WadoPort</name>
<value>
<string>8010</string>
</value>
</member>
<member>
<name>WadoAuthLogin</name>
<value>
<string></string>
</value>
</member>
<member>
<name>WadoAuthPassword</name>
<value>
<string></string>
</value>
</member>
<member>
<name>CommandType</name>
<value>
<string>WADO-RS</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodCall>
"displayStudy.xml"
<?xml version=";1.0"; encoding=";utf-8";?> <methodCall> <methodName>DisplayStudy</methodName> <params> <param> <value> <struct> <member> <name>PatientID</name> <value> <string> 8211038be1bebb57fb131414a04818f4f5c8f25f4a02cccec2b0cc20 \...\8211038be1bebb57fb131414a04818f4f5c8f25f4a02cccec2b0cc21 </string> </value> </member> <member> <name>StudyInstanceUID</name> <value> <string> 1.2.276.0.7230010.3.1.2.1658924591.30288.1727881038.636 \...\1.2.276.0.7230010.3.1.2.1658924591.30288.1727881038.637 </string> </value> </member> </struct> </value> </param> </params> </methodCall>