Mercurial > hg > orthanc-book

comparison Sphinx/source/users/anonymization.rst @ 711:4f658c25addd

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
bulk anonymization/modification
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 16 Jun 2021 17:05:36 +0200
parents bcd1a6a89280
children 6c4fcd1ad337
comparison
equal deleted inserted replaced
710:41e450b5ac2e 711:4f658c25addd
242 242
243 As written above, the anonymization process can be fine-tuned by using 243 As written above, the anonymization process can be fine-tuned by using
244 a JSON body. 244 a JSON body.
245 245
246 246
247 .. _bulk-modification:
248
249 Bulk modification or anonymization
250 ----------------------------------
251
252 Starting with Orthanc 1.9.4, it is possible to use the new routes
253 ``/tools/bulk-modify`` and ``/tools/bulk-anonymize`` to respectively
254 modify or anonymize a set of multiple DICOM resources that are not
255 related (i.e. that don't share any parent DICOM resource). A typical
256 use case is to modify/anonymize a list of DICOM instances that don't
257 belong to the same parent patient/study/series.
258
259 .. highlight:: bash
260
261 These two routes accept the same arguments as described above, but
262 must also be provided with an additional argument ``Resources`` that
263 lists the :ref:`Orthanc identifiers <orthanc-ids>` of the resources of
264 interest (that may indifferently correspond to patients, studies,
265 series or instances). Here are two sample calls::
266
267 $ curl http://localhost:8042/tools/bulk-modify -d '{"Replace":{"SeriesDescription":"HELLO"},"Resources":["b6da0b16-a25ae9e7-1a80fc33-20df01a9-a6f7a1b0","d6634d97-24379e4a-1e68d3af-e6d0451f-e7bcd3d1"]}'
268 $ curl http://localhost:8042/tools/bulk-anonymize -d '{"Resources":["b6da0b16-a25ae9e7-1a80fc33-20df01a9-a6f7a1b0","d6634d97-24379e4a-1e68d3af-e6d0451f-e7bcd3d1"]}'
269
270 .. highlight:: json
271
272 The output of the modification/anonymization lists all the resources
273 that have been altered by the call (including their parents). Here is
274 the output of the second sample above::
275
276 {
277 "Description" : "REST API",
278 "FailedInstancesCount" : 0,
279 "InstancesCount" : 2,
280 "IsAnonymization" : true,
281 "Resources" : [
282 {
283 "ID" : "04c04806-27b01a5a-08ea66cb-cb36c8b9-ebe62fe3",
284 "Path" : "/instances/04c04806-27b01a5a-08ea66cb-cb36c8b9-ebe62fe3",
285 "Type" : "Instance"
286 },
287 {
288 "ID" : "4e37fce9-6b33b8ba-7bb378e1-abc7e2c4-fca4ade3",
289 "Path" : "/instances/4e37fce9-6b33b8ba-7bb378e1-abc7e2c4-fca4ade3",
290 "Type" : "Instance"
291 },
292 {
293 "ID" : "6438ee62-b58a4788-517931b3-e10321eb-d1ab2613",
294 "Path" : "/series/6438ee62-b58a4788-517931b3-e10321eb-d1ab2613",
295 "Type" : "Series"
296 },
297 {
298 "ID" : "660494fd-1ddd661b-4358d996-ba600e5a-066d94cc",
299 "Path" : "/studies/660494fd-1ddd661b-4358d996-ba600e5a-066d94cc",
300 "Type" : "Study"
301 },
302 {
303 "ID" : "5faa0bf8-8a45520b-3a07e536-fc24f241-f59ae3e1",
304 "Path" : "/patients/5faa0bf8-8a45520b-3a07e536-fc24f241-f59ae3e1",
305 "Type" : "Patient"
306 }
307 ]
308 }
309
310
311
247 .. _split-merge: 312 .. _split-merge:
248 313
249 Split/merge of DICOM studies 314 Split/merge of DICOM studies
250 ---------------------------- 315 ----------------------------
251 316