Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
POST - /data/services/import

 


Files

Files are attached in the body of the request. "inbody=true" must be set as a parameter. 

 


Select An Import Handler

Using the import-handler parameter, you can specify a specific implementation of the import logic. If this parameter is not specified, the default is "SI". 

OptionDescription
SIstandard session importer: Used to import individual DICOM or ECAT files or zips of DICOM or ECAT files.  Most of the other parameters below only work with this importer
gradual-DICOM

same implementation as XNAT's integrated DICOM receiver  Accepts individual DICOM files and follows the DICOM receiver mapping/archive logic

DICOM-zip

similar to the gradual-DICOM but accepts zipped collections of DICOM files  This is used by the Upload Applet

XAR

used to upload XAR files (zip files which include the session xml and the associated files)

 


All Parameters

Info

All parameters are optional, though the 'dest' is highly encouraged

 


overwrite
  • none (DEFAULT): Do not overwrite existing xml or files
  • append: Add content to existing xml & file system, but do not overwrite existing files
  • delete: Upload new data, and overwrite any existing files. 
quarantine
  • false (DEFAULT): follow project settings for whether new/modified archive content should go into quarantine
  • true: override project settings and place new/modified archive content in quarantine.
triggerPipelines
  • true (DEFAULT): run the AutoRun pipeline for any archived sessions which are modified/created by this import
  • false: Do not run the AutoRun at this time
src

Only used when attempting to import a previously uploaded file. You can specify multiple src attributes or separate them with commas. Example:

  • /user/cache/resources/X/files/X.zip
dest

Specifies intended destination. If it is empty, it will review the uploaded content and attempt to put it in the right place (or leave it in the prearchive Unassigned).

  • /prearchive
    • It will try to determine the proper project from the DICOM/ECAT headers.


  • /prearchive/projects/PROJECT
  • /prearchive/projects/PROJECT/timestamp
  • /prearchive/projects/PROJECT/timestamp/session
    • Importing to this url would allow you to merge additional content with previously uploaded content.


  • /archive
    • It will try to determine the proper project from the DICOM/ECAT headers.


  • /archive/projects/PROJECT
  • /archive/projects/PROJECT/subjects/SUBJECT
  • /archive/projects/PROJECT/subjects/SUBJECT/experiments/LABEL
    • Importing to this url would allow you to merge content with previously archived data.
import-handler

Defaults to standard import logic ("SI"). Client can specify a key using free-form text which the server maps to a different implementation of the import logic. See above.

http-session-listener

Used by the web based zip uploader

  •  free-form text: which should uniquely identify this upload process. If this is used, an http-session variable will be created using this text as the attribute ID, and will contain process/status information.
inbody

Used to tell the server that the body of the message is the actual file. This shouldn't be necessary if all upload tools set the Content-Type header appropriately.  But, many do not.  If your upload is failing and you can't figure out why, try setting this to true

  • true: the body of the message is the actual file
project
PROJECT_ID

For use when not using dest attribute

PROJECT
SUBJECT_IDFor use when not using dest attribute
EXPT_LABELFor use when not using dest attribute




Refresh The Archive Catalog XML

...