ONLY FOR INTERNAL REFERENCE BY CONVERSION TECHNICIANS, DO NOT PROVIDE OUTSIDE THE ORGANIZATION
Troubleshooting
NOTE 1: Don't start the xvhost push until you see if there are any large CT files being converted. Check these converted files in DicomViewer to see if the Modality is CT, and if the image slices display correctly. Follow the instructions here to review and correct CT files: 3D Images
NOTE 2: You will also need to follow the instructions here to correct the patient table: Patient Table Fix
NOTE 3: Use Extra ID as the patient ID
IMPORTANT - Use the one-at-a-time parameter in the xvhost push if you are starting the upload after the conversion is done.
ODBC connection:
Name: Sidexis
Driver: SQL Server
Server instance: typically SERVER\SIDEXIS_SQL
Default database: Sidexis
NOTE: Click the down arrow to the right of the Server text box to search for the correct SQL Server. If it doesn't find the SQL Server, it will display no results:
If this happens, look for an existing SQL Server instance named "PDATA_SQLEXPRESS" and double-click it to see the name of the Server:
Copy this server name and port number to your new "Sidexis" entry, and then change the default database to Sidexis:
For the login, try Windows NT authentication first, however if that does not work, select SQL Server authentication and try these credentials:
Login ID: sa
Password: 2BeChanged!
Change the default database to SIDEXIS
Image path is normally called \PDATA\ with subfolders P_0000, P_0001, etc:
NOTE: IF THE CONVERSION WON'T START, SEE TROUBLESHOOTING SECTION FOR Sidexis 4 below
Troubleshooting
Patient Table Fix
If the converter gives this error after starting: Unable to open "patient" table of Sidexis 4 database.
Then run SQL Server Management Studio, and connect to the server instance for SIDEXIS_SQL
Right-click on the SIDEXIS database and choose Tasks > Back Up. Make a backup copy of the database.
Navigate to the SIDEXIS database table dbo.Patient
Right-click the table and choose Design. Click in the empty row at the bottom, and type in a new column name ExternalPatientID with these settings:
For the Column Name, type: ExternalPatientID
For the Data Type, select either: nvarchar(32) , nvarchar(50), nvarchar(MAX)
Check the box for Allow Nulls
Then choose File menu > Save Patient
NOTE: If most of the CardID values in the patient table were blank, you can skip the next step.
Then run this SQL command:
update dbo.Patient set ExternalPatientID = CardIdThis should copy the values from the CardID column to the ExternalPatientID column.
Then retry the conversion.
3D Images
If the client or IC mentions there are 3D Images in the old imaging software to be converted, do not start push loop before completing steps below for modality and image compression type.
Modality
-
Confirming Presence of 3D Images
Set up converter as normal. When on the final screen, DO NOT check box next to Skip patient preview and image verification screen. We need to view this information before starting the conversion.
Once the patient preview window loads (this may take minutes to hours depending on speed of machine and size of database), go to the converter folder > Logs > Logging_Images... .txt
This file displays all images the converter found in the database. Search the file for "3D Volumes". If 3D Volumes are present, start the converter but DO NOT start push loop.
-
Checking Modality of 3D Images
Once the conversion is complete, go to converter folder and launch DicomViewer.exe as Administrator
In File Explorer navigate to \converter\Apteryx-Images folder and sort files largest to smallest
Drag any file larger than 30 MB to the DicomViewer.exe pane and locate the modality. Do this for several large files.
If the modalities are all CT, begin push loop as normal. If modalities are CR, continue following these steps.
Fixing the Modality of 3D Images
NOTE: YOU MUST WAIT UNTIL THE CONVERSION IS COMPLETE BEFORE RUNNING NEXT STEPS
If the 3D file preview looks fine in DICOMViewer but the modality is CR instead of CT, you can use Brian's new "check_and_fix_dicom_cts.exe"
Brian Tinker: This script: Scans a directory for DICOM files with .DCM or .DIC ...
posted in CX - Customer Onboarding / Conversion - Apteryx Internal on Thursday, March 13, 2025 12:02 PM
|
This script:
How to use:
|
OLD METHOD TO FIX MODALITY:
Create a folder within the converter folder called something like Apteryx-Images-Wrong-Modality
Cut large images (over 30 MB) from Apteryx-Images to the new folder you've made
Transfer Sante DICOM Editor to client's desktop, unzip, and install the .exe
Launch Sante DICOM Editor > File > Batch > Modify DICOM Tag
Point to the Wrong Modality folder you've made
-
Tags should be:
Group = 0008
Element = 0060
Tag = CT
Once the Editor is done processing the images, it will output files with the suffix _mod to the folder you pointed it to.
Sort the wrong modality folder by date modified (newest to oldest) and cut all _mod files from that folder to the Apteryx-Images folder
Run the XVHost Push as normal