[Shanoir uploader] Massive import from PACS using a XLSX (Excel) file - fli-iam/shanoir-ng GitHub Wiki

Mass import from a PACS using a XLSX (Excel) file

A French version of this page is available here.

It is now possible to import multiple datasets at once from a PACS using a configured Excel file. In order to do this, got to Mass Import -> From PACS with Excel

Than you are able to choose the study you want to import to, and to click on the "Open" button to select your Excel file.

mass_import

The uploads are automatically starting one after the other in the "Import" tab. Once the upload is FINISHED the DICOM files are deleted from the /workfolder to avoid using too much space.

The Excel file must respect the Shanoir format detailed below. You can download the .xlsx template file to have a template to fill.

Here is a listing of all the columns and their use:

  • DICOM_QUERY_LEVEL : values can be "STUDY" or "PATIENT" depending on the query. Set it to "STUDY" if you want to query for a specific study with the DICOM_STUDY_DATE and/or DICOM_MODALITY columns. Some pacs do not accept a PATIENT root query with a specified DICOM_MODALITY.
  • DICOM_PATIENT_NAME : Patient name as it appears in the pacs (can vary -> less reliable than IPP).
  • DICOM_PATIENT_ID : The unique identifier of the patient we want to load data. If the IPP is set, NAME and SURNAME aren't necessary.
  • DICOM_PATIENT_BIRTH_DATE : Patient birthdate as it appears in the pacs.
  • DICOM_STUDY_DESCRIPTION : Name of the study as it appears in the pacs.
  • DICOM_STUDY_DATE : Date of the study as it appears in the pacs. Beware that the value is formatted as text in the excel file to keep the pattern YYYYMMdd. You can set a time window by entering {firstDate}-{lastDate} still respecting the YYYYMMdd pattern for each date.
  • DICOM_MODALITY : Modality of the DICOM study you wish to query (e.g MR, CT, XA...).
  • FILTER_DICOM_STUDY_DESCRIPTION : Filter to apply at DICOM study level. The list can be separated by ";", and contain "*" (wildcard) and/or "!" (negation).
  • FILTER_DICOM_STUDY_MIN_DATE : Minimum date from which the data will be selected. Can be set to 0 in order to select all. Formats accepted : yyyy, yyyy-MM-dd, yyyy-MM-dd-HH
  • FILTER_DICOM_SERIES_DESCRIPTION : Filter to apply at DICOM serie level. The list can be separated by ";", and contain "*" (wildcard) and/or "!" (negation).
  • VERIFICATION_PATIENT_FIRSTNAME :
  • VERIFICATION_PATIENT_LASTNAME :
  • VERIFICATION_PATIENT_BIRTHNAME :
  • VERIFICATION_PATIENT_BIRTHDATE :
  • SHANOIR_STUDY_CARD_NAME : Shanoir study card name that will be used by default if another study card with adapted equipment is not found.
  • SHANOIR_SUBJECT_NAME : The name of the subject that will be created in Shanoir. it must be unique, and it is pertinent to add the study name.
  • SHANOIR_EXAM_COMMENT : Shanoir examination comment, can be set to null.

Filter examples

!Crane => We exclude exactly "Crane"

!*Crane* => We exclude all values containing "Crane"

*Crane;!*Injection* => We include all values finishing by "Crane" and not containing "Injection"

NB : It's not case sensitive

";" means AND

";;" means OR