The DICOM Viewer may be launched by clicking the link on the web browser page.
The URL parameters from the command line may be sent to the launched DICOM Viewer (see Launch multiple instances of the program).
To enable the DICOM Viewer launch with a URL Command on Windows, the DICOM Viewer must be registered in the URI system as inobitec.
The DICOM Viewer is automatically registered in the URI system when the software is installed. To enable the support of the DICOM Viewer launch with a URL Command, check the Register the schema "inobitec" to launch a viewer with parameters from browser box in the Launch by browser window (Fig. 7). By default, the box is not checked. If this option has been activated, administrator privileges will be required in the process of software installation. When the DICOM Viewer is deleted, it remains registered in the URI system.
In order to enable the DICOM Viewer launch from a browser on Linux, when the Applmage ﬁle is run for the ﬁrst time, it must be integrated with the system. A support program, such as AppImageLauncher may be required for the OS to make an integration request.
When the application is integrated, the scheme is registered for the current user (the desktop ﬁle from Applmage is installed in ∼/.local/share/applications).
|The Firefox browser installed with Snap or Flatpack deployment utilities will not follow any third-party URI schemes due to the security policy.
The support of the DICOM Viewer launch from a browser on MacOS is enabled automatically when the DMG ﬁle with the application is opened.
To reset the scheme provided, use the following command: /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/ Support/lsregister -u <Path to the installed app ﬁle>
To test the DICOM Viewer launch, enter the inobitec:// command in the address bar of the browser.
The DICOM Viewer window will be opened after conﬁrmation of the request.
The following parameters (in the key=<value> or key format) are available for URL requests:
study-folder=<path> — the path to the directory with the study ﬁles
study-uid=<study_uid> — the unique identiﬁer (UID) of the study containing a series to be opened by the image viewer
series-uid=<series_uid> — the unique identiﬁer (UID) of the series to be opened
series-index=<series_index> — the index of the series to be opened
patient-id=<patient_id> — the identiﬁer of the patient, for whom the study list is to be opened
pacs-aetitle=<pacs_aetitle> — provide the AE Title for the PACS server
open-series-images — open the images of the series
open-series-mpr — open the series in the multiplanar reconstruction tab
open-series-volume — open the series in the volume reconstruction tab
open-series-endoscopy — open the series in the virtual endoscopy tab
The following format of the URL command is used for launching the DICOM Viewer inobitec://?param_1=”value_1”&...¶m_m=&...¶m_n=”value_n”
In this format, the param_m parameter has no value. Quote symbols must be replaced by
the respective code designations. It is also recommended to replace any symbols diﬀerent
from letters and numbers by code designations in the names of parameters and values.
Below you can see some examples of console commands and respective URL commands.
Example 1. viewer.exe --study-folder “D:/DicomData/001” --series-index “0” --open-series-mpr console command corresponds to inobitec://?study%2Dfolder=%22D%3A%2FDicomData%2F001%22&series%2Dindex=%220%22&open%2Dseries%2Dmpr= URL command.
In the multiplanar reconstruction window, the command opens a series with 0 index of the ﬁrst
study contained in the D:/DicomData/001.
Example 2. viewer.exe --pacs-aetitle “PACS_Inobitec” --patient-id “9Htqj5c” --open-series-images console command corresponds to inobitec://?pacs%2Daetitle=%22PACS%5FInobitec%22&patient%2Did= %229Htqj5c%22&series%2Dindex=10&open%2Dseries%2Dimages= URL command.
In the ﬂat image viewer window, the command opens the ﬁrst series of the ﬁrst study with 9Htqj5c
patient id, which is placed on the PACS Server with AE Title PACS_Inobitec.
If there is a mistake in the URL request, the DICOM Viewer window is opened, and an error notiﬁcation is added to the log ﬁle. If there is a mistake in one of the request parameters, the other parameters are processed all the same.