changeset 173:901bc7b2dbab

improved bulk store scu section
author Sebastien Jodogne <s.jodogne@gmail.com>
date Fri, 09 Nov 2018 15:00:31 +0100
parents e239c4561bdc
children 1e9764acdf95
files Sphinx/source/users/rest.rst
diffstat 1 files changed, 15 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/Sphinx/source/users/rest.rst	Wed Nov 07 12:13:50 2018 +0100
+++ b/Sphinx/source/users/rest.rst	Fri Nov 09 15:00:31 2018 +0100
@@ -418,7 +418,8 @@
 The ``/sample/`` component of the URI corresponds to the identifier of
 the remote modality, as specified above in the configuration file.
 
-Note that you can send isolated DICOM instances with this command, but also entire patients, studies or series.
+Note that you can send isolated DICOM instances with this command, but
+also entire patients, studies or series.
 
 Bulk Store SCU
 ^^^^^^^^^^^^^^
@@ -426,19 +427,21 @@
 .. highlight:: bash
 
 Each time a POST request is made to ``/modalities/.../store``, a new
-DICOM connection is possibly established. This may lead to a large
-communication overhead if sending multiple isolated instances.
+DICOM association is possibly established. This may lead to a large
+communication overhead if sending multiple isolated instances by
+making one REST call for each of these instances.
 
 To circumvent this problem, you have 2 possibilities:
 
 1. Set the ``DicomAssociationCloseDelay`` option in the
    :ref:`configuration file <configuration>` to a non-zero value. This
    will keep the DICOM connection open for a certain amount of time,
-   waiting for new instances to be routed.
+   waiting for new instances to be routed. This is useful if 
+   autorouting images :ref:`using Lua <lua-auto-routing>`.
 
-2. If you do not want to keep the connection open but inactive, it is
-   possible to send multiple instances with a single POST request
-   (so-called "Bulk Store SCU", available from Orthanc 0.5.2)::
+2. It is possible to send multiple instances with a single POST
+   request (so-called "Bulk Store SCU", available from Orthanc
+   0.5.2)::
 
     $ curl -X POST http://localhost:8042/modalities/sample/store -d '["d4b46c8e-74b16992-b0f5ca11-f04a60fa-8eb13a88","d5604121-7d613ce6-c315a5-a77b3cf3-9c253b23","cb855110-5f4da420-ec9dc9cb-2af6a9bb-dcbd180e"]'
 
@@ -447,6 +450,11 @@
    available
    <https://bitbucket.org/sjodogne/orthanc/src/default/Resources/Samples/Python/HighPerformanceAutoRouting.py>`__.
 
+   Note that the list of resources to be sent can include the
+   :ref:`Orthanc identifiers <orthanc-ids>` of entire patients,
+   studies or series as well.
+
+
 
 Performing Query/Retrieve and Find with REST
 --------------------------------------------