Различия

Показаны различия между двумя версиями страницы.

--- документация:функции_комплекса [2025/04/27 20:31] – adm0001
+++ документация:функции_комплекса [2026/01/11 22:24] (текущий) – adm0001
@@ Строка 546: / Строка 546: @@
 и) кнопки изменения масштаба карты.
+Кнопки, указанные в б) и в), отображаются и, соответственно, доступны для операций только пользователю с ролью «Администратор».
 {{:документация:функции_комплекса:виджет_карта.jpg?200|}}
+В перечне ОМ, кроме названия и адреса ОМ, отображаются:
+а) индикатор состояния ОМ: цветовой код индикатора (аналогичный индикатор отображается на участке карты в месте размещения ОМ);
+б) кнопка «Центрировать на объекте»: кнопка используется для оперативной навигации по карте (поиск ОМ и расположение его по центру отображаемого участка карты), кнопка отображается при наведении курсора мыши на ОМ в перечне ОМ.
+Для настройки параметров виджета необходимо перейти на страницу «Параметры панели», открыть вкладку «Виджеты» и нажать на кнопку «Параметры» виджета «Карта».
+На странице настройки параметров виджета отображаются следующие параметры:
+а) «Координаты центра карты»: координаты центра карты в формате хх.хххххх северной широты, yy.yyyyyy восточной долготы, параметр – обязательный к заданию, значение – числовое значение координат в указанном формате, значение по умолчанию отсутствует, способ ввода – с клавиатуры или выбор на карте с помощью кнопки «Указать на карте»;
+б) «Масштаб по умолчанию»: масштаб отображения карты по умолчанию, параметр – обязательный к заданию, значение – целое десятичное число от 0 до 17 включительно, значение по умолчанию отсутствует, способ ввода – с клавиатуры или с помощью степпера (шаг = ±1);
+в) «Масштаб при центрировании на объекте»: масштаб отображения карты при нажатии кнопки «Центрировать на объекте» , параметр – обязательный к заданию, значение – целое десятичное число от 0 до 17 включительно, значение по умолчанию отсутствует, способ ввода – с клавиатуры или с помощью степпера (шаг = ±1);
+г) «Фиксированная высота карты»: высота карты в пикселях, параметр – необязательный к заданию (если не задан, то карта будет занимать всю доступную высоту), значение – целое десятичное число (начиная с 1), единица величины – пиксель, значение по умолчанию отсутствует, способ ввода – с клавиатуры или с помощью степпера (шаг = ±1).
+{{:документация:функции_комплекса:карта_параметры.jpg?200|}}
+Для сохранения заданных параметров нажать на кнопку «Сохранить».
 ** Внешний виджет (класс виджета – ExternalUrlWidget) **
@@ Строка 666: / Строка 689: @@
 {{:документация:функции_комплекса:виджет_3d-модель.jpg?200|}}
-Все подключенные к ОМ устройства и каналы отображаются на панели «Мнемосхема» в виде дерева. Изменение или добавление новых устройств/каналов производится в настройках панели (кнопка «Параметры модели»).
+Все подключенные к ОМ устройства и каналы отображаются на панели «Мнемосхема» в виде дерева. Изменение или добавление новых устройств/каналов производится в настройках панели (кнопка «Параметры панели»).
 При одиночном клике на устройство в модели название данного устройства в мнемосхеме выделяется жирным шрифтом.
@@ Строка 955: / Строка 978: @@
 {{:документация:функции_комплекса:виджет_верт_неск_устр_параметры.jpg?200|}}
