UI reference

Open from archive

Connect to an Orthanc, DICOMweb or DIMSE archive, search it, and open a study.

Desktop app only, 1.6.0 or newerdcmage pro

Choose Archive on the start screen or Open from Archive… in the session menu. If you are connected, you can search straight away. Otherwise pick an archive from the Archive list, enter its password or token if it asks for one, and click Connect. Picking an archive connects nothing, and a connection stays up until you make a different one. Manage archives… opens the list in Settings, and Change details… shows everything dcmage remembers about the archive you picked.

To add one, click Add archive…, pick how it connects (Orthanc, DICOMweb or DIMSE), enter its address, and connect. Orthanc and DICOMweb ask for a user name and password or an access token. DIMSE asks for the host, the port, the archive’s AE title and yours instead of a password. An archive reached with a client certificate always opens on its details, because you choose the two files again each time.

A password or token lasts until you disconnect, unless you tick Remember securely. Then, once the archive accepts it, the desktop app keeps it in macOS Keychain or Windows Credential Manager, and next time the field reads Saved securely. dcmage never shows the saved secret in the form.

Over DIMSE or DICOMweb you can also tick This archive removes images when it receives a rejection note for them. Tick it only if your archive does, dcm4chee for example; it is off by default and remembered with the archive. It adds Replace original, which sends an IOCM rejection note for the original after the corrected copy, and dcmage still checks afterwards whether the original went. See Send to archive.

Once connected, the window tells you which archive answered, whether the connection is encrypted, and what that archive lets dcmage do. Search by patient ID, patient name, study date, accession number, study description or modality. Open brings the whole study into the workspace. Series… lists its series so you can open only the ones you need.

Each result has a tick box where the connection can retrieve studies. Tick any number and click Anonymize to a folder… to write them, anonymized, to a folder with no identifiable copy on disk.

On Orthanc, tick two or more studies, up to 50, and click Correct N studies together to fix the same mistake in all of them at once. dcmage reads every ticked study, opens the first, and the edits you make to it are sent to all of them from Send to archive. A new search clears the ticks.

A bar below the results shows how far a download has got, and you can cancel from it. A click outside the window does nothing, so what you typed stays until you click Close. If some images can’t be fetched, dcmage opens the rest and tells you how many are missing.

Caution Without encryption (plain HTTP, or DIMSE without TLS), patient data crosses the network in readable form, and so does your password over HTTP. The window warns you while such a connection is open.