Import Studies and Files
Overview
The OmegaAI Import feature allows users to upload both DICOM and non-DICOM files directly through the web interface. This guide covers the full import workflow — from starting a new session and uploading files, to configuring import settings, monitoring progress, and resolving errors.
Supported file types:
- DICOM Objects
- JPEG
- PNG
- MP4
Step 1: Access the Import Page
- In the left sidebar, click + Add New.
- A menu appears with two options — Import and Order. Select Import.
- The New Import page will open with a drop zone to upload files.
Step 2: Upload Files
On the New Import page, add files using one of the following methods:
- Drag & Drop — Drag a file or folder from your file explorer and drop it onto the dashed drop zone.
- Browse Files — Click "click to browse files" inside the drop zone and select your file(s).
Once files are added, the Import Details panel will open automatically on the right side of the screen.
Step 3: Configure Import Details
The Import Details panel contains three fields. Start typing in the Study field to search — a dropdown will display matching results including patient name, study type, accession number, organization, and date. Selecting a study will auto-populate the Managing Organization and Study Status fields.
Click ADD to confirm or CANCEL to discard |
|
Step 4: Review and Start the Import
After clicking ADD, the import staging screen displays:
- The import session (e.g., Import 1) is displayed in the header, alongside the associated study details shown as a button. Click the ✏ pencil icon to edit the study details before starting.
- Each uploaded file is listed as a row, annotated with its detected file type. When a folder is uploaded, each subfolder appears as a separate row with its folder name.
- The total number of queued items in the top right corner.
- Session tabs at the bottom of the screen represent each open import session, showing its current status.
Before starting:
- To remove a file or folder from the queue, hover over its row and click and hold the Delete option.
- Click ✕ CANCEL to cancel all operations and discard the session.
When ready, click ► START to begin the import.
Step 5: Monitor Import Progress
Once started, the screen updates in real time. Each item row displays its own upload progress and status:
| Status | Description |
|---|---|
| Ready | Queued, not yet started |
| Uploading – n% | Transfer in progress with per-item percentage shown |
| Completed | Upload successful |
| Failed | Upload encountered an error |
A progress bar at the bottom shows the overall upload percentage across all items. The bar turns amber if any item fails. Click ■ STOP at any time to halt the upload.
When the import finishes:
- Successful imports display a success message. Click ✕ CLOSE to close the session.
- Failed imports display a failure message. Click ERROR LOG to view error details or RETRY FAILED to re-attempt uploading the failed items without restarting the session.
Running Multiple Import Sessions
OmegaAI supports up to 3 concurrent import sessions. To start an additional import, simply repeat the steps above — each new import opens as a separate session (e.g., Import 1, Import 2, Import 3), with its own tab at the bottom of the screen.
Click any session tab to switch between sessions and monitor each one independently.
Once all 3 sessions are active, attempting to start a new import will show the following error:
"Max Import Session is 3. If you want to upload the new session, please delete the old ones"
To free up a slot, click ✕ CLOSE on one or more completed sessions, then retry.
Reviewing Import Progress via Task Logs
To check import status outside of an active session:
- Navigate to Task Logs from the sidebar.
- Filter the Status Reason column to view the status of your imports.
Handling Special File Types
DICOM SR Objects with Measurements
When importing DICOM files containing SR (Structured Report) objects with measurements:
- If no study is set, SR measurements will be displayed directly in the image viewer.
- If a study is set, SR objects will be converted into a PDF document and added to the study documents, and will not appear as measurements in the viewer.
Tip: Leave the Study field empty to keep measurements visible in the image viewer.
Troubleshooting
Managing Organization required This field cannot be left empty. If you attempt to proceed without it, a red validation message will appear below the field. Search for and select an organization before clicking ADD.
File not appearing after drop Ensure you are using a supported file format (DCM, JPEG, PNG, PDF, or MP4). Try using the "click to browse files" option as an alternative.
"Import Failed — One or more files you tried to upload are not supported" The file format is not accepted. Click CLOSE and retry using a supported format: DCM, JPEG, PNG, PDF, or MP4.
"Cannot Import Non-DICOM object without a study specified" A study is required when importing non-DICOM files (e.g., JPEG, PNG, PDF, MP4). Return to the Import Details panel, enter a study in the Study field, and retry.
Max Import Session error You have reached the 3-session limit. Click ✕ CLOSE on one or more completed sessions to free up a slot, then retry.
Upload is stuck or not progressing Click ■ STOP to cancel the upload. Check your internet connection and start a new import session with the same file.
Some files show "Failed" after upload Click ERROR LOG to view a full error report. Use RETRY FAILED to re-attempt uploading the failed files without restarting the entire session.