+** Виджет «Азимут перемещения» (класс виджета – AzimuthWidget) **
+Виджет «Азимут перемещения» отображает график отклонения вертикальности ОМ с видом сверху.
+{{:документация:функции_комплекса:виджет_азимут.jpg?200|}}
+Виджет содержит следующие элементы графического пользовательского интерфейса:
+а) заголовок виджета (параметр «Заголовок виджета»);
+б) кнопка «Обновить график»: обновление графика для текущего времени;
+в) кнопка «Добавить»: добавление графика для конкретных даты и времени;
+г) поле выбора цвета графика: определение цвета линий для графиков;
+д) поле выбора даты и времени: определение даты и времени измеренных данных для отображения на графике;
+е) панель «График перемещения»: отображение графика перемещения (отклонения от вертикальности) с видом сверху.
+При наведении мышки на точку на графике отображаются:
+а) Высота – высота (глубина) установки измерительного устройства в метрах;
+б) Азимут – азимут отклонения выбранной точки от вертикальности в градусах;
+в) Отклонение – величина отклонения от вертикальности в миллиметрах.
+{{:документация:функции_комплекса:виджет_азимут_-_точки.jpg?200|}}
+При нажатии на кнопку «Параметры» в реестре виджетов ОМ Пользователь переходит на панель «Параметры виджета» (отображается пользовательский заголовок виджета), где есть возможность задать:
+а) "устройство, соответствующее оси Х": название устройства из всех имеющихся в СМИК, которое собирает данные по отклонению по оси Х. Ось Х соответствует направлению на Север;
+б) "устройство, соответствующее оси Y": название устройства из всех имеющихся в СМИК, которое собирает данные по отклонению по оси Y. Ось Y соответствует направлению на Восток;
+в) "фиксированный масштаб графика по оси значений": параметры «Минимальный предел» и «Максимальный предел» задаются при отключенном режиме автоматического масштабирования графика по оси значений (ординат), значения – десятичное число, значения по умолчанию отсутствуют, способ ввода – с клавиатуры. Значение минимального предела должно быть меньше значения максимального предела;
+г) "последние данные за период, часы": период отображения данных. Если за указанный период не найдено данных – виджет пустой. Единица измерения – час, значение вводится с клавиатуры или выбирается с помощью степпера, шаг = ±1;
+д) "подпись для направления Север/Юг/Запад/Восток": наименование осей, которые будут отображаться на графике направления и скорости ветра на панели Объекта, значения – текстовая строка, значения по умолчанию – С (для Севера), Ю (для Юга), З (для Запада), В (для Востока), способ ввода – с клавиатуры.
+{{:документация:функции_комплекса:виджета_азимут_-_параметры.jpg?200|}}
+** Виджет «Роза ветров» (класс виджета – WindRoseWidget) **
+Виджет «Роза ветров» отображает текущее направление и скорость ветра на ОМ. Масштаб графика – фиксированный: от 0 до 30 м/с. Промежуточные оси – 0/10/20/30 м/с.
+{{:документация:функции_комплекса:виджет_роза_ветров.jpg?200|}}
+Виджет содержит следующие элементы графического пользовательского интерфейса:
+а) заголовок виджета (параметр «Заголовок виджета»);
+б) кнопка «Обновить график»: обновление графика для текущего времени;
+в) панель «График направления и скорости ветра»: отображение графика направления и скорости ветра с видом сверху.
+При наведении мышки на точку на графике отображаются:
+а) Направление – направление ветра в градусах;
+б) Скорость – скорость ветра в метрах в секунду.
+{{:документация:функции_комплекса:виджет_роза_ветров_точки.jpg?200|}}
+При нажатии на кнопку «Параметры» в реестре виджетов ОМ Пользователь переходит на панель «Параметры виджета» (отображается пользовательский заголовок виджета), где есть возможность задать:
+а) «направление ветра – устройство»: название устройства из всех имеющихся в СМИК, которое измеряет направление ветра. Выбор производится из выпадающего списка;
+б) «направление ветра – канал»: название канала выбранного устройства. Выбор производится из выпадающего списка;
+в) «скорость ветра – устройство»: название устройства из всех имеющихся в СМИК, которое измеряет скорость ветра. Выбор производится из выпадающего списка;
+г) «направление ветра – канал»: название канала выбранного устройства. Выбор производится из выпадающего списка;
+д) «выводить массив данных на виджет, минут»: период отображения данных. Если за указанный период не найдено данных – виджет пустой. Единица измерения – минута, значение вводится с клавиатуры или выбирается с помощью степпера, шаг = ±1.
+{{:документация:функции_комплекса:виджет_роза_ветров_параметры.jpg?200|}}
+** Виджет «Схема расположения оборудования с зуммированием» (класс виджета – SchemeZoomWidget) **
+Виджет «Схема расположения оборудования с зуммированием» аналогично виджету «Схема расположения оборудования» отображает расположение устройств на схеме ОМ, а также позволяет выполнять зуммирование (приближение, отдаление) на схеме для более детального рассмотрения схемы.
+Зуммирование производится колёсиком мыши при нахождении курсора внутри пространства виджета.
+Внешний вид виджета, элементы графического пользовательского интерфейса, параметры и алгоритм создания и размещения на схеме точек полностью аналогичны виджету «Схема расположения оборудования».
+Для корректной работы виджета рекомендуется, чтобы файл не превышал 20 000 пикселей по ширине и 15 000 по высоте. Использование бо́льших по размеру изображений возможно, но определяется производительностью сервера.
 ** Панель «История измерений» **
