20.1. Запуск программы из командной строки

Внимание! В операционных системах семейства macOS передача параметров командной строки не поддерживается.

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

Запуск программы из командной строки позволяет задавать особые параметры текущего сеанса работы программы, изменить настройки и получить справочную информацию о параметрах командной строки. Синтаксис команды запуска:

[<путь_к_программе>]<имя_исполняемого_файла_программы> [ --help] | [--study-folder <path> [--open-series-images | --open-series-mpr | --open-series-volume | --open-series-
endoscopy [--series-uid <uid> | --series-index <index>]]] | [--pacs-aetitle <aetitle> [--patient-id <patientID>] [--study-uid <studyUID>] [--series-index <seriesIndex> | --series-uid <seriesUID>] [--open-series-images] ] | [--aet <aet>] | [--import-settings <path> [--use-imported-listener-aetitle | --aet <aet>] [--update-scu-aetitle]] | [--export-settings <path>]

• --help: отображается справочная информация о параметрах командной строки, программа завершает работу.

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

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

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

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

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

  • С любым из этих параметров могут использоваться параметры

    • --series-uid <seriesUID>: открывается серия с соответствующим seriesUID

    • --series-index <seriesIndex>: открывается серия с соответствующим seriesIndex

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

  • --patient-id <patientID>: в списке исследований ищутся исследования с соответствующим patientID. Параметр имеет более высокий приоритет, чем --study-uid

  • --study-uid <studyUID>: в списке исследований ищутся исследования с соответствующим studyUID

  • --series-uid <seriesUID>: для выбранного исследования выбирается серия с соответствующим seriesUID. Если найдено несколько исследований, то используется первое в списке

  • --series-index <seriesIndex>: для выбранного исследования выбирается серия с соответствующим seriesIndex. Если найдено несколько исследований, то используется первое в списке

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

Пример: C:\Users\user\DICOMViewerPro1.9.1\viewer.exe --study-folder D:\dicom_data --open-series-images --series-index 1 откроет в окне просмотра плоских изображений серию с индексом 1 первого исследования, содержащегося в папке D:\dicom_data.

Если параметр введен неверно, отображается справочная информация о параметрах командной строки, программа завершает работу. Если значение параметра введено неверно, например, в указанной папке не содержатся DICOM-данные, не существует серии с указанным seriesUID или seriesIndex, то данный и все последующие параметры игнорируются.

Внимание! Если несколько серверов имеют одинаковые AE Title, то поиск данных выполняется на первом найденном сервере. Сортировка PACS-серверов происходит по полю "Название сервера".

Настройка подключения к PACS-серверам описана в разделе 13.2.

Длина значения AE Title не должна превышать 16 символов. Кириллические символы и знак "\" в значении AE Title не допускаются.

Следующие команды служат для изменения настроек. После выполнения любой из этих команд программа завершает работу, в случае успешного выполнения в командной строке появляется слово "Done" (выполнено).

• --aet <aetitle>: AE Title DICOM-сервиса заменится на <aetitle>

• --import-settings <file>: импортируются настройки из файла <file>.

  • --use-imported-listener-aetitle: AE Title DICOM-сервиса заменится на указанный в файле настроек

    • если одновременно используется параметр --aet <aetitle>, AE Title DICOM-сервиса заменится на <aetitle>

  • --update-scu-aetitle: Название клиента (SCU) для PACS-серверов AE Title DICOM-сервиса останется текущим

    • если одновременно используется параметр --aet <aetitle>, то Название клиента (SCU) для PACS-серверов заменится на <aetitle>

• --export-settings <file>: настройки сохраняются в файл <file>.