Различия

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

--- документация:функции_комплекса [2025/04/27 16:33] – adm0001
+++ документация:функции_комплекса [2025/07/22 18:47] (текущий) – adm0001
@@ Строка 503: / Строка 503: @@
 ** Виджет «Диаграмма вертикальности» (класс виджета – VerticalWidget) **
-Виджет «Диаграмма вертикальности» отображает график вертикальности контролируемого конструктивного элемента ОМ (стенки, опоры и пр.) для выбранных дат и времени.
+Виджет «Диаграмма вертикальности» отображает график вертикальности и/или осадки контролируемого конструктивного элемента ОМ (стенки, опоры и пр.) для выбранных дат и времени.
 {{:документация:функции_комплекса:виджет_диаграмма_вертикальности.png?400|}}
@@ Строка 546: / Строка 546: @@
 и) кнопки изменения масштаба карты.
+Кнопки, указанные в б) и в), отображаются и, соответственно, доступны для операций только пользователю с ролью «Администратор».
 {{:документация:функции_комплекса:виджет_карта.jpg?200|}}
+В перечне ОМ, кроме названия и адреса ОМ, отображаются:
+а) индикатор состояния ОМ: цветовой код индикатора (аналогичный индикатор отображается на участке карты в месте размещения ОМ);
+б) кнопка «Центрировать на объекте»: кнопка используется для оперативной навигации по карте (поиск ОМ и расположение его по центру отображаемого участка карты), кнопка отображается при наведении курсора мыши на ОМ в перечне ОМ.
+Для настройки параметров виджета необходимо перейти на страницу «Параметры панели», открыть вкладку «Виджеты» и нажать на кнопку «Параметры» виджета «Карта».
+На странице настройки параметров виджета отображаются следующие параметры:
+а) «Координаты центра карты»: координаты центра карты в формате хх.хххххх северной широты, yy.yyyyyy восточной долготы, параметр – обязательный к заданию, значение – числовое значение координат в указанном формате, значение по умолчанию отсутствует, способ ввода – с клавиатуры или выбор на карте с помощью кнопки «Указать на карте»;
+б) «Масштаб по умолчанию»: масштаб отображения карты по умолчанию, параметр – обязательный к заданию, значение – целое десятичное число от 0 до 17 включительно, значение по умолчанию отсутствует, способ ввода – с клавиатуры или с помощью степпера (шаг = ±1);
+в) «Масштаб при центрировании на объекте»: масштаб отображения карты при нажатии кнопки «Центрировать на объекте» , параметр – обязательный к заданию, значение – целое десятичное число от 0 до 17 включительно, значение по умолчанию отсутствует, способ ввода – с клавиатуры или с помощью степпера (шаг = ±1);
+г) «Фиксированная высота карты»: высота карты в пикселях, параметр – необязательный к заданию (если не задан, то карта будет занимать всю доступную высоту), значение – целое десятичное число (начиная с 1), единица величины – пиксель, значение по умолчанию отсутствует, способ ввода – с клавиатуры или с помощью степпера (шаг = ±1).
+{{:документация:функции_комплекса:карта_параметры.jpg?200|}}
+Для сохранения заданных параметров нажать на кнопку «Сохранить».
 ** Внешний виджет (класс виджета – ExternalUrlWidget) **
@@ Строка 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|}}
 ** Панель «История измерений» **
@@ Строка 1420: / Строка 1521: @@
 е) «Координаты размещения объекта»: географические координаты объекта мониторинга (широта, долгота), разделитель между координатами – символ «,» (0x2C), значения – диапазон широты от минус 90 ° до плюс 90 °, диапазон долготы от минус 180 °до плюс 180 °, максимальное количество знаков в дробной части величин – не более 14 (пример приведен в подписи к полю), единица величин – градус плоского угла (десятичная дробь), значения по умолчанию – широта = 0 °, долгота = 0 °, способ ввода – с клавиатуры;
-ж) «Часовой пояс»: номер часового пояса, используется при отображении поясного времени на сервере, значение – целое десятичное число (диапазон от 0 до 23 (включ.) (с запада на восток)), значение по умолчанию – из конфигурации при инсталляции Комплекса;
+ж) «Часовой пояс»: выбор часового пояса, значение – выбор из выпадающего списка, значение по умолчанию – из конфигурации при инсталляции Комплекса.
+При выборе часового пояса соответствующее время устанавливается:
+- в правом верхнем углу на любой панели Комплекса (время на сервере);
+– в журнале событий;
+– в журнале сейсмических событий;
+– в виджетах с графиками любого типа;
+– при экспорте данных.
+Если при создании ОМ параметр «часовой пояс» остается по умолчанию, то отображается время сервера, установленное при инсталляции Комплекса.
+Если отдельные панели/виджеты созданы без привязки к ОМ, на котором в параметрах задан часовой пояс, отличный от часового пояса по умолчанию, то на таких панелях/виджетах отображается время сервера, установленное при инсталляции Комплекса.
 з) «Дата подключения объекта»: календарная дата начала сбора данных с ОМ;
