orthanc-book: Sphinx/source/plugins/dicomweb.rst annotate

annotate Sphinx/source/plugins/dicomweb.rst @ 872:f72b2dd172da Orthanc-1.11.2

Orthanc 1.11.2

author	Alain Mazy <am@osimis.io>
date	Wed, 31 Aug 2022 12:06:15 +0200
parents	09be5f68aabf
children	ce9218a720db

rev	line source
24 25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	1 .. _dicomweb:
25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	2
25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	3
25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	4 DICOMweb plugin
25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	5 ===============
25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	6
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	7 .. contents::
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	8
24 25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	9 This official plugin extends Orthanc with support of the `DICOMweb
25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	10 protocols <https://en.wikipedia.org/wiki/DICOMweb>`__. More precisely,
25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	11 the plugin introduces a basic, reference implementation of WADO-URI,
25fa874803ab plugins inside book Sebastien Jodogne <s.jodogne@gmail.com> parents: diff changeset	12 WADO-RS, QIDO-RS and STOW-RS, following `DICOM PS3.18
25 669ea65ba7fb fix links Sebastien Jodogne <s.jodogne@gmail.com> parents: 24 diff changeset	13 <http://dicom.nema.org/medical/dicom/current/output/html/part18.html>`__.
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	14 The plugin simultaneously turns Orthanc into a DICOMweb server and
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	15 into a DICOMweb client.
27 c23f02a64caf postgresql Sebastien Jodogne <s.jodogne@gmail.com> parents: 25 diff changeset	16
c23f02a64caf postgresql Sebastien Jodogne <s.jodogne@gmail.com> parents: 25 diff changeset	17 For general information, check out the `official homepage of the
358 011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	18 plugins <https://www.orthanc-server.com/static.php?page=dicomweb>`__.
27 c23f02a64caf postgresql Sebastien Jodogne <s.jodogne@gmail.com> parents: 25 diff changeset	19
c23f02a64caf postgresql Sebastien Jodogne <s.jodogne@gmail.com> parents: 25 diff changeset	20 The full standard is not implemented yet, the supported features are
c23f02a64caf postgresql Sebastien Jodogne <s.jodogne@gmail.com> parents: 25 diff changeset	21 `tracked in the repository
449 2922fb1bd65e fix links Sebastien Jodogne <s.jodogne@gmail.com> parents: 445 diff changeset	22 <https://hg.orthanc-server.com/orthanc-dicomweb/file/default/Status.txt>`__.
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	23
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	24
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	25 Compilation
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	26 -----------
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	27
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	28 .. highlight:: text
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	29
255 949a13b92195 google Sebastien Jodogne <s.jodogne@gmail.com> parents: 243 diff changeset	30 The procedure to compile this plugin is similar of that for the
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	31 :ref:`core of Orthanc <compiling>`. The following commands should work
761 525d59a7c198 typo Sebastien Jodogne <s.jodogne@gmail.com> parents: 713 diff changeset	32 for most UNIX-like distribution (including GNU/Linux)::
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	33
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	34 $ mkdir Build
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	35 $ cd Build
81 4eea0dc5f071 documenting wsi Sebastien Jodogne <s.jodogne@gmail.com> parents: 33 diff changeset	36 $ cmake .. -DSTATIC_BUILD=ON -DCMAKE_BUILD_TYPE=Release
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	37 $ make
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	38
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	39 The compilation will produce a shared library ``OrthancDicomWeb`` that
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	40 contains the DICOMweb plugin. Pre-compiled binaries for Microsoft
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	41 Windows `are also available
358 011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	42 <https://www.orthanc-server.com/browse.php?path=/plugin-dicom-web>`__,
255 949a13b92195 google Sebastien Jodogne <s.jodogne@gmail.com> parents: 243 diff changeset	43 and are included in the `Windows installers
949a13b92195 google Sebastien Jodogne <s.jodogne@gmail.com> parents: 243 diff changeset	44 <https://www.orthanc-server.com/download-windows.php>`__. A package
949a13b92195 google Sebastien Jodogne <s.jodogne@gmail.com> parents: 243 diff changeset	45 for `Apple's Mac OS X
358 011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	46 <https://www.orthanc-server.com/static.php?page=download-mac>`__ is
011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	47 available courtesy of `Osimis <https://www.osimis.io/>`__.
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	48
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	49 Remark: Some older build instructions are also available in the
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	50 `source distribution
449 2922fb1bd65e fix links Sebastien Jodogne <s.jodogne@gmail.com> parents: 445 diff changeset	51 <https://hg.orthanc-server.com/orthanc-dicomweb/file/default/Resources/BuildInstructions.txt>`__.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	52
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	53
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	54 Installation
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	55 ------------
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	56
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	57 .. highlight:: json
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	58
31 93bbfaf0e62c worklist instructions migrated to a specific page, indexing of Osimis Web viewer Sebastien Jodogne <s.jodogne@gmail.com> parents: 30 diff changeset	59 You of course first have to :ref:`install Orthanc <binaries>`. Once
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	60 Orthanc is installed, you must change the :ref:`configuration file
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	61 <configuration>` to tell Orthanc where it can find the plugin: This is
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	62 done by properly modifying the ``Plugins`` option. For GNU/Linux, you
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	63 could for instance use the following configuration file::
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	64
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	65 {
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	66 "Name" : "MyOrthanc",
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	67 [...]
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	68 "Plugins" : [
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	69 "/home/user/OrthancDicomWeb/Build/libOrthancDicomWeb.so"
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	70 ]
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	71 }
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	72
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	73 Or, for Windows::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	74
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	75 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	76 "Name" : "MyOrthanc",
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	77 [...]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	78 "Plugins" : [
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	79 "c:/Temp/OrthancDicomWeb.dll"
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	80 ]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	81 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	82
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	83 Note that the DICOMweb server will share all the parameters of the
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	84 Orthanc HTTP server, notably wrt. authentication and HTTPS
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	85 encryption. For this reason, you will most probably have to enable the
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	86 remote access to the Orthanc HTTP server::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	87
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	88 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	89 [...]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	90 "RemoteAccessEnabled" : true,
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	91 [...]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	92 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	93
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	94 Once Orthanc has restarted, the root of the DICOMweb REST API is
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	95 accessible at ``http://localhost:8042/dicom-web/``.
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	96
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	97
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	98 Options
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	99 -------
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	100
318 83d822f11e78 SeriesMetadata and StudiesMetadata in DICOMweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 311 diff changeset	101
83d822f11e78 SeriesMetadata and StudiesMetadata in DICOMweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 311 diff changeset	102 .. _dicomweb-server-config:
83d822f11e78 SeriesMetadata and StudiesMetadata in DICOMweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 311 diff changeset	103
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	104 Server-related options
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	105 ^^^^^^^^^^^^^^^^^^^^^^
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	106
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	107 .. highlight:: json
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	108
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	109 There are several configuration options that can be set to fine-tune
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	110 the Orthanc DICOMweb server. Here is the full list of the available
856 60c4deeb6892 dicom-web Host and Ssl config Alain Mazy <am@osimis.io> parents: 838 diff changeset	111 options and their default values, all of them must be grouped inside
60c4deeb6892 dicom-web Host and Ssl config Alain Mazy <am@osimis.io> parents: 838 diff changeset	112 the ``DicomWeb`` section of the Orthanc configuration file::
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	113
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	114 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	115 [...]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	116 "DicomWeb" : {
838 6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	117 "Enable" : true, // Whether DICOMweb support is enabled
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	118 "Root" : "/dicom-web/", // Root URI of the DICOMweb API (for QIDO-RS, STOW-RS and WADO-RS)
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	119 "EnableWado" : true, // Whether WADO-URI (previously known as WADO) support is enabled
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	120 "WadoRoot" : "/wado", // Root URI of the WADO-URI (aka. WADO) API
856 60c4deeb6892 dicom-web Host and Ssl config Alain Mazy <am@osimis.io> parents: 838 diff changeset	121 "Ssl" : false, // Whether HTTPS should be used for subsequent WADO-RS requests.
60c4deeb6892 dicom-web Host and Ssl config Alain Mazy <am@osimis.io> parents: 838 diff changeset	122 // If Orthanc is behind a reverse-proxy, the 'forwarded' headers will be used instead of the config.
838 6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	123 "QidoCaseSensitive" : true, // For QIDO-RS server, whether search is case sensitive (since release 0.5)
856 60c4deeb6892 dicom-web Host and Ssl config Alain Mazy <am@osimis.io> parents: 838 diff changeset	124 "Host" : "", // Hard-codes the name of the host for subsequent WADO-RS requests.
60c4deeb6892 dicom-web Host and Ssl config Alain Mazy <am@osimis.io> parents: 838 diff changeset	125 // e.g: "localhost:8042", "dicomweb.mydomain.org"
60c4deeb6892 dicom-web Host and Ssl config Alain Mazy <am@osimis.io> parents: 838 diff changeset	126 // If empty (default), the plugin will guess it from other configurations or
60c4deeb6892 dicom-web Host and Ssl config Alain Mazy <am@osimis.io> parents: 838 diff changeset	127 // from the reverse-proxy 'forwarded' headers.
838 6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	128 "StudiesMetadata" : "Full", // How study-level metadata is retrieved (since release 1.1, cf. section below)
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	129 "SeriesMetadata" : "Full", // How series-level metadata is retrieved (since release 1.1, cf. section below)
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	130 "PublicRoot": "/dicom-web/", // The public Root URI of the DICOMweb API in case it is different from "Root".
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	131 // This is useful if, e.g, your Orthanc is behind a reverse-proxy and has another
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	132 // base endpoint than the "Root" one. Note that, if using a reverse-proxy, make sure to set the "host"
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	133 // and "proto" correctly in the "Forwarded" HTTP headers.
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	134 // (since release 1.8)
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	135 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	136 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	137
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	138 Furthermore, the global option ``DefaultEncoding`` specifies the
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	139 encoding (specific character set) that will be used when answering a
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	140 QIDO-RS request. It might be a good idea to set this option to
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	141 ``Utf8`` if you are dealing with an international environment.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	142
318 83d822f11e78 SeriesMetadata and StudiesMetadata in DICOMweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 311 diff changeset	143 Remark 1: The following configuration options were present in
83d822f11e78 SeriesMetadata and StudiesMetadata in DICOMweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 311 diff changeset	144 releases <= 0.6 of the plugin, but are not used anymore::
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	145
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	146 {
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	147 [...]
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	148 "DicomWeb" : {
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	149 "StowMaxInstances" : 10, // For STOW-RS client, the maximum number of instances in one single HTTP query (0 = no limit)
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	150 "StowMaxSize" : 10, // For STOW-RS client, the maximum size of the body in one single HTTP query (in MB, 0 = no limit)
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	151 }
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	152 }
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	153
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	154 These older configuration options were used to limit the size of the
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	155 HTTP requests, by issuing multiple calls to STOW-RS (set both options
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	156 to 0 to send one single request).
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	157
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	158
318 83d822f11e78 SeriesMetadata and StudiesMetadata in DICOMweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 311 diff changeset	159 Remark 2: The option ``Host`` is deprecated. Starting with release
243 57ecb27d1851 note Sebastien Jodogne <s.jodogne@gmail.com> parents: 238 diff changeset	160 0.7 of the DICOMweb plugin, its value are computed from the standard
57ecb27d1851 note Sebastien Jodogne <s.jodogne@gmail.com> parents: 238 diff changeset	161 HTTP headers ``Forwarded`` and ``Host``, as provided by the HTTP
57ecb27d1851 note Sebastien Jodogne <s.jodogne@gmail.com> parents: 238 diff changeset	162 clients.
57ecb27d1851 note Sebastien Jodogne <s.jodogne@gmail.com> parents: 238 diff changeset	163
57ecb27d1851 note Sebastien Jodogne <s.jodogne@gmail.com> parents: 238 diff changeset	164
320 42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	165 .. _dicomweb-server-metadata-config:
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	166
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	167 Fine-tuning server for WADO-RS Retrieve Metadata
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	168 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	169
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	170 The options ``StudiesMetadata`` and ``SeriesMetadata`` were introduced
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	171 in release 1.1 of the DICOMweb plugin. These options specify how the
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	172 calls to ``/dicom-web/studies/.../metadata`` and
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	173 ``/dicom-web/studies/.../series/.../metadata`` (i.e. `WADO-RS Retrieve
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	174 Metadata
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	175 <http://dicom.nema.org/medical/dicom/2019a/output/chtml/part18/sect_6.5.6.html>`__)
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	176 are processed:
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	177
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	178 * If ``Full`` mode is used, the plugin will read all the DICOM
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	179 instances of the study/series of interest from the :ref:`storage
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	180 area <orthanc-storage>`, which gives fully accurate results but
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	181 requires all the individual instances to be read and parsed from the
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	182 filesystem, leading to slow performance (cf. `issue 162
445 987fbbc2b59e leaving bitbucket wrt. bug tracker Sebastien Jodogne <s.jodogne@gmail.com> parents: 361 diff changeset	183 <https://bugs.orthanc-server.com/show_bug.cgi?id=162>`__). This is
987fbbc2b59e leaving bitbucket wrt. bug tracker Sebastien Jodogne <s.jodogne@gmail.com> parents: 361 diff changeset	184 the default mode.
320 42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	185
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	186 * If ``MainDicomTags`` mode is used, the plugin will only report the
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	187 main DICOM tags that are indexed by the Orthanc database. The DICOM
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	188 files are not read from the disk, which provides best
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	189 performance. However, this is a small subset of all the tags that
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	190 would be retrieved if using the ``Full`` mode: A DICOMweb viewer
838 6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	191 might need more tags. Important Note: From Orthanc 1.11.0 and DICOMweb plugin 1.8,
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	192 you may store more :ref:`MainDicomTags <main-dicom-tags>` in DB.
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	193 By correctly setting these tags, the ``MainDicomTags`` mode can
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	194 become faster than the ``Extrapolate`` mode with the same accuracy
6afc236cd60a dicom-web & main-dicom-tags Alain Mazy <am@osimis.io> parents: 822 diff changeset	195 as the ``Full`` mode.
320 42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	196
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	197 * If ``Extrapolate`` mode is used, the plugin will read up to 3 DICOM
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	198 instances at random that belong to the study/series of interest. It
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	199 will then test whether the majority of these instances share the
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	200 same value for a predefined subset of DICOM tags. If so, this value
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	201 is added to the metadata response; otherwise, the tag is not
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	202 reported. In other words, this mode extrapolates the value of some
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	203 predefined tags by assuming that these tags should be constant
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	204 across all the instances of the study/series. This mode is a
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	205 compromise between ``MainDicomTags`` (focus on speed) and ``Full``
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	206 (focus on accuracy).
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	207
858 09be5f68aabf dicom-web and MainDicomTags Alain Mazy <am@osimis.io> parents: 856 diff changeset	208 * If you are using a DICOMweb viewer (such as Stone Web
320 42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	209 viewer or `OHIF viewer
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	210 <https://groups.google.com/d/msg/orthanc-users/y1N5zOFVk0M/a3YMdhNqBwAJ>`__)
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	211 in a setup where performance and accuracy are both important, you
858 09be5f68aabf dicom-web and MainDicomTags Alain Mazy <am@osimis.io> parents: 856 diff changeset	212 should configure :ref:`ExtraMainDicomTags <main-dicom-tags>` and configure
09be5f68aabf dicom-web and MainDicomTags Alain Mazy <am@osimis.io> parents: 856 diff changeset	213 ``StudiesMetadata`` to ``MainDicomTags`` and ``SeriesMetadata`` to ``MainDicomTags``
09be5f68aabf dicom-web and MainDicomTags Alain Mazy <am@osimis.io> parents: 856 diff changeset	214 as demonstrated in this `sample <https://bitbucket.org/osimis/orthanc-setup-samples/src/master/docker/stone-viewer/docker-compose.yml>`__.
320 42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	215
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	216
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	217 If using the ``Extrapolate`` mode, the predefined tags are provided
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	218 using the ``StudiesMetadataExtrapolatedTags`` and
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	219 ``SeriesMetadataExtrapolatedTags`` configuration options as follows::
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	220
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	221 {
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	222 [...]
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	223 "DicomWeb" : {
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	224 [...]
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	225 "StudiesMetadata" : "Extrapolate",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	226 "StudiesMetadataExtrapolatedTags" : [
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	227 "AcquisitionDate"
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	228 ],
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	229 "SeriesMetadata" : "Extrapolate",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	230 "SeriesMetadataExtrapolatedTags" : [
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	231 "BitsAllocated",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	232 "BitsStored",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	233 "Columns",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	234 "HighBit",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	235 "PhotometricInterpretation",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	236 "PixelSpacing",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	237 "PlanarConfiguration",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	238 "RescaleIntercept",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	239 "RescaleSlope",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	240 "Rows",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	241 "SOPClassUID",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	242 "SamplesPerPixel",
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	243 "SliceThickness"
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	244 ]
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	245 }
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	246 }
42104307e838 "Extrapolate" mode of DICOMweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 318 diff changeset	247
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	248
255 949a13b92195 google Sebastien Jodogne <s.jodogne@gmail.com> parents: 243 diff changeset	249 .. _dicomweb-client-config:
949a13b92195 google Sebastien Jodogne <s.jodogne@gmail.com> parents: 243 diff changeset	250
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	251 Client-related options
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	252 ^^^^^^^^^^^^^^^^^^^^^^
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	253
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	254 .. highlight:: json
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	255
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	256 If you want to connect Orthanc as a client to remote DICOMweb servers
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	257 (cf. below), you need to modify the configuration file so as to define
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	258 each of them in the option ``DicomWeb.Servers``. The syntax is
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	259 identical to the ``OrthancPeers`` option of the :ref:`configuration of
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	260 the Orthanc core <configuration>`.
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	261
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	262 In the most simple case, here is how to instruct Orthanc about the
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	263 existence of a password-less DICOMweb server that will be referred to
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	264 as "sample" in Orthanc::
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	265
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	266 {
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	267 [...]
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	268 "DicomWeb" : {
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	269 "Servers" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	270 "sample" : [ "http://192.168.1.1/dicom-web/" ]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	271 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	272 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	273 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	274
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	275 You are of course free to add as many DICOMweb servers as you need. If
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	276 the DICOMweb server is protected by a password (with `HTTP Basic
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	277 access authentication
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	278 <https://en.wikipedia.org/wiki/Basic_access_authentication>`__)::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	279
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	280 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	281 [...]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	282 "DicomWeb" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	283 "Servers" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	284 "sample" : [ "http://192.168.1.1/dicom-web/", "username", "password" ]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	285 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	286 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	287 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	288
324 89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	289 Three important options can be provided for individual remote DICOMweb servers:
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	290
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	291 * ``HasDelete`` can be set to ``true`` to indicate that the HTTP
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	292 DELETE method can be used to delete remote studies/series/instances.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	293 This notably adds a "delete" button on the Web interface of the
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	294 DICOMweb client, and creates a route
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	295 ``/dicom-web/servers/sample/delete`` in the REST API.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	296
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	297 * ``ChunkedTransfers`` must be set to ``false`` if the remote DICOMweb
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	298 server does not support `HTTP chunked transfer encoding
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	299 <https://en.wikipedia.org/wiki/Chunked_transfer_encoding>`__. Setting
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	300 this option to ``true`` is the best choice to reduce memory
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	301 consumption. However, it must be set to ``false`` if the remote
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	302 DICOMweb server is Orthanc <= 1.5.6, as chunked transfer encoding is
325 c94074bbf7aa note about issue 156 Sebastien Jodogne <s.jodogne@gmail.com> parents: 324 diff changeset	303 only supported starting with Orthanc 1.5.7. Beware setting
c94074bbf7aa note about issue 156 Sebastien Jodogne <s.jodogne@gmail.com> parents: 324 diff changeset	304 ``ChunkedTransfers`` to ``true`` in Orthanc 1.5.7 and 1.5.8 utilizes
c94074bbf7aa note about issue 156 Sebastien Jodogne <s.jodogne@gmail.com> parents: 324 diff changeset	305 one CPU at 100%, which results in very low throughput: This issue is
c94074bbf7aa note about issue 156 Sebastien Jodogne <s.jodogne@gmail.com> parents: 324 diff changeset	306 resolved in Orthanc 1.6.0 (cf. `issue 156
445 987fbbc2b59e leaving bitbucket wrt. bug tracker Sebastien Jodogne <s.jodogne@gmail.com> parents: 361 diff changeset	307 <https://bugs.orthanc-server.com/show_bug.cgi?id=156>`__ for full
325 c94074bbf7aa note about issue 156 Sebastien Jodogne <s.jodogne@gmail.com> parents: 324 diff changeset	308 explanation).
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	309
324 89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	310 * ``HasWadoRsUniversalTransferSyntax`` (new in DICOMweb 1.1) must be
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	311 set to ``false`` if the remote DICOMweb server does not support the
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	312 value ``transfer-syntax=*`` in the ``Accept`` HTTP header for
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	313 WADO-RS requests. This option is notably needed if the remote
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	314 DICOMweb server is Orthanc equipped with DICOMweb plugin <= 1.0. On
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	315 the other hand, setting this option to ``true`` prevents the remote
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	316 DICOMweb server from transcoding to uncompressed transfer syntaxes,
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	317 which gives `much better performance
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	318 <https://groups.google.com/d/msg/orthanc-users/w1Ekrsc6-U8/T2a_DoQ5CwAJ>`__.
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	319 The implicit value of this parameter was ``false`` in DICOMweb
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	320 plugin <= 1.0, and its default value is ``true`` since DICOMweb
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	321 plugin 1.1.
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	322
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	323 You'll have to convert the JSON array into a JSON object to set these
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	324 options::
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	325
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	326 {
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	327 [...]
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	328 "DicomWeb" : {
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	329 "Servers" : {
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	330 "sample" : {
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	331 "Url" : "http://192.168.1.1/dicom-web/",
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	332 "Username" : "username",
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	333 "Password" : "password",
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	334 "HasDelete" : true,
324 89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	335 "ChunkedTransfers" : true, // Set to "false" if "sample" is Orthanc <= 1.5.6
89d4ee2e6e6e documentation of "HasWadoRsUniversalTransferSyntax" in DICOMweb client Sebastien Jodogne <s.jodogne@gmail.com> parents: 320 diff changeset	336 "HasWadoRsUniversalTransferSyntax" : true // Set to "false" if "sample" is Orthanc DICOMweb plugin <= 1.0
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	337 }
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	338 }
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	339 }
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	340 }
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	341
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	342
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	343 Furthermore, if the DICOMweb server is protected with HTTPS client
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	344 authentication, you must provide your client certificate (in the `PEM
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	345 format
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	346 <https://en.wikipedia.org/wiki/Privacy-enhanced_Electronic_Mail>`__),
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	347 your client private key (also in the PEM format), together with the
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	348 password protecting the private key::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	349
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	350 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	351 [...]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	352 "DicomWeb" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	353 "Servers" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	354 "sample" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	355 "Url" : "http://192.168.1.1/dicom-web/",
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	356 "CertificateFile" : "client.crt",
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	357 "CertificateKeyFile" : "client.key",
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	358 "CertificateKeyPassword" : "password"
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	359 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	360 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	361 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	362 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	363
665 9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	364
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	365 The definition of a DICOMweb server can also specify the HTTP headers
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	366 to be provided during each request to the remote DICOMweb server. This
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	367 can for instance be useful to set authorization tokens::
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	368
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	369 {
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	370 [...]
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	371 "DicomWeb" : {
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	372 "Servers" : {
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	373 "sample" : {
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	374 "Url" : "http://localhost:8042/dicom-web/",
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	375 "HttpHeaders": {
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	376 "Authorization" : "Bearer HelloWorldToken"
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	377 }
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	378 }
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	379 }
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	380 }
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	381 }
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	382
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	383
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	384 Finally, it is possible to use client authentication with hardware
9062c9c464f5 HttpHeaders in the definition of DICOMweb servers Sebastien Jodogne <s.jodogne@gmail.com> parents: 617 diff changeset	385 security modules and smart cards through `PKCS#11
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	386 <https://en.wikipedia.org/wiki/PKCS_11>`__ (this feature is only
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	387 available is the core of Orthanc was compiled with the
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	388 ``-DENABLE_PKCS11=ON`` option in CMake, and if the Orthanc
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	389 configuration file has a proper ``Pkcs11`` section)::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	390
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	391 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	392 [...]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	393 "DicomWeb" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	394 "Servers" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	395 "sample" : {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	396 "Url" : "http://192.168.1.1/dicom-web/",
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	397 "Pkcs11" : true
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	398 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	399 }
30 79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	400 }
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	401 }
79b6d3ea92aa dicomweb Sebastien Jodogne <s.jodogne@gmail.com> parents: 27 diff changeset	402
603 60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	403 Starting with release 1.5 of the DICOMweb plugin, the configuration
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	404 option ``ServersInDatabase`` can be set to ``true`` in order for the
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	405 plugin to **read/write the definitions of the DICOMweb servers
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	406 from/into the database of Orthanc**. This makes the modifications to
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	407 the DICOMweb servers persistent across successive executions of
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	408 Orthanc. If this option is enabled, the REST API must be used on URI
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	409 ``/dicom-web/servers/`` (with the GET, DELETE or PUT methods) to
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	410 :ref:`add/update/remove DICOMweb servers
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	411 <dicomweb-additional-samples>`. Here is the syntax to enable this
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	412 feature::
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	413
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	414 {
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	415 [...]
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	416 "DicomWeb" : {
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	417 "ServersInDatabase" : true // "false" by default
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	418 }
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	419 }
60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	420
617 324ca8f236b8 document "Timeout" option when defining a DICOMweb server Sebastien Jodogne <s.jodogne@gmail.com> parents: 603 diff changeset	421 In forthcoming release 1.6 of the DICOMweb plugin, the ``Timeout``
324ca8f236b8 document "Timeout" option when defining a DICOMweb server Sebastien Jodogne <s.jodogne@gmail.com> parents: 603 diff changeset	422 field can be added to the definition of a DICOMweb server (in
324ca8f236b8 document "Timeout" option when defining a DICOMweb server Sebastien Jodogne <s.jodogne@gmail.com> parents: 603 diff changeset	423 ``DicomWeb.Servers``) in order to specify a separate HTTP timeout when
324ca8f236b8 document "Timeout" option when defining a DICOMweb server Sebastien Jodogne <s.jodogne@gmail.com> parents: 603 diff changeset	424 contacting this DICOMweb server. By default, the global value
324ca8f236b8 document "Timeout" option when defining a DICOMweb server Sebastien Jodogne <s.jodogne@gmail.com> parents: 603 diff changeset	425 ``HttpTimeout`` is used.
324ca8f236b8 document "Timeout" option when defining a DICOMweb server Sebastien Jodogne <s.jodogne@gmail.com> parents: 603 diff changeset	426
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	427 Remark: A :ref:`plugin by Osimis <google>` is available to
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	428 dynamically create authenticated connections to Google Cloud Platform.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	429
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	430 Important remark: When querying a DICOMweb server, Orthanc will
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	431 automatically use the global configuration options ``HttpProxy``,
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	432 ``HttpTimeout``, ``HttpsVerifyPeers``, ``HttpsCACertificates``, and
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	433 ``Pkcs11``. Make sure to adapt them if need be.
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	434
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	435
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	436 Quickstart - DICOMweb client
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	437 ----------------------------
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	438
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	439 Starting with version 1.0 of the DICOMweb plugin, a Web interface is
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	440 provided to use Orthanc as a DICOMweb client. Simply click on the
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	441 "Open DICOMweb client" button at the bottom of the welcome screen of
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	442 :ref:`Orthanc Explorer <orthanc-explorer>`.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	443
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	444 Here is a direct link to the DICOMweb client running on our demo
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	445 server:
358 011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	446 `https://demo.orthanc-server.com/dicom-web/app/client/index.html
011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	447 <https://demo.orthanc-server.com/dicom-web/app/client/index.html>`__
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	448
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	449
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	450
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	451 Quickstart - DICOMweb server
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	452 ----------------------------
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	453
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	454 Once your Orthanc server is properly configured (see above), you can
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	455 make REST calls to the API of the DICOMweb server. For demonstration
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	456 purpose, this section makes the assumption that the ``VIX`` dataset
358 011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	457 provided by `OsiriX
011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	458 <https://www.osirix-viewer.com/resources/dicom-image-library/>`__ has
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	459 been uploaded to Orthanc.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	460
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	461 WADO-URI
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	462 ^^^^^^^^
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	463
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	464 .. highlight:: text
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	465
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	466 Here is a proper WADO-URI (previously known simply as WADO) request to
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	467 render one slice of the VIX dataset as a JPEG image::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	468
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	469 http://localhost:8042/wado?objectUID=1.3.12.2.1107.5.1.4.54693.30000006100507010800000005466&requestType=WADO
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	470
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	471
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	472 .. highlight:: bash
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	473
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	474 The ``objectUID`` corresponds to the ``SOPInstanceUID`` DICOM tag of
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	475 some instance in the ``VIX`` dataset. Given the Orthanc identifier of
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	476 an instance from VIX
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	477 (e.g. ``14b4db2c-065edecb-6a767936-7068293a-92fcb080``), the latter
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	478 tag can be obtained from the ``MainDicomTags`` field::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	479
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	480 $ curl http://localhost:8042/instances/14b4db2c-065edecb-6a767936-7068293a-92fcb080
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	481
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	482
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	483 QIDO-RS
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	484 ^^^^^^^
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	485
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	486 .. highlight:: bash
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	487
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	488 Regarding QIDO-RS (querying the content of a remote DICOMweb server),
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	489 here is how to obtain the list of studies stored by Orthanc::
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	490
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	491 $ curl http://localhost:8042/dicom-web/studies
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	492
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	493 Note that the ``/dicom-web/`` prefix comes from the configuration
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	494 option ``Root`` of the ``DicomWeb`` section. Filtering the studies is
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	495 possible as follows::
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	496
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	497 $ curl http://localhost:8042/dicom-web/studies?PatientName=VIX
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	498
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	499
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	500
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	501 WADO-RS
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	502 ^^^^^^^
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	503
311 0078d465c768 note Sebastien Jodogne <s.jodogne@gmail.com> parents: 293 diff changeset	504 A study can be retrieved through WADO-RS. Here is a sample using the VIX dataset::
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	505
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	506 $ curl http://localhost:8042/dicom-web/studies/2.16.840.1.113669.632.20.1211.10000315526/
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	507
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	508 This answer is a `multipart stream
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	509 <https://en.wikipedia.org/wiki/MIME#Multipart_messages>`__ of
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	510 ``application/dicom`` DICOM instances, so a Web browser will not be
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	511 able to display it (. You will have to use either AJAX (JavaScript) or a
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	512 command-line tool (such as cURL).
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	513
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	514 You can render one individual frame as a plain PNG image as follows::
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	515
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	516 $ curl http://localhost:8042/dicom-web/studies/2.16.840.1.113669.632.20.1211.10000315526/series/1.3.12.2.1107.5.1.4.54693.30000006100507010800000005268/instances/1.3.12.2.1107.5.1.4.54693.30000006100507010800000005466/frames/1/rendered -H 'accept: image/png'
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	517
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	518
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	519 Other endpoints
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	520 ^^^^^^^^^^^^^^^
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	521
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	522 This page only provides some very basic examples about the use of a
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	523 DICOMweb server. Please check out `the full reference of the DICOMweb
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	524 API <https://www.dicomstandard.org/dicomweb/>`__ for more information.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	525
713 d92edd545754 note about samples Sebastien Jodogne <s.jodogne@gmail.com> parents: 665 diff changeset	526 Also, check out the :ref:`section about additional samples
d92edd545754 note about samples Sebastien Jodogne <s.jodogne@gmail.com> parents: 665 diff changeset	527 <dicomweb-additional-samples>` that notably provides example of
d92edd545754 note about samples Sebastien Jodogne <s.jodogne@gmail.com> parents: 665 diff changeset	528 STOW-RS clients in JavaScript and Python.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	529
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	530
238 a363714813b2 securing orthanc Sebastien Jodogne <s.jodogne@gmail.com> parents: 172 diff changeset	531 .. _dicomweb-client:
a363714813b2 securing orthanc Sebastien Jodogne <s.jodogne@gmail.com> parents: 172 diff changeset	532
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	533 REST API of the Orthanc DICOMweb client
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	534 ---------------------------------------
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	535
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	536 Listing the available servers
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	537 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	538
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	539 .. highlight:: bash
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	540
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	541 The list of the remote DICOMweb servers that are known to the DICOMweb
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	542 plugin can be obtained as follows::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	543
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	544 $ curl http://localhost:8042/dicom-web/servers/
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	545 [ "sample" ]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	546
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	547 In this case, a single server called ``sample`` is configured.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	548
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	549
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	550 Making a call to QIDO-RS or WADO-RS
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	551 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	552
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	553 .. highlight:: bash
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	554
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	555 In Orthanc, the URI ``/{dicom-web-root}/servers/{name}/get`` allows to
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	556 make a HTTP GET call against a DICOMweb server. This can be used to
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	557 issue a QIDO-RS or WADO-RS command. Orthanc will take care of properly
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	558 encoding the URL and authenticating the client. For instance, here is
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	559 a sample QIDO-RS search to query all the studies (using a bash
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	560 command-line)::
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	561
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	562 $ curl http://localhost:8042/dicom-web/servers/sample/get -d @- << EOF
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	563 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	564 "Uri" : "/studies"
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	565 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	566 EOF
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	567
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	568 The result of this call is a JSON document formatted according to the
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	569 DICOMweb standard. You do not have to specify the base URL of the
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	570 remote DICOMweb server, as it is encoded in the configuration file.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	571
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	572 As a more advanced example, here is how to search all the series
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	573 associated with a given patient name, while requesting to use an XML
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	574 format::
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	575
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	576 $ curl http://localhost:8042/dicom-web/servers/sample/get -d @- << EOF
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	577 {
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	578 "Uri" : "/series",
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	579 "HttpHeaders" : {
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	580 "Accept" : "application/dicom+xml"
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	581 },
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	582 "Arguments" : {
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	583 "00100010" : "KNIX"
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	584 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	585 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	586 EOF
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	587
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	588 The result of the command above is a `multipart stream
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	589 <https://en.wikipedia.org/wiki/MIME#Multipart_messages>`__ of XML
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	590 documents describing each series.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	591
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	592 Note how all the GET arguments to the QIDO-RS request must be
89 c9a33e4a0577 fix mixup between HttpArguments and HttpHeaders in WADO-RS Sebastien Jodogne <s.jodogne@gmail.com> parents: 81 diff changeset	593 specified in the ``Arguments`` field. Orthanc will take care of
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	594 `properly encoding it as an URL
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	595 <https://en.wikipedia.org/wiki/Percent-encoding>`__.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	596
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	597 An user-friendly reference of the features available in QIDO-RS and
358 011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	598 WADO-RS `can be found on this site
011b01ccf52d fixing external hyperlinks Sebastien Jodogne <s.jodogne@gmail.com> parents: 325 diff changeset	599 <https://www.dicomstandard.org/dicomweb/>`__.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	600
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	601
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	602 Sending DICOM resources to a STOW-RS server
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	603 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	604
822 0f4f11636193 transfers atomicity Alain Mazy <am@osimis.io> parents: 761 diff changeset	605 .. _dicomweb-stow-rs:
0f4f11636193 transfers atomicity Alain Mazy <am@osimis.io> parents: 761 diff changeset	606
0f4f11636193 transfers atomicity Alain Mazy <am@osimis.io> parents: 761 diff changeset	607
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	608 .. highlight:: bash
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	609
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	610 STOW-RS allows to send local DICOM resources to a remote DICOMweb
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	611 server. In Orthanc, the STOW-RS client primitive is available at URI
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	612 ``/{dicom-web-root}/servers/{name}/stow``. Here is a sample call::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	613
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	614 $ curl http://localhost:8042/dicom-web/servers/sample/stow -X POST -d @- << EOF
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	615 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	616 "Resources" : [
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	617 "6ca4c9f3-5e895cb3-4d82c6da-09e060fe-9c59f228"
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	618 ]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	619 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	620 EOF
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	621
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	622 Note that this primitive takes as its input a list of :ref:`Orthanc
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	623 identifiers <orthanc-ids>` corresponding to the resources (patients,
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	624 studies, series and/or instances) to be exported.
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	625
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	626 Additional HTTP headers can be added with an optional ``HttpHeaders``
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	627 argument as for QIDO-RS and WADO-RS. This might be useful e.g. for
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	628 cookie-based session management.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	629
262 3391edf37359 note for packagers Sebastien Jodogne <s.jodogne@gmail.com> parents: 260 diff changeset	630 Internally, this call results in creating an :ref:`Orthanc job <jobs>`
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	631 that is executed synchronously (the REST call only returns once the
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	632 STOW-RS request is finished). You can run the job in asynchronous
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	633 mode as follows::
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	634
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	635 $ curl http://localhost:8042/dicom-web/servers/sample/stow -X POST -d @- << EOF
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	636 {
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	637 "Resources" : [
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	638 "6ca4c9f3-5e895cb3-4d82c6da-09e060fe-9c59f228"
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	639 ],
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	640 "Synchronous" : false,
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	641 "Priority" : 10
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	642 }
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	643 EOF
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	644
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	645 {
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	646 "ID" : "a7bd2a5c-291d-4ca5-977a-66502cab22a1",
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	647 "Path" : ".././../jobs/a7bd2a5c-291d-4ca5-977a-66502cab22a1"
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	648 }
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	649
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	650 Such a call ends immediately, and returns the ID of the job created by
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	651 Orthanc. The :ref:`status of the job <jobs-monitoring>` can then be
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	652 monitored using the Orthanc REST API.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	653
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	654
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	655
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	656 Retrieving DICOM resources from a WADO-RS server
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	657 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	658
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	659 .. highlight:: bash
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	660
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	661 Once DICOM resources of interest have been identified through a
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	662 QIDO-RS call to a remote DICOMweb server (cf. above), it is
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	663 interesting to download them locally with a WADO-RS call. You could do
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	664 it manually with a second call to the
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	665 ``/{dicom-web-root}/servers/{name}/get`` URI, but Orthanc provides
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	666 another primitive ``.../retrieve`` to automate this process, in order
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	667 to avoid the manual parsing of the multipart stream.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	668
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	669 Here is how you would download one study, one series and one instance
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	670 whose StudyInstanceUID (0020,000d), SeriesInstanceUID (0020,000e) are
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	671 SOPInstanceUID (0008,0018) have been identified through a former
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	672 QIDO-RS call::
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	673
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	674 $ curl http://localhost:8042/dicom-web/servers/sample/retrieve -X POST -d @- << EOF
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	675 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	676 "Resources" : [
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	677 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	678 "Study" : "1.3.51.0.1.1.192.168.29.133.1688840.1688819"
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	679 },
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	680 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	681 "Study" : "1.3.51.0.1.1.192.168.29.133.1681753.1681732",
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	682 "Series" : "1.3.12.2.1107.5.2.33.37097.2012041613040617636372171.0.0.0"
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	683 },
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	684 {
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	685 "Study" : "1.3.51.0.1.1.192.168.29.133.1681753.1681732",
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	686 "Series" : "1.3.12.2.1107.5.2.33.37097.2012041612474981424569674.0.0.0",
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	687 "Instance" : "1.3.12.2.1107.5.2.33.37097.2012041612485540185869716"
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	688 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	689 ]
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	690 }
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	691 EOF
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	692
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	693 Orthanc will reply with the list of the Orthanc identifiers of all the
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	694 DICOM instances that were downloaded from the remote server.
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	695
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	696 Remark 1: Contrarily to the ``.../stow`` URI that uses :ref:`Orthanc
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	697 identifiers <orthanc-ids>`, the ``.../retrieve`` URI uses DICOM
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	698 identifiers.
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	699
89 c9a33e4a0577 fix mixup between HttpArguments and HttpHeaders in WADO-RS Sebastien Jodogne <s.jodogne@gmail.com> parents: 81 diff changeset	700 Remark 2: The ``HttpHeaders`` and ``Arguments`` arguments are also
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	701 available, as for QIDO-RS, to fine-tune the parameters of the WADO-RS
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	702 request.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	703
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	704 Remark 3: As for QIDO-RS, the request is run synchronously by default.
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	705 The ``Synchronous`` and ``Priority`` arguments can be used to
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	706 asynchronously run the request.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	707
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	708
603 60c787d3f4d3 DICOMweb: ServersInDatabase option Sebastien Jodogne <s.jodogne@gmail.com> parents: 449 diff changeset	709 .. _dicomweb-additional-samples:
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	710
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	711 Additional samples
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	712 ------------------
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	713
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	714 Samples of how to call DICOMweb services from standalone applications
03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	715 are available for `Python
449 2922fb1bd65e fix links Sebastien Jodogne <s.jodogne@gmail.com> parents: 445 diff changeset	716 <https://hg.orthanc-server.com/orthanc-dicomweb/file/default/Resources/Samples/Python>`__
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	717 and for `JavaScript
449 2922fb1bd65e fix links Sebastien Jodogne <s.jodogne@gmail.com> parents: 445 diff changeset	718 <https://hg.orthanc-server.com/orthanc-dicomweb/file/default/Resources/Samples/JavaScript>`__.
32 03b32d0e49f2 documentation of the dicomweb plugin Sebastien Jodogne <s.jodogne@gmail.com> parents: 31 diff changeset	719
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	720 Integration tests are `available separately
449 2922fb1bd65e fix links Sebastien Jodogne <s.jodogne@gmail.com> parents: 445 diff changeset	721 <https://hg.orthanc-server.com/orthanc-tests/file/default/Plugins/DicomWeb/Run.py>`__,
260 f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	722 and provide samples for more advanced features of the REST API (such
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	723 as dynamically adding/updating/removing remote DICOMweb servers using
f9e7036d81d0 updating DICOMweb documentation Sebastien Jodogne <s.jodogne@gmail.com> parents: 255 diff changeset	724 HTTP PUT and DELETE methods).

Mercurial > hg > orthanc-book

annotate Sphinx/source/plugins/dicomweb.rst @ 872:f72b2dd172da Orthanc-1.11.2