# HG changeset patch # User Alain Mazy # Date 1661940375 -7200 # Node ID f72b2dd172da18582cb563cf70c589f1e88e88f1 # Parent ab39093b898f8c3ead5d202a3121098578ec6b04 Orthanc 1.11.2 diff -r ab39093b898f -r f72b2dd172da OpenAPI/orthanc-openapi.json --- a/OpenAPI/orthanc-openapi.json Tue Aug 30 14:16:48 2022 +0200 +++ b/OpenAPI/orthanc-openapi.json Wed Aug 31 12:06:15 2022 +0200 @@ -2,7 +2,7 @@ "info" : { "description" : "This is the full documentation of the [REST API](https://book.orthanc-server.com/users/rest.html) of Orthanc.

This reference is automatically generated from the source code of Orthanc. A [shorter cheat sheet](https://book.orthanc-server.com/users/rest-cheatsheet.html) is part of the Orthanc Book.

An earlier, manually crafted version from August 2019, is [still available](2019-08-orthanc-openapi.html), but is not up-to-date anymore ([source](https://groups.google.com/g/orthanc-users/c/NUiJTEICSl8/m/xKeqMrbqAAAJ)).", "title" : "Orthanc API", - "version" : "1.11.1" + "version" : "1.11.2" }, "openapi" : "3.0.0", "paths" : { @@ -3598,9 +3598,9 @@ "schema" : { "description" : "JSON array containing either the jobs identifiers, or detailed information about the reported jobs (if `expand` argument is provided)", "example" : [ - "003e5852-af2b-42af-8190-2e333b8f8bbb", - "1114a97d-0a79-40de-be60-a3af5d4ba680", - "1dec255c-7736-41ec-8560-e1486aa941ce", + "23a80b32-d72d-47cd-93d2-88d12e064ff6", + "2db25003-6758-4509-a828-e74d70773c5e", + "3f1aa2c2-fca5-4d83-bb47-f4eafe85ae24", "..." ] } @@ -15223,7 +15223,7 @@ "200" : { "content" : { "text/plain" : { - "example" : "orthanc_count_instances 2552 1656599741752\northanc_count_patients 8 1656599741752\northanc_count_series 26 1656599741752\northanc_count_studies 8 1656599741752\northanc_dicom_cache_count 344 1656589511558\northanc_dicom_cache_size 127.937477 1656589511556\northanc_disk_size_mb 1018.65021 1656599741752\northanc_jobs_completed 10 1656599741752\northanc_jobs_failed 5 1656599741752\northanc_jobs_pending 0 1656599741752\northanc_jobs_running 0 1656599741752\northanc_jobs_success 5 1656599741752\northanc_rest_api_active_requests 1 1656599741751\northanc_rest_api_duration_ms 385 1656599740245\northanc_storage_read_duration_ms 16 1656599738604\northanc_uncompressed_size_mb 1018.65021 1656599741752\n" + "example" : "orthanc_count_instances 2552 1661940227313\northanc_count_patients 8 1661940227313\northanc_count_series 26 1661940227313\northanc_count_studies 8 1661940227313\northanc_dicom_cache_count 587 1661939724041\northanc_dicom_cache_size 127.833656 1661939724040\northanc_disk_size_mb 1018.65021 1661940227313\northanc_jobs_completed 10 1661940227313\northanc_jobs_failed 2 1661940227313\northanc_jobs_pending 0 1661940227313\northanc_jobs_running 0 1661940227313\northanc_jobs_success 8 1661940227313\northanc_rest_api_active_requests 1 1661940227312\northanc_rest_api_duration_ms 3036 1661940225539\northanc_storage_read_duration_ms 57 1661940217477\northanc_uncompressed_size_mb 1018.65021 1661940227313\n" } }, "description" : "" @@ -15242,7 +15242,7 @@ "200" : { "content" : { "text/plain" : { - "example" : "20220630T143541", + "example" : "20220831T100347", "schema" : { "description" : "The UTC time" } @@ -15264,7 +15264,7 @@ "200" : { "content" : { "text/plain" : { - "example" : "20220630T143541", + "example" : "20220831T100347", "schema" : { "description" : "The local time" } diff -r ab39093b898f -r f72b2dd172da Sphinx/source/developers/creating-plugins.rst --- a/Sphinx/source/developers/creating-plugins.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/developers/creating-plugins.rst Wed Aug 31 12:06:15 2022 +0200 @@ -15,7 +15,7 @@ Native Orthanc plugins must use the `plugin SDK `__ whose interface is available as a `C header -`__. +`__. As a consequence, an Orthanc plugin will typically be written using C or C++, although it is also possible to create native plugins using languages that feature compatibility with C headers and with `FFI of @@ -96,7 +96,7 @@ that is part of the Orthanc source distribution: * `Plugins/Include/orthanc/OrthancCPlugin.h - `__ + `__ `Online documentation `__ for this C header is available, as generated by `Doxygen @@ -110,8 +110,8 @@ ``HAS_ORTHANC_EXCEPTION`` is set to ``0``: * `Plugins/Samples/Common/OrthanPluginCppWrapper.h - `__ + `__ * `Plugins/Samples/Common/OrthanPluginCppWrapper.cpp - `__ + `__ * `Plugins/Samples/Common/OrthanPluginException.h - `__ + `__ diff -r ab39093b898f -r f72b2dd172da Sphinx/source/developers/db-versioning.rst --- a/Sphinx/source/developers/db-versioning.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/developers/db-versioning.rst Wed Aug 31 12:06:15 2022 +0200 @@ -26,7 +26,7 @@ Version DB v2 DB v3 DB v4 DB v5 DB v6 =============================== ===== ===== ===== ===== ===== Mainline u u u x -Orthanc 0.9.5 - Orthanc 1.11.1 u u u x +Orthanc 0.9.5 - Orthanc 1.11.2 u u u x Orthanc 0.8.5 - Orthanc 0.9.4 u u x Orthanc 0.7.3 - Orthanc 0.8.4 u x Orthanc 0.4.0 - Orthanc 0.7.2 x diff -r ab39093b898f -r f72b2dd172da Sphinx/source/dicom-guide.rst --- a/Sphinx/source/dicom-guide.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/dicom-guide.rst Wed Aug 31 12:06:15 2022 +0200 @@ -665,7 +665,7 @@ $ getscu -v localhost 4242 -aec ORTHANC -k "0008,0052=STUDY" -k "0020,000d=1.2.840.113543.6.6.4.7.64067529866380271256212683512383713111129" -*Note:* As of Orthanc 1.11.1, Orthanc only implements C-Get as a +*Note:* As of Orthanc 1.11.2, Orthanc only implements C-Get as a service class provider (SCP). Using C-Get as a service class user (SCU) is not currently supported in Orthanc. diff -r ab39093b898f -r f72b2dd172da Sphinx/source/faq/crash.rst --- a/Sphinx/source/faq/crash.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/faq/crash.rst Wed Aug 31 12:06:15 2022 +0200 @@ -64,13 +64,13 @@ above ` is available as the ``crash.cpp`` file, here is a sample debug session:: - $ wget https://lsb.orthanc-server.com/orthanc/debug/1.11.1/Orthanc + $ wget https://lsb.orthanc-server.com/orthanc/debug/1.11.2/Orthanc $ chmod +x ./Orthanc $ gcc -fPIC -shared ./crash.cpp -I ~/orthanc/Plugins/Include -o crash.so $ ulimit -c unlimited $ echo '{ "Plugins" : ["crash.so"] }' > Configuration.json $ rm -f core ; ./Orthanc Configuration.json - W0427 15:43:24.215783 main.cpp:1436] Orthanc version: 1.11.1 + W0427 15:43:24.215783 main.cpp:1436] Orthanc version: 1.11.2 W0427 15:43:24.215910 main.cpp:1279] Performance warning: Non-release build, runtime debug assertions are turned on W0427 15:43:24.217585 OrthancConfiguration.cpp:61] Reading the configuration from: "Configuration.json" W0427 15:43:24.254733 main.cpp:700] Loading plugin(s) from: crash.so diff -r ab39093b898f -r f72b2dd172da Sphinx/source/faq/debugging.rst --- a/Sphinx/source/faq/debugging.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/faq/debugging.rst Wed Aug 31 12:06:15 2022 +0200 @@ -45,13 +45,13 @@ to debug Orthanc without compiling from sources. Here is a sample debug session:: - $ wget https://lsb.orthanc-server.com/orthanc/debug/1.11.1/Orthanc + $ wget https://lsb.orthanc-server.com/orthanc/debug/1.11.2/Orthanc $ chmod +x ./Orthanc $ gdb ./Orthanc Configuration.json (gdb) catch throw Catchpoint 1 (throw) (gdb) run - W0513 15:24:42.374349 main.cpp:1436] Orthanc version: 1.11.1 + W0513 15:24:42.374349 main.cpp:1436] Orthanc version: 1.11.2 ---> Reproduce your error case <--- Thread 15 "Orthanc" hit Catchpoint 1 (exception thrown), 0x00007ffff6de68bd in __cxa_throw () from /usr/lib/x86_64-linux-gnu/libstdc++.so.6 (gdb) backtrace diff -r ab39093b898f -r f72b2dd172da Sphinx/source/faq/orthanc-storage.rst --- a/Sphinx/source/faq/orthanc-storage.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/faq/orthanc-storage.rst Wed Aug 31 12:06:15 2022 +0200 @@ -59,9 +59,9 @@ database schema is kept as simple as possible, and can be found in the following two files of the source code of Orthanc: `PrepareDatabase.sql -`__ +`__ and `InstallTrackAttachmentsSize.sql -`__. +`__. Direct access diff -r ab39093b898f -r f72b2dd172da Sphinx/source/faq/scalability.rst --- a/Sphinx/source/faq/scalability.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/faq/scalability.rst Wed Aug 31 12:06:15 2022 +0200 @@ -54,7 +54,7 @@ Here is a generic setup that should provide best performance in the presence of large databases: -* Make sure to use the latest release of Orthanc (1.11.1 at the time of +* Make sure to use the latest release of Orthanc (1.11.2 at the time of writing) running on a GNU/Linux distribution. * We suggest to use the latest release of the :ref:`PostgreSQL plugin diff -r ab39093b898f -r f72b2dd172da Sphinx/source/plugins/python.rst --- a/Sphinx/source/plugins/python.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/plugins/python.rst Wed Aug 31 12:06:15 2022 +0200 @@ -18,7 +18,7 @@ Python plugins have access to more features and a more consistent SDK than :ref:`Lua scripts `. The largest part of the Python API is automatically generated from the `Orthanc plugin SDK in C -`__ +`__ using the `Clang `__ compiler front-end. diff -r ab39093b898f -r f72b2dd172da Sphinx/source/users/advanced-rest.rst --- a/Sphinx/source/users/advanced-rest.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/users/advanced-rest.rst Wed Aug 31 12:06:15 2022 +0200 @@ -89,7 +89,7 @@ the ``MediaArchiveSize`` configuration that defines the maximum number of ZIP/media archives that are maintained by Orthanc, as a response to the asynchronous creation of archive. As of Orthanc -1.11.1, this value is ``1`` by default ! +1.11.2, this value is ``1`` by default ! .. _jobs-monitoring: @@ -139,7 +139,7 @@ ``ErrorCode`` and ``ErrorDescription`` fields for more information. * ``Paused``: The job has been paused. * ``Retry``: The job has failed internally, and has been scheduled for - re-submission after a delay. As of Orthanc 1.11.1, this feature is not + re-submission after a delay. As of Orthanc 1.11.2, this feature is not used by any type of job. In order to wait for the end of an asynchronous call, the caller will @@ -148,7 +148,7 @@ ``Failure``. Note that the `integration tests of Orthanc -`__ +`__ give an example about how to monitor a job in Python using the REST API (cf. function ``MonitorJob()``). @@ -221,7 +221,7 @@ Note how we retrieve the content of the archive by accessing the ``archive`` output of the job (check out the virtual method ``IJob::GetOutput()`` from the `source code -`__ +`__ of Orthanc). Here is the corresponding sequence of commands to generate a DICOMDIR @@ -230,7 +230,7 @@ $ curl http://localhost:8042/studies/27f7126f-4f66fb14-03f4081b-f9341db2-53925988/media -d '{"Asynchronous":true}' $ curl http://localhost:8042/jobs/6332be8a-0052-44fb-8cc2-ac959aeccad9/archive > a.zip -As of Orthanc 1.11.1, only the creation of a ZIP or a DICOMDIR archive +As of Orthanc 1.11.2, only the creation of a ZIP or a DICOMDIR archive produces such "outputs". diff -r ab39093b898f -r f72b2dd172da Sphinx/source/users/anonymization.rst --- a/Sphinx/source/users/anonymization.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/users/anonymization.rst Wed Aug 31 12:06:15 2022 +0200 @@ -80,7 +80,7 @@ **Implementation:** Internally, the setup of the anonymization profiles can be found in the methods ``SetupAnonymizationXXX()`` of the class ``Orthanc::DicomModification`` (cf. `source code -`__). +`__). Modification of a Single Instance diff -r ab39093b898f -r f72b2dd172da Sphinx/source/users/configuration.rst --- a/Sphinx/source/users/configuration.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/users/configuration.rst Wed Aug 31 12:06:15 2022 +0200 @@ -8,7 +8,7 @@ Configuring Orthanc simply consists in providing a configuration file. Orthanc has numerous configuration that are documented in the `default configuration file -`_. This +`_. This file is in the `JSON `_ file format. You can generate this file file with the following call:: diff -r ab39093b898f -r f72b2dd172da Sphinx/source/users/debian-packages.rst --- a/Sphinx/source/users/debian-packages.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/users/debian-packages.rst Wed Aug 31 12:06:15 2022 +0200 @@ -106,10 +106,10 @@ This can be done with this sequence of commands:: $ sudo service orthanc stop - $ sudo wget https://lsb.orthanc-server.com/orthanc/1.11.1/Orthanc --output-document /usr/sbin/Orthanc + $ sudo wget https://lsb.orthanc-server.com/orthanc/1.11.2/Orthanc --output-document /usr/sbin/Orthanc $ sudo rm -f /usr/share/orthanc/plugins/*.so - $ sudo wget https://lsb.orthanc-server.com/orthanc/1.11.1/libServeFolders.so --output-document /usr/share/orthanc/plugins/libServeFolders.so - $ sudo wget https://lsb.orthanc-server.com/orthanc/1.11.1/libModalityWorklists.so --output-document /usr/share/orthanc/plugins/libModalityWorklists.so + $ sudo wget https://lsb.orthanc-server.com/orthanc/1.11.2/libServeFolders.so --output-document /usr/share/orthanc/plugins/libServeFolders.so + $ sudo wget https://lsb.orthanc-server.com/orthanc/1.11.2/libModalityWorklists.so --output-document /usr/share/orthanc/plugins/libModalityWorklists.so $ $ sudo wget https://lsb.orthanc-server.com/plugin-dicom-web/1.6/libOrthancDicomWeb.so --output-document /usr/share/orthanc/plugins/libOrthancDicomWeb.so $ ... diff -r ab39093b898f -r f72b2dd172da Sphinx/source/users/rest.rst --- a/Sphinx/source/users/rest.rst Tue Aug 30 14:16:48 2022 +0200 +++ b/Sphinx/source/users/rest.rst Wed Aug 31 12:06:15 2022 +0200 @@ -98,7 +98,7 @@ $ curl -X POST -H "Expect:" http://localhost:8042/instances --data-binary @CT.X.1.2.276.0.7230010.dcm The code distribution of Orthanc contains a `sample Python script -`__ +`__ that recursively upload the content of some folder into Orthanc using the REST API:: @@ -110,7 +110,7 @@ import the content of ``.zip``, ``.tar.gz`` or ``.tar.bz2`` archives without having to uncompress them first. It also provides more comprehensive command-line options. `Check this script out -`__. +`__. .. highlight:: perl