@@ Строка 1648: / Строка 1765: @@
 Для перехода к реестру конструктивных Элементов ОМ в реестре ОМ нажать на кнопку «Элементы» напротив требуемого ОМ.
-Реестр Элементов, кроме кнопок «Изменить» и «Удалить», содержит дополнительную кнопку для выполнения следующих операций:
+Реестр Элементов, кроме кнопок «Изменить» и «Удалить», содержит дополнительные кнопки:
-а) кнопка «+Добавить»: переход на вкладку «Создать Элемент» (создание нового элемента верхнего уровня).
+а) кнопка «+Добавить»: переход на вкладку «Создать Элемент» (создание нового элемента верхнего уровня);
+б) кнопки «Подвинуть выше», «Подвинуть ниже»: для элементов верхнего уровня – перемещение в иерархии совместно с подэлементами, для элементов нижних уровней – перемещение внутри иерархии элемента верхнего уровня.
 {{:документация:функции_комплекса:панель_элементы.jpg?200|}}
@@ Строка 1736: / Строка 1855: @@
 {{:документация:функции_комплекса:ручной_ввод_данных_5.jpg?200|}}
-После заполнения и сохранения файла выбрать его с помощью кнопки обзор и нажать «Сохранить».
+После заполнения и сохранения файла выбрать его с помощью кнопки "Обзор" и нажать «Сохранить».
 В открывшемся окне проверить корректность данных и нажать кнопку «Выполнить импорт данных».
@@ Строка 1775: / Строка 1894: @@
 {{:документация:функции_комплекса:задание_по_расписанию_-_формула_в_канале_.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|}}
+Для продолжения загрузки данных нажать на кнопку «Вернуться».
+После завершения процедуры импорта необходимо проконтролировать загруженные данные на панели ОМ и в истории измерений.
 ** Операции подпункта «Панели» **
@@ Строка 1862: / Строка 2045: @@
 б) «Тип элемента»: выбор типа элемента мнемосхемы, параметр – обязательный к заданию, значение по умолчанию – «Папка», способ ввода – выбор из выпадающего списка. Далее для элемента типа «Папка» имеется возможность создать дочерний элемент (подпапку) на следующем уровне иерархии мнемосхемы, для элемента типа «Устройство» такая возможность отсутствует. При выборе типа «Устройство» отобразятся дополнительные параметры;
-в) «Название папки»: название элемента типа «Папка», параметр – обязательный к заданию для элемента типа «Папка», значение – символьная строка, способ ввода – с клавиатуры:
+в) «Название папки»: название элемента типа «Папка», параметр – обязательный к заданию для элемента типа «Папка», значение – символьная строка, способ ввода – с клавиатуры;
-г) «Элемент активен»: состояние режима отображения элемента в виджете «Мнемосхема» мнемосхеме, параметр – обязательный к заданию, значение – наличие / отсутствие индикатора в чек-боксе («включен» / «отключен»), значение по умолчанию – режим отображения включен (элемент активен). При отключенном состоянии режима отображения сам элемент и его дочерние элементы не отображаются в виджете «Мнемосхема».
+г) «Панель»: выбор панели ОМ, на которой будет отображаться мнемосхема, параметр – обязательный к заданию, значение по умолчанию – «не указана», способ ввода – выбор из выпадающего списка;
+д) «Элемент активен»: состояние режима отображения элемента в виджете «Мнемосхема» мнемосхеме, параметр – обязательный к заданию, значение – наличие / отсутствие индикатора в чек-боксе («включен» / «отключен»), значение по умолчанию – режим отображения включен (элемент активен). При отключенном состоянии режима отображения сам элемент и его дочерние элементы не отображаются в виджете «Мнемосхема».
 При выборе типа элемента «Устройство» на панели «Создать элемент мнемосхемы» отобразится дополнительный параметр «Устройство», который необходимо задать путем выбора из выпадающего списка устройств всех ОМ СМИК.
@@ Строка 1908: / Строка 2093: @@
 Для добавления новой точки нажать на кнопку «Добавить точку» и в открывшейся панели «Добавить точку» заполнить необходимые поля.
-{{:документация:функции_комплекса:реестр_точек.jpg?200|}}
+Виджеты размещаются на панелях «Объект» и «Карта».
 Для добавления виджетов на панель перейти на вкладку «Виджеты», нажав на заголовок вкладки. На вкладке «Виджеты» отображается реестр виджетов. В реестре виджетов Пользователь выполняет следующие операции:
@@ Строка 1955: / Строка 2140: @@
 б) «Класс виджета»: класс виджета, параметр – обязательный к заданию, значение по умолчанию – CustomGroupChartWidget, способ ввода – выбор из выпадающего списка.
+{{:документация:функции_комплекса:класс_виджета.jpg?200|}}
 в) «Виджет включен»: состояние виджета, параметр – обязательный к заданию, значение – наличие / отсутствие индикатора в чек-боксе («включен» / «отключен»), значение по умолчанию – виджет отключен (не отображается на панели), способ ввода – клик мышью в чек-боксе;
