DICOM-Просмотрщик может быть запущен при клике по ссылке на странице интернет-браузера.
Если на компьютере уже запущен DICOM-Просмотрщик, то URL-параметры передаются запущенной программе. Второй экземпляр программы не запускается (см. раздел ??).
Для активации запуска DICOM-Просмотрщика с помощью URL-команды в ОС Windows необходимо, чтобы DICOM-Просмотрщик был зарегистрирован в системе URI как «inobitec».
Регистрация DICOM-Просмотрщика в системе URI осуществляется автоматически на этапе установки программы. Чтобы активировать поддержку запуска DICOM-Просмотрщика по URL-команде, установите флаг «Зарегистрировать схему «inobitec» для запуска просмотрщика с параметрами из браузера» в окне «Расширенные параметры» (рис. 7) . По умолчанию флаг снят. Если опция активирована, то в процессе установки программы требуются административные права. При удалении DICOM-Просмотрщика его регистрация в системе URI сохраняется.
Для активации запуска DICOM-Просмотрщика из браузера в ОС Linux необходимо при первом запуске AppImage-файла произвести его интеграцию в систему. Для того, чтобы ОС выдала запрос на интеграцию, может потребоваться вспомогательная программа, например, AppImageLauncher.
При интеграции приложения схема регистрируется для текущего пользователя (desktop-файл из состава AppImage устанавливается в каталог ∼/.local/share/applications).
Интернет-браузер Firefox, установленный с помощью утилит развёртывания программного обеспечения Snap или Flatpak, не выполняет сторонние URI-схемы из-за политики безопасности. | |
Поддержка запуска DICOM-Просмотрщика из браузера в macOS активируется автоматически при открытии dmg-файла приложения.
Для сброса установленной схемы используйте команду: /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/ Support/lsregister -u <Путь до установленного app-файла>
Чтобы проверить запуск DICOM-Просмотрщика, введите в адресную строку браузера команду: inobitec://
После подтверждения запроса открывается окно DICOM-Просмотрщика.
Для передачи в URL-запросы доступны следующие параметры (указаны в формате ключ=<значение> или ключ):
study-folder=<path> — путь к каталогу с файлами исследования. Если исследований несколько, то следующие параметры запуска применяются к первому в списке исследованию:
open-series-images — первая серия исследования открывается во вкладке просмотра плоских изображений
open-series-mpr — первая серия исследования открывается во вкладке мультипланарной реконструкции
open-series-volume — первая серия исследования открывается во вкладке объёмной реконструкции
open-series-endoscopy — первая серия исследования открывается во вкладке виртуальной эндоскопии
study-uid=<study_uid> — уникальный идентификатор (UID) исследования, содержащего серию для открытия на форме просмотра изображений
series-uid=<series_uid> — UID-идентификатор серии для открытия
series-index=<series_index> — индекс серии для открытия
patient-id=<patient_id> — идентификатор пациента, список исследований которого будет открыт
pacs-aetitle=<pacs_aetitle> — установить AE Title PACS-сервера, с которого осуществляется попытка открыть исследование. С этим параметром может использоваться только команда:
open-series-images — первая серия исследования открывается во вкладке просмотра плоских изображений
Для запуска DICOM-Просмотрщика используется следующий формат URL-команды: inobitec://?param_1=”value_1”&...¶m_m=&...¶m_n=”value_n”
Параметр param_m в указанном формате передаётся без значения. Символы кавычек
необходимо заменять соответствующими кодовыми обозначениями. Также кодовыми
обозначениями рекомендуется заменять любые символы, отличные от букв и цифр, в
наименованиях параметров и в значениях.
Ниже приведены примеры консольных и соответствующих им URL-команд.
Пример 1. Консольной команде viewer.exe --study-folder “D:/DicomData/001” --series-index “0” --open-series-mpr
соответствует URL-команда inobitec://?study%2Dfolder=%22D%3A%2FDicomData%2F001%22&series%2Dindex=%220%22&open%2Dseries%2Dmpr=
Команда открывает в окне мультипланарной реконструкции серию с индексом 0 первого
исследования, содержащегося в папке D:/DicomData/001.
Пример 2. Консольной команде viewer.exe --pacs-aetitle “PACS_Inobitec” --patient-id “9Htqj5c” --open-series-images
соответствует URL-команда inobitec://?pacs%2Daetitle=%22PACS%5FInobitec%22&patient%2Did= %229Htqj5c%22&series%2Dindex=10&open%2Dseries%2Dimages=
Команда открывает в окне просмотра плоских изображений первую серию первого
исследования с идентификатором пациента 9Htqj5c, расположенного на PACS-сервере с AE Title
PACS_Inobitec.
При ошибке в URL-запросе открывается окно DICOM-Просмотрщика и в log-файл записывается сообщение об ошибке. Ошибка в одном из параметров запроса не отменяет обработку остальных параметров.