@@ Строка 1208: / Строка 1321: @@
 а) журнал событий;
-б) журнал сейсмических событий.
+б) журнал сейсмических событий;
+в) журнал изменений.
 {{:документация:функции_комплекса:журналы.jpg?200|}}
@@ Строка 1318: / Строка 1433: @@
 {{:документация:функции_комплекса:канал_вероятность.jpg?200|}}
+** Журнал изменений **
+В журнале изменений регистрируются события, связанные с авторизацией в СМИК, выходе из пользовательского аккаунта СМИК, изменением/добавлением/удалением различных сущностей СМИК (панелей, объектов, устройств, каналов и пр.).
+Для входа в журнал изменений нажать на подпункт «Журнал изменений» пункта «Журналы» основного меню. Внешний вид панели «Журнал изменений»:
+{{:документация:функции_комплекса:журнал_изменений.jpg?200|}}
+Панель содержит следующие элементы графического пользовательского интерфейса:
+а) название панели;
+б) панель фильтра;
+в) журнал изменений;
+г) кнопки страниц журнала для навигации по страницам при большом объеме журнала изменений.
+Журнал изменений содержит столбцы:
+а) «Дата и время»: календарная дата и время действия;
+б) «Пользователь»: имя пользователя, который произвел действие, и e-mail;
+в) «Действие»: тип действия (авторизация, выход, изменение, добавление, удаление);
+г) «Раздел системы»: в каком разделе системы было произведено действие;
+д) «Сущность»: над каким конкретно элементом СМИК было произведено действие (объект, панель, виджет, устройство и пр.);
+е) Описание: краткое описание сути действия.
+Заголовок столбца является командной (нажимной) кнопкой, которая предоставляет пользователю возможность сортировки строк в журнале изменений (см. описание аналогичного элемента формы «Реестр»). По умолчанию (без применения сортировки) действие с наиболее поздним значением в столбце «Дата и время» занимает верхнюю строку журнала изменений.
+Панель фильтра журнала изменений позволяет задать условия выборки по следующим столбцам:
+а) «Пользователь»: имя пользователя, выбор из выпадающего списка, список формируется на основании всех пользователей СМИК;
+б) «Действие»: тип действия, выбор из выпадающего списка:
+– авторизация;
+– выход;
+– добавление;
+– изменение;
+– удаление.
+в) «Раздел системы»: наименование раздела СМИК, выбор из выпадающего списка:
+– пользователи;
+– управление объектом;
+– управление панелями;
+– общие параметры;
+– управление шинами;
+– управление тегами;
+– управление меню;
+– изменение панели;
+– устройства.
+г) «Сущность»: наименование конкретного элемента СМИК, фильтрация с помощью поля ввода.
+Дополнительно для задания условий выборки имеется возможность применить поля «Начало периода» и «Конец периода», определяющие границы интервала времени (выбор с помощью средства выбора календарной даты).
+Отмену условий выборки проводить:
+– для столбцов «Пользователь», «Действие», «Раздел системы» – выбором из выпадающего списка варианта «---»;
+– для столбца «Сущность» – удалением текстовой строки в поле ввода;
+– для полей «Начало периода», «Конец периода» – с помощью кнопки "Удалить".
 ==== Функция «Конфигурирование» ====