@@ Строка 1965: / Строка 2152: @@
 ж) «Вес колонки виджета»: относительный размер виджета в строке панели «Объект», если в строке размещается более одного виджета, параметр – необязательный к заданию, значение десятичное число (диапазон от 0 до 1 (включ.), разделитель дробной части – символ «.» (0x2E)), значение по умолчанию отсутствует, способ ввода – с клавиатуры.
+{{:документация:функции_комплекса:добавление_виджета.jpg?200|}}
 Панель «Объект» обеспечивает одновременное размещение нескольких виджетов, поэтому задавать параметры «Строка для отображения» и «Колонка для отображения» следует исходя из условного разделения панели «Объект».
@@ Строка 1978: / Строка 2167: @@
 При выборе классов виджетов SpectrWidget и SpectrogramWidget на панели «Добавить виджет» отображаются дополнительные параметры:
-  * Канал устройства, для выбора измерительного канала, значение по умолчанию – не выбрано, способ ввода – выбор из выпадающего списка;
+  * «Канал устройства»: для выбора измерительного канала, значение по умолчанию – не выбрано, способ ввода – выбор из выпадающего списка;
-  * Высота виджета, px: для задания высоты виджета в пикселях, значение по умолчанию – 0, способ ввода – ввод с клавиатуры или задание с помощью степпера, шаг = ±1 px;
+  * «Высота виджета, px»: для задания высоты виджета в пикселях, значение по умолчанию – 0, способ ввода – ввод с клавиатуры или задание с помощью степпера, шаг = ±1 px;
 При выборе классов виджетов ThermogramWidget и ThermometryWidget на панели «Добавить виджет» отображаются дополнительные параметры:
-  * Устройство, для выбора устройства, параметр – обязательный к заданию, значение по умолчанию – не выбрано, способ ввода – выбор из выпадающего списка;
+  * «Устройство»: для выбора устройства, параметр – обязательный к заданию, значение по умолчанию – не выбрано, способ ввода – выбор из выпадающего списка;
-  * Высота виджета, px: для задания высоты виджета в пикселях, значение по умолчанию – 0, способ ввода – ввод с клавиатуры или задание с помощью степпера, шаг = ±1 px;
+  * «Высота виджета, px»: для задания высоты виджета в пикселях, значение по умолчанию – 0, способ ввода – ввод с клавиатуры или задание с помощью степпера, шаг = ±1 px;
 При выборе класса виджета VerticalWidget на панели «Добавить виджет» отображаются дополнительные параметры:
-  * Диаграмма на виджете, для выбора типа диаграммы, значение по умолчанию – вертикальности и осадки, способ ввода – выбор из выпадающего списка;
+  * «Диаграмма на виджете»: для выбора типа диаграммы (только вертикальности / только осадки / вертикальности и осадки), значение по умолчанию – вертикальности и осадки, способ ввода – выбор из выпадающего списка;
-  * Устройство, для выбора устройства, параметр – обязательный к заданию, значение по умолчанию – не выбрано, способ ввода – выбор из выпадающего списка;
+  * «Устройство»: для выбора устройства, параметр – обязательный к заданию, значение по умолчанию – не выбрано, способ ввода – выбор из выпадающего списка;
-  * Высота виджета, px: для задания высоты виджета в пикселях, значение по умолчанию – 0, способ ввода – ввод с клавиатуры или задание с помощью степпера, шаг = ±1 px;
+  * «Высота виджета, px»: для задания высоты виджета в пикселях, значение по умолчанию – 0, способ ввода – ввод с клавиатуры или задание с помощью степпера, шаг = ±1 px;
 При выборе класса виджета MapWidget Комплекс cформирует панель «Карта», на которой и размещается добавленный виджет.
-На панели «Карта» размещаются:
-а) пользовательское название панели (параметр «Название панели»);
-б) кнопка «Параметры панели»: для перехода на вкладку «Параметры» панели «Управление панелями»;
-в) кнопка «Виджеты панели»: для перехода на вкладку «Виджеты» панели «Управление панелями»;
-г) имя Пользователя СМИК (параметр «Имя пользователя»);
-д) текущее время сервера;
-е) перечень ОМ, размещенных на карте;
-ж) участок карты;
-з) ОМ, привязанные к участку карты согласно географическим координатам (параметр «Координаты размещения объекта»);
-и) кнопки изменения масштаба карты.
-Кнопки, указанные выше, отображаются и, соответственно, доступны для операций только пользователю с ролью «Администратор».
-В перечне ОМ, кроме названия и адреса ОМ, отображаются:
-а) индикатор состояния ОМ: цветовой код индикатора (аналогичный индикатор отображается на участке карты в месте размещения ОМ);
-б) кнопка «Центрировать на объекте»: кнопка используется для оперативной навигации по карте (поиск ОМ и расположение его по центру отображаемого участка карты), кнопка отображается при наведении курсора мыши на ОМ в перечне ОМ.
-{{:документация:функции_комплекса:в_перечне_ом_отображаются.jpg?200|}}
 === Конфигурирование Комплекса ===