20.2. Запуск DICOM-Просмотрщика по URL-команде

DICOM-Просмотрщик может быть запущен при клике по ссылке на странице интернет-браузера.

Если на компьютере уже запущен DICOM-Просмотрщик, то URL-параметры передаются запущенной программе. Второй экземпляр программы не запускается (см. раздел "Запуск нескольких экземпляров программы").

20.2.1 Активация запуска DICOM-Просмотрщика по URL-команде в ОС Windows

Для активации запуска DICOM-Просмотрщика с помощью URL-команды в ОС Windows необходимо, чтобы DICOM-Просмотрщик был зарегистрирован в системе URI как "inobitec".

Регистрация DICOM-Просмотрщика в системе URI осуществляется автоматически на этапе установки программы. Чтобы активировать поддержку запуска DICOM-Просмотрщика по URL-команде, установите флаг "Зарегистрировать схему "inobitec" для запуска просмотрщика с параметрами из браузера" в окне "Расширенные параметры" (рис. 7) . По умолчанию флаг снят. Если опция активирована, то в процессе установки программы требуются административные права. При удалении DICOM-Просмотрщика его регистрация в системе URI сохраняется.

20.2.2 Активация запуска DICOM-Просмотрщика по URL-команде в ОС Linux

Для активации запуска DICOM-Просмотрщика из браузера в ОС Linux необходимо при первом запуске AppImage-файла произвести его интеграцию в систему. Для того, чтобы ОС выдала запрос на интеграцию, может потребоваться вспомогательная программа, например, AppImageLauncher.

При интеграции приложения схема регистрируется для текущего пользователя (desktop-файл из состава AppImage устанавливается в каталог ∼/.local/share/applications).

Интернет-браузер Firefox, установленный с помощью утилит развёртывания программного обеспечения Snap или Flatpak, не выполняет сторонние URI-схемы из-за политики безопасности.

20.2.3 Активация запуска DICOM-Просмотрщика по URL-команде в macOS

Поддержка запуска DICOM-Просмотрщика из браузера в macOS активируется автоматически при открытии dmg-файла приложения.

Для сброса установленной схемы используйте команду: /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/ Support/lsregister -u <Путь до установленного app-файла>

20.2.4 Запуск DICOM-Просмотрщика с помощью URL-команды

Чтобы проверить запуск DICOM-Просмотрщика, введите в адресную строку браузера команду: inobitec://

После подтверждения запроса открывается окно DICOM-Просмотрщика.

Для передачи в URL-запросы доступны следующие параметры (указаны в формате ключ=<значение> или ключ):

• study-folder=<path> — путь к каталогу с файлами исследования. Если исследований несколько, то следующие параметры запуска применяются к первому в списке исследованию:

  • open-series-images — первая серия исследования открывается во вкладке просмотра плоских изображений

  • open-series-mpr — первая серия исследования открывается во вкладке мультипланарной реконструкции

  • open-series-volume — первая серия исследования открывается во вкладке объёмной реконструкции

  • open-series-endoscopy — первая серия исследования открывается во вкладке виртуальной эндоскопии

• study-uid=<study_uid 1>\…\<study_uid N> — список уникальных идентификаторов (UID) исследований, содержащих серии для открытия во вкладке просмотра изображений

• series-uid=<series_uid 1>\…\<series_uid N> — список UID-идентификаторов серий для открытия

• series-index=<series_index 1>\…\<series_index N> — список индексов серий для открытия. Нумерация параметра series-index начинается с нуля и зависит от текущего типа сортировки серий в исследовании

• patient-id=<patient_id> — идентификатор пациента, список исследований которого будет открыт

• pacs-aetitle=<pacs_aetitle> — установить AE Title PACS-сервера, с которого осуществляется попытка открыть исследование. Для подключения используются параметры, указанные в настройках подключения к данному серверу (см. раздел 13.2). С этим параметром может использоваться только команда:

  • open-series-images — первая серия исследования открывается во вкладке просмотра плоских изображений

Передача в URL-запросах списка, содержащего UID исследований (study-uid), серий (series-uid) и индексов серий (series-index), которые следует загрузить, осуществляется аналогично передаче списков параметров в командной строке (см. раздел 20.1).

Для запуска DICOM-Просмотрщика используется следующий формат URL-команды: inobitec://?param_1=”value_1”&...&param_m=&...&param_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-файл записывается сообщение об ошибке. Ошибка в одном из параметров запроса не отменяет обработку остальных параметров.