@@ Строка 1420: / Строка 1616: @@
 е) «Координаты размещения объекта»: географические координаты объекта мониторинга (широта, долгота), разделитель между координатами – символ «,» (0x2C), значения – диапазон широты от минус 90 ° до плюс 90 °, диапазон долготы от минус 180 °до плюс 180 °, максимальное количество знаков в дробной части величин – не более 14 (пример приведен в подписи к полю), единица величин – градус плоского угла (десятичная дробь), значения по умолчанию – широта = 0 °, долгота = 0 °, способ ввода – с клавиатуры;
-ж) «Часовой пояс»: номер часового пояса, используется при отображении поясного времени на сервере, значение – целое десятичное число (диапазон от 0 до 23 (включ.) (с запада на восток)), значение по умолчанию – из конфигурации при инсталляции Комплекса;
+ж) «Часовой пояс»: выбор часового пояса, значение – выбор из выпадающего списка, значение по умолчанию – из конфигурации при инсталляции Комплекса.
+При выборе часового пояса соответствующее время устанавливается:
+- в правом верхнем углу на любой панели Комплекса (время на сервере);
+– в журнале событий;
+– в журнале сейсмических событий;
+– в виджетах с графиками любого типа;
+– при экспорте данных.
+Если при создании ОМ параметр «часовой пояс» остается по умолчанию, то отображается время сервера, установленное при инсталляции Комплекса.
+Если отдельные панели/виджеты созданы без привязки к ОМ, на котором в параметрах задан часовой пояс, отличный от часового пояса по умолчанию, то на таких панелях/виджетах отображается время сервера, установленное при инсталляции Комплекса.
 з) «Дата подключения объекта»: календарная дата начала сбора данных с ОМ;
@@ Строка 1648: / Строка 1860: @@
 Для перехода к реестру конструктивных Элементов ОМ в реестре ОМ нажать на кнопку «Элементы» напротив требуемого ОМ.
-Реестр Элементов, кроме кнопок «Изменить» и «Удалить», содержит дополнительную кнопку для выполнения следующих операций:
+Реестр Элементов, кроме кнопок «Изменить» и «Удалить», содержит дополнительные кнопки:
-а) кнопка «+Добавить»: переход на вкладку «Создать Элемент» (создание нового элемента верхнего уровня).
+а) кнопка «+Добавить»: переход на вкладку «Создать Элемент» (создание нового элемента верхнего уровня);
+б) кнопки «Подвинуть выше», «Подвинуть ниже»: для элементов верхнего уровня – перемещение в иерархии совместно с подэлементами, для элементов нижних уровней – перемещение внутри иерархии элемента верхнего уровня.
 {{:документация:функции_комплекса:панель_элементы.jpg?200|}}
@@ Строка 1736: / Строка 1950: @@
 {{:документация:функции_комплекса:ручной_ввод_данных_5.jpg?200|}}
-После заполнения и сохранения файла выбрать его с помощью кнопки обзор и нажать «Сохранить».
+После заполнения и сохранения файла выбрать его с помощью кнопки "Обзор" и нажать «Сохранить».
 В открывшемся окне проверить корректность данных и нажать кнопку «Выполнить импорт данных».
@@ Строка 1756: / Строка 1970: @@
 {{:документация:функции_комплекса:задание_по_расписанию_-_чек-бокс_в_устройстве_.jpg?200|}}
