Connect to and search a remote DICOM archive
Point dcmage at an Orthanc, DICOMweb or DIMSE archive and find the study you need to correct.
Desktop app only, 1.6.0 or newerdcmage pro
Problem
A mislabelled study lives in the archive, not on your disk. Correcting it the usual way means exporting it, fixing it locally, importing it again and then remembering to delete the original. That is four steps, and each one can leave the archive holding two versions of the same study.
The desktop app connects to the archive directly, over Orthanc, DICOMweb or DIMSE (the DICOM network protocol most PACS speak). Searching and opening work the same way for all three. What differs is how a correction goes back: see Commit a corrected remote study and Re-send after correction.
Steps
-
Open the archive browser from the session menu.
-
Choose how the archive connects, and enter its address.
- Orthanc: the server’s address, for example
https://orthanc.hospital.example. - DICOMweb: the address of its DICOMweb service, for example
https://pacs.example.org/dicom-web. - DIMSE: the host and port, the archive’s AE title and the AE title it knows dcmage by, and how studies should be retrieved.
dcmage refuses an address that has a password written into it, or one that could send requests to a server other than the one you named.
- Orthanc: the server’s address, for example
-
Sign in. For Orthanc and DICOMweb, enter a user name and password, which is what the form opens on, or paste the access token your archive gave you. You never need both. A DIMSE archive takes no password: it recognises dcmage by its AE title, and may require an encrypted (TLS) connection.
dcmage remembers the address, which way you signed in and your user name, so the form opens where you left it. It does not remember the password or token unless you tick Remember securely.
With the box ticked, the desktop app keeps the password or token in macOS Keychain or Windows Credential Manager, and only after the archive has accepted it, so a mistyped password is never saved. Next time the field reads Saved securely and you can connect without typing it. The secret is not written to dcmage’s settings and is not shown in the form. To remove it, clear the box and connect, or forget the archive in Settings → Connections. If the credential store refuses the secret, for example because you denied access, the connection does not open and says why. Clear the box to connect without saving it.
-
Read what the connection reports: which archive answered and what it lets dcmage do. Searching, opening, storing and replacing a study without leaving a duplicate are separate abilities. An archive that can’t replace a study says so here, not when you try to send.
-
Search by patient ID, patient name, study date, accession number, study description or modality. A modality such as
CTmatches every study that has a CT series, whatever else it holds. Results show each study’s patient name, date and description.
When the connection is not encrypted
If the archive is reachable only over plain HTTP, dcmage says that the connection is not encrypted and that your password and the patient data cross the network in readable form. The connection still works, since some archives sit behind a local proxy that handles encryption.
When nothing matches
A search that finds no study says so, and loads nothing into the workspace.
Result
You are connected to one archive and can see the studies that match your search, with what the archive can do stated up front. A password or token lasts only until you disconnect, unless you chose to remember it securely.