Mercurial > hg > orthanc-book
comparison Sphinx/source/users/anonymization.rst @ 711:4f658c25addd
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 |