-При установленной галочке в чек-боксе «Задание по расписанию» в настройках устройства, в настройках канала поле «Формула вычисления» меняется на поле «Формула вычисления значения по расписанию».
+При установленной галочке в чек-боксе «Задание по расписанию» в настройках устройства появляется дополнительный чек-бокс «Не синхронный источник данных». Этот параметр необходимо использовать для корректной обработки при синхронном или несинхронном поступлении данных с нескольких устройств ОМ.
+Также при установленной галочке в чек-боксе «Задание по расписанию» в настройках устройства в настройках канала поле «Формула вычисления» меняется на поле «Формула вычисления значения по расписанию».
 Примеры возможных формул для задания:
@@ Строка 1775: / Строка 1991: @@
 {{:документация:функции_комплекса:задание_по_расписанию_-_формула_в_канале_.jpg?200|}}
+** Ручной ввод GBI **
+Для определения вертикальных и горизонтальных смещений грунта используется скважинный инклинометр BIN-В3 (далее – GBI (Gorizont Borehole Inclinometer)) производства ООО «НТП «Горизонт-М» (см. руководство по эксплуатации МПГТ 401262.25.00.01 РЭ).
+Скважинный инклинометр не предназначен для удаленной передачи данных. Физическое устройство BIN-В3 производит измерения параметров непосредственно на ОМ, вносит значения измеряемых параметров в файл-шаблон, данные из которого заносятся в СМИК вручную с помощью загрузки этого файла.
+Файл содержит следующую информацию:
+а) «Площадка»: наименование ОМ, ячейка В1;
+б) «Скважина»: наименование скважины, в которой производятся измерения, ячейка В2;
+в) «Направление»: ориентация скважины (вертикальная или горизонтальная), ячейка В3;
+г) «Один проход»: признак одного прохода, ячейка В4;
+д) «Измерение»: номер измерения, ячейка В5 (соответствует названию вкладки в файле);
+е) «Создано»: дата создания файла, ячейка В6;
+ж) «Азимут сечения»: азимут сечения скважины в градусах, ячейка В7;
+з) «Завершено»: дата завершения измерений, ячейка В6;
+и) Таблица с параметрами (строка 9) и результатами измерений.
+{{:документация:функции_комплекса:gbi_файл-шаблон.jpg?200|}}
+Примечание: СМИК обрабатывает параметры, выделенные в файле-шаблоне зелёным цветом.
+Для работы со скважинным инклинометром в СМИК создаются виртуальные устройства, по одному устройству для каждого измеряемого параметра (см. файл-шаблон, строка 9, зеленые ячейки). Также в каждом устройстве создается столько измерительных каналов, сколько измерений производится физически на ОМ.
+Для корректной идентификации устройств и для правильной загрузки параметров из файла-шаблона, при создании каждого виртуального устройства в конце названия обязательно указывается признак «| Скважина …» в соответствии с названием из ячейки B2 в файле-шаблоне.
+{{:документация:функции_комплекса:gbi_название_устройства.jpg?200|}}
+Для загрузки файла в СМИК необходимо перейти в пункт меню «Ручной ввод GBI». Данный пункт меню не является пунктом по умолчанию, а подключается вручную при работе с устройствами типа GBI.
+{{:документация:функции_комплекса:gbi_меню_ручной_ввод.jpg?200|}}
+В открывшемся окне выбрать ОМ, в котором созданы необходимые устройства и каналы, выбрать файл с помощью кнопки «Обзор» и нажать «Загрузить».
+{{:документация:функции_комплекса:gbi_загрузка_файла.jpg?200|}}
+Если файл содержит несколько листов с измерениями, то откроется страница предварительного просмотра файла. После выбора листа файла для загрузки необходимо нажать кнопку «Продолжить». Впоследствии нужно поочерёдно загрузить все листы файла, данные запишутся в каналы с разным временем измерения.
+{{:документация:функции_комплекса:gbi_листы_файла.jpg?200|}}
+Если названия устройств не соответствуют измеряемым параметрам или если не указан признак скважины, то СМИК выдаст предупреждение с указанием количества столбцов, которые не удалость сопоставить. Для продолжения загрузки данных необходимо либо исправить ошибки в системе и повторить загрузку файла, либо сопоставить столбцы вручную. Для этого необходимо выбрать из выпадающего списка название устройства (строка «Устройство»), соответствующее параметру (строка «Уровень»).
+{{:документация:функции_комплекса:gbi_ошибка_при_загрузке.jpg?200|}}
+После сопоставления необходимо нажать кнопку «Выполнить импорт данных» внизу страницы.
+{{:документация:функции_комплекса:gbi_сопоставление_столбцов.jpg?200|}}
+Если ошибок больше не обнаружено, то СМИК проинформирует об успешном импорте данных.
+{{:документация:функции_комплекса:gbi_успешный_импорт.jpg?200|}}
+Для продолжения загрузки данных нажать на кнопку «Вернуться».
+После завершения процедуры импорта необходимо проконтролировать загруженные данные на панели ОМ и в истории измерений.
 ** Операции подпункта «Панели» **
