Утилита Selector

Данный материал описывает функционал утилиты FileSelector.

Ожидаемый результат: Пользователь ознакомлен с утилитой и способен самостоятельно пользоваться ее функционалом.

Введение

Утилита Selector является программой для навигации и запуска файлов и каталогов в рамках выбранного проекта автоматизации.

Запуск утилиты

Запуск утилиты возможен:

из меню «Инструменты» на верхней строке Uniplant Atomix (пункт Selector);
из окна внутреннего модуля “ПЛК”;
при помощи файла selector.bat, расположенного по адресу Projects\{Project_Name}\JSC\Conf\Tools\Selector.

Запуск утилиты через расположение файла .bat	Запуск утилиты через окно модуля ПЛК

Описание интерфейса

1. Вкладка Main

Вкладка Main является основной рабочей областью утилиты (в стандартной конфигурации) “FileSelector” и содержит следующие разделы:

Вкладка Main

Рисунок 1 - “Вкладка Main”

Элементы управления:

Перечитывание конфигурации: Слева в верхней части окна находится кнопка для перечитывания файла sel_settings.xml без перезапуска программы.
Установка поверх всех окон: Справа в верхней части окна находится кнопка для установки утилиты поверх всех других окон.
Контекстное меню: При правом клике на элементе появляется контекстное меню с действиями, такими как “Открыть папку”, “SVN: update”, “SVN: commit”.
Дополнительно: В нижней части интерфейса есть кнопка “Дополнительно”. При разворачивании отображается последняя выполненная команда. Также есть выбор открывать каталог в проводнике (explorer) или в Total Commander (TOTALCMD.EXE).

Раздел “Утилиты”

Генератор
Выполняет запуск релизной версии Uniplant Atomix (Automiq\AutomiqAutomation\Release\net7.0-windows10.0.17763.0)
Генератор RC
Выполняет запуск дорелизной версии Uniplant Atomix (Automiq\AutomiqAutomation\ReleaseCandidate\net7.0-windows10.0.17763.0)
Настройка/SettingsManager:
Выполняет запуск утилиты SettingsManager

Раздел “Файлы конфигурации”

Позволяет совершить быстрый переход к основным файлам выбранного проекта:

Группы событий EventLists (Projects\{Project_Name}\JSC\Usr\Prj\Conf\EventLists)
Сетевые коммутаторы NetSwitches (Projects\{Project_Name}\JSC\Usr\Prj\Conf\NetSwitches)
Устройства ModbusTcp Modbus (Projects\{Project_Name}\JSC\Usr\Prj\Conf\DevStudioDevs\Modbus)
Дополнительно - раскрывающийся список, позволяющий выбрать систему для навигации по директориям и отображает последнюю выполненную команду.

2. Вкладка “Библиотеки”

Во вкладке “Библиотеки” доступен переход к библиотекам корневой структуры.

Вкладка Библиотеки

Рисунок 2 – “Вкладка Библиотеки”

3. Вкладка “Admin”

Вкладка Admin позволяет выполнить настройку утилиты Selector (как на глобальном уровне - Selector.xml GLOBAL, так и на локальном - Selector.xml LOCAL)

Глобальный уровень: JSC\Conf\Tools\Selector\sel_settings.xml — применяется ко всем проектам.
Локальный уровень: JSC\Usr\Prj\Conf\Tools\Selector\sel_settings.xml — применяется к выбранному проекту.

Вкладка Admin

Рисунок 3 – “Вкладка Admin”

Структура файла для настройки утилиты sel_settings.xml

Структура файла sel_settings.xml

Структура файла конфигурации

Файл является XML-документом, содержащим список элементов <ITEM>.

<ITEM Group="Библиотеки" Name="DevStudio" Programm="explorer.exe" Path="#GPATH#\..\..\..\Libraries\DevStudio"/>

Атрибут Group: Определяет имя вкладки, в которой будет отображаться элемент. Например, Group="Библиотеки" помещает элемент на вкладку “Библиотеки”.
Атрибут Name: Название элемента, отображаемое в списке.
Атрибут Programm: Путь к исполняемому файлу, который будет запущен при клике.
Атрибут Path: Путь к каталогу, который будет открыт в проводнике.
Атрибут AsAdmin: Если установлено в true, программа запускается от имени администратора.
Атрибут IfExists: Если установлено в true, элемент будет отображаться только если целевой файл/каталог существует.
Атрибут Params: Дополнительные параметры командной строки для запускаемой программы.

Используемые Макросы:

Список сокращений:

%JSC% = AppConfig.JscDirectory
%HMI% = AppConfig.HmiDirectory
%Unimod% = AppConfig.UnimodDirectoryPath.UnimodProjectsPath
%DevStudio% = AppConfig.DevStudioPath
%Weintek% = AppConfig.WeintekPath
%Libraries% = AppConfig.LibraryDirectory