@@ Строка 1944: / Строка 2224: @@
 д) кнопка «Параметры объекта»: для перехода на вкладку «Параметры» панели «Управление настройками объекта»;
-е) имя Пользователя СМИК (параметр «Имя пользователя»);
+е) кнопка «Информация об объекте»: для открытия окна с краткой информации об объекте: название, краткое описание, адрес, координаты размещения,  часовой пояс, дата подключения, балансодержатель/управляющая компания, оператор услуги передачи данных, информация по подключению к сети оператора;
-ж) текущее время сервера.
+{{:документация:функции_комплекса:кнопка_информация_об_объекте.jpg?200|}}
+ж) кнопка «Редактировать панель»: для изменения размера виджетов и их расположения на панели Объекта;
+з) имя Пользователя СМИК (параметр «Имя пользователя»);
+и) текущее время сервера.
 Кнопки, указанные выше, отображаются и, соответственно, доступны для операций только Пользователю с ролью «Администратор».
-{{:документация:функции_комплекса:на_панели_виджеты_размещаются.jpg?200|}}
+{{:документация:функции_комплекса:на_панели_объект_размещаются.jpg?200|}}
 Для добавления нового виджета нажать кнопку «Добавить виджет» и в открывшемся окне задать в соответствующих полях следующие параметры:
@@ Строка 1975: / Строка 2261: @@
 {{:документация:функции_комплекса:условное_разделение_панели_объект.jpg?200|}}
+Кнопка «Редактировать панель»
+Используется для быстрого изменения размеров и/или положения виджетов на панели Объекта.
+При нажатии на кнопку «Редактировать панель» появляется возможность:
+а) перемещать виджеты по панели Объекта. Для этого необходимо зажать левой кнопкой мыши верхнюю часть виджета, содержащую заголовок виджета, переместить виджет в нужную позицию на панели и отпустить левую кнопку мыши;
+б) изменять размеры виджетов. Для этого необходимо зажать левой кнопкой мыши кнопку «диагональная двойная стрелочка», изменить размеры и отпустить левую кнопку мыши. Кнопка изменения размеров виджета появляется в правом нижнем углу при наведении курсора на виджет.
+{{:документация:функции_комплекса:редактирование_панели.jpg?200|}}
+После выполнения всех действий нажать кнопку «Сохранить панель» для сохранения внесённых изменений либо кнопку «Отмена» для возврата к предыдущему варианту размещения виджетов (до внесения изменений).
 При выборе классов виджетов ExternalUrlWidget или TreeWidget на панели «Добавить виджет» отображается дополнительный параметр «Ссылка на данные», в поле которого указать ссылку с URL, по которому размещен внешний виджет (напр., https://ru-meteo.ru/informer/moscow-1-0.png).