docs.kb-agava.ru - Вклад участника [ru]

Узлы проекта AgavaSCADA/AgavaPLC

2025-10-30T11:57:56Z

SharipovRR:

== Узлы проекта ==
Узел - элементарная сущность проекта, осуществляющая хранение информации или реализующая определенный функционал. Каждый узел обладает набором [[Свойства узлов в AgavaSCADA/AgavaPLC|свойств]]. Все узлы, объединенные в иерархическую структуру, образуют проект.

== Проект ==
[[Файл:AgavaPLC–Дерево проекта.png|мини|Рисунок 21 – Дерево проекта]]
Узел "Проект" ("Корневой узел", "Корень") предназначен для хранения общей информации о проекте и связывания других узлов проекта.

== Станция ==
Станция – важнейший узел, управляющий работой собственных систем и выполняющий обмен данными с другими станциями. Физически станция представляет собой устройство, на котором исполняется проект (компьютер, панель оператора, МПР-60 или другое устройство).

Для использования в проекте доступны несколько типов станций. например:

* '''Станция''' - общий тип станции. Проекты с такой станцией могут выполняться на большинстве устройств - контроллеры, панели, персональные компьютеры. Чаще всего используется для проектов, предназначенных для выполнения на персональном компьютере.
* '''Панель ПО-40''' - специализированный тип для проектов на панелях оператора ПО-40. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.
* '''Панель ПО-50''' - специализированный тип для проектов на панелях оператора ПО-50. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.).
* '''Контроллер МПР-60''' - специализированный тип для проектов на программируемых реле МПР-60. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием устройства (светодиоды индикации и др.), использования корзины субмодулей.
* '''Контроллер ПЛК-70.A''' - специализированный тип для проектов, предназначенных для контроллеров АГАВА ПЛК-70.А. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием контроллера (светодиоды индикации и др.), использования корзины субмодулей.

При построении больших проектов станций в проекте может быть несколько, и они могут выполнять разные задачи. Например, станция-сервер выполняет сбор и регистрацию данных, клиентские станции выполняют визуализацию данных на рабочих местах и т. д.

Станции подчиняются узлы типа "Система" - Транспортная система, Система архивирования, Система визуализации и т. д.

== Транспортная система ==
Транспортная система управляет передачей данных по различным каналам связи. Система управляет работой "Транспортов" - узлов, выполняющих обмен данными с устройствами по определенному протоколу.

С одной стороны, транспортная система обращается непосредственно к сигналам и каналам устройства, а с другой стороны, представляет их в виде неких универсальных единиц – узлов-источников. Каждый источник однозначно соответствует определенному сигналу или параметру устройства. При изменении сигнала меняется и значение источника. При записи данных в источник производится подача команды устройству на установку определенного значения конкретного параметра.

Транспортная система допускает использование нескольких транспортов, что дает возможность одновременного обмена данными с большим количеством устройств по разным протоколам.

=== Транспорт ===
Транспорт предназначен для обмена данными с устройствами по определенному протоколу. Один транспорт, в зависимости от типа, позволяет обмениваться данными с одним или несколькими устройствами.

Доступны для использования следующие виды транспортов:

* Транспорт Modbus-TCP;
* Транспорт Modbus-RTU;
* Транспорт SNMP;
* Транспорт OPC UA;
* Транспорт OPC DA (только для Windows);
* Транспорт MQTT;
* Последовательный транспорт (устаревший);
* TCP/IP транспорт (устаревший).
Подробное описание транспортов приведено в отдельном документе "[[Транспорты AgavaSCADA/AgavaPLC]]".

==Система визуализации==
{{Внимание|Тип=Восклицание желтый.png|Текст=Система визуализации недоступна в проектах для контроллеров МПР}}

Задачей этой системы является отображение данных в виде набора мнемонических схем (экранов, мнемосхем), а также предоставление пользователю возможности управления.

Каждый экран позволяет в схематичном, понятном пользователю виде представить участок технологической схемы с отображением необходимых параметров технологического процесса.

Изображение на экране строится с помощью окон, на которых размещаются объекты визуализации – виджеты. Виджетами могут быть текстовые метки, изображения, в том числе анимированные, элементы управления, графики и т. д. Виджеты можно объединять в слои для удобного управления отображением виджетов.

Виджеты могут быть статическими и динамическими. Динамические виджеты привязаны к одному или нескольким сигналам и их отображение зависит от значений этих сигналов. Статические виджеты не имеют привязки к сигналам и их изображение всегда постоянно.

Для перехода по экранам, изменения значений параметров и иного управления служат специальные виджеты: кнопки управления, поля ввода и другие.

Для повышения быстродействия и увеличения комфортности работы с системой система визуализации хранит в памяти кэш из нескольких последних открытых экранов. Когда при последовательном открытии экранов этот кэш заполняется, наиболее старые экраны удаляются из него. Это связано с тем, что, как правило, в работе используются несколько одних и тех же экранов, которые отображают сводную информацию о техпроцессе и оператор в штатном режиме переключается только между ними. Сохраняя их в памяти, система ускоряет переключение между ними, поскольку при этом не требуется каждый раз создавать экран, все находящиеся на нем объекты и запускать процессы обновления параметров.

Когда экран переходит в кэш, обновление параметров на нем прекращается для снижения нагрузки на центральный процессор. Если все же необходимо, чтобы экран всегда производил обновление данных (по разным причинам), даже находясь в кэше, необходимо в его настройках включить опцию «Постоянно обновляемый».

Подчиненные типы узлов:

*фрейм;
*окно;
*композиция.

===Фрейм===
[[Файл:AgavaPLC–Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией.png|мини|Рисунок 23 – Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией]]
Фрейм – узел, предназначенный для группировки окон, отображаемых на определенном дисплее. Обеспечивает организацию окон в пространстве экрана, управление мониторами и границами отображения.

Если необходимо отобразить информацию на нескольких дисплеях одновременно, то для каждого из них нужно использовать отдельный фрейм. Окон во фрейме может быть несколько, однако они не могут накладываться друг на друга.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
|-
|Позиция X
|XCoord
|int
|Координата X левого верхнего угла фрейма
|Целое число
|-
|Позиция Y
|YCoord
|int
|Координата Y левого верхнего угла фрейма
|Целое число
|-
|Ширина
|XSize
|int
|Ширина фрейма в пикселях
|Целое число > 0
|-
|Высота
|YSize
|int
|Высота фрейма в пикселях
|Целое число > 0
|-
|Окна
|Windows
|NodesArray
|Список окон, принадлежащих фрейму
|Узлы типа: Window
|-
|Номер монитора
|DisplayNo
|int
|Номер монитора для отображения фрейма
|0 - по умолчанию
≥1 - конкретные мониторы
|-
|Тип границы
|BorderType
|enum
|Тип границы фрейма
|0: Не определен (ошибка)
1: Отсутствует

2: Фиксированная
|}

==== Позиция и размеры (XCoord, YCoord, XSize, YSize) ====

* '''Тип:''' int.
* '''Описание:''' Определяют положение и размеры фрейма на экране.
* '''Значения по умолчанию:''' (0, 0, 640, 480).
* '''Применение:''' Задание области экрана, которую занимает фрейм.

==== Окна (Windows) ====
'''Тип:''' NodesArray.

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

'''Особенности:'''

* Поддерживаются только узлы типа Window.

==== Номер монитора (DisplayNo) ====
'''Тип:''' int.

'''Описание:''' Определяет, на каком мониторе системы отображается фрейм. Значение 0 соответствует монитору по умолчанию.

'''Использование:'''

* 0 - основной монитор.
* 1, 2, ... - дополнительные мониторы.
* Свойство важно для многомониторных конфигураций.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип обрамления фрейма. Влияет на внешний вид и поведение границ.

'''Значения:'''

* '''Отсутствует''' - фрейм без видимых границ.
* '''Фиксированная''' - стандартная граница окна.
* '''Не определен''' - используется только для обработки ошибок.

==== Наследование привилегий ====
Фрейм автоматически добавляет доступные привилегии для работы с окнами:

* <code>OpenWindow</code> - привилегия на открытие окон.
* <code>CloseWindow</code> - привилегия на закрытие окон.

===Окна===
Окно – узел, осуществляющий отображение видеокадра (мнемонической схемы).

Существуют несколько видов окон:

1. «Форма», предназначенная для вывода простого набора данных без необходимости управления видимостью или внешним видом его элементов. Для вывода информации в такое окно кроме создания окна и добавления к нему виджетов ничего более не требуется.
[[Файл:AgavaPLC-Меню.png|мини|164x164пкс|Рисунок 24 — Внешний вид меню в среде исполнения]]
2. «Окно с композицией», предназначенное для вывода большого количества информации и позволяющее организовать группировку элементов по слоям, управлять внешним видом элементов, видимостью слоев и отдельных элементов, а также дающее возможность регулирования работы пользователя с элементами. Для вывода информации в такое окно нужно к окну привязать композицию, содержащую минимум один слой, в который уже добавляются виджеты.

=== Форма ===
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Модальность
|Modality
|enum
|Режим модальности окна
|0: Не определен (ошибка)
1: Немодальное

2: Модальное (Фрейм)

3: Модальное (Система)
|Чтение/Запись
|-
|Тип границы
|BorderType
|enum
|Тип границы окна
|0: Не определен (ошибка)
1: Фиксированная

2: Изменяемая

3: Отсутствует
|Чтение/Запись
|-
|Отображать строку заголовка
|TitleEnabled
|bool
|Отображать строку заголовка
|true/false
|Чтение/Запись
|-
|Отображать кнопку "Закрыть"
|CloseEnabled
|bool
|Отображать кнопку "Закрыть"
|true/false
|Чтение/Запись
|-
|Цвет фона
|BackgroundColor
|NColor
|Цвет фона окна
|Цвет в формате RGBA
|Чтение/Запись
|-
|Затемнение
|NeedDarkenApplication
|bool
|Затемнение других окон приложения при открытии этого окна
|true/false
|Чтение/Запись
|-
|Цвет затемнения
|ColorDarkenApplication
|NColor
|Цвет затемнения
|Цвет в формате RGBA
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов, мс
|0 - без задержки
>0 - интервал в мс
|Чтение/Запись
|-
|Действия OnShow
|ActionsOnShow
|NodesContainer
|Действия при показе окна
|Узлы типа: Action
|Чтение/Запись
|-
|Действия OnClose
|ActionsOnClose
|NodesContainer
|Действия при закрытии окна
|Узлы типа: Action
|Чтение/Запись
|}

==== Модальность (Modality) ====
'''Тип:''' enum.

'''Описание:''' Определяет поведение окна относительно других окон приложения.

'''Значения:'''

* '''Немодальное''' - позволяет взаимодействовать с другими окнами.
* '''Модальное (Фрейм)''' - блокирует взаимодействие с окнами в том же фрейме.
* '''Модальное (Система)''' - блокирует все окна приложения.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип и поведение границ окна.

'''Значения:'''

* '''Фиксированная''' - окно нельзя изменять размер.
* '''Изменяемая''' - пользователь может изменять размер окна.
* '''Отсутствует''' - окно без видимых границ.

==== Управление заголовком (TitleEnabled, CloseEnabled) ====
'''Тип:''' bool.

'''Описание:''' Контролируют отображение элементов заголовка окна.

==== Фон и затемнение (BackgroundColor, NeedDarkenApplication, ColorDarkenApplication) ====
'''Тип:''' NColor, bool, NColor.

'''Описание:''' Управляют визуальным оформлением окна и его влиянием на другие окна.

'''Особенности:'''

* Затемнение применяется только при NeedDarkenApplication = true.
* Цвет затемнения по умолчанию: черный с прозрачностью 50%.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Определяет частоту обновления виджетов в окне.

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчики событий (ActionsOnShow, ActionsOnClose) ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых при показе и закрытии окна.

=== Окно с композицией ===
Данный узел имеет те же свойства, что и форма, а также собственные:
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Композиция
|CompositionId
|NodeLink
|Основная композиция окна
|Узлы типа: CompositionLayered, CompositionTemplated
|Чтение/Запись
|-
|Описание текущей композиции
|CurrentCompositionDesc
|string
|Описание текущей загруженной композиции
|Автоматически формируется
|Только чтение
|}

==== Композиция (CompositionId) ====
'''Тип:''' NodeLink.

'''Описание:''' Ссылка на композицию, отображаемую в окне.

'''Поддерживаемые типы:''' CompositionLayered, CompositionTemplated.

==== Описание текущей композиции (CurrentCompositionDesc) ====
'''Тип:''' string.

'''Описание:''' Автоматически обновляемое описание загруженной композиции.

'''Особенности:''' Свойство только для чтения, обновляется системой автоматически.[[Файл:AgavaPLC-Настройка меню в среде разработки.png|мини|226x226пкс|Рисунок 25 — Настройка меню в среде разработки]]

===Композиция===
Композиция – узел, представляющий составленную при разработке проекта мнемоническую схему в виде набора элементов визуализации (виджетов), сгруппированных в один или несколько слоев.

Композиция дает возможность организовать виджеты в слои, видимостью которых можно управлять во время работы проекта.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Размеры
|Size
|NSize
|Размеры композиции
|Структура {ширина, высота}
|Чтение/Запись
|-
|Кэширование
|Cacheable
|bool
|Кэширование данных композиции для быстрого повторного открытия
|true/false
|Чтение/Запись
|-
|Источник интервала обновления
|UpdateIntervalSource
|enum
|Определяет источник интервала обновления виджетов
|0: Окно
1: Композиция
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов в миллисекундах
|Целое число ≥ 0
|Чтение/Запись
|-
|Действия OnLoad
|ActionsOnLoad
|NodesContainer
|Действия при загрузке композиции
|Узлы типа: Action
|Чтение/Запись
|}

==== Размеры (Size) ====
'''Тип:''' NSize (ширина, высота).

'''Описание:''' Определяет размеры композиции в пикселях. По умолчанию установлены значения 800x600.

==== Кэширование (Cacheable) ====
'''Тип:''' bool.

'''Описание:''' Включает или отключает кэширование данных композиции. При включенном кэшировании композиция сохраняется в памяти для быстрого повторного открытия.

'''Преимущества кэширования:'''

* Быстрое переключение между композициями.
* Снижение нагрузки на систему при частом использовании.
* Сохранение состояния элементов.

'''Рекомендации:''' Включать для часто используемых композиций, отключать для редко используемых или ресурсоемких.

==== Источник интервала обновления (UpdateIntervalSource) ====
'''Тип:''' enum.

'''Описание:''' Определяет, откуда виджеты композиции получают интервал обновления.

'''Значения:'''

* '''Окно''' - интервал обновления наследуется от родительского окна.
* '''Композиция''' - используется собственный интервал обновления композиции.

'''Применение:''' Централизованное управление производительностью через окно или индивидуальная настройка для каждой композиции.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Задает интервал обновления виджетов в миллисекундах. При значении 0 отрисовка виджетов выполняется без задержки (максимальная частота).

'''Особенности:'''

* 0 - обновление без задержек (может создать высокую нагрузку).
* > 0 - обновление с заданным интервалом. Учитывается только при UpdateIntervalSource = "Композиция"

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчик событий ActionsOnLoad ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых после загрузки композиции <code>AS 1.6.27+</code>.

===Слой===
Слой – набор виджетов, объединенных каким-то общим структурным признаком. В многослойных композициях слой обеспечивает организацию виджетов в z-порядке, управление видимостью и взаимодействием с пользователем. С помошью свойства "Видимость" слоя можно управлять видимостью виджетов, размещенных на слое.

Свойства
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Z-Порядок
|ZOrder
|int
|Порядок слоя в композиции
|Целое число (чем выше значение, тем выше слой)
|Чтение/Запись
|-
|Прозрачность для действий
|ActionTransparency
|enum
|Определяет поведение слоя при взаимодействии с пользователем
|0: Не определен (ошибка)
1: Непрозрачный

2: Прозрачный
|Чтение/Запись
|-
|Видимость
|Visible
|bool
|Видимость слоя и всех его виджетов
|true/false
|Чтение/Запись
|}

==== Z-Порядок (ZOrder) ====
'''Тип:''' int

'''Описание:''' Определяет порядок отображения слоя относительно других слоев в композиции. Слои с большим значением ZOrder отображаются поверх слоев с меньшим значением.

'''Пример использования:'''

* Фоновый слой: ZOrder = 1.
* Основной контент: ZOrder = 2.
* Контекстные виджеты: ZOrder = 3.

==== Прозрачность для действий (ActionTransparency) ====
'''Тип:''' enum

'''Описание:''' Управляет взаимодействием слоя с пользовательскими действиями (клики, наведения и т.д.)

'''Значения:'''

* '''Непрозрачный''' - слой полностью перехватывает пользовательские действия, элементы под ним недоступны, даже если они видимы.
* '''Прозрачный''' - пользовательские действия проходят сквозь слой к элементам ниже.

Обратите внимание: если на слое размещается изображение с прозрачной областью, то такие виджеты не позволяют пользователю взаимодействовать с видимыми и размещенными под ним виджетами.

==== Видимость (Visible) ====
'''Тип:''' bool

'''Описание:''' Определяет видимость всего слоя и всех его дочерних виджетов. При значении false слой и все его содержимое становится невидимым.

'''Применение:''' Временное скрытие виджетов или переключение их видимости.

===Виджет===
Виджет – элемент визуализации, предназначенный для отображения информации в заданном виде.

===Меню===
Меню – элемент визуализации, сочетающий в себе несколько виджетов «Кнопка». Используется для более удобного управления проектом (см. Рисунок 24).

Для добавления меню, необходимо в среде разработки назначить [[Универсальная среда разработки#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.9E.D1.82.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5 .D0.BC.D0.B5.D0.BD.D1.8E.C2.BB|действие «Отображение меню»]] для кнопки (или любого другого виджета). После добавления действия необходимо выделить его и нажать на кнопку настроек на панели вверху окна действий. Открывшееся окно (см. Рисунок 25) содержит дерево со структурой меню, в который можно добавлять элементы двух типов:

*меню – элемент, который позволяет группировать элементы меню, выводя их в виде раскрывающегося списка. На рисунках 24 и 25 этим элементом являются кнопки «Арочник» и «БПО».
*элемент меню – элемент, который предоставляет функционал, аналогичный [[Универсальная среда разработки#.D0.92.D0.B8.D0.B4.D0.B6.D0.B5.D1.82 .C2.AB.D0.9A.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0.C2.BB|виджету «Кнопка»]]. Для добавления действия, выполняющегося при нажатии на элемент меню в среде исполнения, необходимо нажать на него ПКМ в дереве структуры меню и выбрать "Создать действие". На рисунках 24 и 25 этим элементом являются кнопки «Котельная», «Котёл №1», «Котёл №2» и «Котёл №3».

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

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

# Добавить дополнительные фреймы, чтобы их количество в проекте соответствовало количеству дисплеев. Каждому фрейму назначить порядковый номер, начиная с 1. Фреймы связываются с дисплеями по номеру.
# Добавить дополнительное окно (или окна, если в исходном фрейме их несколько или дополнительных фреймов больше одного).
# Добавить в дополнительные фреймы созданные на этапе 2 окна, чтобы повторить структуру основоного фрейма.

Базовая настройка на этом закончена. После запуска такого проекта на двух или более дисплеях должны отображаться созданные окна.

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

===Виджеты===
====Виджет «Текстовая метка»====
[[Файл:AgavaPLC–Примеры оформления виджетов типа "Текстовая метка".png|мини|Рисунок 26 – Примеры оформления виджетов типа "Текстовая метка"]]
Виджет «Текстовая метка» – наиболее часто применяемый виджет, с помощью которого можно реализовать разные способы отображения текстовой информации.

Виджет «Текстовая метка» может использоваться для отображения статичного текста, значений параметров (одного или нескольких) и их комбинаций.

При необходимости отображения значений параметров они указываются в свойстве «Источник». Для задания определенного формата отображения используются спецификаторы формата в стиле языка «Си»:

*%f – значение в виде числа с плавающей точкой;
* %s – строка;
*%i – целое число со знаком;
*%u – целое число без знака;
* %d – целое число со знаком в десятичной системе исчисления.

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

Для отображения знака «%» необходимо указать его дважды: «%%».

===== Отображение нескольких значений =====
Одна текстовая метка может использоваться для отображения нескольких значений. Для этого все значения, которые нужно отобразить, указываются в свойстве «Источник», а в свойстве «Текст» указываются последовательно несколько спецификаторов формата соответственно порядку перечисления значений в свойстве «Источник».

Пример: текстовая метка, отображающая текущую позицию в очереди:

* Текст: <code>Позиция %i из %i</code>
* Источник: два узла из проекта.

=====Модификаторы спецификаторов формата=====

======Модификатор минимальной ширины поля======
Целое число, расположенное между знаком % и кодом формата, играет роль модификатора минимальной ширины поля. Если указан модификатор минимальной ширины поля, то, чтобы ширина поля вывода была не меньше указанной минимальной величины, вывод при необходимости будет дополнен пробелами. Если же выводятся строки или числа, которые длиннее указанного минимума, то они все равно будут отображаться полностью. По умолчанию для дополнения используются пробелы. А если для этого надо использовать нули, то перед модификатором ширины поля следует поместить 0. Например, %05i означает, что любое число, количество цифр которого меньше пяти, будет дополнено таким количеством нулей, чтобы состоять из пяти цифр.

Примеры
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%i
|10
|-
|10.123
|%d
|10
|-
|10.123
|%05i
|00010
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
| 10.1
|-
|10.123
|%10f
|<пробел>10.123000
|-
|10.123
|%012f
|00010.123000
|}

======Модификатор точности======
Модификатор точности следует за модификатором минимальной ширины поля (если таковой имеется). Он состоит из точки и расположенного за ней целого числа. Значение этого модификатора зависит от типа данных, к которым его применяют.

Когда модификатор точности применяется к данным с плавающей точкой, для преобразования которых используются спецификаторы преобразования %f, %e или %E, то он определяет количество выводимых десятичных разрядов. Например, %10.4f означает, что ширина поля вывода будет не менее 10 символов, причем для десятичных разрядов будет отведено четыре позиции.

Если модификатор точности применяется к %g или %G, то он определяет количество значащих цифр.

Примененный к строкам, модификатор точности определяет максимальную длину поля. Например, %5.7s означает, что длина выводимой строки будет составлять минимум пять и максимум семь символов. Если строка окажется длиннее, чем максимальная длина поля, то конечные символы выводиться не будут.

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

Примеры:
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
|10.1
|-
|10.123
|%10.4f
|<пробел><пробел><пробел>10.1230
|-
|10.123
|%010.3f
|000010.123
|-
| Это простая проверка
|%10.15s
|Это простая про
|}

====Виджет «Условная метка» ====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условная метка".png|мини|Рисунок 27 – Список сопоставлений виджета "Условная метка"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условная_метка%22.png]]
Виджет «Условная метка» позволяет изменять выводимую строку в соответствии с изменениями привязанной к ней переменной.

Задать соответствие текста необходимому условию можно в свойстве «Список сопоставлений».

==== Виджет «Изображение»====
Виджет «Изображение» предназначен для отображения на окнах статичных изображений форматов png, gif, jpg, bmp или анимированных изображений в формате gif. Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Условное изображение»====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условное изображение".png|мини|Рисунок 28 – Список сопоставлений виджета "Условное изображение"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условное_изображение%22.png]]
Виджет «Условное изображение» позволяет изменять отображаемое изображение в соответствии с изменениями привязанной к нему переменной.

Задать соответствие изображения необходимому условию можно в свойстве «Список сопоставлений».

====Виджет «Движущееся изображение»====
Виджет предназначен для отображения на окнах изображений, перемещающихся в пределах области виджета. В основном используются на экране спящего режима.

Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Кнопка»====
Виджет «Кнопка» предназначен для реализации функций управления:

*ввод данных;
*передача управляющих воздействий;
* смена режима работы АРМ или иного устройства, исполняющего проект.

Выполнение всех функций виджета обеспечивается с помощью узлов типа «Действие», добавляемых в соответствующее свойство (см. раздел [[#Действия]]).

====Виджет «Гистограмма»====
[[Файл:AgavaPLC–Виджет "Гистограмма".png|мини|Рисунок 29 – Виджет "Гистограмма"|ссылка=Файл:AgavaPLC–Виджет_%22Гистограмма%22.png]]
Виджет предназначен для отображения значений сигналов в виде столбчатой диаграммы.

Виджету необходимо задать источник (регистр/сигнал, с которого он будет получать данные), а также минимальное и максимальное значения.

====Виджет «Исторический график»====
Виджет «Исторический график» предназначен для отображения графиков параметров на двухкоординатной области изображения с привязкой к осям времени и значений.

Виджет может работать с данными, архивируемыми в БД, и напрямую с сигналами, значения которых вычисляются в ходе работы.

При работе с архивируемыми данными интервал обновления графика зависит от режима выдачи значения у базы данных: при выборе сохраняемых в БД он будет соответствовать интервалу архивирования, а при сохраненных в БД - интервалу сохранения БД на диск. Независимо от режима выдачи, график не может обновляться меньше чем за 300 мс.

При работе напрямую с сигналами график обновляется при изменении значения сигнала, но также не чаще чем раз в 300 мс.
[[Файл:AgavaPLC–Экран «Архив» с виджетом «Исторический график».png|мини|Рисунок 30 – Виджет «Исторический график». Области кнопок-пиктограмм. В нижней части отображена легенда]]
Виджет «Исторический график» состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода данных.

На виджете имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 28):

#область пиктограмм графика;
#область пиктограмм оси времени (X);
#область пиктограмм оси значений (Y);
#область легенды.

В области пиктограмм графика слева направо расположены следующие кнопки-пиктограммы:

* кнопка переключения режима отображения точек на всех кривых;
* кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси времени (X) слева направо расположены следующие кнопки-пиктограммы:

*кнопка открытия окна выбора интервала времени для оси Х, текст кнопки отображает текущий выбранный интервал, например: 5М – 5 минут, 6Ч – 6 часов, 30М – 30 минут;
*кнопка-индикатор включения следящего режима.

В области пиктограмм оси значений (Y) расположена кнопка-пиктограмма «A» – кнопка переключения режима автоматического масштабирования значений.

=====Легенда=====
[[Файл:AgavaPLC–Легенда с четырьмя выключенными параметрами.png|мини|Рисунок 31 – Легенда с четырьмя выключенными параметрами]]
Легенда – специальная область в нижней части экрана архива, предназначенная для отображения параметров (наименование, текущее значение и т. д.) выводимых графиков в виде таблицы. Для ознакомления с примерным видом легенды см. Рисунок 31. Информация о каждом сигнале в легенде выводится в несколько колонок:

*«Цвет» – индицирует цвет, которым выводится соответствующая кривая на графике, колонка «Цвет» позволяет нажатием переключать видимость соответствующей кривой на графике (см. Рисунок 29). Также в колонке "Цвет" отображается номер пера, которым выводится кривая параметра на графике;
* «Имя» («Наименование») – содержит наименование параметра;
*«Время» – содержит время последнего зарегистрированного значения параметра;
*«Значение» – содержит последнее зарегистрированное значение параметра.

=====Режимы просмотра графиков=====
Пользователю доступно два режима просмотра графиков:

*следящий режим;
*режим просмотра истории.

В следящем режиме на графике всегда отображаются актуальные значения параметров, тренд периодически дочитывает поступившие данные из базы и обновляет графики.

В режиме просмотра истории на графике отображаются исторические значения параметров. Просмотр истории технологического процесса осуществляется с помощью кнопок перемещения по осям и кнопок изменения масштаба.

Режим просмотра истории включается автоматически при прокрутке графика назад по времени.

=====Визирная линия=====
[[Файл:AgavaPLC–График в режиме просмотра истории с установленной визирной линией.png|мини|Рисунок 32 – График в режиме просмотра истории с установленной визирной линией]]
Для просмотра значений параметров в нужный момент времени служит визирная линия, отображаемая на графике как вертикальная линия.

При щелчке левой кнопкой мыши (ЛКМ) в области графиков визирная линия будет отображена в выбранном месте графика.

В точке пересечения визирной линии и кривых параметров отображаются значения этих параметров. Также в нижней части области графиков, возле оси времени, визирная линия отображает время.

====Виджет «График кусочно-линейной функции»====
Виджет предназначен для отображения графика зависимости двух параметров, расположенном на осях X и Y.
[[Файл:AgavaPLC–Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм..png|мини|Рисунок 33 – Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм.]]
Виджет состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода графика.

На области вывода графика виджета имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 33):

#Область пиктограмм графика.
#Область пиктограмм оси первого параметра (X).
#Область пиктограмм оси второго параметра (Y).

В области пиктограмм графика расположены следующие кнопки-пиктограммы:

*кнопка переключения режима отображения точек на всех кривых;
*кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси первого (X) и второго (Y) параметров расположены кнопки-пиктограммы «А» – кнопка переключения режима автоматического масштабирования значений.[[Файл:AgavaPLC–Виджет "Список событий".png|мини|Рисунок 34 – Виджет "Список событий"|ссылка=Файл:AgavaPLC–Виджет_%22Список_событий%22.png]]
====Виджет «Список событий»====
[[Файл:AgavaPLC–Окно выбора интервала.png|мини|Рисунок 35 – Окно выбора интервала]]Виджет предназначен для отображения регистрируемых событий в работе.

В верхней части виджета расположена панель управления (1).

Панель управления содержит органы управления журналом:

*кнопка отображения фильтра событий;
*кнопка включения следящего режима журнала;
*кнопка изменения интервала на один день назад;
*кнопка-индикатор выбора интервала, за который отображаются события;
*кнопка изменения интервала на один день вперед;
*кнопка вызова окна со списком активных тревог.

Ниже панели управления, в основном поле экрана, расположена таблица, содержащая зарегистрированные события.

Заголовок таблицы позволяет изменять порядок столбцов и включать сортировку по столбцам. Например, возможно включение сортировки событий сначала по времени, затем по группе. Заголовок таблицы имеет возможность отключения / включения отображения любого столбца.

При большом количестве записей в правой части таблицы появляется полоса прокрутки, позволяющая пролистывать список событий.

Нажатие на кнопку-индикатор выбора интервала вызывает окно выбора интервала (см. Рисунок 35):[[Файл:AgavaPLC–Окно "Фильтр".png|мини|Рисунок 36 – Окно "Фильтр"|ссылка=Файл:AgavaPLC–Окно_%22Фильтр%22.png]]После выбора нужного интервала для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события за выбранный интервал.
Нажатие на кнопку отображения окна фильтра вызывает соответствующее окно. Окно фильтра позволяет изменить содержимое основного окна журнала событий путем выбора групп и подгрупп событий, перечисленных в окне фильтра (см. Рисунок 36).

После выбора нужных групп и подгрупп для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события, принадлежащих выбранным группам.

====Виджет «Ввод значения»====
Виджет «Ввод значения» предназначен для отображения значения привязанного сигнала и его редактирования.
[[Файл:AgavaPLC–Виджет «Ввод значения» с отображением экранной цифровой клавиатуры.png|мини|Рисунок 37 – Виджет «Ввод значения» с отображением экранной цифровой клавиатуры|212x212пкс]]
После выбора узла для чтения/записи и соответствующего типа значения необходимо выбрать нужный тип ввода в разделе «Оформление».

Доступны следующие типы ввода:

*кнопки изменения – при нажатии на виджет появляются кнопки увеличения и уменьшения на заданный шаг изменения;
*кнопка редактирования – при нажатии на виджет появляется кнопка, при клике на которую открывается экранная цифровая клавиатура;

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

====Виджет «Выбор значения из списка»====
[[Файл:AgavaPLC–Виджет «Выбор значения из списка».png|мини|Рисунок 38 – Виджет «Выбор значения из списка»]]
Виджет «Выбор значения из списка» предназначен для отображения значения привязанного сигнала и его изменения в удобном для пользователя текстовом виде (см. Рисунок 37).

С помощью свойства «Список сопоставлений» задается соответствие между значением сигнала и выводимой в виджете строкой.

При нажатии на кнопку в правой части виджета отображается список всех сопоставлений. При выборе нужного элемента в списке в установленный узел производится запись нового значения.

====Виджет «Флаг»====
[[Файл:AgavaPLC–Варианты внешнего вида виджета «Флаг».png|мини|Рисунок 39 – Варианты внешнего вида виджета «Флаг»]]
Виджет «Флаг» предназначен для отображения значения и изменения булевой переменной (true/false). Состояние true отображается в виде галочки (см. Рисунок 38).

При нажатии на виджет значение переменной изменяется на противоположное.

В случае, если флаг необходимо использовать только для отображения информации, поставьте галочку в свойстве «Отключен»

====Виджет «Отчет»====
[[Файл:AgavaPLC–Виджет «Отчет» в режиме отображения сформированного отчета.png|мини|Рисунок 40 – Виджет «Отчет» в режиме отображения сформированного отчета]]
Виджет «Отчет» предназначен для формирования отчетов по заранее спроектированному макету.

Подробный порядок создания и редактирования отчетов приведен в разделе [[#Отчеты]].
[[Файл:AgavaPLC–Окно выбора интервала отчета.png|мини|Рисунок 41 – Окно выбора интервала отчета]]
В верхней части виджета размещена панель управления, содержащая кнопки вызова команд:

* печать сформированного отчета на установленном в системе принтере;
*сохранение сформированного отчета в файле формата PDF;
*переход к предыдущей странице отчета;
*переход к следующей странице отчета;
*масштабирование экрана по ширине листа отчета;
*масштабирование экрана по высоте листа отчета.

При формировании отчета для изменения интервала времени, за который будет формироваться отчет, необходимо на панели управления щелкнуть кнопку выбора интервала (на ней отображается текущий выбранный интервал, например, «Начало суток без смещения – Конец суток без смещения»). Далее появится окно «Интервал», в котором можно выбрать начало и конец интервала (см. Рисунок 41).

В качестве начала и конца интервала можно выбрать как конкретную дату по календарю, так относительную, например, «Начало дня», "Конец недели". После выбора желаемого интервала необходимо нажать кнопку «ОК».

Выбранный интервал отобразится на панели управления отчетом. Для формирования отчета за выбранный интервал необходимо нажать кнопку «Сформировать отчет». Через некоторое время, после загрузки данных из БД и их обработки, экран обновится и сформированный отчет за выбранный интервал будет отображен.

{{Шаблон:Действия AgavaSCADA/AgavaPLC}}

==Система тревог==
Система тревог предназначена для оповещения пользователя об обнаруженных нарушениях.

Система содержит два типа узлов:

*Группа событий.
*Контроллер событий.

===Группа событий===
Группа событий – узел, предназначенный для взаимодействия с виджетом «Список событий». Группы событий позволяют группировать события по какому-то признаку, например по уровню тревоги (авария, предупреждение, квитирование и т.д.), технологическому участку и т.д.

Для каждой группы можно выбрать свой цвет шрифта и фона, которые будут использоваться для вывода событий, принадлежащих этой группе в виджете "Список событий".

В свойстве «Описание» группы событий указывается текст, который будет отображаться в фильтре списка событий.

===Монитор событий===
Монитор событий (ранее - Контроллер событий) – узел, реализующий логику проверки соответствия выбранных сигналов контролируемым условиям. Контроллеры событий выполняют всю работу по проверке значений контролируемых параметров и выполнению соответствующих действий.

Монитор событий проверяет значения заданных узлов на соответствие заданным условиям и при их совпадении выполняет заданные действия.

В качестве действий можно указать не только действие "Создание события", но и другие (см. раздел [[#Действия]]).
[[Файл:AgavaPLC-Cистема тревог.png|мини|Cистема тревог]]

===Порядок настройки системы===
Порядок настройки системы тревог следующий:
#Добавить в проект систему тревог. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система тревог».
#Добавить узел «События» в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Группа» - «События». При необходимости настроить цвет шрифта и фона, которые будут отображаться у события в окне тревог или журнале.
#Добавить нужные [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|группы событий]] в узел «События». Для этого нажать ПКМ по узлу «События» в дереве проекта, затем выбрать «Добавить узел» - «Группа событий».
#Добавить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9A.D0.BE.D0.BD.D1.82.D1.80.D0.BE.D0.BB.D0.BB.D0.B5.D1.80 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|контроллеры событий]] в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Контроллер событий».
#Добавить в свойство «Сигналы» контроллеров событий узлы, состояние которых необходимо контролировать.
#Задать для этих узлов контролируемые условия в соответствующем свойстве контроллера событий.
#Настроить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действия]], которые будут выполняться при выполнении контролируемого условия. Для вывода аварий, предупреждений или информационных сообщений необходимо добавить действие «Создание события».
# Настроить действие «Создание события». В его свойстве «Группа событий» указать группу из созданных в пункте 2. Ввести тексты сообщения активации и деактивации (при необходимости), указать уровень события. Теперь, при срабатывании контролируемого условия, будет появляться окно тревог с сообщением активации.

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

Архивация параметров производится с помощью архиваторов. Архиваторы SQLite и PostgreSQL могут выполнять [[Узлы проекта AgavaSCADA/AgavaPLC#Прореживание данных|прореживание данных]].
[[Файл:AgavaPLC-Настройка архиватора.png|мини|505x505пкс|Настройка архиватора]]

===Порядок настройки системы===
Для сохранения истории изменения значений параметров в БД необходимо выполнить следующие действия:

#Добавить в проект систему архивации. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система архивации».
#Добавить в систему архивации архиватор. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем выбрать «Добавить узел» - «Архиватор в БД SQLite».
#Настроить параметры архиватора, такие как: путь до файла БД, интервал архивирования (как часто система архивации будет опрашивать значение параметра), интервал сохранения БД на диск (как часто эти значения будут записываться в постоянную память), разбиение БД (будет ли система архивации создавать новый файл БД каждые сутки), период хранения и режим выдачи значений для построения графика (сохраняемые значения будут обновляться с частотой интервала архивирования, а сохраненные - с частотой интервала сохранения).
#Добавить параметры в коннекторы база данных. Для этого необходимо открыть свойство архиватора «Коннекторы БД», выбрать «Создать новый» - «Коннектор БД». После этого нужно нажать по добавленному коннектору, открыть его свойство «Сигналы» и добавить параметр, значение которого необходимо сохранять в БД.

=== Архиватор SQLite===
Архиватор SQLite предназначен для сохранения значений параметров в БД формата SQLite.

Для извлечения и просмотра баз данных формата SQLite с устройств может использоваться программа «[[Архиватор]]».

====Свойства узла "Архиватор SQLite"====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
|Путь до файла БД
|FilePath
|STRING
|Чтение / запись
|Путь до файла БД. Абсолютный или относительный.
|-
|Интервал архивирования
|Interval
|INT
|Чтение / запись
|Интервал архивирования, мс.
|-
|Период хранения
|Retention
|INT
|Чтение / запись
|Период хранения, дней.
|-
|Разбиение БД
|DBSplitting
|BOOL
|Чтение / запись
|Разбиение БД на файлы. При включении база данных будет разделяться на отдельные файлы, содержащие данные за одни сутки.
|-
|Интервал сохранения БД на диск
|StoringInterval
|INT
|Чтение / запись
|Интервал сохранения БД на диск, мс.
|-
|Режим выдачи значений
|ValueReturnMode
|ENUM
|Чтение / запись
|Режим выдачи значений. Режим "Сохраняемые в БД" — данные выдаются сразу после получения архиватором, возможно до фактического сохранения в БД. Режим "Сохраненные в БД" — данные выдаются только после фактической записи в БД на диск.
|-
|Коннекторы БД
|Signals
|NODESARRAY
|Чтение / запись
|Список коннекторов, содержащих сигналы для архивирования.
|-
|Текущий размер БД
|DBCurrentSize
|INT
|Только чтение
|Текущий размер БД, Мб.
|-
|Максимальный размер БД
|DBMaxSize
|INT
|Только чтение
|Максимальный размер БД, Мб.
|-
|Состояние БД
|DBStatus
|INT
|Только чтение
|Текущий статус операций SQLite (числовой код). Для расшифровки см. раздел [[Узлы проекта AgavaSCADA/AgavaPLC#Статусы операций SQLite|Статусы операций SQLite]].
|-
|Включить прореживание
|ThinningEnabled
|BOOL
|Чтение / запись
|Включение режима прореживания архива. При включении применяется фильтрация по изменению значения.
|-
|Тип допуска
|ToleranceType
|ENUM
|Чтение / запись
|Тип допуска для прореживания. Возможные значения: "[[Узлы проекта AgavaSCADA/AgavaPLC#Абсолютный допуск|Абсолютные единицы]]", "[[Узлы проекта AgavaSCADA/AgavaPLC#Процент от последнего значения|Процент от последнего значения]]", "[[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего N последних|Процент от среднего значения]]" и "[[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего по временному окну|Процент от среднего значения (окно по времени)]]"
|-
|Допуск
|ThinningTolerance
|FLOAT
|Чтение / запись
|Величина допуска: в абсолютных единицах для режима «Абсолютные единицы», в процентах для режимов «Процент от…».
|-
|Период обязательной записи (мс)
|MandatoryPeriod
|UINT
|Чтение / запись
|Максимальный интервал между записями данных в архив, даже если значение не изменилось.
|-
|Размер окна среднего (N)
|AverageWindowN
|UINT
|Чтение / запись
|Количество последних значений для расчёта среднего. Используется только в режиме «Процент от среднего значения». В остальных режимах игнорируется.
|}

==== Статусы операций SQLite ====
В ходе работы SQLite возвращает статус выполнения операций в виде целочисленных значений. Далее приведена расшифровка этих кодов и возможные пути разрешения ошибок.
{| class="wikitable"
!Код
!Расшифровка
!Что предпринять чтобы починить?
|-
|'''0'''
|Операция выполнена успешно.
|Не ошибка. Действий не требуется.
|-
|'''1'''
|Общая ошибка выполнения операции.
|Повторите операцию. Проверьте доступность пути к базе и прав доступа, наличие свободного места на диске, отсутствие блокировки антивирусом/резервным копированием. Перезапустите приложение.
|-
|'''2'''
|Внутренняя ошибка SQLite (ошибка логики).
|Перезапустите приложение (при необходимости — ПК). Убедитесь, что не запущено несколько копий программы.
|-
|'''3'''
|Недостаточно прав для доступа к файлу или базе данных.
|Проверьте, что у пользователя или службы, от имени которой работает программа, есть разрешение на чтение и запись в каталог базы данных. Если база на сетевом диске — убедитесь, что доступ не заблокирован.
|-
|'''4'''
|Операция прервана внутренним процессом.
|Обычно это означает, что выполнение запроса было остановлено из-за внутреннего условия или сигнала прерывания. Повторите операцию. Если ошибка повторяется — перезапустите программу.
|-
|'''5'''
|Файл базы данных удерживается другой программой/процессом.
|Подождите 5–30 секунд и повторите операцию. Закройте другие копии программы/станции, отчёты, резервное копирование, антивирусное сканирование. Если база на сетевом диске — убедитесь, что её не открывают с других машин.
|-
|'''6'''
|Заблокирована таблица внутри базы.
|Дождитесь завершения текущей операции в программе. Закройте окна/отчёты, которые используют ту же таблицу. Если запущено несколько экземпляров на одной станции — оставьте один. Перезапустите программу.
|-
|'''7'''
|Недостаточно оперативной памяти.
|Закройте лишние приложения/тяжёлые отчёты и повторите. Перезапустите программу или ПК. Убедитесь, что хватает ОЗУ и места под файл подкачки. При систематическом повторении — используйте машину с большим объёмом памяти.
|-
|'''8'''
|Попытка записи в базу «только для чтения».
|Снимите атрибут «Только чтение» с файла .db и каталога. Проверьте права на запись (локально/на сетевой шаре). Убедитесь, что диск/том не смонтирован как «только чтение» и в настройках программы не выбран режим «только чтение».
|-
|'''9'''
|Операция была прервана системой/другим процессом.
|Повторите операцию и дождитесь завершения. Не закрывайте окно и не переключайте станцию во время выполнения. Убедитесь, что на станции не идут параллельно резервное копирование/антивирусное сканирование. Перезапустите приложение (при необходимости — ПК). Если повторяется — сохраните лог и время сбоя и обратитесь в поддержку.
|-
|'''10'''
|Ошибка чтения/записи на диск.
|Проверьте свободное место и доступ к диску; исключите блокировку антивирусом; проверьте доступность сетевого пути.
|-
|'''11'''
|Файл базы повреждён.
|Сделайте копию файла; восстановите из резервной копии. Если её нет — переименуйте/удалите базу (создастся заново; история будет потеряна).
|-
|'''12'''
|Запрошена неподдерживаемая низкоуровневая операция хранения.
|Если работа продолжается — действий не требуется. Если операция с базой данных не выполняется: перезапустите приложение; проверьте доступность диска/сетевого пути; по возможности временно перенесите базу на локальный диск.
|-
|'''13'''
|На диске закончилось место.
|Освободите место; уменьшите период хранения; включите разбиение БД на файлы.
|-
|'''14'''
|Не удаётся открыть файл базы.
|Проверьте путь и существование папки; права доступа; при необходимости укажите новый путь.
|-
|'''15'''
|Ошибка протокола блокировок (нарушен порядок совместного доступа).
|Закройте все окна/станции, которые используют базу. Подождите 30–60 секунд и запустите снова. Убедитесь, что не идут резервное копирование/антивирусное сканирование. Если база доступна по сети — временно скопируйте её на локальный диск и проверьте работу.
|-
|'''16'''
|Внутренняя ошибка SQLite (служебный код).
|Перезапустите приложение.
|-
|'''17'''
|Изменилась структура базы во время работы.
|Закройте другие экземпляры/станции, которые могли менять структуру. Перезапустите приложение. Если база обновлялась — дождитесь завершения обновления.
|-
|'''18'''
|Слишком большой блок данных.
|Уменьшите размер добавляемых данных.
|-
|'''19'''
|Нарушено ограничение данных (дубликат, пустое обязательное поле и т.п.).
|Проверьте вводимые значения: уникальные имена/ID, заполнение обязательных полей, корректные ссылки на объекты. Исправьте данные и повторите. Если источник данных внешний — исправьте файл/настройки импорта.
|-
|'''20'''
|Несовместимый тип данных (текст вместо числа и т.п.).
|Проверьте формат значений и региональные настройки (разделитель дроби, дата/время). Исправьте файл/настройки импорта или параметры тега и повторите.
|-
|'''21'''
|Ошибка использования библиотеки (ошибка приложения).
|Перезапустите приложение. Убедитесь, что не запускаете несколько конфликтующих копий.
|-
|'''22'''
|Файловая система/операционная система не поддерживает большие файлы/нужные функции.
|Вероятная причина — устаревшая файловая система или сетевое хранилище. Обратитесь к администратору для переноса базы на современную ФС/носитель. Как временная мера — уменьшите размер базы (сократите период хранения/включите ротацию).
|-
|'''23'''
|Отказ в авторизации (нет прав на действие).
|Войдите под учётной записью с нужными правами или запросите доступ у администратора. Если используется сеть — проверьте подключение и актуальность прав.
|-
|'''24'''
|Не используется (оставлен для обратной совместимости).
|Действий не требуется.
|-
|'''25'''
|Неверные параметры запроса (внутренняя ошибка приложения).
|Перезапустите приложение.
|-
|'''26'''
|Открыт файл, который не является базой данных.
|Проверьте путь и что выбран именно файл БД. Если файл повреждён — восстановите из резервной копии или создайте новую БД.
|-
|'''27'''
|Уведомление (информационное сообщение).
|Действий не требуется. В случае частых появлений кода проверьте логи базы данных для выяснения причины.
|-
|'''28'''
|Предупреждение (некритичная проблема).
|Действий не требуется. В случае частых появлений кода проверьте логи базы данных для выяснения причины.
|-
|'''100'''
|Доступна следующая строка данных.
|Не ошибка. Действий не требуется.
|-
|'''101'''
|Операция завершена, данных больше нет.
|Не ошибка. Действий не требуется.
|}

=== Архиватор PostgreSQL ===
Архиватор PostgreSQL предназначен для сохранения значений параметров в базы данных под управлением сервера PostgreSQL.

=== Прореживание данных ===
Прореживание данных — это процесс фильтрации и уменьшения количества точек данных, сохраняемых в архиве. Вместо того чтобы записывать каждое полученное значение, система анализирует поток данных и сохраняет только те значения, которые представляют значимое изменение.

'''Назначение прореживания'''

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

* '''Снижение нагрузки на архив''': Меньшее количество записей означает более быструю работу базы данных.
* '''Ускорение отображения графиков''': Нужно обрабатывать меньше точек для построения трендов.
* '''Сохранение только значимых изменений''': Система отфильтровывает шум и оставляет только те изменения, которые важны для анализа технологического процесса.
'''Общий принцип работы'''

Алгоритм прореживания работает по простому принципу:

# SCADA-система получает новое значение от источника данных.
# Она сравнивает это значение с последним, которое было сохранено в архив.
# Если изменение превышает заранее настроенный '''допуск''' (tolerance), новое значение сохраняется.
# Если изменение меньше допуска, значение пропускается.

Кроме того, существует параметр "'''Период обязательной записи"'''. Если с момента последней записи прошло больше времени, чем указано в этом параметре, новое значение будет сохранено '''независимо от его изменения'''. Это гарантирует, что записи в архив будут сохраняться не реже заданной периодичности, даже если сигнал не меняется. Ключевая идея: "'''Сохраняем только то, что заметно изменилось, но не реже, чем задано".'''

'''Как подобрать допуск?'''

* '''Слишком малый допуск''' приведёт к записи избыточных данных, и архив будет быстро расти.
* '''Слишком большой допуск''' может привести к потере мелких, но значимых изменений в сигнале.

Выбор правильного допуска — это компромисс между детализацией данных и размером архива.
==== Типы алгоритмов прореживания ====
В системе доступны несколько алгоритмов, которые определяют, как именно вычисляется «значимость» изменения. Выбор алгоритма зависит от характера сигнала и требований к точности данных.

# [[Узлы проекта AgavaSCADA/AgavaPLC#Абсолютный допуск|Абсолютный допуск]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от последнего значения|Процент от последнего значения]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего N последних|Процент от среднего N последних]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего по временному окну|Процент от среднего по временному окну]]

'''Обозначения и определения'''

В дальнейшем используются следующие обозначения (для числовых сигналов):

* <math>x_{in}</math> — текущее измерение сигнала, полученное от источника данных к моменту обработки (кандидат на запись).
* <math>x_{ref}</math> — последнее сохранённое числовое значение сигнала в архиве на момент обработки (опорное значение).
* <math>|\Delta| = |x_{in} - x_{ref}|</math> — абсолютная величина изменения между текущим измерением и последним сохранённым значением.
* <math>\bar{x}_N</math> — арифметическое среднее последних <math>N</math> сохранённых числовых значений.
* <math>\bar{x}_T</math> — среднее всех сохранённых числовых значений, чьи метки времени попадают в временное окно длительности <math>T</math> миллисекунд.
* <math>\varepsilon</math> — машинная точность для чисел двойной точности; используется для формальной проверки «близости к нулю».
* <math>tolerance</math> — допуск: абсолютный (в физических единицах) или относительный (в процентах), в зависимости от выбранного алгоритма.

'''Настройки в Свойствах архиватора, общие для всех типов прореживания'''

* '''Включить прореживание''' — включает/выключает применение алгоритма прореживания при записи значений. При выключении все поступающие значения сохраняются без фильтрации.
* '''Тип допуска''' — выбирает алгоритм сравнения.
* '''Период обязательной записи (мс)''' — максимальный допустимый промежуток между двумя записями одного сигнала. Если за это время значимого изменения не произошло, ближайшее поступившее значение будет записано принудительно. 0 — отключить принудительную запись.

===== Абсолютный допуск =====
'''Принцип:'''

Новое значение сохраняется, если модуль изменения больше установленного порога в физических единицах.

<math display="block">|\Delta| > tolerance</math>

'''Когда использовать:'''

* Если диапазон сигнала стабилен и известен заранее.
* Для параметров вроде температуры, давления, уровня жидкости, где фиксированное изменение имеет одинаковую интерпретацию по всей шкале.

'''Преимущества:'''

* Обеспечивает предсказуемое и детерминированное поведение независимо от текущего масштаба значения.
* Не требует накопления или хранения дополнительных данных (окон/истории), вычислительно прост.
* Удобен при наличии нормативно заданных пределов точности в физических единицах.

'''Ограничения:'''

* Не масштабируется на широкий динамический диапазон: один и тот же порог может быть слишком грубым для малых значений и слишком чувствительным для больших.
* Требует аккуратного подбора порога под единицы измерения и разрешение датчика; при неверной калибровке возможны либо избыточные записи, либо потеря значимых мелких изменений.
* Не учитывает относительный контекст изменения (например, 1 единица при значении 10 и при значении 10 000 трактуется одинаково).

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — абсолютный порог в физических единицах сигнала. Определяет значение <math>tolerance</math>.

===== Процент от последнего значения =====
'''Принцип:'''

Новое значение сохраняется, если относительное изменение относительно последнего сохранённого превышает заданный процент.

<math display="block">\frac{|\Delta|}{|x_{ref}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов, где важна относительная динамика, а не абсолютные величины.
* Для показателей с большим динамическим диапазоном, где относительная точность должна быть сопоставима на всех уровнях.

'''Преимущества:'''

* Масштабируемость: одинаково интерпретирует относительные изменения на низких и высоких уровнях сигнала.
* Не требует хранения окна значений; использует только последнее сохранённое значение, поэтому вычислительно лёгок.
* Быстро и корректно реагирует на пропорциональные изменения процесса (проценты), поддерживая заданную относительную чувствительность.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).
* При малых базовых значениях возможна повышенная чувствительность к шуму и микроколебаниям.
* Не подавляет высокочастотный шум сам по себе: при необходимости сочетать с обязательной записью по времени и корректной настройкой допуска.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

===== Процент от среднего N последних =====
'''Принцип:'''

Новое значение сохраняется, если изменение больше заданного процента от среднего по последним N сохранённым значениям.

<math display="block">\frac{|\Delta|}{|\bar{x}_{N}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с постоянным шумом или пульсациями, когда важно снижать чувствительность к случайным отклонениям.
* Для процессов с умеренной динамикой, где требуется устойчивость к «зубчатым» колебаниям.

'''Преимущества:'''

* Снижает чувствительность к высокочастотному шуму за счёт опоры на усреднение; сокращает объём записей на стационарных участках.
* Гибко настраивается параметром <math>N</math>: увеличение окна повышает устойчивость, уменьшение — повышает чувствительность и снижает задержку реакции.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).

* Инерционность: при резких скачках возможна задержка фиксации изменения, особенно при большом <math>N</math>.
* Усреднение может «сглаживать» и не фиксировать кратковременные, но важные пики; не подходит для задач, критичных к коротким экстремумам.
* Предполагает относительно стабильную частоту выборок; при сильно переменной частоте эффективная «временная» ширина окна становится непредсказуемой.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Размер окна среднего (<math>N</math>)''' — число последних сохранённых значений, по которым считается среднее. Большее <math>N</math> повышает устойчивость к шуму, но увеличивает инерционность реакции.

===== Процент от среднего по временному окну =====
'''Принцип:'''

Похож на предыдущий, но среднее считается не по количеству точек, а по всем значениям за заданный интервал времени.

<math display="block">\frac{|\Delta|}{|\bar{x}_{T}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с непостоянной частотой измерений (событийные, неравномерные потоки).
* В случаях, когда важно учитывать реальную временную протяжённость усреднения независимо от плотности измерений.

'''Преимущества:'''

* Корректно работает при переменной частоте выборок: окно фиксируется по времени, а не по числу точек.
* Более реалистично оценивает тренд во времени на участках с неравномерными измерениями.
* Управляемый компромисс между подавлением шума и чувствительностью за счёт выбора длительности окна.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).

* Более высокая ресурсоёмкость: требуется хранить и периодически «очищать» значения по условию выхода из временного окна; потребление памяти зависит от фактической скорости поступления данных.
* Инерционность, присущая усреднению: возможна задержка фиксации коротких, но значимых пиковых изменений.
* Критичен выбор длительности окна: слишком малое окно даёт мало подавления шума, слишком большое — чрезмерную инерцию и риск пропуска кратких событий.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Интервал архивирования''' — длительность временного окна <math>T</math> (мс), в пределах которого вычисляется среднее. При увеличении <math>T</math> растёт сглаживание и уменьшается чувствительность к кратким всплескам; при уменьшении — наоборот. Значения, чьи метки времени выходят за пределы окна, автоматически исключаются из расчёта.

==== Примечание к алгоритмам 'Процент от…' ====
При малых опорных значениях система автоматически переходит в абсолютный режим, чтобы избежать деления на величину, близкую к нулю, и связанных с этим скачков чувствительности. Этот механизм применяется ко всем алгоритмам, использующим относительное сравнение: «Процент от последнего», «Процент от среднего N», «Процент от среднего по временному окну» и обеспечивает стабильность критерия при слабых сигналах.

* Условия входа в режим абсолютного допуска:
** для «Процента от последнего»: <math>|x_{ref}| < \varepsilon</math>;
** для «Процента от среднего N»: <math>|\bar{x}_{N}| < \varepsilon</math>;
** для «Процента от среднего по времени»: <math>|\bar{x}_{T}| < \varepsilon</math>.
* Критерий в режиме абсолютного допуска: значение фиксируется, если <math>|\Delta| > tolerance</math>.
* Условие выхода: как только соответствующая базовая величина (<math>|x_{ref}|</math>, <math>|\bar{x}_{N}|</math> или <math>|\bar{x}_{T}|</math>) становится <math>\geq \varepsilon</math>, система автоматически возвращается к относительному критерию.
* Трактовка <math>tolerance</math>: используется то же значение настройки; в абсолютном режиме оно интерпретируется как порог в физических единицах сигнала.

==== Сравнение алгоритмов прореживания данных ====
{| class="wikitable"
!Критерий
!Абсолютный
!% от последнего
!% от среднего N
!% от среднего по времени
|-
|Единицы допуска
|Физические
|Проценты
|Проценты
|Проценты
|-
|Устойчивость к шуму
|Низкая
|Средняя
|Высокая
|Высокая
|-
|Реакция на резкие скачки
|Быстрая
|Быстрая
|Задержка (при большом N)
|Задержка
|-
|Подходит при переменной частоте
|Да
|Да
|Нет
|Да
|}

==Система журналирования==
Система ведения журналов событий предназначена для управления регистрацией и хранением событий. В базу данных записываются все системные события и события, генерируемые с помощью [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.A1.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D0.B0 .D1.82.D1.80.D0.B5.D0.B2.D0.BE.D0.B3|системы тревог]], которые соответствуют выбранному уровню сообщений.

Для ведения журналов используются узлы типа "Логгер".

===Порядок настройки системы===
Порядок настройки системы журналирования следующий:

#Добавить и [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9F.D0.BE.D1.80.D1.8F.D0.B4.D0.BE.D0.BA .D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8 .D1.81.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D1.8B|настроить систему тревог]] для генерации событий.
#Добавить в проект систему журналирования. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система журналирования».
#Добавить в систему журналирования логгер. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем нажать «Добавить узел» и выбрать нужный логгер.
#Настроить параметры логгера (см. разделы ниже).

=== Логгер SQLite===
Логгер SQLite предназначен для сохранения событий, возникающих в ходе исполнения прикладной программы в СУБД SQLite.

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

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

===Логгер файловый ===
Логгер файловый предназначен для сохранения журналов событий в текстовых файлах на накопителе. Логгер имеет минимальное количество настроек, и обычно используется для сохранения журнала событий в случае необходимости отладки работы прикладной программы без среды разработки.

===Логгер SMS===
Логгер SMS предназначен для SMS информирования с помощью субмодуля GRPS или внешнего GPRS модема.

Принцип работы логгера следующий:

#Логгер принимает возникающие события, фильтрует их согласно установленного уровня событий и выбранных групп.
#События, прошедшие фильтрацию, форматируются согласно установленного шаблона.
#Отформатированные сообщения отправляются через подключенный модем в виде SMS сообщения. Отправка сообщений производится на телефонные номера, записанные в телефонной книге на SIM-карте.

==Система проверки прав пользователей==
[[Файл:AgavaPLC-Окно привилегий.png|мини|494x494пкс|Окно привилегий]]
Система реализует механизм контроля доступа к узлам проекта и их функциях на основе ролей. Узлы при выполнении действий проверяют наличие установленных привилегий у авторизованного в данный момент пользователя.

=== Роли и пользователи ===
Система содержит в себе две подсистемы:
*Пользователи. Подсистема определяет пользователей, каждому из которых назначается логин/пароль и одна или несколько ролей.
*Роли. Роли хранят наборы доступных привилегий.
Отношения между пользователями, ролями и привилегиями можно описать следующим образом:

* Один пользователь может иметь несколько ролей.
* Одну роль могут иметь несколько пользователей.
* Одна роль может иметь несколько привилегий.
* Одна привилегия может принадлежать нескольким ролям.

=== Привилегии ===
[[Файл:AgavaPLC-Система проверки прав пользователей.png|мини|Система проверки прав пользователей]]
Для узлов системы доступна установка следующих привилегий:

Все узлы:

*Чтение значения.
*Запись значения.
Окна и фреймы:
*Открытие окна.
*Закрытие окна.

При установке привилегий на какой-либо узел, все подчиненные узлы получают те же привилегии с флагом "унаследована".

Если привилегия не установлена, то считается что действие, регулируемое привилегией, запрещено.

Значение унаследованных привилегий можно переопределить с помощью явного задания привилегии.
===Порядок настройки системы===
Привилегии настраиваются в отдельном окне привилегий, доступном в меню "Вид".

Порядок настройки системы проверки прав в версии AgavaSCADA 1.2 следующий:

#Добавить в проект систему проверки прав пользователей. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система проверки прав пользователей».
#Добавить в систему проверки прав пользователей узел «Роль». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Роли».
#Добавить в узел «Роли» необходимые роли. Для этого нажать ПКМ по узлу «Роли» в дереве проекта, затем выбрать «Добавить узел» - «Роль».
#Для каждой роли настроить привилегии в окне привилегий. Для этого необходимо нажать «Вид» - «Открыть привилегии». В открывшемся окне в выпадающем списке «Пользователь / роль» выбрать нужную роль. Затем, нажимая ПКМ по узлам и выбирая «Добавить привилегию» настроить все необходимые ограничения для данной роли.
#Добавить в систему проверки прав пользователей узел «Пользователи». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Добавить в узел «Пользователи» необходимых пользователей. Для этого нажать ПКМ по узлу «Пользователи» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Для каждого пользователя указать имя и пароль, которые будут использоваться при авторизации, и выбрать одну или несколько ролей.

== Сигналы, источники и операции ==
Регистры и другие узлы, добавленные в группу «Сигналы», являются внутренними для проекта и могут менять свои значения только с помощь скриптов или других узлов, с которыми они связаны.

Сигналы содержат в себе несколько подгрупп.

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

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

Первичное значение поступает на вход операции, производится вычисление. Если есть еще операции, то вычисленное значение после первой операции передается на вход второй. И так далее по всем операциям. Если операций больше нет, вычисленное значение устанавливается в качестве значения узла.

Все операции выполняются в порядке, в котором они заданы в соответствующих свойствах.

====Сигнал простой====
Узел типа "Сигнал простой" предназначен для хранения и обработки значения источника, или другого сигнала или операции. Позволяет произвести какие-либо действия с этим значением с помощью добавления нужных операций в свойство «Операции после чтения».

====Постоянная ====
Узел типа "Постоянная" предназначен для хранения данных выбранного формата и позволяет изменять их в ходе выполнения программы. Связывание с источником не предусмотрено. Изменение осуществляется с помощью специализированных функций или блока установки значения в задаче ПЛК.

====Массив====
Массив - совокупность каких-либо объектов, указанных в свойстве «Входные значения». Нумерация объектов в массиве начинается с 0. Может использоваться для взаимодействия с демультиплексором.

====Сигнал комплексный====
Сигнал используется для взаимодействия с виджетом «Цифровой индикатор». Позволяет контролировать входное значение и генерировать события переходу входного значения через уставки.

Содержит в себе свойства для настройки следующих параметров:

*ВАУ – верхняя аварийная уставка;
*ВПУ - верхняя предаварийная уставка;
*НПУ - нижняя предаварийная уставка;
*НАУ – нижняя аварийная уставка;
*ФНЧ – фильтр низких частот.

===Источник===
Источник - специальный тип узлов, предназначенных для передачи данных от внешних устройств.

====Регистр Modbus====
Регистр Modbus используется для приема и передачи данных по протоколам Modbus-RTU, Modbus-TCP. Данный тип узов также может использоваться для организации работы некоторых алгоритмов программы (например для взаимодействия с контроллером событий).

====Источник индексный====
Узел типа "Источник индексный" используется для обработки данных, полученных по протоколу Upd, а так же в массивах для индексации значений.

===Операция===
[[Файл:AgavaPLC-Входные значения операций.png|мини|Входные значения операций]]
Узлы типа "Операция" используются для реализации вычислительных алгоритмов в задаче ПЛК или отдельно, при их размещении в группе "Сигналы".

В качестве входных значений операций выбираются константные числа, другие узлы группы «Сигналы», регистры или блоки задачи ПЛК.

====Операция «Сложение»====
Выходным значением является сумма входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Вычитание»====
Выходным значением является разность первого входного значения и суммы всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Умножение»====
Выходным значением является произведение значений всех входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Деление»====
Выходным значением является результат от деления первого входного значения на произведение всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Условие»====
Узел типа "Операция условие" предназначен для сравнения значений двух узлов. Для условия задаются сравниваемые параметры и выбирается режим сравнения. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Пара условий»====
[[Файл:AgavaPLC-Операция «Пара условий».png|мини|Операция «Пара условий»]]
Операция содержит в себе два условия. Для каждого условия задаются индивидуальные сравнимаемые параметры и выбирается режим сравнения.

Выходное значение операции зависит от ее режима проверки – при выбранном режиме «Логическое ИЛИ» выходное значение равно логической «1» если одно из условий равно «1», при «Логическом И»- если оба условия равны «1».

====Операция «Логическое ИЛИ»====
Если одно из входных значений становится равно логической «1» (контакты замкнуты), то выходное значение становится логической «1» (выход включен).

====Операция «Логическое И»====
Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

====Операция «Логическое НЕ»====
Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

====Операция «Таймер»====
Таймер предназначен для выполнения каких-либо [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действий]] через одинаковые промежутки времени (например запись значения в узел). Промежуток между исполнениями действий задается в свойстве «Интервал срабатывания», а сами действия в свойстве «Действия OnTimer». Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

====Операция «Мультиплексор»====
Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...».

Например если в качестве входных значений указаны два регистра, то выходное значение мультиплексора будет формироваться следующим образом:
{| class="wikitable"
!Значение регистра 1
!Значение регистра 2
!Выходное значение
|-
|0
|0
|0
|-
|1
|0
|1
|-
|0
|1
|2
|-
|1
|1
|3
|}

====Операция «Демультиплексор»====
Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

====Операция «Генератор случайного числа»====
Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями. Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

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

Для выполнения скрипта, можно добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения. Другим способом вызова срабатывания скрипта является добавление его в [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.92.D1.8B.D0.BF.D0.BE.D0.BB.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5 .D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0.C2.BB|действие «Выполнение скрипта»]].

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

*void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

===Объект===
Узлы типа "Объект" предназначены для взаимодействия с аппаратными компонентами контроллера. Для всех объектов, являющихся субмодулями, необходимо указать слот, в котором они установлены. Доступ к значениям входов/выходов субмодуля осуществляется через его вложенные узлы.

'''ПЛК процессорный модуль'''

Предоставляет возможность регулирования подсветки экрана; включения и отключения индикаторов работы, аварии и программы.

'''ПЛК субмодуль DI'''

Позволяет получать доступ к значениям входов субмодуля DI.

'''ПЛК субмодуль R'''

Позволяет управлять значениями выходов субмодуля R.

'''ПЛК субмодуль SIM'''

Позволяет управлять значениями выходов субмодуля SIM.

'''ПЛК субмодуль DO6'''

Позволяет управлять значениями выходов субмодуля DO6.

'''ПЛК субмодуль AI'''

Позволяет получать доступ к значениям входов субмодуля AI и задавать их тип.

'''ПЛК субмодуль AIO'''

Позволяет получать доступ к значениям входов субмодуля AIO, управлять значениями выходов и задавать тип входов и выходов.

'''ПЛК субмодуль TMP'''

Позволяет получать доступ к значениям входов субмодуля TMP и задавать их тип.

==Задачи==
Группа «Задачи» предназначена для группировки узлов типа «Задача», которые используются для циклического или разового выполнения созданных пользователем алгоритмов.

===Задача ПЛК===
Данный узел предоставляет возможности для связывания между собой других узлов (таких как сигналы, субмодули ПЛК, постоянные и т. д.) в удобной графической форме (см. Рисунок 64). Для перехода к редактору необходимо щелкнуть правой кнопкой мыши на задачу ПЛК и выбрать в открывшемся контекстном меню команду «Открыть графическое представление» или дважды щелкнуть левой кнопкой мыши на задаче ПЛК в дереве проекта.

Рисунок 64 – Окно графического редактирования задачи «ПЛК-60»

Панель инструментов задачи ПЛК, расположенная в верхней части окна, содержит следующие элементы (см. Рисунок 16):

*Выпадающий список выбора режима подписи портов.
*Выпадающий список выбора режима подписи блоков.
*Кнопка запуска режима симулятора.
*Кнопка запуска онлайн отладки.
*Кнопка печати задачи.
*Инструменты управления симуляцией.

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

Созданную связь можно удалить, выделив ее левой кнопкой мыши и нажав клавишу "Del". Связь можно "разорвать", то есть добавить разрыв, нажав по ней правой кнопкой мыши и выбрав в контекстном меню команду «Добавить разрыв».

Для выделения нескольких блоков рамкой зажмите клавишу "Shift" и выделяйте блоки мышью с нажатой левой кнопкой.

Задача ПЛК предоставляет возможности для проведения тестирования и отладки проекта, описанные в разделе [[#Проверка и отладка проекта]].

====Блоки задачи ПЛК====
Помимо операций, описанных в разделе [[#Операция]], для реализации алгоритмов в задачу ПЛК можно добавлять блоки, описанные ниже.

'''Функциональный блок'''

Используется для выделения каких-либо действий в отдельный блок, для упрощения понимания работы алгоритма программы. Содержит входы, выходы и блоки, обеспечивающие работу внутренней логики. Позволяет проводить изолированную отладку, при которой значения на входах функционального блока вручную задаются пользователем. Блок, работающий в данном режиме выделяется черной рамкой. Для включения изолированной отладки необходимо открыть блок и нажать кнопку «Изолированная отладка» на панели управления задачей.

'''Блок установки значения'''

Блок осуществляет запись значения, поданного на вход in0, в узел, указанный в свойстве «Узел для чтения/записи»

'''Блок задержки'''

Блок задержки используется для создания задержки передачи значения с входа блока на выход на один цикл обработки задачи.

'''Блок «Битовое OR»'''

Для вычисления значения будет произведена операция "ИЛИ" над каждым битом значения в отдельности. Например: 1010 OR 0110 = 1110

'''Блок «Логическое И»'''

Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

'''Блок «Битовое AND»'''

Для вычисления значения будет произведена операция "И" над каждым битом значения в отдельности. Если все биты, стоящие на одинаковых позициях в двоичных представлениях значений, поступающих на входы блока, равны логической «1», то на выходе элемента в этой позиции появляется логическая «1» (выход включен). Например: 1010 AND 0110 = 0010

'''Блок «Логическое НЕ»'''

Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

'''Блок «Битовое XOR»'''

Если только на один из входов блока функции поступает логическая «1», то на выходе элемента появляется логическая «1». Если на входы блока функции поступают целочисленные значения, то операция будет произведена над каждым битом значения в отдельности. Например: 1010 XOR 0110 = 1100

'''Блок «Битовое SHR»'''

Побитовый логический сдвиг вправо используется для выполнения операции побитового логического сдвига операнда X вправо на N бит с дополнением нулями слева.

'''Блок «Битовое SHL»'''

Побитовый логический сдвиг влево используется для выполнения операции побитового логического сдвига операнда X влево на N бит с дополнением нулями справа.

'''Блок «Таймер»'''

Таймер предназначен для выполнения каких-либо действий (см. раздел 4.6) через одинаковые промежутки времени (например запись значения в узел).

'''Блок «Мультиплексор»'''

Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...»

'''Блок «Демультиплексор»'''

Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

'''Блок «Генератор случайного числа»'''

Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями.

'''Блок «Скрипт С++»'''

Операция «Скрипт С++» предназначена для реализации разнообразных алгоритмов на языке С++. Операция предусматривает реализацию одной или нескольких функций, выполняющих необходимые пользователю действия. Для выполнения скрипта, необходимо добавить его в качестве узла для задачи или задачи ПЛК.

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

* void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

'''Блок «Таймер с задержкой»'''

Таймер с задержкой используется для операции задержки передачи и/или отключения сигнала. На выходе таймера появится сигнал логической «1» с задержкой относительно фронта входного сигнала продолжительностью равной интервалу включения и выключится по спаду входного сигнала с задержкой продолжительностью равной интервалу выключения. В том случае, если необходимо использовать блок только как таймер с задержкой включения (отключения) интервал выключения (включения) устанавливается равным 0.

'''Блок «Генератор прямоугольных импульсов»'''

Генератор прямоугольных импульсов используется для формирования прямоугольных импульсов пульсации. На выходе генератора формируются импульсы с заданными параметрами длительности включенного и отключенного импульса на время действия управляющего сигнала на входе (сигнал логической «1»).

'''Блок «Триггер RS»'''

RS-триггер с приоритетом выключения используется для переключения с фиксацией состояния во время поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Триггер SR»'''

SR-триггер с приоритетом включения используется для переключения с фиксацией состояния в случае поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Детектор переднего фронта импульса»'''

Детектор переднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «0» в «1».

'''Блок «Детектор заднего фронта импульса»'''

Детектор заднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «1» в «0».

'''Блок «D-триггер»'''

D-триггер используется для формирования импульса включения выхода на интервал времени импульса на входе D, выходной интервал будет синхронизирован с тактовой частотой на входе С. На выходе Q триггера появится сигнал логической «1» по фронту тактовых импульсов на входе С при наличии сигнала логической «1» на входе D. Возврат выхода в сигнал логического «0» произойдет по фронту тактовых импульсов на входе С при наличии сигнала логического «0» на входе D. Вход Set принудительно устанавливает выход в состояние логической «1». Вход Reset является приоритетным и устанавливает выход в состояние логического «0».

'''Блок «Селектор»'''

Если на вход Value подается логическая «1», то результатом выполнения операции блока на выходе является входной сигнал ValueT. Если же Value равен логической «0», то результатом выполнения операции блока на выходе является входной сигнал ValueF.

'''Блок «Больше чем»'''

На выход подается логическая «1», если значение in0 больше чем значение in1.

'''Блок «Равенство»'''

На выход подается логическая «1», если значение in0 равно значению in1.

'''Блок «Абсолютное значение числа»'''

Результатом операции функции на выходе является модуль подаваемого на вход значения. Если число на входе положительное, то на выход подается само число, если отрицательное – положительное число, получаемое от перемены его знака с «-» на «+».

'''Блок «Возведение в степень»'''

Результатом операции функции на выходе является значение, равное значению in0, возведенному в степень значения N.

'''Блок «PID-регулятор»'''

Регулятор PID применяется для поддержания заданного значения параметра. На вход Pv подается текущее значение регулируемой величины, на Sp – ее заданное значение. С помощью изменения коэффициентов ПИД регулятора kP, kI и kD достигается оптимальный режим работы. Min задает минимальное значение на выходе, Max – максимальное. time - период регулятора (в мс.).

'''Блок «PWM-регулятор»'''

Применяется для преобразования аналогового сигнала в дискретный с помощью ШИМ. На вход in подается текущее значение регулируемой величины, Min задает минимальное значение на входе, Max – максимальное. time - период регулятора (в мс.)

==Устройства==
Группа «Устройства» предназначена для группировки узлов типа "Устройство", выполняющие разнообразные задачи, например работа с внешними накопителями и ПЗУ.

Retain-накопитель дает возможность хранить значения регистров, постоянных и сигналов в постоянной памяти контроллера, что позволяет им сохранять свои значения после отключения питания.

Для сохранения переменных необходимо перечислить их в свойстве «Узлы» и указать путь сохранения на выбранном накопителе.

== Отчеты==
{{Внимание|Тип=Восклицание желтый.png|Текст=Данный узел доступен только при исполнении проекта на настольном компьютере. На панелях оператора и контроллерах МПР этот узел не доступен.}}
Отчет – технологический документ, содержащий информацию о ходе производственного процесса, обработанную по заложенным в отчет алгоритмам. Отчеты формируются на основе макетов (статической части отчетов) путем добавления в них свойств и значений заданных параметров технологического процесса, которые формируются (выбираются из базы данных технологических параметров и проходят соответствующую обработку) по алгоритмам, размещенным в этих шаблонах.

Данные для отчета предоставляет выборка, осуществляющая получение данных и их обработку из базы данных.

===Создание нового отчета===
Создание любого отчета производится в два этапа.

#Создание необходимых узлов в конфигурации: сам отчет и необходимое количество выборок.
#Составление макета отчета.

Создание узла типа «Отчет» в конфигурации и выборок для него производится аналогично созданию узлов других типов. К станции добавляется узел типа «Отчеты» с помощью команды контекстного меню «Добавить узел», далее к узлу типа «Отчеты» добавляется отчет и к отчету добавляется необходимое количество выборок.

Выборка – специальный узел, предназначенный для выборки данных из архива и их обработки для последующего отображения в отчете.

Перед переходом к редактированию макета желательно проделать следующие операции:

*в свойстве отчета «Путь к файлу отчета» установить имя файла, в котором будет храниться макет отчета;
* в свойстве «Источники» выборки (выборок) отчета установить перечень архивных сигналов (коннекторов), которые будут выводиться в отчете.

===Редактирование макета отчета===
[[Файл:AgavaPLC–Редактор макета отчета.png|мини|Рисунок 42 – Редактор макета отчета]]
Для редактирования макета отчета необходимо переключиться из редактора конфигурации в редактор макета отчета с помощью команды «Открыть редактор макета отчета», доступной из контекстного меню дерева конфигурации, отображаемого при щелчке правой кнопкой мыши на узле типа «Отчет».

В окне редактора расположены:

*панели инструментов;
* панель объектов отчета;
*окно «Инспектор объектов»;
*окно «Инспектор данных»;
*окно «Инспектор скриптов»;
*область построения макета отчета;
*окно «Структура отчета».

Редактор макета позволяет вызывать команды сочетаниями клавиш:

*Ctrl + N – новый макет;
*Ctrl + O – загрузить макет;
*Ctrl + S – сохранить макет;
*Ctrl + Shift + S – сохранить макет под новым именем;
*Ctrl + P – предварительный просмотр;
*Ctrl + Z – отмена изменений;
*Ctrl + Shift + Z – возврат отмененных изменений;
* Ctrl + C – копировать объект;
*Ctrl + X – вырезать объект;
*Ctrl + V – вставить объект;
*Ctrl + Стрелки – переместить выделенный объект;
*Shift + Стрелки – изменить размер выделенных объектов;
*Del – удалить выделенные объекты;
*Shift + левая кнопка мыши – создать область выделения.

====Окно «Инспектор объектов»====
Окно «Инспектор объектов» содержит список свойств выделенного объекта и предназначено для их редактирования.

====Окно «Инспектор данных»====
Окно «Инспектор данных» содержит список доступных для использования источников данных (выборок) и предназначено для заполнения блока «Данные» элементами соответствующего типа.

====Окно «Инспектор скриптов»====
Окно «Инспектор скриптов» содержит список доступных для использования в отчете скриптов.

====Окно «Структура отчета»====
Окно «Структура отчет» отображает структуру отчета в виде дерева связанных элементов.

===Элементы отчета===
Для составления макета отчета доступны следующие элементы:

*текст;
*данные;
*изображение;
*фигура;
*компоновка (Layout).

====Текст====
Элемент «Текст» служит для вывода надписей или содержимого полей источников данных.

Объект «Текст» обладает очень широкими возможностями. Он умеет отображать текст, рамку, заливку. Текст может быть отображен любым шрифтом любого размера, цвета и стиля. Большинство настроек делаются визуально с помощью панелей инструментов.

Одна из самых главных особенностей этого универсального объекта – это возможность отображения не только статичного текста, но и текста с применением вычисляемых выражений. Причем, выражения могут располагаться в объекте вперемешку с текстом. Рассмотрим простой пример – поместим в объект «Текст» следующую строку: «Привет! Сегодня $S{now()}».

Если запустить отчет на построение, мы увидим приблизительно следующее: «Привет! Сегодня 20180803». В процессе построения отчета выражение в тексте, заключенное $S{}, было вычислено и полученное значение вставлено обратно в текст. Объект «Текст» может содержать любое количество выражений, смешанных с обычным текстом. В скобки можно заключать и одиночные переменные, и выражения, например, $S{1+2*(3+4)}. В выражениях можно использовать константы, переменные ($V{}), функции, поля БД ($D{}).

Свойства элемента «Текст»:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|alignment
|Выравнивание текста по вертикали и горизонтали
|-
|angle
|Поворот надписи
|-
|autoHeight
|Автоматический подбор высоты
|-
|autoWidth
|Автоматический подбор ширины
|-
|backgroundColor
|Цвет заливки
|-
|backgroundMode
|Режим заливки
|-
| backgroundOpacity
|Прозрачность заливки
|-
|borders
|Границы
|-
|content
|Содержимое объекта «Текст»
|-
|font
|Шрифт
|-
|fontColor
|Цвет шрифта
|-
| foregroundOpacity
|Прозрачность шрифта
|-
|geometry
|Размер и расположение объекта
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|margin
|Отступы
|-
|objectName
| Имя объекта
|-
|stretchToMaxHeight
|Установка значения высоты самого высокого объекта на бэнде
|-
|trimValue
|Удаление пробелов в начале и в конце надписи
|}

Для редактирования свойства «Content» используется диалоговое окно «Text Item Editor», вызов которого осуществляется двойным щелчком левой кнопки мыши на элементе «Текст».

Свойство «Content» может содержать:

*текст;
*значения переменных;
*значения полей из набора данных;
*значения, формируемые посредством исполнения скрипта.

Для вывода значений переменных используется синтаксис «$V{имяПеременной}» (без кавычек), для вывода значения поля данных – «$D{имяНабораДанных.ИмяПеременной}», для вывода результата исполнения скрипта – «$S{телоСкрипта}».

==== Изображение ====
Элемент для вывода изображений:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoSize
|Подгонять размер под размер изображения
|-
|borders
|Границы
|-
|content
|
|-
|datasource
|Источник данных
|-
|field
|Поле данных
|-
|geometry
|Размер и расположение
|-
|image
|Изображение
|-
| itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
| stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Фигура====
Элемент для вывода фигур:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
| geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|lineWidth
|Толщина линии
|-
|objectName
|Имя объекта
|-
|opacity
|Прозрачность
|-
|penStyle
|Стиль линии
|-
|shape
|Фигура
|-
|shapeBrush
|Стиль заливки
|-
|shapeBrushColor
|Цвет заливки
|-
|shapeColor
|Цвет фигуры
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Горизонтальная компоновка (Layout)====
Элемент, позволяющий объединять несколько элементов в группу:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
|geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

=== Разделы отчета (бэнды) ===
Бэнд предназначен для размещения других элементов отчета. Бэнд может быть нескольких типов:

*Report Header – заголовок отчета;
*Report Footer – завершение отчета;
*Page Header – верхний колонтитул страницы отчета;
*Page Footer – нижний колонтитул страницы отчета;
*Data – данные отчета;
* SubDetail – подчиненные данные отчета;
*SubDetailHeader – заголовок подчиненных данных;
*SubDetailFooter – завершение подчиненных данных;
*GroupHeader – заголовок группы;
*GroupFooter – завершение группы.

Бэнды применяются для логической группировки объектов. К примеру, размещение объекта на элементе «Данные» типа «Page Header», приводит к отображению этого объекта в верхней части каждой страницы готового отчета. Аналогичным образом «Page Footer» выводится внизу каждой страницы со всеми лежащими на нем объектами.

Общие для всех элементов «Данные» свойства:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoHeight
|Автоматический подбор высоты
|-
|backgroundColor
|Цвет заливки бэнда
|-
|borders
|Границы
|-
|geometry
|Размер
|-
|keepBottomSpace
|Сохранение отступа от нижней границы бэнда
|-
|objectName
|Имя объекта
|-
|printIfEmpty
|Отображение пустого бэнда
|-
|splittable
|Разделение бэнда, если он не влезает на страницу
|}

Report Footer:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|maxScalePercent
|Максимальный процент, на который можно уменьшить бенд, если он не влезает на страницу. Если бэнд даже после сжатия

не влезает на страницу, он будет перенесен полностью или частично – в зависимости от настроек бэнда
|}

Data:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|datasource
|Источник данных. Data-бэнд будет сформирован для каждой строки в источнике данных
|-
|keepFooterTogether
|Если Report Footer не влезает на страницу, то он будет перенесен на следующую страницу совместно с последним

экземпляром Data-бэнда
|-
|sliceLastRow
| Указывает генератору отчетов на то, можно ли разрезать последний экземпляр Data-бэнда или его нужно перенести

целиком
|}

Бэнды данного типа предназначены для вывода на печать данных из наборов. Набор данных - это заранее неизвестное количество строк (записей), каждая из которых содержит определенное количество колонок (полей).

SubDetail:
{| class="wikitable"
! Наименование свойства
!Описание
|-
|datasource
| Источник данных. SubDetail-бэнд будет сформирован для каждой строки в источнике данных
|}

SubDetailHeader, SubDetailFooter:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|printAlways
| Печатать, даже если SubDetail пустой
|}

GroupHeader:
{| class="wikitable"
!Наименование свойства
! Описание
|-
|groupFieldName
|Поле, по которому осуществляется группировка. Экземпляр GroupHeader будет формироваться при смене значения в этом поле
|}

===Функции===
==== Агрегатные функции ====
Агрегатные функции предназначены для обработки значений, содержащихся в резделах Data и SubDetail.

===== AVG - вычисление среднего значения =====
Пример использования:
$S{AVG("TextItem4","DataBand1");}

===== SUM - вычисление суммы значений =====
Пример использования:
$S{SUM("TextItem8","DataBand1");}

===== MIN =====

===== MAX =====

===== COUNT =====

==== Числовые функции ====

===== numberFormat - форматирование числа =====
Синтаксис:
numberFormat(значение, 'формат', точность)
Форматы:

* <code>'f'</code> — фиксированная запись (например, <code>"123.45"</code>);
* <code>'g'</code> — общий формат (автоматически выбирает между <code>'f'</code> и <code>'e'</code>);
* <code>'e'</code> — экспоненциальная запись (например, <code>"1.2345e+02"</code>);

Пример использования:
$S{numberFormat($D{fetcharchiverdata1.ArchiversSourceConnector0 (среднее)}, 'f', 3)} -> 123.495
[[Категория:AgavaSCADA/AgavaPLC]]

Узлы проекта AgavaSCADA/AgavaPLC

2025-10-30T04:36:15Z

SharipovRR: /* Примечание к алгоритмам 'Процент от…' */

== Узлы проекта ==
Узел - элементарная сущность проекта, осуществляющая хранение информации или реализующая определенный функционал. Каждый узел обладает набором [[Свойства узлов в AgavaSCADA/AgavaPLC|свойств]]. Все узлы, объединенные в иерархическую структуру, образуют проект.

== Проект ==
[[Файл:AgavaPLC–Дерево проекта.png|мини|Рисунок 21 – Дерево проекта]]
Узел "Проект" ("Корневой узел", "Корень") предназначен для хранения общей информации о проекте и связывания других узлов проекта.

== Станция ==
Станция – важнейший узел, управляющий работой собственных систем и выполняющий обмен данными с другими станциями. Физически станция представляет собой устройство, на котором исполняется проект (компьютер, панель оператора, МПР-60 или другое устройство).

Для использования в проекте доступны несколько типов станций. например:

* '''Станция''' - общий тип станции. Проекты с такой станцией могут выполняться на большинстве устройств - контроллеры, панели, персональные компьютеры. Чаще всего используется для проектов, предназначенных для выполнения на персональном компьютере.
* '''Панель ПО-40''' - специализированный тип для проектов на панелях оператора ПО-40. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.
* '''Панель ПО-50''' - специализированный тип для проектов на панелях оператора ПО-50. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.).
* '''Контроллер МПР-60''' - специализированный тип для проектов на программируемых реле МПР-60. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием устройства (светодиоды индикации и др.), использования корзины субмодулей.
* '''Контроллер ПЛК-70.A''' - специализированный тип для проектов, предназначенных для контроллеров АГАВА ПЛК-70.А. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием контроллера (светодиоды индикации и др.), использования корзины субмодулей.

При построении больших проектов станций в проекте может быть несколько, и они могут выполнять разные задачи. Например, станция-сервер выполняет сбор и регистрацию данных, клиентские станции выполняют визуализацию данных на рабочих местах и т. д.

Станции подчиняются узлы типа "Система" - Транспортная система, Система архивирования, Система визуализации и т. д.

== Транспортная система ==
Транспортная система управляет передачей данных по различным каналам связи. Система управляет работой "Транспортов" - узлов, выполняющих обмен данными с устройствами по определенному протоколу.

С одной стороны, транспортная система обращается непосредственно к сигналам и каналам устройства, а с другой стороны, представляет их в виде неких универсальных единиц – узлов-источников. Каждый источник однозначно соответствует определенному сигналу или параметру устройства. При изменении сигнала меняется и значение источника. При записи данных в источник производится подача команды устройству на установку определенного значения конкретного параметра.

Транспортная система допускает использование нескольких транспортов, что дает возможность одновременного обмена данными с большим количеством устройств по разным протоколам.

=== Транспорт ===
Транспорт предназначен для обмена данными с устройствами по определенному протоколу. Один транспорт, в зависимости от типа, позволяет обмениваться данными с одним или несколькими устройствами.

Доступны для использования следующие виды транспортов:

* Транспорт Modbus-TCP;
* Транспорт Modbus-RTU;
* Транспорт SNMP;
* Транспорт OPC UA;
* Транспорт OPC DA (только для Windows);
* Транспорт MQTT;
* Последовательный транспорт (устаревший);
* TCP/IP транспорт (устаревший).
Подробное описание транспортов приведено в отдельном документе "[[Транспорты AgavaSCADA/AgavaPLC]]".

==Система визуализации==
{{Внимание|Тип=Восклицание желтый.png|Текст=Система визуализации недоступна в проектах для контроллеров МПР}}

Задачей этой системы является отображение данных в виде набора мнемонических схем (экранов, мнемосхем), а также предоставление пользователю возможности управления.

Каждый экран позволяет в схематичном, понятном пользователю виде представить участок технологической схемы с отображением необходимых параметров технологического процесса.

Изображение на экране строится с помощью окон, на которых размещаются объекты визуализации – виджеты. Виджетами могут быть текстовые метки, изображения, в том числе анимированные, элементы управления, графики и т. д. Виджеты можно объединять в слои для удобного управления отображением виджетов.

Виджеты могут быть статическими и динамическими. Динамические виджеты привязаны к одному или нескольким сигналам и их отображение зависит от значений этих сигналов. Статические виджеты не имеют привязки к сигналам и их изображение всегда постоянно.

Для перехода по экранам, изменения значений параметров и иного управления служат специальные виджеты: кнопки управления, поля ввода и другие.

Для повышения быстродействия и увеличения комфортности работы с системой система визуализации хранит в памяти кэш из нескольких последних открытых экранов. Когда при последовательном открытии экранов этот кэш заполняется, наиболее старые экраны удаляются из него. Это связано с тем, что, как правило, в работе используются несколько одних и тех же экранов, которые отображают сводную информацию о техпроцессе и оператор в штатном режиме переключается только между ними. Сохраняя их в памяти, система ускоряет переключение между ними, поскольку при этом не требуется каждый раз создавать экран, все находящиеся на нем объекты и запускать процессы обновления параметров.

Когда экран переходит в кэш, обновление параметров на нем прекращается для снижения нагрузки на центральный процессор. Если все же необходимо, чтобы экран всегда производил обновление данных (по разным причинам), даже находясь в кэше, необходимо в его настройках включить опцию «Постоянно обновляемый».

Подчиненные типы узлов:

*фрейм;
*окно;
*композиция.

===Фрейм===
[[Файл:AgavaPLC–Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией.png|мини|Рисунок 23 – Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией]]
Фрейм – узел, предназначенный для группировки окон, отображаемых на определенном дисплее. Обеспечивает организацию окон в пространстве экрана, управление мониторами и границами отображения.

Если необходимо отобразить информацию на нескольких дисплеях одновременно, то для каждого из них нужно использовать отдельный фрейм. Окон во фрейме может быть несколько, однако они не могут накладываться друг на друга.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
|-
|Позиция X
|XCoord
|int
|Координата X левого верхнего угла фрейма
|Целое число
|-
|Позиция Y
|YCoord
|int
|Координата Y левого верхнего угла фрейма
|Целое число
|-
|Ширина
|XSize
|int
|Ширина фрейма в пикселях
|Целое число > 0
|-
|Высота
|YSize
|int
|Высота фрейма в пикселях
|Целое число > 0
|-
|Окна
|Windows
|NodesArray
|Список окон, принадлежащих фрейму
|Узлы типа: Window
|-
|Номер монитора
|DisplayNo
|int
|Номер монитора для отображения фрейма
|0 - по умолчанию
≥1 - конкретные мониторы
|-
|Тип границы
|BorderType
|enum
|Тип границы фрейма
|0: Не определен (ошибка)
1: Отсутствует

2: Фиксированная
|}

==== Позиция и размеры (XCoord, YCoord, XSize, YSize) ====

* '''Тип:''' int.
* '''Описание:''' Определяют положение и размеры фрейма на экране.
* '''Значения по умолчанию:''' (0, 0, 640, 480).
* '''Применение:''' Задание области экрана, которую занимает фрейм.

==== Окна (Windows) ====
'''Тип:''' NodesArray.

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

'''Особенности:'''

* Поддерживаются только узлы типа Window.

==== Номер монитора (DisplayNo) ====
'''Тип:''' int.

'''Описание:''' Определяет, на каком мониторе системы отображается фрейм. Значение 0 соответствует монитору по умолчанию.

'''Использование:'''

* 0 - основной монитор.
* 1, 2, ... - дополнительные мониторы.
* Свойство важно для многомониторных конфигураций.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип обрамления фрейма. Влияет на внешний вид и поведение границ.

'''Значения:'''

* '''Отсутствует''' - фрейм без видимых границ.
* '''Фиксированная''' - стандартная граница окна.
* '''Не определен''' - используется только для обработки ошибок.

==== Наследование привилегий ====
Фрейм автоматически добавляет доступные привилегии для работы с окнами:

* <code>OpenWindow</code> - привилегия на открытие окон.
* <code>CloseWindow</code> - привилегия на закрытие окон.

===Окна===
Окно – узел, осуществляющий отображение видеокадра (мнемонической схемы).

Существуют несколько видов окон:

1. «Форма», предназначенная для вывода простого набора данных без необходимости управления видимостью или внешним видом его элементов. Для вывода информации в такое окно кроме создания окна и добавления к нему виджетов ничего более не требуется.
[[Файл:AgavaPLC-Меню.png|мини|164x164пкс|Рисунок 24 — Внешний вид меню в среде исполнения]]
2. «Окно с композицией», предназначенное для вывода большого количества информации и позволяющее организовать группировку элементов по слоям, управлять внешним видом элементов, видимостью слоев и отдельных элементов, а также дающее возможность регулирования работы пользователя с элементами. Для вывода информации в такое окно нужно к окну привязать композицию, содержащую минимум один слой, в который уже добавляются виджеты.

=== Форма ===
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Модальность
|Modality
|enum
|Режим модальности окна
|0: Не определен (ошибка)
1: Немодальное

2: Модальное (Фрейм)

3: Модальное (Система)
|Чтение/Запись
|-
|Тип границы
|BorderType
|enum
|Тип границы окна
|0: Не определен (ошибка)
1: Фиксированная

2: Изменяемая

3: Отсутствует
|Чтение/Запись
|-
|Отображать строку заголовка
|TitleEnabled
|bool
|Отображать строку заголовка
|true/false
|Чтение/Запись
|-
|Отображать кнопку "Закрыть"
|CloseEnabled
|bool
|Отображать кнопку "Закрыть"
|true/false
|Чтение/Запись
|-
|Цвет фона
|BackgroundColor
|NColor
|Цвет фона окна
|Цвет в формате RGBA
|Чтение/Запись
|-
|Затемнение
|NeedDarkenApplication
|bool
|Затемнение других окон приложения при открытии этого окна
|true/false
|Чтение/Запись
|-
|Цвет затемнения
|ColorDarkenApplication
|NColor
|Цвет затемнения
|Цвет в формате RGBA
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов, мс
|0 - без задержки
>0 - интервал в мс
|Чтение/Запись
|-
|Действия OnShow
|ActionsOnShow
|NodesContainer
|Действия при показе окна
|Узлы типа: Action
|Чтение/Запись
|-
|Действия OnClose
|ActionsOnClose
|NodesContainer
|Действия при закрытии окна
|Узлы типа: Action
|Чтение/Запись
|}

==== Модальность (Modality) ====
'''Тип:''' enum.

'''Описание:''' Определяет поведение окна относительно других окон приложения.

'''Значения:'''

* '''Немодальное''' - позволяет взаимодействовать с другими окнами.
* '''Модальное (Фрейм)''' - блокирует взаимодействие с окнами в том же фрейме.
* '''Модальное (Система)''' - блокирует все окна приложения.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип и поведение границ окна.

'''Значения:'''

* '''Фиксированная''' - окно нельзя изменять размер.
* '''Изменяемая''' - пользователь может изменять размер окна.
* '''Отсутствует''' - окно без видимых границ.

==== Управление заголовком (TitleEnabled, CloseEnabled) ====
'''Тип:''' bool.

'''Описание:''' Контролируют отображение элементов заголовка окна.

==== Фон и затемнение (BackgroundColor, NeedDarkenApplication, ColorDarkenApplication) ====
'''Тип:''' NColor, bool, NColor.

'''Описание:''' Управляют визуальным оформлением окна и его влиянием на другие окна.

'''Особенности:'''

* Затемнение применяется только при NeedDarkenApplication = true.
* Цвет затемнения по умолчанию: черный с прозрачностью 50%.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Определяет частоту обновления виджетов в окне.

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчики событий (ActionsOnShow, ActionsOnClose) ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых при показе и закрытии окна.

=== Окно с композицией ===
Данный узел имеет те же свойства, что и форма, а также собственные:
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Композиция
|CompositionId
|NodeLink
|Основная композиция окна
|Узлы типа: CompositionLayered, CompositionTemplated
|Чтение/Запись
|-
|Описание текущей композиции
|CurrentCompositionDesc
|string
|Описание текущей загруженной композиции
|Автоматически формируется
|Только чтение
|}

==== Композиция (CompositionId) ====
'''Тип:''' NodeLink.

'''Описание:''' Ссылка на композицию, отображаемую в окне.

'''Поддерживаемые типы:''' CompositionLayered, CompositionTemplated.

==== Описание текущей композиции (CurrentCompositionDesc) ====
'''Тип:''' string.

'''Описание:''' Автоматически обновляемое описание загруженной композиции.

'''Особенности:''' Свойство только для чтения, обновляется системой автоматически.[[Файл:AgavaPLC-Настройка меню в среде разработки.png|мини|226x226пкс|Рисунок 25 — Настройка меню в среде разработки]]

===Композиция===
Композиция – узел, представляющий составленную при разработке проекта мнемоническую схему в виде набора элементов визуализации (виджетов), сгруппированных в один или несколько слоев.

Композиция дает возможность организовать виджеты в слои, видимостью которых можно управлять во время работы проекта.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Размеры
|Size
|NSize
|Размеры композиции
|Структура {ширина, высота}
|Чтение/Запись
|-
|Кэширование
|Cacheable
|bool
|Кэширование данных композиции для быстрого повторного открытия
|true/false
|Чтение/Запись
|-
|Источник интервала обновления
|UpdateIntervalSource
|enum
|Определяет источник интервала обновления виджетов
|0: Окно
1: Композиция
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов в миллисекундах
|Целое число ≥ 0
|Чтение/Запись
|-
|Действия OnLoad
|ActionsOnLoad
|NodesContainer
|Действия при загрузке композиции
|Узлы типа: Action
|Чтение/Запись
|}

==== Размеры (Size) ====
'''Тип:''' NSize (ширина, высота).

'''Описание:''' Определяет размеры композиции в пикселях. По умолчанию установлены значения 800x600.

==== Кэширование (Cacheable) ====
'''Тип:''' bool.

'''Описание:''' Включает или отключает кэширование данных композиции. При включенном кэшировании композиция сохраняется в памяти для быстрого повторного открытия.

'''Преимущества кэширования:'''

* Быстрое переключение между композициями.
* Снижение нагрузки на систему при частом использовании.
* Сохранение состояния элементов.

'''Рекомендации:''' Включать для часто используемых композиций, отключать для редко используемых или ресурсоемких.

==== Источник интервала обновления (UpdateIntervalSource) ====
'''Тип:''' enum.

'''Описание:''' Определяет, откуда виджеты композиции получают интервал обновления.

'''Значения:'''

* '''Окно''' - интервал обновления наследуется от родительского окна.
* '''Композиция''' - используется собственный интервал обновления композиции.

'''Применение:''' Централизованное управление производительностью через окно или индивидуальная настройка для каждой композиции.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Задает интервал обновления виджетов в миллисекундах. При значении 0 отрисовка виджетов выполняется без задержки (максимальная частота).

'''Особенности:'''

* 0 - обновление без задержек (может создать высокую нагрузку).
* > 0 - обновление с заданным интервалом. Учитывается только при UpdateIntervalSource = "Композиция"

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчик событий ActionsOnLoad ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых после загрузки композиции <code>AS 1.6.27+</code>.

===Слой===
Слой – набор виджетов, объединенных каким-то общим структурным признаком. В многослойных композициях слой обеспечивает организацию виджетов в z-порядке, управление видимостью и взаимодействием с пользователем. С помошью свойства "Видимость" слоя можно управлять видимостью виджетов, размещенных на слое.

Свойства
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Z-Порядок
|ZOrder
|int
|Порядок слоя в композиции
|Целое число (чем выше значение, тем выше слой)
|Чтение/Запись
|-
|Прозрачность для действий
|ActionTransparency
|enum
|Определяет поведение слоя при взаимодействии с пользователем
|0: Не определен (ошибка)
1: Непрозрачный

2: Прозрачный
|Чтение/Запись
|-
|Видимость
|Visible
|bool
|Видимость слоя и всех его виджетов
|true/false
|Чтение/Запись
|}

==== Z-Порядок (ZOrder) ====
'''Тип:''' int

'''Описание:''' Определяет порядок отображения слоя относительно других слоев в композиции. Слои с большим значением ZOrder отображаются поверх слоев с меньшим значением.

'''Пример использования:'''

* Фоновый слой: ZOrder = 1.
* Основной контент: ZOrder = 2.
* Контекстные виджеты: ZOrder = 3.

==== Прозрачность для действий (ActionTransparency) ====
'''Тип:''' enum

'''Описание:''' Управляет взаимодействием слоя с пользовательскими действиями (клики, наведения и т.д.)

'''Значения:'''

* '''Непрозрачный''' - слой полностью перехватывает пользовательские действия, элементы под ним недоступны, даже если они видимы.
* '''Прозрачный''' - пользовательские действия проходят сквозь слой к элементам ниже.

Обратите внимание: если на слое размещается изображение с прозрачной областью, то такие виджеты не позволяют пользователю взаимодействовать с видимыми и размещенными под ним виджетами.

==== Видимость (Visible) ====
'''Тип:''' bool

'''Описание:''' Определяет видимость всего слоя и всех его дочерних виджетов. При значении false слой и все его содержимое становится невидимым.

'''Применение:''' Временное скрытие виджетов или переключение их видимости.

===Виджет===
Виджет – элемент визуализации, предназначенный для отображения информации в заданном виде.

===Меню===
Меню – элемент визуализации, сочетающий в себе несколько виджетов «Кнопка». Используется для более удобного управления проектом (см. Рисунок 24).

Для добавления меню, необходимо в среде разработки назначить [[Универсальная среда разработки#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.9E.D1.82.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5 .D0.BC.D0.B5.D0.BD.D1.8E.C2.BB|действие «Отображение меню»]] для кнопки (или любого другого виджета). После добавления действия необходимо выделить его и нажать на кнопку настроек на панели вверху окна действий. Открывшееся окно (см. Рисунок 25) содержит дерево со структурой меню, в который можно добавлять элементы двух типов:

*меню – элемент, который позволяет группировать элементы меню, выводя их в виде раскрывающегося списка. На рисунках 24 и 25 этим элементом являются кнопки «Арочник» и «БПО».
*элемент меню – элемент, который предоставляет функционал, аналогичный [[Универсальная среда разработки#.D0.92.D0.B8.D0.B4.D0.B6.D0.B5.D1.82 .C2.AB.D0.9A.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0.C2.BB|виджету «Кнопка»]]. Для добавления действия, выполняющегося при нажатии на элемент меню в среде исполнения, необходимо нажать на него ПКМ в дереве структуры меню и выбрать "Создать действие". На рисунках 24 и 25 этим элементом являются кнопки «Котельная», «Котёл №1», «Котёл №2» и «Котёл №3».

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

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

# Добавить дополнительные фреймы, чтобы их количество в проекте соответствовало количеству дисплеев. Каждому фрейму назначить порядковый номер, начиная с 1. Фреймы связываются с дисплеями по номеру.
# Добавить дополнительное окно (или окна, если в исходном фрейме их несколько или дополнительных фреймов больше одного).
# Добавить в дополнительные фреймы созданные на этапе 2 окна, чтобы повторить структуру основоного фрейма.

Базовая настройка на этом закончена. После запуска такого проекта на двух или более дисплеях должны отображаться созданные окна.

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

===Виджеты===
====Виджет «Текстовая метка»====
[[Файл:AgavaPLC–Примеры оформления виджетов типа "Текстовая метка".png|мини|Рисунок 26 – Примеры оформления виджетов типа "Текстовая метка"]]
Виджет «Текстовая метка» – наиболее часто применяемый виджет, с помощью которого можно реализовать разные способы отображения текстовой информации.

Виджет «Текстовая метка» может использоваться для отображения статичного текста, значений параметров (одного или нескольких) и их комбинаций.

При необходимости отображения значений параметров они указываются в свойстве «Источник». Для задания определенного формата отображения используются спецификаторы формата в стиле языка «Си»:

*%f – значение в виде числа с плавающей точкой;
* %s – строка;
*%i – целое число со знаком;
*%u – целое число без знака;
* %d – целое число со знаком в десятичной системе исчисления.

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

Для отображения знака «%» необходимо указать его дважды: «%%».

===== Отображение нескольких значений =====
Одна текстовая метка может использоваться для отображения нескольких значений. Для этого все значения, которые нужно отобразить, указываются в свойстве «Источник», а в свойстве «Текст» указываются последовательно несколько спецификаторов формата соответственно порядку перечисления значений в свойстве «Источник».

Пример: текстовая метка, отображающая текущую позицию в очереди:

* Текст: <code>Позиция %i из %i</code>
* Источник: два узла из проекта.

=====Модификаторы спецификаторов формата=====

======Модификатор минимальной ширины поля======
Целое число, расположенное между знаком % и кодом формата, играет роль модификатора минимальной ширины поля. Если указан модификатор минимальной ширины поля, то, чтобы ширина поля вывода была не меньше указанной минимальной величины, вывод при необходимости будет дополнен пробелами. Если же выводятся строки или числа, которые длиннее указанного минимума, то они все равно будут отображаться полностью. По умолчанию для дополнения используются пробелы. А если для этого надо использовать нули, то перед модификатором ширины поля следует поместить 0. Например, %05i означает, что любое число, количество цифр которого меньше пяти, будет дополнено таким количеством нулей, чтобы состоять из пяти цифр.

Примеры
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%i
|10
|-
|10.123
|%d
|10
|-
|10.123
|%05i
|00010
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
| 10.1
|-
|10.123
|%10f
|<пробел>10.123000
|-
|10.123
|%012f
|00010.123000
|}

======Модификатор точности======
Модификатор точности следует за модификатором минимальной ширины поля (если таковой имеется). Он состоит из точки и расположенного за ней целого числа. Значение этого модификатора зависит от типа данных, к которым его применяют.

Когда модификатор точности применяется к данным с плавающей точкой, для преобразования которых используются спецификаторы преобразования %f, %e или %E, то он определяет количество выводимых десятичных разрядов. Например, %10.4f означает, что ширина поля вывода будет не менее 10 символов, причем для десятичных разрядов будет отведено четыре позиции.

Если модификатор точности применяется к %g или %G, то он определяет количество значащих цифр.

Примененный к строкам, модификатор точности определяет максимальную длину поля. Например, %5.7s означает, что длина выводимой строки будет составлять минимум пять и максимум семь символов. Если строка окажется длиннее, чем максимальная длина поля, то конечные символы выводиться не будут.

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

Примеры:
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
|10.1
|-
|10.123
|%10.4f
|<пробел><пробел><пробел>10.1230
|-
|10.123
|%010.3f
|000010.123
|-
| Это простая проверка
|%10.15s
|Это простая про
|}

====Виджет «Условная метка» ====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условная метка".png|мини|Рисунок 27 – Список сопоставлений виджета "Условная метка"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условная_метка%22.png]]
Виджет «Условная метка» позволяет изменять выводимую строку в соответствии с изменениями привязанной к ней переменной.

Задать соответствие текста необходимому условию можно в свойстве «Список сопоставлений».

==== Виджет «Изображение»====
Виджет «Изображение» предназначен для отображения на окнах статичных изображений форматов png, gif, jpg, bmp или анимированных изображений в формате gif. Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Условное изображение»====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условное изображение".png|мини|Рисунок 28 – Список сопоставлений виджета "Условное изображение"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условное_изображение%22.png]]
Виджет «Условное изображение» позволяет изменять отображаемое изображение в соответствии с изменениями привязанной к нему переменной.

Задать соответствие изображения необходимому условию можно в свойстве «Список сопоставлений».

====Виджет «Движущееся изображение»====
Виджет предназначен для отображения на окнах изображений, перемещающихся в пределах области виджета. В основном используются на экране спящего режима.

Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Кнопка»====
Виджет «Кнопка» предназначен для реализации функций управления:

*ввод данных;
*передача управляющих воздействий;
* смена режима работы АРМ или иного устройства, исполняющего проект.

Выполнение всех функций виджета обеспечивается с помощью узлов типа «Действие», добавляемых в соответствующее свойство (см. раздел [[#Действия]]).

====Виджет «Гистограмма»====
[[Файл:AgavaPLC–Виджет "Гистограмма".png|мини|Рисунок 29 – Виджет "Гистограмма"|ссылка=Файл:AgavaPLC–Виджет_%22Гистограмма%22.png]]
Виджет предназначен для отображения значений сигналов в виде столбчатой диаграммы.

Виджету необходимо задать источник (регистр/сигнал, с которого он будет получать данные), а также минимальное и максимальное значения.

====Виджет «Исторический график»====
Виджет «Исторический график» предназначен для отображения графиков параметров на двухкоординатной области изображения с привязкой к осям времени и значений.

Виджет может работать с данными, архивируемыми в БД, и напрямую с сигналами, значения которых вычисляются в ходе работы.

При работе с архивируемыми данными интервал обновления графика зависит от режима выдачи значения у базы данных: при выборе сохраняемых в БД он будет соответствовать интервалу архивирования, а при сохраненных в БД - интервалу сохранения БД на диск. Независимо от режима выдачи, график не может обновляться меньше чем за 300 мс.

При работе напрямую с сигналами график обновляется при изменении значения сигнала, но также не чаще чем раз в 300 мс.
[[Файл:AgavaPLC–Экран «Архив» с виджетом «Исторический график».png|мини|Рисунок 30 – Виджет «Исторический график». Области кнопок-пиктограмм. В нижней части отображена легенда]]
Виджет «Исторический график» состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода данных.

На виджете имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 28):

#область пиктограмм графика;
#область пиктограмм оси времени (X);
#область пиктограмм оси значений (Y);
#область легенды.

В области пиктограмм графика слева направо расположены следующие кнопки-пиктограммы:

* кнопка переключения режима отображения точек на всех кривых;
* кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси времени (X) слева направо расположены следующие кнопки-пиктограммы:

*кнопка открытия окна выбора интервала времени для оси Х, текст кнопки отображает текущий выбранный интервал, например: 5М – 5 минут, 6Ч – 6 часов, 30М – 30 минут;
*кнопка-индикатор включения следящего режима.

В области пиктограмм оси значений (Y) расположена кнопка-пиктограмма «A» – кнопка переключения режима автоматического масштабирования значений.

=====Легенда=====
[[Файл:AgavaPLC–Легенда с четырьмя выключенными параметрами.png|мини|Рисунок 31 – Легенда с четырьмя выключенными параметрами]]
Легенда – специальная область в нижней части экрана архива, предназначенная для отображения параметров (наименование, текущее значение и т. д.) выводимых графиков в виде таблицы. Для ознакомления с примерным видом легенды см. Рисунок 31. Информация о каждом сигнале в легенде выводится в несколько колонок:

*«Цвет» – индицирует цвет, которым выводится соответствующая кривая на графике, колонка «Цвет» позволяет нажатием переключать видимость соответствующей кривой на графике (см. Рисунок 29). Также в колонке "Цвет" отображается номер пера, которым выводится кривая параметра на графике;
* «Имя» («Наименование») – содержит наименование параметра;
*«Время» – содержит время последнего зарегистрированного значения параметра;
*«Значение» – содержит последнее зарегистрированное значение параметра.

=====Режимы просмотра графиков=====
Пользователю доступно два режима просмотра графиков:

*следящий режим;
*режим просмотра истории.

В следящем режиме на графике всегда отображаются актуальные значения параметров, тренд периодически дочитывает поступившие данные из базы и обновляет графики.

В режиме просмотра истории на графике отображаются исторические значения параметров. Просмотр истории технологического процесса осуществляется с помощью кнопок перемещения по осям и кнопок изменения масштаба.

Режим просмотра истории включается автоматически при прокрутке графика назад по времени.

=====Визирная линия=====
[[Файл:AgavaPLC–График в режиме просмотра истории с установленной визирной линией.png|мини|Рисунок 32 – График в режиме просмотра истории с установленной визирной линией]]
Для просмотра значений параметров в нужный момент времени служит визирная линия, отображаемая на графике как вертикальная линия.

При щелчке левой кнопкой мыши (ЛКМ) в области графиков визирная линия будет отображена в выбранном месте графика.

В точке пересечения визирной линии и кривых параметров отображаются значения этих параметров. Также в нижней части области графиков, возле оси времени, визирная линия отображает время.

====Виджет «График кусочно-линейной функции»====
Виджет предназначен для отображения графика зависимости двух параметров, расположенном на осях X и Y.
[[Файл:AgavaPLC–Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм..png|мини|Рисунок 33 – Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм.]]
Виджет состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода графика.

На области вывода графика виджета имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 33):

#Область пиктограмм графика.
#Область пиктограмм оси первого параметра (X).
#Область пиктограмм оси второго параметра (Y).

В области пиктограмм графика расположены следующие кнопки-пиктограммы:

*кнопка переключения режима отображения точек на всех кривых;
*кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси первого (X) и второго (Y) параметров расположены кнопки-пиктограммы «А» – кнопка переключения режима автоматического масштабирования значений.[[Файл:AgavaPLC–Виджет "Список событий".png|мини|Рисунок 34 – Виджет "Список событий"|ссылка=Файл:AgavaPLC–Виджет_%22Список_событий%22.png]]
====Виджет «Список событий»====
[[Файл:AgavaPLC–Окно выбора интервала.png|мини|Рисунок 35 – Окно выбора интервала]]Виджет предназначен для отображения регистрируемых событий в работе.

В верхней части виджета расположена панель управления (1).

Панель управления содержит органы управления журналом:

*кнопка отображения фильтра событий;
*кнопка включения следящего режима журнала;
*кнопка изменения интервала на один день назад;
*кнопка-индикатор выбора интервала, за который отображаются события;
*кнопка изменения интервала на один день вперед;
*кнопка вызова окна со списком активных тревог.

Ниже панели управления, в основном поле экрана, расположена таблица, содержащая зарегистрированные события.

Заголовок таблицы позволяет изменять порядок столбцов и включать сортировку по столбцам. Например, возможно включение сортировки событий сначала по времени, затем по группе. Заголовок таблицы имеет возможность отключения / включения отображения любого столбца.

При большом количестве записей в правой части таблицы появляется полоса прокрутки, позволяющая пролистывать список событий.

Нажатие на кнопку-индикатор выбора интервала вызывает окно выбора интервала (см. Рисунок 35):[[Файл:AgavaPLC–Окно "Фильтр".png|мини|Рисунок 36 – Окно "Фильтр"|ссылка=Файл:AgavaPLC–Окно_%22Фильтр%22.png]]После выбора нужного интервала для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события за выбранный интервал.
Нажатие на кнопку отображения окна фильтра вызывает соответствующее окно. Окно фильтра позволяет изменить содержимое основного окна журнала событий путем выбора групп и подгрупп событий, перечисленных в окне фильтра (см. Рисунок 36).

После выбора нужных групп и подгрупп для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события, принадлежащих выбранным группам.

====Виджет «Ввод значения»====
Виджет «Ввод значения» предназначен для отображения значения привязанного сигнала и его редактирования.
[[Файл:AgavaPLC–Виджет «Ввод значения» с отображением экранной цифровой клавиатуры.png|мини|Рисунок 37 – Виджет «Ввод значения» с отображением экранной цифровой клавиатуры|212x212пкс]]
После выбора узла для чтения/записи и соответствующего типа значения необходимо выбрать нужный тип ввода в разделе «Оформление».

Доступны следующие типы ввода:

*кнопки изменения – при нажатии на виджет появляются кнопки увеличения и уменьшения на заданный шаг изменения;
*кнопка редактирования – при нажатии на виджет появляется кнопка, при клике на которую открывается экранная цифровая клавиатура;

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

====Виджет «Выбор значения из списка»====
[[Файл:AgavaPLC–Виджет «Выбор значения из списка».png|мини|Рисунок 38 – Виджет «Выбор значения из списка»]]
Виджет «Выбор значения из списка» предназначен для отображения значения привязанного сигнала и его изменения в удобном для пользователя текстовом виде (см. Рисунок 37).

С помощью свойства «Список сопоставлений» задается соответствие между значением сигнала и выводимой в виджете строкой.

При нажатии на кнопку в правой части виджета отображается список всех сопоставлений. При выборе нужного элемента в списке в установленный узел производится запись нового значения.

====Виджет «Флаг»====
[[Файл:AgavaPLC–Варианты внешнего вида виджета «Флаг».png|мини|Рисунок 39 – Варианты внешнего вида виджета «Флаг»]]
Виджет «Флаг» предназначен для отображения значения и изменения булевой переменной (true/false). Состояние true отображается в виде галочки (см. Рисунок 38).

При нажатии на виджет значение переменной изменяется на противоположное.

В случае, если флаг необходимо использовать только для отображения информации, поставьте галочку в свойстве «Отключен»

====Виджет «Отчет»====
[[Файл:AgavaPLC–Виджет «Отчет» в режиме отображения сформированного отчета.png|мини|Рисунок 40 – Виджет «Отчет» в режиме отображения сформированного отчета]]
Виджет «Отчет» предназначен для формирования отчетов по заранее спроектированному макету.

Подробный порядок создания и редактирования отчетов приведен в разделе [[#Отчеты]].
[[Файл:AgavaPLC–Окно выбора интервала отчета.png|мини|Рисунок 41 – Окно выбора интервала отчета]]
В верхней части виджета размещена панель управления, содержащая кнопки вызова команд:

* печать сформированного отчета на установленном в системе принтере;
*сохранение сформированного отчета в файле формата PDF;
*переход к предыдущей странице отчета;
*переход к следующей странице отчета;
*масштабирование экрана по ширине листа отчета;
*масштабирование экрана по высоте листа отчета.

При формировании отчета для изменения интервала времени, за который будет формироваться отчет, необходимо на панели управления щелкнуть кнопку выбора интервала (на ней отображается текущий выбранный интервал, например, «Начало суток без смещения – Конец суток без смещения»). Далее появится окно «Интервал», в котором можно выбрать начало и конец интервала (см. Рисунок 41).

В качестве начала и конца интервала можно выбрать как конкретную дату по календарю, так относительную, например, «Начало дня», "Конец недели". После выбора желаемого интервала необходимо нажать кнопку «ОК».

Выбранный интервал отобразится на панели управления отчетом. Для формирования отчета за выбранный интервал необходимо нажать кнопку «Сформировать отчет». Через некоторое время, после загрузки данных из БД и их обработки, экран обновится и сформированный отчет за выбранный интервал будет отображен.

{{Шаблон:Действия AgavaSCADA/AgavaPLC}}

==Система тревог==
Система тревог предназначена для оповещения пользователя об обнаруженных нарушениях.

Система содержит два типа узлов:

*Группа событий.
*Контроллер событий.

===Группа событий===
Группа событий – узел, предназначенный для взаимодействия с виджетом «Список событий». Группы событий позволяют группировать события по какому-то признаку, например по уровню тревоги (авария, предупреждение, квитирование и т.д.), технологическому участку и т.д.

Для каждой группы можно выбрать свой цвет шрифта и фона, которые будут использоваться для вывода событий, принадлежащих этой группе в виджете "Список событий".

В свойстве «Описание» группы событий указывается текст, который будет отображаться в фильтре списка событий.

===Монитор событий===
Монитор событий (ранее - Контроллер событий) – узел, реализующий логику проверки соответствия выбранных сигналов контролируемым условиям. Контроллеры событий выполняют всю работу по проверке значений контролируемых параметров и выполнению соответствующих действий.

Монитор событий проверяет значения заданных узлов на соответствие заданным условиям и при их совпадении выполняет заданные действия.

В качестве действий можно указать не только действие "Создание события", но и другие (см. раздел [[#Действия]]).
[[Файл:AgavaPLC-Cистема тревог.png|мини|Cистема тревог]]

===Порядок настройки системы===
Порядок настройки системы тревог следующий:
#Добавить в проект систему тревог. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система тревог».
#Добавить узел «События» в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Группа» - «События». При необходимости настроить цвет шрифта и фона, которые будут отображаться у события в окне тревог или журнале.
#Добавить нужные [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|группы событий]] в узел «События». Для этого нажать ПКМ по узлу «События» в дереве проекта, затем выбрать «Добавить узел» - «Группа событий».
#Добавить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9A.D0.BE.D0.BD.D1.82.D1.80.D0.BE.D0.BB.D0.BB.D0.B5.D1.80 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|контроллеры событий]] в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Контроллер событий».
#Добавить в свойство «Сигналы» контроллеров событий узлы, состояние которых необходимо контролировать.
#Задать для этих узлов контролируемые условия в соответствующем свойстве контроллера событий.
#Настроить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действия]], которые будут выполняться при выполнении контролируемого условия. Для вывода аварий, предупреждений или информационных сообщений необходимо добавить действие «Создание события».
# Настроить действие «Создание события». В его свойстве «Группа событий» указать группу из созданных в пункте 2. Ввести тексты сообщения активации и деактивации (при необходимости), указать уровень события. Теперь, при срабатывании контролируемого условия, будет появляться окно тревог с сообщением активации.

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

Архивация параметров производится с помощью архиваторов. Архиваторы SQLite и PostgreSQL могут выполнять [[Узлы проекта AgavaSCADA/AgavaPLC#Прореживание данных|прореживание данных]].
[[Файл:AgavaPLC-Настройка архиватора.png|мини|505x505пкс|Настройка архиватора]]

===Порядок настройки системы===
Для сохранения истории изменения значений параметров в БД необходимо выполнить следующие действия:

#Добавить в проект систему архивации. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система архивации».
#Добавить в систему архивации архиватор. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем выбрать «Добавить узел» - «Архиватор в БД SQLite».
#Настроить параметры архиватора, такие как: путь до файла БД, интервал архивирования (как часто система архивации будет опрашивать значение параметра), интервал сохранения БД на диск (как часто эти значения будут записываться в постоянную память), разбиение БД (будет ли система архивации создавать новый файл БД каждые сутки), период хранения и режим выдачи значений для построения графика (сохраняемые значения будут обновляться с частотой интервала архивирования, а сохраненные - с частотой интервала сохранения).
#Добавить параметры в коннекторы база данных. Для этого необходимо открыть свойство архиватора «Коннекторы БД», выбрать «Создать новый» - «Коннектор БД». После этого нужно нажать по добавленному коннектору, открыть его свойство «Сигналы» и добавить параметр, значение которого необходимо сохранять в БД.

=== Архиватор SQLite===
Архиватор SQLite предназначен для сохранения значений параметров в БД формата SQLite.

Для извлечения и просмотра баз данных формата SQLite с устройств может использоваться программа «[[Архиватор]]».

====Свойства узла "Архиватор SQLite"====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
| Путь до файла БД
|FilePath
|STRING
|Чтение / запись
|Путь до файла БД. Абсолютный или относительный.
|-
|Интервал архивирования
|Interval
|INT
|Чтение / запись
|Интервал архивирования, мс.
|-
|Период хранения
|Retention
|INT
|Чтение / запись
|Период хранения, дней.
|-
|Разбиение БД
|DBSplitting
|BOOL
|Чтение / запись
|Разбиение БД на файлы. При включении база данных будет разделяться на отдельныйе файлы, содержащие данные за одни сутки.
|-
|Интервал сохранения БД на диск
|StoringInterval
|INT
|Чтение / запись
|Интервал сохранения БД на диск, мс.
|-
|Режим выдачи значений
|ValueReturnMode
|ENUM
|Чтение / запись
|Режим выдачи значений. Режим "Сохраняемые в БД" - данные выдаются сразу после получения архиватором, возможно до фактического сохранения в БД. Режим "Сохраненные в БД" - данные выдаются только после фактической записи в БД на диск.
|-
|Коннекторы БД
|Signals
|NODESARRAY
|Чтение / запись
|Список коннекторов, содержащих сигналы для архивирования.
|-
|Текущий размер БД
|DBCurrentSize
|INT
|Только чтение
|Текущий размер БД, Мб.
|-
|Максимальный размер БД
|DBMaxSize
|INT
|Только чтение
|Максимальный размер БД, Мб.
|-
|Состояние БД
|DBStatus
|INT
|Только чтение
|Состояние БД.
|}

==== Статусы операций SQLite ====
В ходе работы SQLite возвращает статус выполнения операций в виде целочисленных значений. Далее приведена расшифровка этих кодов.
{| class="wikitable"
!Код
!Краткое описание
!Подробное объяснение
|-
|'''0 (SQLITE_OK)'''
|Успешно
|Операция завершилась без ошибок. Всё прошло штатно.
|-
|'''1 (SQLITE_ERROR)'''
|Общая ошибка
|Непредвиденная ошибка SQL. Может быть вызвана синтаксической ошибкой в запросе или другой общей проблемой. Пользователю стоит проверить SQL-запрос.
|-
|'''2 (SQLITE_INTERNAL)'''
|Внутренняя ошибка
|Ошибка в логике самой SQLite. Обычно не связана с действиями пользователя.
|-
|'''3 (SQLITE_PERM)'''
|Нет доступа
|Недостаточно прав для выполнения операции (например, чтение/запись файла базы данных). Нужно проверить права доступа.
|-
|'''4 (SQLITE_ABORT)'''
|Прервано
|Выполнение операции было прервано обратным вызовом (callback). Обычно не ошибка, а результат логики программы.
|-
|'''5 (SQLITE_BUSY)'''
|База данных занята
|Файл БД заблокирован другим процессом. Нужно подождать или повторить попытку позже.
|-
|'''6 (SQLITE_LOCKED)'''
|Таблица заблокирована
|Конкретная таблица заблокирована другим соединением. Нужно освободить блокировку или использовать WAL-режим.
|-
|'''7 (SQLITE_NOMEM)'''
|Недостаточно памяти
|Не удалось выделить память. Проблема на уровне системы, а не базы.
|-
|'''8 (SQLITE_READONLY)'''
|Только для чтения
|Попытка записи в базу, открытую в режиме "только чтение". Нужно открыть её с правом записи.
|-
|'''9 (SQLITE_INTERRUPT)'''
|Прервано пользователем
|Операция остановлена вызовом <code>sqlite3_interrupt()</code>. Обычно пользователь сам прерывает длительный запрос.
|-
|'''10 (SQLITE_IOERR)'''
|Ошибка ввода/вывода
|Ошибка чтения или записи с диска. Может означать сбой диска или проблемы с файловой системой.
|-
|'''11 (SQLITE_CORRUPT)'''
|Повреждённая база
|Файл базы данных повреждён. Необходимо восстановление из резервной копии.
|-
|'''12 (SQLITE_NOTFOUND)'''
|Неизвестная операция
|Обнаружен неизвестный код операции при работе с файловым интерфейсом. Обычно внутренняя ошибка.
|-
|'''13 (SQLITE_FULL)'''
|Нет места
|Диск или файл достиг предельного размера. Нужно освободить место.
|-
|'''14 (SQLITE_CANTOPEN)'''
|Не удалось открыть файл
|SQLite не смогла открыть базу данных. Возможны проблемы с путём или правами доступа.
|-
|'''15 (SQLITE_PROTOCOL)'''
|Ошибка протокола блокировки
|Нарушен внутренний протокол синхронизации между процессами. Обычно связано с конкурентным доступом.
|-
|'''16 (SQLITE_EMPTY)'''
|Внутреннее использование
|Этот код зарезервирован, не используется в обычных операциях.
|-
|'''17 (SQLITE_SCHEMA)'''
|Схема изменилась
|Во время выполнения запроса изменена структура таблицы или индекса. Запрос нужно выполнить заново.
|-
|'''18 (SQLITE_TOOBIG)'''
|Слишком большие данные
|Строка или BLOB превышают допустимый размер. Нужно уменьшить данные.
|-
|'''19 (SQLITE_CONSTRAINT)'''
|Нарушено ограничение
|Нарушено ограничение (например, UNIQUE, FOREIGN KEY, CHECK). Данные не могут быть вставлены/обновлены.
|-
|'''20 (SQLITE_MISMATCH)'''
|Несовпадение типов
|Тип данных не соответствует ожидаемому (например, текст в числовом поле).
|-
|'''21 (SQLITE_MISUSE)'''
|Некорректное использование API
|Функции SQLite использованы неправильно. Ошибка в коде программы, а не в данных.
|-
|'''22 (SQLITE_NOLFS)'''
|Нет поддержки файловой системы
|Операция требует возможности, которой нет в ОС (например, большие файлы на старой FS).
|-
|'''23 (SQLITE_AUTH)'''
|Отказ в авторизации
|Запрос отклонён по соображениям безопасности (например, триггер или расширение).
|-
|'''24 (SQLITE_FORMAT)'''
|Не используется
|Код зарезервирован, не применяется.
|-
|'''25 (SQLITE_RANGE)'''
|Параметр вне диапазона
|Неверный индекс параметра при связывании (<code>sqlite3_bind_*</code>). Ошибка в логике кода.
|-
|'''26 (SQLITE_NOTADB)'''
|Не база данных
|Файл, открытый как база, не является файлом SQLite. Возможно, повреждён или подменён.
|-
|'''27 (SQLITE_NOTICE)'''
|Уведомление
|Сообщение информационного характера из <code>sqlite3_log()</code>. Не ошибка.
|-
|'''28 (SQLITE_WARNING)'''
|Предупреждение
|Сообщение о потенциальной проблеме из <code>sqlite3_log()</code>. Обычно не критично.
|-
|'''100 (SQLITE_ROW)'''
|Есть ещё данные
|<code>sqlite3_step()</code> вернул строку данных — нужно вызывать дальше, чтобы получить все строки.
|-
|'''101 (SQLITE_DONE)'''
|Завершено
|<code>sqlite3_step()</code> завершил выполнение без ошибок. Все строки обработаны.
|}

=== Архиватор PostgreSQL ===
Архиватор PostgreSQL предназначен для сохранения значений параметров в базы данных под управлением сервера PostgreSQL.

=== Прореживание данных ===
Прореживание данных (data thinning) — это процесс фильтрации и уменьшения количества точек данных, сохраняемых в архиве. Вместо того чтобы записывать каждое полученное значение, система анализирует поток данных и сохраняет только те значения, которые представляют значимое изменение.

'''Назначение прореживания'''

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

* '''Снижение нагрузки на архив''': Меньшее количество записей означает более быструю работу базы данных.
* '''Ускорение отображения графиков''': Нужно обрабатывать меньше точек для построения трендов.
* '''Сохранение только значимых изменений''': Система отфильтровывает шум и оставляет только те изменения, которые важны для анализа технологического процесса.
'''Общий принцип работы'''

Алгоритм прореживания работает по простому принципу:

# SCADA-система получает новое значение от источника данных.
# Она сравнивает это значение с последним, которое было сохранено в архив.
# Если изменение превышает заранее настроенный '''допуск''' (tolerance), новое значение сохраняется.
# Если изменение меньше допуска, значение пропускается.

Кроме того, существует параметр "'''Период обязательной записи"'''. Если с момента последней записи прошло больше времени, чем указано в этом параметре, новое значение будет сохранено '''независимо от его изменения'''. Это гарантирует, что записи в архив будут сохраняться не реже заданной периодичности, даже если сигнал не меняется. Ключевая идея: "'''Сохраняем только то, что заметно изменилось, но не реже, чем задано".'''

'''Как подобрать допуск?'''

* '''Слишком малый допуск''' приведёт к записи избыточных данных, и архив будет быстро расти.
* '''Слишком большой допуск''' может привести к потере мелких, но значимых изменений в сигнале.

Выбор правильного допуска — это компромисс между детализацией данных и размером архива.
==== Типы алгоритмов прореживания ====
В системе доступны несколько алгоритмов, которые определяют, как именно вычисляется «значимость» изменения. Выбор алгоритма зависит от характера сигнала и требований к точности данных.

# [[Узлы проекта AgavaSCADA/AgavaPLC#Абсолютный допуск|Абсолютный допуск]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от последнего значения|Процент от последнего значения]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего N последних|Процент от среднего N последних]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего по временному окну|Процент от среднего по временному окну]]

'''Обозначения и определения'''

В дальнейшем используются следующие обозначения (для числовых сигналов):

* <math>x_{in}</math> — текущее измерение сигнала, полученное от источника данных к моменту обработки (кандидат на запись).
* <math>x_{ref}</math> — последнее сохранённое числовое значение сигнала в архиве на момент обработки (опорное значение).
* <math>|\Delta| = |x_{in} - x_{ref}|</math> — абсолютная величина изменения между текущим измерением и последним сохранённым значением.
* <math>\bar{x}_N</math> — арифметическое среднее последних <math>N</math> сохранённых числовых значений.
* <math>\bar{x}_T</math> — среднее всех сохранённых числовых значений, чьи метки времени попадают в временное окно длительности <math>T</math> миллисекунд.
* <math>\varepsilon</math> — машинная точность для чисел двойной точности; используется для формальной проверки «близости к нулю».
* <math>tolerance</math> — допуск: абсолютный (в физических единицах) или относительный (в процентах), в зависимости от выбранного алгоритма.

'''Настройки в Свойствах архиватора, общие для всех типов прореживания'''

* '''Включить прореживание''' — включает/выключает применение алгоритма прореживания при записи значений. При выключении все поступающие значения сохраняются без фильтрации.
* '''Тип допуска''' — выбирает алгоритм сравнения.
* '''Период обязательной записи (мс)''' — максимальный допустимый промежуток между двумя записями одного сигнала. Если за это время значимого изменения не произошло, ближайшее поступившее значение будет записано принудительно. 0 — отключить принудительную запись.

===== Абсолютный допуск =====
'''Принцип:'''

Новое значение сохраняется, если модуль изменения больше установленного порога в физических единицах.

<math display="block">|\Delta| > tolerance</math>

'''Когда использовать:'''

* Если диапазон сигнала стабилен и известен заранее.
* Для параметров вроде температуры, давления, уровня жидкости, где фиксированное изменение имеет одинаковую интерпретацию по всей шкале.

'''Преимущества:'''

* Обеспечивает предсказуемое и детерминированное поведение независимо от текущего масштаба значения.
* Не требует накопления или хранения дополнительных данных (окон/истории), вычислительно прост.
* Удобен при наличии нормативно заданных пределов точности в физических единицах.

'''Ограничения:'''

* Не масштабируется на широкий динамический диапазон: один и тот же порог может быть слишком грубым для малых значений и слишком чувствительным для больших.
* Требует аккуратного подбора порога под единицы измерения и разрешение датчика; при неверной калибровке возможны либо избыточные записи, либо потеря значимых мелких изменений.
* Не учитывает относительный контекст изменения (например, 1 единица при значении 10 и при значении 10 000 трактуется одинаково).

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — абсолютный порог в физических единицах сигнала. Определяет значение <math>tolerance</math>.

===== Процент от последнего значения =====
'''Принцип:'''

Новое значение сохраняется, если относительное изменение относительно последнего сохранённого превышает заданный процент.

<math display="block">\frac{|\Delta|}{|x_{ref}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов, где важна относительная динамика, а не абсолютные величины.
* Для показателей с большим динамическим диапазоном, где относительная точность должна быть сопоставима на всех уровнях.

'''Преимущества:'''

* Масштабируемость: одинаково интерпретирует относительные изменения на низких и высоких уровнях сигнала.
* Не требует хранения окна значений; использует только последнее сохранённое значение, поэтому вычислительно лёгок.
* Быстро и корректно реагирует на пропорциональные изменения процесса (проценты), поддерживая заданную относительную чувствительность.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).
* При малых базовых значениях возможна повышенная чувствительность к шуму и микроколебаниям.
* Не подавляет высокочастотный шум сам по себе: при необходимости сочетать с обязательной записью по времени и корректной настройкой допуска.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

===== Процент от среднего N последних =====
'''Принцип:'''

Новое значение сохраняется, если изменение больше заданного процента от среднего по последним N сохранённым значениям.

<math display="block">\frac{|\Delta|}{|\bar{x}_{N}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с постоянным шумом или пульсациями, когда важно снижать чувствительность к случайным отклонениям.
* Для процессов с умеренной динамикой, где требуется устойчивость к «зубчатым» колебаниям.

'''Преимущества:'''

* Снижает чувствительность к высокочастотному шуму за счёт опоры на усреднение; сокращает объём записей на стационарных участках.
* Гибко настраивается параметром <math>N</math>: увеличение окна повышает устойчивость, уменьшение — повышает чувствительность и снижает задержку реакции.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).

* Инерционность: при резких скачках возможна задержка фиксации изменения, особенно при большом <math>N</math>.
* Усреднение может «сглаживать» и не фиксировать кратковременные, но важные пики; не подходит для задач, критичных к коротким экстремумам.
* Предполагает относительно стабильную частоту выборок; при сильно переменной частоте эффективная «временная» ширина окна становится непредсказуемой.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Размер окна среднего (<math>N</math>)''' — число последних сохранённых значений, по которым считается среднее. Большее <math>N</math> повышает устойчивость к шуму, но увеличивает инерционность реакции.

===== Процент от среднего по временному окну =====
'''Принцип:'''

Похож на предыдущий, но среднее считается не по количеству точек, а по всем значениям за заданный интервал времени.

<math display="block">\frac{|\Delta|}{|\bar{x}_{T}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с непостоянной частотой измерений (событийные, неравномерные потоки).
* В случаях, когда важно учитывать реальную временную протяжённость усреднения независимо от плотности измерений.

'''Преимущества:'''

* Корректно работает при переменной частоте выборок: окно фиксируется по времени, а не по числу точек.
* Более реалистично оценивает тренд во времени на участках с неравномерными измерениями.
* Управляемый компромисс между подавлением шума и чувствительностью за счёт выбора длительности окна.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).

* Более высокая ресурсоёмкость: требуется хранить и периодически «очищать» значения по условию выхода из временного окна; потребление памяти зависит от фактической скорости поступления данных.
* Инерционность, присущая усреднению: возможна задержка фиксации коротких, но значимых пиковых изменений.
* Критичен выбор длительности окна: слишком малое окно даёт мало подавления шума, слишком большое — чрезмерную инерцию и риск пропуска кратких событий.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Интервал архивирования''' — длительность временного окна <math>T</math> (мс), в пределах которого вычисляется среднее. При увеличении <math>T</math> растёт сглаживание и уменьшается чувствительность к кратким всплескам; при уменьшении — наоборот. Значения, чьи метки времени выходят за пределы окна, автоматически исключаются из расчёта.

==== Примечание к алгоритмам 'Процент от…' ====
При малых опорных значениях система автоматически переходит в абсолютный режим, чтобы избежать деления на величину, близкую к нулю, и связанных с этим скачков чувствительности. Этот механизм применяется ко всем алгоритмам, использующим относительное сравнение: «Процент от последнего», «Процент от среднего N», «Процент от среднего по временному окну» и обеспечивает стабильность критерия при слабых сигналах.

* Условия входа в режим абсолютного допуска:
** для «Процента от последнего»: <math>|x_{ref}| < \varepsilon</math>;
** для «Процента от среднего N»: <math>|\bar{x}_{N}| < \varepsilon</math>;
** для «Процента от среднего по времени»: <math>|\bar{x}_{T}| < \varepsilon</math>.
* Критерий в режиме абсолютного допуска: значение фиксируется, если <math>|\Delta| > tolerance</math>.
* Условие выхода: как только соответствующая базовая величина (<math>|x_{ref}|</math>, <math>|\bar{x}_{N}|</math> или <math>|\bar{x}_{T}|</math>) становится <math>\geq \varepsilon</math>, система автоматически возвращается к относительному критерию.
* Трактовка <math>tolerance</math>: используется то же значение настройки; в абсолютном режиме оно интерпретируется как порог в физических единицах сигнала.

==== Сравнение алгоритмов прореживания данных ====
{| class="wikitable"
!Критерий
!Абсолютный
!% от последнего
!% от среднего N
!% от среднего по времени
|-
|Единицы допуска
|Физические
|Проценты
|Проценты
|Проценты
|-
|Устойчивость к шуму
|Низкая
|Средняя
|Высокая
|Высокая
|-
|Реакция на резкие скачки
|Быстрая
|Быстрая
|Задержка (при большом N)
|Задержка
|-
|Подходит при переменной частоте
|Да
|Да
|Нет
|Да
|}

==Система журналирования==
Система ведения журналов событий предназначена для управления регистрацией и хранением событий. В базу данных записываются все системные события и события, генерируемые с помощью [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.A1.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D0.B0 .D1.82.D1.80.D0.B5.D0.B2.D0.BE.D0.B3|системы тревог]], которые соответствуют выбранному уровню сообщений.

Для ведения журналов используются узлы типа "Логгер".

===Порядок настройки системы===
Порядок настройки системы журналирования следующий:

#Добавить и [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9F.D0.BE.D1.80.D1.8F.D0.B4.D0.BE.D0.BA .D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8 .D1.81.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D1.8B|настроить систему тревог]] для генерации событий.
#Добавить в проект систему журналирования. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система журналирования».
#Добавить в систему журналирования логгер. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем нажать «Добавить узел» и выбрать нужный логгер.
#Настроить параметры логгера (см. разделы ниже).

=== Логгер SQLite===
Логгер SQLite предназначен для сохранения событий, возникающих в ходе исполнения прикладной программы в СУБД SQLite.

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

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

===Логгер файловый ===
Логгер файловый предназначен для сохранения журналов событий в текстовых файлах на накопителе. Логгер имеет минимальное количество настроек, и обычно используется для сохранения журнала событий в случае необходимости отладки работы прикладной программы без среды разработки.

===Логгер SMS===
Логгер SMS предназначен для SMS информирования с помощью субмодуля GRPS или внешнего GPRS модема.

Принцип работы логгера следующий:

#Логгер принимает возникающие события, фильтрует их согласно установленного уровня событий и выбранных групп.
#События, прошедшие фильтрацию, форматируются согласно установленного шаблона.
#Отформатированные сообщения отправляются через подключенный модем в виде SMS сообщения. Отправка сообщений производится на телефонные номера, записанные в телефонной книге на SIM-карте.

==Система проверки прав пользователей==
[[Файл:AgavaPLC-Окно привилегий.png|мини|494x494пкс|Окно привилегий]]
Система реализует механизм контроля доступа к узлам проекта и их функциях на основе ролей. Узлы при выполнении действий проверяют наличие установленных привилегий у авторизованного в данный момент пользователя.

=== Роли и пользователи ===
Система содержит в себе две подсистемы:
*Пользователи. Подсистема определяет пользователей, каждому из которых назначается логин/пароль и одна или несколько ролей.
*Роли. Роли хранят наборы доступных привилегий.
Отношения между пользователями, ролями и привилегиями можно описать следующим образом:

* Один пользователь может иметь несколько ролей.
* Одну роль могут иметь несколько пользователей.
* Одна роль может иметь несколько привилегий.
* Одна привилегия может принадлежать нескольким ролям.

=== Привилегии ===
[[Файл:AgavaPLC-Система проверки прав пользователей.png|мини|Система проверки прав пользователей]]
Для узлов системы доступна установка следующих привилегий:

Все узлы:

*Чтение значения.
*Запись значения.
Окна и фреймы:
*Открытие окна.
*Закрытие окна.

При установке привилегий на какой-либо узел, все подчиненные узлы получают те же привилегии с флагом "унаследована".

Если привилегия не установлена, то считается что действие, регулируемое привилегией, запрещено.

Значение унаследованных привилегий можно переопределить с помощью явного задания привилегии.
===Порядок настройки системы===
Привилегии настраиваются в отдельном окне привилегий, доступном в меню "Вид".

Порядок настройки системы проверки прав в версии AgavaSCADA 1.2 следующий:

#Добавить в проект систему проверки прав пользователей. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система проверки прав пользователей».
#Добавить в систему проверки прав пользователей узел «Роль». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Роли».
#Добавить в узел «Роли» необходимые роли. Для этого нажать ПКМ по узлу «Роли» в дереве проекта, затем выбрать «Добавить узел» - «Роль».
#Для каждой роли настроить привилегии в окне привилегий. Для этого необходимо нажать «Вид» - «Открыть привилегии». В открывшемся окне в выпадающем списке «Пользователь / роль» выбрать нужную роль. Затем, нажимая ПКМ по узлам и выбирая «Добавить привилегию» настроить все необходимые ограничения для данной роли.
#Добавить в систему проверки прав пользователей узел «Пользователи». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Добавить в узел «Пользователи» необходимых пользователей. Для этого нажать ПКМ по узлу «Пользователи» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Для каждого пользователя указать имя и пароль, которые будут использоваться при авторизации, и выбрать одну или несколько ролей.

== Сигналы, источники и операции ==
Регистры и другие узлы, добавленные в группу «Сигналы», являются внутренними для проекта и могут менять свои значения только с помощь скриптов или других узлов, с которыми они связаны.

Сигналы содержат в себе несколько подгрупп.

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

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

Первичное значение поступает на вход операции, производится вычисление. Если есть еще операции, то вычисленное значение после первой операции передается на вход второй. И так далее по всем операциям. Если операций больше нет, вычисленное значение устанавливается в качестве значения узла.

Все операции выполняются в порядке, в котором они заданы в соответствующих свойствах.

====Сигнал простой====
Узел типа "Сигнал простой" предназначен для хранения и обработки значения источника, или другого сигнала или операции. Позволяет произвести какие-либо действия с этим значением с помощью добавления нужных операций в свойство «Операции после чтения».

====Постоянная ====
Узел типа "Постоянная" предназначен для хранения данных выбранного формата и позволяет изменять их в ходе выполнения программы. Связывание с источником не предусмотрено. Изменение осуществляется с помощью специализированных функций или блока установки значения в задаче ПЛК.

====Массив====
Массив - совокупность каких-либо объектов, указанных в свойстве «Входные значения». Нумерация объектов в массиве начинается с 0. Может использоваться для взаимодействия с демультиплексором.

====Сигнал комплексный====
Сигнал используется для взаимодействия с виджетом «Цифровой индикатор». Позволяет контролировать входное значение и генерировать события переходу входного значения через уставки.

Содержит в себе свойства для настройки следующих параметров:

*ВАУ – верхняя аварийная уставка;
*ВПУ - верхняя предаварийная уставка;
*НПУ - нижняя предаварийная уставка;
*НАУ – нижняя аварийная уставка;
*ФНЧ – фильтр низких частот.

===Источник===
Источник - специальный тип узлов, предназначенных для передачи данных от внешних устройств.

====Регистр Modbus====
Регистр Modbus используется для приема и передачи данных по протоколам Modbus-RTU, Modbus-TCP. Данный тип узов также может использоваться для организации работы некоторых алгоритмов программы (например для взаимодействия с контроллером событий).

====Источник индексный====
Узел типа "Источник индексный" используется для обработки данных, полученных по протоколу Upd, а так же в массивах для индексации значений.

===Операция===
[[Файл:AgavaPLC-Входные значения операций.png|мини|Входные значения операций]]
Узлы типа "Операция" используются для реализации вычислительных алгоритмов в задаче ПЛК или отдельно, при их размещении в группе "Сигналы".

В качестве входных значений операций выбираются константные числа, другие узлы группы «Сигналы», регистры или блоки задачи ПЛК.

====Операция «Сложение»====
Выходным значением является сумма входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Вычитание»====
Выходным значением является разность первого входного значения и суммы всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Умножение»====
Выходным значением является произведение значений всех входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Деление»====
Выходным значением является результат от деления первого входного значения на произведение всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Условие»====
Узел типа "Операция условие" предназначен для сравнения значений двух узлов. Для условия задаются сравниваемые параметры и выбирается режим сравнения. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Пара условий»====
[[Файл:AgavaPLC-Операция «Пара условий».png|мини|Операция «Пара условий»]]
Операция содержит в себе два условия. Для каждого условия задаются индивидуальные сравнимаемые параметры и выбирается режим сравнения.

Выходное значение операции зависит от ее режима проверки – при выбранном режиме «Логическое ИЛИ» выходное значение равно логической «1» если одно из условий равно «1», при «Логическом И»- если оба условия равны «1».

====Операция «Логическое ИЛИ»====
Если одно из входных значений становится равно логической «1» (контакты замкнуты), то выходное значение становится логической «1» (выход включен).

====Операция «Логическое И»====
Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

====Операция «Логическое НЕ»====
Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

====Операция «Таймер»====
Таймер предназначен для выполнения каких-либо [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действий]] через одинаковые промежутки времени (например запись значения в узел). Промежуток между исполнениями действий задается в свойстве «Интервал срабатывания», а сами действия в свойстве «Действия OnTimer». Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

====Операция «Мультиплексор»====
Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...».

Например если в качестве входных значений указаны два регистра, то выходное значение мультиплексора будет формироваться следующим образом:
{| class="wikitable"
!Значение регистра 1
!Значение регистра 2
!Выходное значение
|-
|0
|0
|0
|-
|1
|0
|1
|-
|0
|1
|2
|-
|1
|1
|3
|}

====Операция «Демультиплексор»====
Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

====Операция «Генератор случайного числа»====
Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями. Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

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

Для выполнения скрипта, можно добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения. Другим способом вызова срабатывания скрипта является добавление его в [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.92.D1.8B.D0.BF.D0.BE.D0.BB.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5 .D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0.C2.BB|действие «Выполнение скрипта»]].

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

*void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

===Объект===
Узлы типа "Объект" предназначены для взаимодействия с аппаратными компонентами контроллера. Для всех объектов, являющихся субмодулями, необходимо указать слот, в котором они установлены. Доступ к значениям входов/выходов субмодуля осуществляется через его вложенные узлы.

'''ПЛК процессорный модуль'''

Предоставляет возможность регулирования подсветки экрана; включения и отключения индикаторов работы, аварии и программы.

'''ПЛК субмодуль DI'''

Позволяет получать доступ к значениям входов субмодуля DI.

'''ПЛК субмодуль R'''

Позволяет управлять значениями выходов субмодуля R.

'''ПЛК субмодуль SIM'''

Позволяет управлять значениями выходов субмодуля SIM.

'''ПЛК субмодуль DO6'''

Позволяет управлять значениями выходов субмодуля DO6.

'''ПЛК субмодуль AI'''

Позволяет получать доступ к значениям входов субмодуля AI и задавать их тип.

'''ПЛК субмодуль AIO'''

Позволяет получать доступ к значениям входов субмодуля AIO, управлять значениями выходов и задавать тип входов и выходов.

'''ПЛК субмодуль TMP'''

Позволяет получать доступ к значениям входов субмодуля TMP и задавать их тип.

==Задачи==
Группа «Задачи» предназначена для группировки узлов типа «Задача», которые используются для циклического или разового выполнения созданных пользователем алгоритмов.

===Задача ПЛК===
Данный узел предоставляет возможности для связывания между собой других узлов (таких как сигналы, субмодули ПЛК, постоянные и т. д.) в удобной графической форме (см. Рисунок 64). Для перехода к редактору необходимо щелкнуть правой кнопкой мыши на задачу ПЛК и выбрать в открывшемся контекстном меню команду «Открыть графическое представление» или дважды щелкнуть левой кнопкой мыши на задаче ПЛК в дереве проекта.

Рисунок 64 – Окно графического редактирования задачи «ПЛК-60»

Панель инструментов задачи ПЛК, расположенная в верхней части окна, содержит следующие элементы (см. Рисунок 16):

*Выпадающий список выбора режима подписи портов.
*Выпадающий список выбора режима подписи блоков.
*Кнопка запуска режима симулятора.
*Кнопка запуска онлайн отладки.
*Кнопка печати задачи.
*Инструменты управления симуляцией.

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

Созданную связь можно удалить, выделив ее левой кнопкой мыши и нажав клавишу "Del". Связь можно "разорвать", то есть добавить разрыв, нажав по ней правой кнопкой мыши и выбрав в контекстном меню команду «Добавить разрыв».

Для выделения нескольких блоков рамкой зажмите клавишу "Shift" и выделяйте блоки мышью с нажатой левой кнопкой.

Задача ПЛК предоставляет возможности для проведения тестирования и отладки проекта, описанные в разделе [[#Проверка и отладка проекта]].

====Блоки задачи ПЛК====
Помимо операций, описанных в разделе [[#Операция]], для реализации алгоритмов в задачу ПЛК можно добавлять блоки, описанные ниже.

'''Функциональный блок'''

Используется для выделения каких-либо действий в отдельный блок, для упрощения понимания работы алгоритма программы. Содержит входы, выходы и блоки, обеспечивающие работу внутренней логики. Позволяет проводить изолированную отладку, при которой значения на входах функционального блока вручную задаются пользователем. Блок, работающий в данном режиме выделяется черной рамкой. Для включения изолированной отладки необходимо открыть блок и нажать кнопку «Изолированная отладка» на панели управления задачей.

'''Блок установки значения'''

Блок осуществляет запись значения, поданного на вход in0, в узел, указанный в свойстве «Узел для чтения/записи»

'''Блок задержки'''

Блок задержки используется для создания задержки передачи значения с входа блока на выход на один цикл обработки задачи.

'''Блок «Битовое OR»'''

Для вычисления значения будет произведена операция "ИЛИ" над каждым битом значения в отдельности. Например: 1010 OR 0110 = 1110

'''Блок «Логическое И»'''

Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

'''Блок «Битовое AND»'''

Для вычисления значения будет произведена операция "И" над каждым битом значения в отдельности. Если все биты, стоящие на одинаковых позициях в двоичных представлениях значений, поступающих на входы блока, равны логической «1», то на выходе элемента в этой позиции появляется логическая «1» (выход включен). Например: 1010 AND 0110 = 0010

'''Блок «Логическое НЕ»'''

Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

'''Блок «Битовое XOR»'''

Если только на один из входов блока функции поступает логическая «1», то на выходе элемента появляется логическая «1». Если на входы блока функции поступают целочисленные значения, то операция будет произведена над каждым битом значения в отдельности. Например: 1010 XOR 0110 = 1100

'''Блок «Битовое SHR»'''

Побитовый логический сдвиг вправо используется для выполнения операции побитового логического сдвига операнда X вправо на N бит с дополнением нулями слева.

'''Блок «Битовое SHL»'''

Побитовый логический сдвиг влево используется для выполнения операции побитового логического сдвига операнда X влево на N бит с дополнением нулями справа.

'''Блок «Таймер»'''

Таймер предназначен для выполнения каких-либо действий (см. раздел 4.6) через одинаковые промежутки времени (например запись значения в узел).

'''Блок «Мультиплексор»'''

Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...»

'''Блок «Демультиплексор»'''

Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

'''Блок «Генератор случайного числа»'''

Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями.

'''Блок «Скрипт С++»'''

Операция «Скрипт С++» предназначена для реализации разнообразных алгоритмов на языке С++. Операция предусматривает реализацию одной или нескольких функций, выполняющих необходимые пользователю действия. Для выполнения скрипта, необходимо добавить его в качестве узла для задачи или задачи ПЛК.

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

* void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

'''Блок «Таймер с задержкой»'''

Таймер с задержкой используется для операции задержки передачи и/или отключения сигнала. На выходе таймера появится сигнал логической «1» с задержкой относительно фронта входного сигнала продолжительностью равной интервалу включения и выключится по спаду входного сигнала с задержкой продолжительностью равной интервалу выключения. В том случае, если необходимо использовать блок только как таймер с задержкой включения (отключения) интервал выключения (включения) устанавливается равным 0.

'''Блок «Генератор прямоугольных импульсов»'''

Генератор прямоугольных импульсов используется для формирования прямоугольных импульсов пульсации. На выходе генератора формируются импульсы с заданными параметрами длительности включенного и отключенного импульса на время действия управляющего сигнала на входе (сигнал логической «1»).

'''Блок «Триггер RS»'''

RS-триггер с приоритетом выключения используется для переключения с фиксацией состояния во время поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Триггер SR»'''

SR-триггер с приоритетом включения используется для переключения с фиксацией состояния в случае поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Детектор переднего фронта импульса»'''

Детектор переднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «0» в «1».

'''Блок «Детектор заднего фронта импульса»'''

Детектор заднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «1» в «0».

'''Блок «D-триггер»'''

D-триггер используется для формирования импульса включения выхода на интервал времени импульса на входе D, выходной интервал будет синхронизирован с тактовой частотой на входе С. На выходе Q триггера появится сигнал логической «1» по фронту тактовых импульсов на входе С при наличии сигнала логической «1» на входе D. Возврат выхода в сигнал логического «0» произойдет по фронту тактовых импульсов на входе С при наличии сигнала логического «0» на входе D. Вход Set принудительно устанавливает выход в состояние логической «1». Вход Reset является приоритетным и устанавливает выход в состояние логического «0».

'''Блок «Селектор»'''

Если на вход Value подается логическая «1», то результатом выполнения операции блока на выходе является входной сигнал ValueT. Если же Value равен логической «0», то результатом выполнения операции блока на выходе является входной сигнал ValueF.

'''Блок «Больше чем»'''

На выход подается логическая «1», если значение in0 больше чем значение in1.

'''Блок «Равенство»'''

На выход подается логическая «1», если значение in0 равно значению in1.

'''Блок «Абсолютное значение числа»'''

Результатом операции функции на выходе является модуль подаваемого на вход значения. Если число на входе положительное, то на выход подается само число, если отрицательное – положительное число, получаемое от перемены его знака с «-» на «+».

'''Блок «Возведение в степень»'''

Результатом операции функции на выходе является значение, равное значению in0, возведенному в степень значения N.

'''Блок «PID-регулятор»'''

Регулятор PID применяется для поддержания заданного значения параметра. На вход Pv подается текущее значение регулируемой величины, на Sp – ее заданное значение. С помощью изменения коэффициентов ПИД регулятора kP, kI и kD достигается оптимальный режим работы. Min задает минимальное значение на выходе, Max – максимальное. time - период регулятора (в мс.).

'''Блок «PWM-регулятор»'''

Применяется для преобразования аналогового сигнала в дискретный с помощью ШИМ. На вход in подается текущее значение регулируемой величины, Min задает минимальное значение на входе, Max – максимальное. time - период регулятора (в мс.)

==Устройства==
Группа «Устройства» предназначена для группировки узлов типа "Устройство", выполняющие разнообразные задачи, например работа с внешними накопителями и ПЗУ.

Retain-накопитель дает возможность хранить значения регистров, постоянных и сигналов в постоянной памяти контроллера, что позволяет им сохранять свои значения после отключения питания.

Для сохранения переменных необходимо перечислить их в свойстве «Узлы» и указать путь сохранения на выбранном накопителе.

== Отчеты==
{{Внимание|Тип=Восклицание желтый.png|Текст=Данный узел доступен только при исполнении проекта на настольном компьютере. На панелях оператора и контроллерах МПР этот узел не доступен.}}
Отчет – технологический документ, содержащий информацию о ходе производственного процесса, обработанную по заложенным в отчет алгоритмам. Отчеты формируются на основе макетов (статической части отчетов) путем добавления в них свойств и значений заданных параметров технологического процесса, которые формируются (выбираются из базы данных технологических параметров и проходят соответствующую обработку) по алгоритмам, размещенным в этих шаблонах.

Данные для отчета предоставляет выборка, осуществляющая получение данных и их обработку из базы данных.

===Создание нового отчета===
Создание любого отчета производится в два этапа.

#Создание необходимых узлов в конфигурации: сам отчет и необходимое количество выборок.
#Составление макета отчета.

Создание узла типа «Отчет» в конфигурации и выборок для него производится аналогично созданию узлов других типов. К станции добавляется узел типа «Отчеты» с помощью команды контекстного меню «Добавить узел», далее к узлу типа «Отчеты» добавляется отчет и к отчету добавляется необходимое количество выборок.

Выборка – специальный узел, предназначенный для выборки данных из архива и их обработки для последующего отображения в отчете.

Перед переходом к редактированию макета желательно проделать следующие операции:

*в свойстве отчета «Путь к файлу отчета» установить имя файла, в котором будет храниться макет отчета;
* в свойстве «Источники» выборки (выборок) отчета установить перечень архивных сигналов (коннекторов), которые будут выводиться в отчете.

===Редактирование макета отчета===
[[Файл:AgavaPLC–Редактор макета отчета.png|мини|Рисунок 42 – Редактор макета отчета]]
Для редактирования макета отчета необходимо переключиться из редактора конфигурации в редактор макета отчета с помощью команды «Открыть редактор макета отчета», доступной из контекстного меню дерева конфигурации, отображаемого при щелчке правой кнопкой мыши на узле типа «Отчет».

В окне редактора расположены:

*панели инструментов;
* панель объектов отчета;
*окно «Инспектор объектов»;
*окно «Инспектор данных»;
*окно «Инспектор скриптов»;
*область построения макета отчета;
*окно «Структура отчета».

Редактор макета позволяет вызывать команды сочетаниями клавиш:

*Ctrl + N – новый макет;
*Ctrl + O – загрузить макет;
*Ctrl + S – сохранить макет;
*Ctrl + Shift + S – сохранить макет под новым именем;
*Ctrl + P – предварительный просмотр;
*Ctrl + Z – отмена изменений;
*Ctrl + Shift + Z – возврат отмененных изменений;
* Ctrl + C – копировать объект;
*Ctrl + X – вырезать объект;
*Ctrl + V – вставить объект;
*Ctrl + Стрелки – переместить выделенный объект;
*Shift + Стрелки – изменить размер выделенных объектов;
*Del – удалить выделенные объекты;
*Shift + левая кнопка мыши – создать область выделения.

====Окно «Инспектор объектов»====
Окно «Инспектор объектов» содержит список свойств выделенного объекта и предназначено для их редактирования.

====Окно «Инспектор данных»====
Окно «Инспектор данных» содержит список доступных для использования источников данных (выборок) и предназначено для заполнения блока «Данные» элементами соответствующего типа.

====Окно «Инспектор скриптов»====
Окно «Инспектор скриптов» содержит список доступных для использования в отчете скриптов.

====Окно «Структура отчета»====
Окно «Структура отчет» отображает структуру отчета в виде дерева связанных элементов.

===Элементы отчета===
Для составления макета отчета доступны следующие элементы:

*текст;
*данные;
*изображение;
*фигура;
*компоновка (Layout).

====Текст====
Элемент «Текст» служит для вывода надписей или содержимого полей источников данных.

Объект «Текст» обладает очень широкими возможностями. Он умеет отображать текст, рамку, заливку. Текст может быть отображен любым шрифтом любого размера, цвета и стиля. Большинство настроек делаются визуально с помощью панелей инструментов.

Одна из самых главных особенностей этого универсального объекта – это возможность отображения не только статичного текста, но и текста с применением вычисляемых выражений. Причем, выражения могут располагаться в объекте вперемешку с текстом. Рассмотрим простой пример – поместим в объект «Текст» следующую строку: «Привет! Сегодня $S{now()}».

Если запустить отчет на построение, мы увидим приблизительно следующее: «Привет! Сегодня 20180803». В процессе построения отчета выражение в тексте, заключенное $S{}, было вычислено и полученное значение вставлено обратно в текст. Объект «Текст» может содержать любое количество выражений, смешанных с обычным текстом. В скобки можно заключать и одиночные переменные, и выражения, например, $S{1+2*(3+4)}. В выражениях можно использовать константы, переменные ($V{}), функции, поля БД ($D{}).

Свойства элемента «Текст»:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|alignment
|Выравнивание текста по вертикали и горизонтали
|-
|angle
|Поворот надписи
|-
|autoHeight
|Автоматический подбор высоты
|-
|autoWidth
|Автоматический подбор ширины
|-
|backgroundColor
|Цвет заливки
|-
|backgroundMode
|Режим заливки
|-
| backgroundOpacity
|Прозрачность заливки
|-
|borders
|Границы
|-
|content
|Содержимое объекта «Текст»
|-
|font
|Шрифт
|-
|fontColor
|Цвет шрифта
|-
| foregroundOpacity
|Прозрачность шрифта
|-
|geometry
|Размер и расположение объекта
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|margin
|Отступы
|-
|objectName
| Имя объекта
|-
|stretchToMaxHeight
|Установка значения высоты самого высокого объекта на бэнде
|-
|trimValue
|Удаление пробелов в начале и в конце надписи
|}

Для редактирования свойства «Content» используется диалоговое окно «Text Item Editor», вызов которого осуществляется двойным щелчком левой кнопки мыши на элементе «Текст».

Свойство «Content» может содержать:

*текст;
*значения переменных;
*значения полей из набора данных;
*значения, формируемые посредством исполнения скрипта.

Для вывода значений переменных используется синтаксис «$V{имяПеременной}» (без кавычек), для вывода значения поля данных – «$D{имяНабораДанных.ИмяПеременной}», для вывода результата исполнения скрипта – «$S{телоСкрипта}».

==== Изображение ====
Элемент для вывода изображений:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoSize
|Подгонять размер под размер изображения
|-
|borders
|Границы
|-
|content
|
|-
|datasource
|Источник данных
|-
|field
|Поле данных
|-
|geometry
|Размер и расположение
|-
|image
|Изображение
|-
| itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
| stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Фигура====
Элемент для вывода фигур:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
| geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|lineWidth
|Толщина линии
|-
|objectName
|Имя объекта
|-
|opacity
|Прозрачность
|-
|penStyle
|Стиль линии
|-
|shape
|Фигура
|-
|shapeBrush
|Стиль заливки
|-
|shapeBrushColor
|Цвет заливки
|-
|shapeColor
|Цвет фигуры
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Горизонтальная компоновка (Layout)====
Элемент, позволяющий объединять несколько элементов в группу:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
|geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

=== Разделы отчета (бэнды) ===
Бэнд предназначен для размещения других элементов отчета. Бэнд может быть нескольких типов:

*Report Header – заголовок отчета;
*Report Footer – завершение отчета;
*Page Header – верхний колонтитул страницы отчета;
*Page Footer – нижний колонтитул страницы отчета;
*Data – данные отчета;
* SubDetail – подчиненные данные отчета;
*SubDetailHeader – заголовок подчиненных данных;
*SubDetailFooter – завершение подчиненных данных;
*GroupHeader – заголовок группы;
*GroupFooter – завершение группы.

Бэнды применяются для логической группировки объектов. К примеру, размещение объекта на элементе «Данные» типа «Page Header», приводит к отображению этого объекта в верхней части каждой страницы готового отчета. Аналогичным образом «Page Footer» выводится внизу каждой страницы со всеми лежащими на нем объектами.

Общие для всех элементов «Данные» свойства:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoHeight
|Автоматический подбор высоты
|-
|backgroundColor
|Цвет заливки бэнда
|-
|borders
|Границы
|-
|geometry
|Размер
|-
|keepBottomSpace
|Сохранение отступа от нижней границы бэнда
|-
|objectName
|Имя объекта
|-
|printIfEmpty
|Отображение пустого бэнда
|-
|splittable
|Разделение бэнда, если он не влезает на страницу
|}

Report Footer:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|maxScalePercent
|Максимальный процент, на который можно уменьшить бенд, если он не влезает на страницу. Если бэнд даже после сжатия

не влезает на страницу, он будет перенесен полностью или частично – в зависимости от настроек бэнда
|}

Data:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|datasource
|Источник данных. Data-бэнд будет сформирован для каждой строки в источнике данных
|-
|keepFooterTogether
|Если Report Footer не влезает на страницу, то он будет перенесен на следующую страницу совместно с последним

экземпляром Data-бэнда
|-
|sliceLastRow
| Указывает генератору отчетов на то, можно ли разрезать последний экземпляр Data-бэнда или его нужно перенести

целиком
|}

Бэнды данного типа предназначены для вывода на печать данных из наборов. Набор данных - это заранее неизвестное количество строк (записей), каждая из которых содержит определенное количество колонок (полей).

SubDetail:
{| class="wikitable"
! Наименование свойства
!Описание
|-
|datasource
| Источник данных. SubDetail-бэнд будет сформирован для каждой строки в источнике данных
|}

SubDetailHeader, SubDetailFooter:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|printAlways
| Печатать, даже если SubDetail пустой
|}

GroupHeader:
{| class="wikitable"
!Наименование свойства
! Описание
|-
|groupFieldName
|Поле, по которому осуществляется группировка. Экземпляр GroupHeader будет формироваться при смене значения в этом поле
|}

===Функции===
==== Агрегатные функции ====
Агрегатные функции предназначены для обработки значений, содержащихся в резделах Data и SubDetail.

===== AVG - вычисление среднего значения =====
Пример использования:
$S{AVG("TextItem4","DataBand1");}

===== SUM - вычисление суммы значений =====
Пример использования:
$S{SUM("TextItem8","DataBand1");}

===== MIN =====

===== MAX =====

===== COUNT =====

==== Числовые функции ====

===== numberFormat - форматирование числа =====
Синтаксис:
numberFormat(значение, 'формат', точность)
Форматы:

* <code>'f'</code> — фиксированная запись (например, <code>"123.45"</code>);
* <code>'g'</code> — общий формат (автоматически выбирает между <code>'f'</code> и <code>'e'</code>);
* <code>'e'</code> — экспоненциальная запись (например, <code>"1.2345e+02"</code>);

Пример использования:
$S{numberFormat($D{fetcharchiverdata1.ArchiversSourceConnector0 (среднее)}, 'f', 3)} -> 123.495
[[Категория:AgavaSCADA/AgavaPLC]]

Узлы проекта AgavaSCADA/AgavaPLC

2025-10-30T04:32:42Z

SharipovRR:

== Узлы проекта ==
Узел - элементарная сущность проекта, осуществляющая хранение информации или реализующая определенный функционал. Каждый узел обладает набором [[Свойства узлов в AgavaSCADA/AgavaPLC|свойств]]. Все узлы, объединенные в иерархическую структуру, образуют проект.

== Проект ==
[[Файл:AgavaPLC–Дерево проекта.png|мини|Рисунок 21 – Дерево проекта]]
Узел "Проект" ("Корневой узел", "Корень") предназначен для хранения общей информации о проекте и связывания других узлов проекта.

== Станция ==
Станция – важнейший узел, управляющий работой собственных систем и выполняющий обмен данными с другими станциями. Физически станция представляет собой устройство, на котором исполняется проект (компьютер, панель оператора, МПР-60 или другое устройство).

Для использования в проекте доступны несколько типов станций. например:

* '''Станция''' - общий тип станции. Проекты с такой станцией могут выполняться на большинстве устройств - контроллеры, панели, персональные компьютеры. Чаще всего используется для проектов, предназначенных для выполнения на персональном компьютере.
* '''Панель ПО-40''' - специализированный тип для проектов на панелях оператора ПО-40. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.
* '''Панель ПО-50''' - специализированный тип для проектов на панелях оператора ПО-50. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.).
* '''Контроллер МПР-60''' - специализированный тип для проектов на программируемых реле МПР-60. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием устройства (светодиоды индикации и др.), использования корзины субмодулей.
* '''Контроллер ПЛК-70.A''' - специализированный тип для проектов, предназначенных для контроллеров АГАВА ПЛК-70.А. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием контроллера (светодиоды индикации и др.), использования корзины субмодулей.

При построении больших проектов станций в проекте может быть несколько, и они могут выполнять разные задачи. Например, станция-сервер выполняет сбор и регистрацию данных, клиентские станции выполняют визуализацию данных на рабочих местах и т. д.

Станции подчиняются узлы типа "Система" - Транспортная система, Система архивирования, Система визуализации и т. д.

== Транспортная система ==
Транспортная система управляет передачей данных по различным каналам связи. Система управляет работой "Транспортов" - узлов, выполняющих обмен данными с устройствами по определенному протоколу.

С одной стороны, транспортная система обращается непосредственно к сигналам и каналам устройства, а с другой стороны, представляет их в виде неких универсальных единиц – узлов-источников. Каждый источник однозначно соответствует определенному сигналу или параметру устройства. При изменении сигнала меняется и значение источника. При записи данных в источник производится подача команды устройству на установку определенного значения конкретного параметра.

Транспортная система допускает использование нескольких транспортов, что дает возможность одновременного обмена данными с большим количеством устройств по разным протоколам.

=== Транспорт ===
Транспорт предназначен для обмена данными с устройствами по определенному протоколу. Один транспорт, в зависимости от типа, позволяет обмениваться данными с одним или несколькими устройствами.

Доступны для использования следующие виды транспортов:

* Транспорт Modbus-TCP;
* Транспорт Modbus-RTU;
* Транспорт SNMP;
* Транспорт OPC UA;
* Транспорт OPC DA (только для Windows);
* Транспорт MQTT;
* Последовательный транспорт (устаревший);
* TCP/IP транспорт (устаревший).
Подробное описание транспортов приведено в отдельном документе "[[Транспорты AgavaSCADA/AgavaPLC]]".

==Система визуализации==
{{Внимание|Тип=Восклицание желтый.png|Текст=Система визуализации недоступна в проектах для контроллеров МПР}}

Задачей этой системы является отображение данных в виде набора мнемонических схем (экранов, мнемосхем), а также предоставление пользователю возможности управления.

Каждый экран позволяет в схематичном, понятном пользователю виде представить участок технологической схемы с отображением необходимых параметров технологического процесса.

Изображение на экране строится с помощью окон, на которых размещаются объекты визуализации – виджеты. Виджетами могут быть текстовые метки, изображения, в том числе анимированные, элементы управления, графики и т. д. Виджеты можно объединять в слои для удобного управления отображением виджетов.

Виджеты могут быть статическими и динамическими. Динамические виджеты привязаны к одному или нескольким сигналам и их отображение зависит от значений этих сигналов. Статические виджеты не имеют привязки к сигналам и их изображение всегда постоянно.

Для перехода по экранам, изменения значений параметров и иного управления служат специальные виджеты: кнопки управления, поля ввода и другие.

Для повышения быстродействия и увеличения комфортности работы с системой система визуализации хранит в памяти кэш из нескольких последних открытых экранов. Когда при последовательном открытии экранов этот кэш заполняется, наиболее старые экраны удаляются из него. Это связано с тем, что, как правило, в работе используются несколько одних и тех же экранов, которые отображают сводную информацию о техпроцессе и оператор в штатном режиме переключается только между ними. Сохраняя их в памяти, система ускоряет переключение между ними, поскольку при этом не требуется каждый раз создавать экран, все находящиеся на нем объекты и запускать процессы обновления параметров.

Когда экран переходит в кэш, обновление параметров на нем прекращается для снижения нагрузки на центральный процессор. Если все же необходимо, чтобы экран всегда производил обновление данных (по разным причинам), даже находясь в кэше, необходимо в его настройках включить опцию «Постоянно обновляемый».

Подчиненные типы узлов:

*фрейм;
*окно;
*композиция.

===Фрейм===
[[Файл:AgavaPLC–Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией.png|мини|Рисунок 23 – Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией]]
Фрейм – узел, предназначенный для группировки окон, отображаемых на определенном дисплее. Обеспечивает организацию окон в пространстве экрана, управление мониторами и границами отображения.

Если необходимо отобразить информацию на нескольких дисплеях одновременно, то для каждого из них нужно использовать отдельный фрейм. Окон во фрейме может быть несколько, однако они не могут накладываться друг на друга.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
|-
|Позиция X
|XCoord
|int
|Координата X левого верхнего угла фрейма
|Целое число
|-
|Позиция Y
|YCoord
|int
|Координата Y левого верхнего угла фрейма
|Целое число
|-
|Ширина
|XSize
|int
|Ширина фрейма в пикселях
|Целое число > 0
|-
|Высота
|YSize
|int
|Высота фрейма в пикселях
|Целое число > 0
|-
|Окна
|Windows
|NodesArray
|Список окон, принадлежащих фрейму
|Узлы типа: Window
|-
|Номер монитора
|DisplayNo
|int
|Номер монитора для отображения фрейма
|0 - по умолчанию
≥1 - конкретные мониторы
|-
|Тип границы
|BorderType
|enum
|Тип границы фрейма
|0: Не определен (ошибка)
1: Отсутствует

2: Фиксированная
|}

==== Позиция и размеры (XCoord, YCoord, XSize, YSize) ====

* '''Тип:''' int.
* '''Описание:''' Определяют положение и размеры фрейма на экране.
* '''Значения по умолчанию:''' (0, 0, 640, 480).
* '''Применение:''' Задание области экрана, которую занимает фрейм.

==== Окна (Windows) ====
'''Тип:''' NodesArray.

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

'''Особенности:'''

* Поддерживаются только узлы типа Window.

==== Номер монитора (DisplayNo) ====
'''Тип:''' int.

'''Описание:''' Определяет, на каком мониторе системы отображается фрейм. Значение 0 соответствует монитору по умолчанию.

'''Использование:'''

* 0 - основной монитор.
* 1, 2, ... - дополнительные мониторы.
* Свойство важно для многомониторных конфигураций.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип обрамления фрейма. Влияет на внешний вид и поведение границ.

'''Значения:'''

* '''Отсутствует''' - фрейм без видимых границ.
* '''Фиксированная''' - стандартная граница окна.
* '''Не определен''' - используется только для обработки ошибок.

==== Наследование привилегий ====
Фрейм автоматически добавляет доступные привилегии для работы с окнами:

* <code>OpenWindow</code> - привилегия на открытие окон.
* <code>CloseWindow</code> - привилегия на закрытие окон.

===Окна===
Окно – узел, осуществляющий отображение видеокадра (мнемонической схемы).

Существуют несколько видов окон:

1. «Форма», предназначенная для вывода простого набора данных без необходимости управления видимостью или внешним видом его элементов. Для вывода информации в такое окно кроме создания окна и добавления к нему виджетов ничего более не требуется.
[[Файл:AgavaPLC-Меню.png|мини|164x164пкс|Рисунок 24 — Внешний вид меню в среде исполнения]]
2. «Окно с композицией», предназначенное для вывода большого количества информации и позволяющее организовать группировку элементов по слоям, управлять внешним видом элементов, видимостью слоев и отдельных элементов, а также дающее возможность регулирования работы пользователя с элементами. Для вывода информации в такое окно нужно к окну привязать композицию, содержащую минимум один слой, в который уже добавляются виджеты.

=== Форма ===
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Модальность
|Modality
|enum
|Режим модальности окна
|0: Не определен (ошибка)
1: Немодальное

2: Модальное (Фрейм)

3: Модальное (Система)
|Чтение/Запись
|-
|Тип границы
|BorderType
|enum
|Тип границы окна
|0: Не определен (ошибка)
1: Фиксированная

2: Изменяемая

3: Отсутствует
|Чтение/Запись
|-
|Отображать строку заголовка
|TitleEnabled
|bool
|Отображать строку заголовка
|true/false
|Чтение/Запись
|-
|Отображать кнопку "Закрыть"
|CloseEnabled
|bool
|Отображать кнопку "Закрыть"
|true/false
|Чтение/Запись
|-
|Цвет фона
|BackgroundColor
|NColor
|Цвет фона окна
|Цвет в формате RGBA
|Чтение/Запись
|-
|Затемнение
|NeedDarkenApplication
|bool
|Затемнение других окон приложения при открытии этого окна
|true/false
|Чтение/Запись
|-
|Цвет затемнения
|ColorDarkenApplication
|NColor
|Цвет затемнения
|Цвет в формате RGBA
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов, мс
|0 - без задержки
>0 - интервал в мс
|Чтение/Запись
|-
|Действия OnShow
|ActionsOnShow
|NodesContainer
|Действия при показе окна
|Узлы типа: Action
|Чтение/Запись
|-
|Действия OnClose
|ActionsOnClose
|NodesContainer
|Действия при закрытии окна
|Узлы типа: Action
|Чтение/Запись
|}

==== Модальность (Modality) ====
'''Тип:''' enum.

'''Описание:''' Определяет поведение окна относительно других окон приложения.

'''Значения:'''

* '''Немодальное''' - позволяет взаимодействовать с другими окнами.
* '''Модальное (Фрейм)''' - блокирует взаимодействие с окнами в том же фрейме.
* '''Модальное (Система)''' - блокирует все окна приложения.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип и поведение границ окна.

'''Значения:'''

* '''Фиксированная''' - окно нельзя изменять размер.
* '''Изменяемая''' - пользователь может изменять размер окна.
* '''Отсутствует''' - окно без видимых границ.

==== Управление заголовком (TitleEnabled, CloseEnabled) ====
'''Тип:''' bool.

'''Описание:''' Контролируют отображение элементов заголовка окна.

==== Фон и затемнение (BackgroundColor, NeedDarkenApplication, ColorDarkenApplication) ====
'''Тип:''' NColor, bool, NColor.

'''Описание:''' Управляют визуальным оформлением окна и его влиянием на другие окна.

'''Особенности:'''

* Затемнение применяется только при NeedDarkenApplication = true.
* Цвет затемнения по умолчанию: черный с прозрачностью 50%.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Определяет частоту обновления виджетов в окне.

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчики событий (ActionsOnShow, ActionsOnClose) ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых при показе и закрытии окна.

=== Окно с композицией ===
Данный узел имеет те же свойства, что и форма, а также собственные:
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Композиция
|CompositionId
|NodeLink
|Основная композиция окна
|Узлы типа: CompositionLayered, CompositionTemplated
|Чтение/Запись
|-
|Описание текущей композиции
|CurrentCompositionDesc
|string
|Описание текущей загруженной композиции
|Автоматически формируется
|Только чтение
|}

==== Композиция (CompositionId) ====
'''Тип:''' NodeLink.

'''Описание:''' Ссылка на композицию, отображаемую в окне.

'''Поддерживаемые типы:''' CompositionLayered, CompositionTemplated.

==== Описание текущей композиции (CurrentCompositionDesc) ====
'''Тип:''' string.

'''Описание:''' Автоматически обновляемое описание загруженной композиции.

'''Особенности:''' Свойство только для чтения, обновляется системой автоматически.[[Файл:AgavaPLC-Настройка меню в среде разработки.png|мини|226x226пкс|Рисунок 25 — Настройка меню в среде разработки]]

===Композиция===
Композиция – узел, представляющий составленную при разработке проекта мнемоническую схему в виде набора элементов визуализации (виджетов), сгруппированных в один или несколько слоев.

Композиция дает возможность организовать виджеты в слои, видимостью которых можно управлять во время работы проекта.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Размеры
|Size
|NSize
|Размеры композиции
|Структура {ширина, высота}
|Чтение/Запись
|-
|Кэширование
|Cacheable
|bool
|Кэширование данных композиции для быстрого повторного открытия
|true/false
|Чтение/Запись
|-
|Источник интервала обновления
|UpdateIntervalSource
|enum
|Определяет источник интервала обновления виджетов
|0: Окно
1: Композиция
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов в миллисекундах
|Целое число ≥ 0
|Чтение/Запись
|-
|Действия OnLoad
|ActionsOnLoad
|NodesContainer
|Действия при загрузке композиции
|Узлы типа: Action
|Чтение/Запись
|}

==== Размеры (Size) ====
'''Тип:''' NSize (ширина, высота).

'''Описание:''' Определяет размеры композиции в пикселях. По умолчанию установлены значения 800x600.

==== Кэширование (Cacheable) ====
'''Тип:''' bool.

'''Описание:''' Включает или отключает кэширование данных композиции. При включенном кэшировании композиция сохраняется в памяти для быстрого повторного открытия.

'''Преимущества кэширования:'''

* Быстрое переключение между композициями.
* Снижение нагрузки на систему при частом использовании.
* Сохранение состояния элементов.

'''Рекомендации:''' Включать для часто используемых композиций, отключать для редко используемых или ресурсоемких.

==== Источник интервала обновления (UpdateIntervalSource) ====
'''Тип:''' enum.

'''Описание:''' Определяет, откуда виджеты композиции получают интервал обновления.

'''Значения:'''

* '''Окно''' - интервал обновления наследуется от родительского окна.
* '''Композиция''' - используется собственный интервал обновления композиции.

'''Применение:''' Централизованное управление производительностью через окно или индивидуальная настройка для каждой композиции.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Задает интервал обновления виджетов в миллисекундах. При значении 0 отрисовка виджетов выполняется без задержки (максимальная частота).

'''Особенности:'''

* 0 - обновление без задержек (может создать высокую нагрузку).
* > 0 - обновление с заданным интервалом. Учитывается только при UpdateIntervalSource = "Композиция"

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчик событий ActionsOnLoad ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых после загрузки композиции <code>AS 1.6.27+</code>.

===Слой===
Слой – набор виджетов, объединенных каким-то общим структурным признаком. В многослойных композициях слой обеспечивает организацию виджетов в z-порядке, управление видимостью и взаимодействием с пользователем. С помошью свойства "Видимость" слоя можно управлять видимостью виджетов, размещенных на слое.

Свойства
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Z-Порядок
|ZOrder
|int
|Порядок слоя в композиции
|Целое число (чем выше значение, тем выше слой)
|Чтение/Запись
|-
|Прозрачность для действий
|ActionTransparency
|enum
|Определяет поведение слоя при взаимодействии с пользователем
|0: Не определен (ошибка)
1: Непрозрачный

2: Прозрачный
|Чтение/Запись
|-
|Видимость
|Visible
|bool
|Видимость слоя и всех его виджетов
|true/false
|Чтение/Запись
|}

==== Z-Порядок (ZOrder) ====
'''Тип:''' int

'''Описание:''' Определяет порядок отображения слоя относительно других слоев в композиции. Слои с большим значением ZOrder отображаются поверх слоев с меньшим значением.

'''Пример использования:'''

* Фоновый слой: ZOrder = 1.
* Основной контент: ZOrder = 2.
* Контекстные виджеты: ZOrder = 3.

==== Прозрачность для действий (ActionTransparency) ====
'''Тип:''' enum

'''Описание:''' Управляет взаимодействием слоя с пользовательскими действиями (клики, наведения и т.д.)

'''Значения:'''

* '''Непрозрачный''' - слой полностью перехватывает пользовательские действия, элементы под ним недоступны, даже если они видимы.
* '''Прозрачный''' - пользовательские действия проходят сквозь слой к элементам ниже.

Обратите внимание: если на слое размещается изображение с прозрачной областью, то такие виджеты не позволяют пользователю взаимодействовать с видимыми и размещенными под ним виджетами.

==== Видимость (Visible) ====
'''Тип:''' bool

'''Описание:''' Определяет видимость всего слоя и всех его дочерних виджетов. При значении false слой и все его содержимое становится невидимым.

'''Применение:''' Временное скрытие виджетов или переключение их видимости.

===Виджет===
Виджет – элемент визуализации, предназначенный для отображения информации в заданном виде.

===Меню===
Меню – элемент визуализации, сочетающий в себе несколько виджетов «Кнопка». Используется для более удобного управления проектом (см. Рисунок 24).

Для добавления меню, необходимо в среде разработки назначить [[Универсальная среда разработки#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.9E.D1.82.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5 .D0.BC.D0.B5.D0.BD.D1.8E.C2.BB|действие «Отображение меню»]] для кнопки (или любого другого виджета). После добавления действия необходимо выделить его и нажать на кнопку настроек на панели вверху окна действий. Открывшееся окно (см. Рисунок 25) содержит дерево со структурой меню, в который можно добавлять элементы двух типов:

*меню – элемент, который позволяет группировать элементы меню, выводя их в виде раскрывающегося списка. На рисунках 24 и 25 этим элементом являются кнопки «Арочник» и «БПО».
*элемент меню – элемент, который предоставляет функционал, аналогичный [[Универсальная среда разработки#.D0.92.D0.B8.D0.B4.D0.B6.D0.B5.D1.82 .C2.AB.D0.9A.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0.C2.BB|виджету «Кнопка»]]. Для добавления действия, выполняющегося при нажатии на элемент меню в среде исполнения, необходимо нажать на него ПКМ в дереве структуры меню и выбрать "Создать действие". На рисунках 24 и 25 этим элементом являются кнопки «Котельная», «Котёл №1», «Котёл №2» и «Котёл №3».

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

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

# Добавить дополнительные фреймы, чтобы их количество в проекте соответствовало количеству дисплеев. Каждому фрейму назначить порядковый номер, начиная с 1. Фреймы связываются с дисплеями по номеру.
# Добавить дополнительное окно (или окна, если в исходном фрейме их несколько или дополнительных фреймов больше одного).
# Добавить в дополнительные фреймы созданные на этапе 2 окна, чтобы повторить структуру основоного фрейма.

Базовая настройка на этом закончена. После запуска такого проекта на двух или более дисплеях должны отображаться созданные окна.

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

===Виджеты===
====Виджет «Текстовая метка»====
[[Файл:AgavaPLC–Примеры оформления виджетов типа "Текстовая метка".png|мини|Рисунок 26 – Примеры оформления виджетов типа "Текстовая метка"]]
Виджет «Текстовая метка» – наиболее часто применяемый виджет, с помощью которого можно реализовать разные способы отображения текстовой информации.

Виджет «Текстовая метка» может использоваться для отображения статичного текста, значений параметров (одного или нескольких) и их комбинаций.

При необходимости отображения значений параметров они указываются в свойстве «Источник». Для задания определенного формата отображения используются спецификаторы формата в стиле языка «Си»:

*%f – значение в виде числа с плавающей точкой;
* %s – строка;
*%i – целое число со знаком;
*%u – целое число без знака;
* %d – целое число со знаком в десятичной системе исчисления.

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

Для отображения знака «%» необходимо указать его дважды: «%%».

===== Отображение нескольких значений =====
Одна текстовая метка может использоваться для отображения нескольких значений. Для этого все значения, которые нужно отобразить, указываются в свойстве «Источник», а в свойстве «Текст» указываются последовательно несколько спецификаторов формата соответственно порядку перечисления значений в свойстве «Источник».

Пример: текстовая метка, отображающая текущую позицию в очереди:

* Текст: <code>Позиция %i из %i</code>
* Источник: два узла из проекта.

=====Модификаторы спецификаторов формата=====

======Модификатор минимальной ширины поля======
Целое число, расположенное между знаком % и кодом формата, играет роль модификатора минимальной ширины поля. Если указан модификатор минимальной ширины поля, то, чтобы ширина поля вывода была не меньше указанной минимальной величины, вывод при необходимости будет дополнен пробелами. Если же выводятся строки или числа, которые длиннее указанного минимума, то они все равно будут отображаться полностью. По умолчанию для дополнения используются пробелы. А если для этого надо использовать нули, то перед модификатором ширины поля следует поместить 0. Например, %05i означает, что любое число, количество цифр которого меньше пяти, будет дополнено таким количеством нулей, чтобы состоять из пяти цифр.

Примеры
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%i
|10
|-
|10.123
|%d
|10
|-
|10.123
|%05i
|00010
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
| 10.1
|-
|10.123
|%10f
|<пробел>10.123000
|-
|10.123
|%012f
|00010.123000
|}

======Модификатор точности======
Модификатор точности следует за модификатором минимальной ширины поля (если таковой имеется). Он состоит из точки и расположенного за ней целого числа. Значение этого модификатора зависит от типа данных, к которым его применяют.

Когда модификатор точности применяется к данным с плавающей точкой, для преобразования которых используются спецификаторы преобразования %f, %e или %E, то он определяет количество выводимых десятичных разрядов. Например, %10.4f означает, что ширина поля вывода будет не менее 10 символов, причем для десятичных разрядов будет отведено четыре позиции.

Если модификатор точности применяется к %g или %G, то он определяет количество значащих цифр.

Примененный к строкам, модификатор точности определяет максимальную длину поля. Например, %5.7s означает, что длина выводимой строки будет составлять минимум пять и максимум семь символов. Если строка окажется длиннее, чем максимальная длина поля, то конечные символы выводиться не будут.

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

Примеры:
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
|10.1
|-
|10.123
|%10.4f
|<пробел><пробел><пробел>10.1230
|-
|10.123
|%010.3f
|000010.123
|-
| Это простая проверка
|%10.15s
|Это простая про
|}

====Виджет «Условная метка» ====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условная метка".png|мини|Рисунок 27 – Список сопоставлений виджета "Условная метка"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условная_метка%22.png]]
Виджет «Условная метка» позволяет изменять выводимую строку в соответствии с изменениями привязанной к ней переменной.

Задать соответствие текста необходимому условию можно в свойстве «Список сопоставлений».

==== Виджет «Изображение»====
Виджет «Изображение» предназначен для отображения на окнах статичных изображений форматов png, gif, jpg, bmp или анимированных изображений в формате gif. Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Условное изображение»====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условное изображение".png|мини|Рисунок 28 – Список сопоставлений виджета "Условное изображение"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условное_изображение%22.png]]
Виджет «Условное изображение» позволяет изменять отображаемое изображение в соответствии с изменениями привязанной к нему переменной.

Задать соответствие изображения необходимому условию можно в свойстве «Список сопоставлений».

====Виджет «Движущееся изображение»====
Виджет предназначен для отображения на окнах изображений, перемещающихся в пределах области виджета. В основном используются на экране спящего режима.

Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Кнопка»====
Виджет «Кнопка» предназначен для реализации функций управления:

*ввод данных;
*передача управляющих воздействий;
* смена режима работы АРМ или иного устройства, исполняющего проект.

Выполнение всех функций виджета обеспечивается с помощью узлов типа «Действие», добавляемых в соответствующее свойство (см. раздел [[#Действия]]).

====Виджет «Гистограмма»====
[[Файл:AgavaPLC–Виджет "Гистограмма".png|мини|Рисунок 29 – Виджет "Гистограмма"|ссылка=Файл:AgavaPLC–Виджет_%22Гистограмма%22.png]]
Виджет предназначен для отображения значений сигналов в виде столбчатой диаграммы.

Виджету необходимо задать источник (регистр/сигнал, с которого он будет получать данные), а также минимальное и максимальное значения.

====Виджет «Исторический график»====
Виджет «Исторический график» предназначен для отображения графиков параметров на двухкоординатной области изображения с привязкой к осям времени и значений.

Виджет может работать с данными, архивируемыми в БД, и напрямую с сигналами, значения которых вычисляются в ходе работы.

При работе с архивируемыми данными интервал обновления графика зависит от режима выдачи значения у базы данных: при выборе сохраняемых в БД он будет соответствовать интервалу архивирования, а при сохраненных в БД - интервалу сохранения БД на диск. Независимо от режима выдачи, график не может обновляться меньше чем за 300 мс.

При работе напрямую с сигналами график обновляется при изменении значения сигнала, но также не чаще чем раз в 300 мс.
[[Файл:AgavaPLC–Экран «Архив» с виджетом «Исторический график».png|мини|Рисунок 30 – Виджет «Исторический график». Области кнопок-пиктограмм. В нижней части отображена легенда]]
Виджет «Исторический график» состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода данных.

На виджете имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 28):

#область пиктограмм графика;
#область пиктограмм оси времени (X);
#область пиктограмм оси значений (Y);
#область легенды.

В области пиктограмм графика слева направо расположены следующие кнопки-пиктограммы:

* кнопка переключения режима отображения точек на всех кривых;
* кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси времени (X) слева направо расположены следующие кнопки-пиктограммы:

*кнопка открытия окна выбора интервала времени для оси Х, текст кнопки отображает текущий выбранный интервал, например: 5М – 5 минут, 6Ч – 6 часов, 30М – 30 минут;
*кнопка-индикатор включения следящего режима.

В области пиктограмм оси значений (Y) расположена кнопка-пиктограмма «A» – кнопка переключения режима автоматического масштабирования значений.

=====Легенда=====
[[Файл:AgavaPLC–Легенда с четырьмя выключенными параметрами.png|мини|Рисунок 31 – Легенда с четырьмя выключенными параметрами]]
Легенда – специальная область в нижней части экрана архива, предназначенная для отображения параметров (наименование, текущее значение и т. д.) выводимых графиков в виде таблицы. Для ознакомления с примерным видом легенды см. Рисунок 31. Информация о каждом сигнале в легенде выводится в несколько колонок:

*«Цвет» – индицирует цвет, которым выводится соответствующая кривая на графике, колонка «Цвет» позволяет нажатием переключать видимость соответствующей кривой на графике (см. Рисунок 29). Также в колонке "Цвет" отображается номер пера, которым выводится кривая параметра на графике;
* «Имя» («Наименование») – содержит наименование параметра;
*«Время» – содержит время последнего зарегистрированного значения параметра;
*«Значение» – содержит последнее зарегистрированное значение параметра.

=====Режимы просмотра графиков=====
Пользователю доступно два режима просмотра графиков:

*следящий режим;
*режим просмотра истории.

В следящем режиме на графике всегда отображаются актуальные значения параметров, тренд периодически дочитывает поступившие данные из базы и обновляет графики.

В режиме просмотра истории на графике отображаются исторические значения параметров. Просмотр истории технологического процесса осуществляется с помощью кнопок перемещения по осям и кнопок изменения масштаба.

Режим просмотра истории включается автоматически при прокрутке графика назад по времени.

=====Визирная линия=====
[[Файл:AgavaPLC–График в режиме просмотра истории с установленной визирной линией.png|мини|Рисунок 32 – График в режиме просмотра истории с установленной визирной линией]]
Для просмотра значений параметров в нужный момент времени служит визирная линия, отображаемая на графике как вертикальная линия.

При щелчке левой кнопкой мыши (ЛКМ) в области графиков визирная линия будет отображена в выбранном месте графика.

В точке пересечения визирной линии и кривых параметров отображаются значения этих параметров. Также в нижней части области графиков, возле оси времени, визирная линия отображает время.

====Виджет «График кусочно-линейной функции»====
Виджет предназначен для отображения графика зависимости двух параметров, расположенном на осях X и Y.
[[Файл:AgavaPLC–Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм..png|мини|Рисунок 33 – Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм.]]
Виджет состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода графика.

На области вывода графика виджета имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 33):

#Область пиктограмм графика.
#Область пиктограмм оси первого параметра (X).
#Область пиктограмм оси второго параметра (Y).

В области пиктограмм графика расположены следующие кнопки-пиктограммы:

*кнопка переключения режима отображения точек на всех кривых;
*кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси первого (X) и второго (Y) параметров расположены кнопки-пиктограммы «А» – кнопка переключения режима автоматического масштабирования значений.[[Файл:AgavaPLC–Виджет "Список событий".png|мини|Рисунок 34 – Виджет "Список событий"|ссылка=Файл:AgavaPLC–Виджет_%22Список_событий%22.png]]
====Виджет «Список событий»====
[[Файл:AgavaPLC–Окно выбора интервала.png|мини|Рисунок 35 – Окно выбора интервала]]Виджет предназначен для отображения регистрируемых событий в работе.

В верхней части виджета расположена панель управления (1).

Панель управления содержит органы управления журналом:

*кнопка отображения фильтра событий;
*кнопка включения следящего режима журнала;
*кнопка изменения интервала на один день назад;
*кнопка-индикатор выбора интервала, за который отображаются события;
*кнопка изменения интервала на один день вперед;
*кнопка вызова окна со списком активных тревог.

Ниже панели управления, в основном поле экрана, расположена таблица, содержащая зарегистрированные события.

Заголовок таблицы позволяет изменять порядок столбцов и включать сортировку по столбцам. Например, возможно включение сортировки событий сначала по времени, затем по группе. Заголовок таблицы имеет возможность отключения / включения отображения любого столбца.

При большом количестве записей в правой части таблицы появляется полоса прокрутки, позволяющая пролистывать список событий.

Нажатие на кнопку-индикатор выбора интервала вызывает окно выбора интервала (см. Рисунок 35):[[Файл:AgavaPLC–Окно "Фильтр".png|мини|Рисунок 36 – Окно "Фильтр"|ссылка=Файл:AgavaPLC–Окно_%22Фильтр%22.png]]После выбора нужного интервала для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события за выбранный интервал.
Нажатие на кнопку отображения окна фильтра вызывает соответствующее окно. Окно фильтра позволяет изменить содержимое основного окна журнала событий путем выбора групп и подгрупп событий, перечисленных в окне фильтра (см. Рисунок 36).

После выбора нужных групп и подгрупп для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события, принадлежащих выбранным группам.

====Виджет «Ввод значения»====
Виджет «Ввод значения» предназначен для отображения значения привязанного сигнала и его редактирования.
[[Файл:AgavaPLC–Виджет «Ввод значения» с отображением экранной цифровой клавиатуры.png|мини|Рисунок 37 – Виджет «Ввод значения» с отображением экранной цифровой клавиатуры|212x212пкс]]
После выбора узла для чтения/записи и соответствующего типа значения необходимо выбрать нужный тип ввода в разделе «Оформление».

Доступны следующие типы ввода:

*кнопки изменения – при нажатии на виджет появляются кнопки увеличения и уменьшения на заданный шаг изменения;
*кнопка редактирования – при нажатии на виджет появляется кнопка, при клике на которую открывается экранная цифровая клавиатура;

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

====Виджет «Выбор значения из списка»====
[[Файл:AgavaPLC–Виджет «Выбор значения из списка».png|мини|Рисунок 38 – Виджет «Выбор значения из списка»]]
Виджет «Выбор значения из списка» предназначен для отображения значения привязанного сигнала и его изменения в удобном для пользователя текстовом виде (см. Рисунок 37).

С помощью свойства «Список сопоставлений» задается соответствие между значением сигнала и выводимой в виджете строкой.

При нажатии на кнопку в правой части виджета отображается список всех сопоставлений. При выборе нужного элемента в списке в установленный узел производится запись нового значения.

====Виджет «Флаг»====
[[Файл:AgavaPLC–Варианты внешнего вида виджета «Флаг».png|мини|Рисунок 39 – Варианты внешнего вида виджета «Флаг»]]
Виджет «Флаг» предназначен для отображения значения и изменения булевой переменной (true/false). Состояние true отображается в виде галочки (см. Рисунок 38).

При нажатии на виджет значение переменной изменяется на противоположное.

В случае, если флаг необходимо использовать только для отображения информации, поставьте галочку в свойстве «Отключен»

====Виджет «Отчет»====
[[Файл:AgavaPLC–Виджет «Отчет» в режиме отображения сформированного отчета.png|мини|Рисунок 40 – Виджет «Отчет» в режиме отображения сформированного отчета]]
Виджет «Отчет» предназначен для формирования отчетов по заранее спроектированному макету.

Подробный порядок создания и редактирования отчетов приведен в разделе [[#Отчеты]].
[[Файл:AgavaPLC–Окно выбора интервала отчета.png|мини|Рисунок 41 – Окно выбора интервала отчета]]
В верхней части виджета размещена панель управления, содержащая кнопки вызова команд:

* печать сформированного отчета на установленном в системе принтере;
*сохранение сформированного отчета в файле формата PDF;
*переход к предыдущей странице отчета;
*переход к следующей странице отчета;
*масштабирование экрана по ширине листа отчета;
*масштабирование экрана по высоте листа отчета.

При формировании отчета для изменения интервала времени, за который будет формироваться отчет, необходимо на панели управления щелкнуть кнопку выбора интервала (на ней отображается текущий выбранный интервал, например, «Начало суток без смещения – Конец суток без смещения»). Далее появится окно «Интервал», в котором можно выбрать начало и конец интервала (см. Рисунок 41).

В качестве начала и конца интервала можно выбрать как конкретную дату по календарю, так относительную, например, «Начало дня», "Конец недели". После выбора желаемого интервала необходимо нажать кнопку «ОК».

Выбранный интервал отобразится на панели управления отчетом. Для формирования отчета за выбранный интервал необходимо нажать кнопку «Сформировать отчет». Через некоторое время, после загрузки данных из БД и их обработки, экран обновится и сформированный отчет за выбранный интервал будет отображен.

{{Шаблон:Действия AgavaSCADA/AgavaPLC}}

==Система тревог==
Система тревог предназначена для оповещения пользователя об обнаруженных нарушениях.

Система содержит два типа узлов:

*Группа событий.
*Контроллер событий.

===Группа событий===
Группа событий – узел, предназначенный для взаимодействия с виджетом «Список событий». Группы событий позволяют группировать события по какому-то признаку, например по уровню тревоги (авария, предупреждение, квитирование и т.д.), технологическому участку и т.д.

Для каждой группы можно выбрать свой цвет шрифта и фона, которые будут использоваться для вывода событий, принадлежащих этой группе в виджете "Список событий".

В свойстве «Описание» группы событий указывается текст, который будет отображаться в фильтре списка событий.

===Монитор событий===
Монитор событий (ранее - Контроллер событий) – узел, реализующий логику проверки соответствия выбранных сигналов контролируемым условиям. Контроллеры событий выполняют всю работу по проверке значений контролируемых параметров и выполнению соответствующих действий.

Монитор событий проверяет значения заданных узлов на соответствие заданным условиям и при их совпадении выполняет заданные действия.

В качестве действий можно указать не только действие "Создание события", но и другие (см. раздел [[#Действия]]).
[[Файл:AgavaPLC-Cистема тревог.png|мини|Cистема тревог]]

===Порядок настройки системы===
Порядок настройки системы тревог следующий:
#Добавить в проект систему тревог. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система тревог».
#Добавить узел «События» в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Группа» - «События». При необходимости настроить цвет шрифта и фона, которые будут отображаться у события в окне тревог или журнале.
#Добавить нужные [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|группы событий]] в узел «События». Для этого нажать ПКМ по узлу «События» в дереве проекта, затем выбрать «Добавить узел» - «Группа событий».
#Добавить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9A.D0.BE.D0.BD.D1.82.D1.80.D0.BE.D0.BB.D0.BB.D0.B5.D1.80 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|контроллеры событий]] в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Контроллер событий».
#Добавить в свойство «Сигналы» контроллеров событий узлы, состояние которых необходимо контролировать.
#Задать для этих узлов контролируемые условия в соответствующем свойстве контроллера событий.
#Настроить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действия]], которые будут выполняться при выполнении контролируемого условия. Для вывода аварий, предупреждений или информационных сообщений необходимо добавить действие «Создание события».
# Настроить действие «Создание события». В его свойстве «Группа событий» указать группу из созданных в пункте 2. Ввести тексты сообщения активации и деактивации (при необходимости), указать уровень события. Теперь, при срабатывании контролируемого условия, будет появляться окно тревог с сообщением активации.

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

Архивация параметров производится с помощью архиваторов. Архиваторы SQLite и PostgreSQL могут выполнять [[Узлы проекта AgavaSCADA/AgavaPLC#Прореживание данных|прореживание данных]].
[[Файл:AgavaPLC-Настройка архиватора.png|мини|505x505пкс|Настройка архиватора]]

===Порядок настройки системы===
Для сохранения истории изменения значений параметров в БД необходимо выполнить следующие действия:

#Добавить в проект систему архивации. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система архивации».
#Добавить в систему архивации архиватор. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем выбрать «Добавить узел» - «Архиватор в БД SQLite».
#Настроить параметры архиватора, такие как: путь до файла БД, интервал архивирования (как часто система архивации будет опрашивать значение параметра), интервал сохранения БД на диск (как часто эти значения будут записываться в постоянную память), разбиение БД (будет ли система архивации создавать новый файл БД каждые сутки), период хранения и режим выдачи значений для построения графика (сохраняемые значения будут обновляться с частотой интервала архивирования, а сохраненные - с частотой интервала сохранения).
#Добавить параметры в коннекторы база данных. Для этого необходимо открыть свойство архиватора «Коннекторы БД», выбрать «Создать новый» - «Коннектор БД». После этого нужно нажать по добавленному коннектору, открыть его свойство «Сигналы» и добавить параметр, значение которого необходимо сохранять в БД.

=== Архиватор SQLite===
Архиватор SQLite предназначен для сохранения значений параметров в БД формата SQLite.

Для извлечения и просмотра баз данных формата SQLite с устройств может использоваться программа «[[Архиватор]]».

====Свойства узла "Архиватор SQLite"====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
| Путь до файла БД
|FilePath
|STRING
|Чтение / запись
|Путь до файла БД. Абсолютный или относительный.
|-
|Интервал архивирования
|Interval
|INT
|Чтение / запись
|Интервал архивирования, мс.
|-
|Период хранения
|Retention
|INT
|Чтение / запись
|Период хранения, дней.
|-
|Разбиение БД
|DBSplitting
|BOOL
|Чтение / запись
|Разбиение БД на файлы. При включении база данных будет разделяться на отдельныйе файлы, содержащие данные за одни сутки.
|-
|Интервал сохранения БД на диск
|StoringInterval
|INT
|Чтение / запись
|Интервал сохранения БД на диск, мс.
|-
|Режим выдачи значений
|ValueReturnMode
|ENUM
|Чтение / запись
|Режим выдачи значений. Режим "Сохраняемые в БД" - данные выдаются сразу после получения архиватором, возможно до фактического сохранения в БД. Режим "Сохраненные в БД" - данные выдаются только после фактической записи в БД на диск.
|-
|Коннекторы БД
|Signals
|NODESARRAY
|Чтение / запись
|Список коннекторов, содержащих сигналы для архивирования.
|-
|Текущий размер БД
|DBCurrentSize
|INT
|Только чтение
|Текущий размер БД, Мб.
|-
|Максимальный размер БД
|DBMaxSize
|INT
|Только чтение
|Максимальный размер БД, Мб.
|-
|Состояние БД
|DBStatus
|INT
|Только чтение
|Состояние БД.
|}

==== Статусы операций SQLite ====
В ходе работы SQLite возвращает статус выполнения операций в виде целочисленных значений. Далее приведена расшифровка этих кодов.
{| class="wikitable"
!Код
!Краткое описание
!Подробное объяснение
|-
|'''0 (SQLITE_OK)'''
|Успешно
|Операция завершилась без ошибок. Всё прошло штатно.
|-
|'''1 (SQLITE_ERROR)'''
|Общая ошибка
|Непредвиденная ошибка SQL. Может быть вызвана синтаксической ошибкой в запросе или другой общей проблемой. Пользователю стоит проверить SQL-запрос.
|-
|'''2 (SQLITE_INTERNAL)'''
|Внутренняя ошибка
|Ошибка в логике самой SQLite. Обычно не связана с действиями пользователя.
|-
|'''3 (SQLITE_PERM)'''
|Нет доступа
|Недостаточно прав для выполнения операции (например, чтение/запись файла базы данных). Нужно проверить права доступа.
|-
|'''4 (SQLITE_ABORT)'''
|Прервано
|Выполнение операции было прервано обратным вызовом (callback). Обычно не ошибка, а результат логики программы.
|-
|'''5 (SQLITE_BUSY)'''
|База данных занята
|Файл БД заблокирован другим процессом. Нужно подождать или повторить попытку позже.
|-
|'''6 (SQLITE_LOCKED)'''
|Таблица заблокирована
|Конкретная таблица заблокирована другим соединением. Нужно освободить блокировку или использовать WAL-режим.
|-
|'''7 (SQLITE_NOMEM)'''
|Недостаточно памяти
|Не удалось выделить память. Проблема на уровне системы, а не базы.
|-
|'''8 (SQLITE_READONLY)'''
|Только для чтения
|Попытка записи в базу, открытую в режиме "только чтение". Нужно открыть её с правом записи.
|-
|'''9 (SQLITE_INTERRUPT)'''
|Прервано пользователем
|Операция остановлена вызовом <code>sqlite3_interrupt()</code>. Обычно пользователь сам прерывает длительный запрос.
|-
|'''10 (SQLITE_IOERR)'''
|Ошибка ввода/вывода
|Ошибка чтения или записи с диска. Может означать сбой диска или проблемы с файловой системой.
|-
|'''11 (SQLITE_CORRUPT)'''
|Повреждённая база
|Файл базы данных повреждён. Необходимо восстановление из резервной копии.
|-
|'''12 (SQLITE_NOTFOUND)'''
|Неизвестная операция
|Обнаружен неизвестный код операции при работе с файловым интерфейсом. Обычно внутренняя ошибка.
|-
|'''13 (SQLITE_FULL)'''
|Нет места
|Диск или файл достиг предельного размера. Нужно освободить место.
|-
|'''14 (SQLITE_CANTOPEN)'''
|Не удалось открыть файл
|SQLite не смогла открыть базу данных. Возможны проблемы с путём или правами доступа.
|-
|'''15 (SQLITE_PROTOCOL)'''
|Ошибка протокола блокировки
|Нарушен внутренний протокол синхронизации между процессами. Обычно связано с конкурентным доступом.
|-
|'''16 (SQLITE_EMPTY)'''
|Внутреннее использование
|Этот код зарезервирован, не используется в обычных операциях.
|-
|'''17 (SQLITE_SCHEMA)'''
|Схема изменилась
|Во время выполнения запроса изменена структура таблицы или индекса. Запрос нужно выполнить заново.
|-
|'''18 (SQLITE_TOOBIG)'''
|Слишком большие данные
|Строка или BLOB превышают допустимый размер. Нужно уменьшить данные.
|-
|'''19 (SQLITE_CONSTRAINT)'''
|Нарушено ограничение
|Нарушено ограничение (например, UNIQUE, FOREIGN KEY, CHECK). Данные не могут быть вставлены/обновлены.
|-
|'''20 (SQLITE_MISMATCH)'''
|Несовпадение типов
|Тип данных не соответствует ожидаемому (например, текст в числовом поле).
|-
|'''21 (SQLITE_MISUSE)'''
|Некорректное использование API
|Функции SQLite использованы неправильно. Ошибка в коде программы, а не в данных.
|-
|'''22 (SQLITE_NOLFS)'''
|Нет поддержки файловой системы
|Операция требует возможности, которой нет в ОС (например, большие файлы на старой FS).
|-
|'''23 (SQLITE_AUTH)'''
|Отказ в авторизации
|Запрос отклонён по соображениям безопасности (например, триггер или расширение).
|-
|'''24 (SQLITE_FORMAT)'''
|Не используется
|Код зарезервирован, не применяется.
|-
|'''25 (SQLITE_RANGE)'''
|Параметр вне диапазона
|Неверный индекс параметра при связывании (<code>sqlite3_bind_*</code>). Ошибка в логике кода.
|-
|'''26 (SQLITE_NOTADB)'''
|Не база данных
|Файл, открытый как база, не является файлом SQLite. Возможно, повреждён или подменён.
|-
|'''27 (SQLITE_NOTICE)'''
|Уведомление
|Сообщение информационного характера из <code>sqlite3_log()</code>. Не ошибка.
|-
|'''28 (SQLITE_WARNING)'''
|Предупреждение
|Сообщение о потенциальной проблеме из <code>sqlite3_log()</code>. Обычно не критично.
|-
|'''100 (SQLITE_ROW)'''
|Есть ещё данные
|<code>sqlite3_step()</code> вернул строку данных — нужно вызывать дальше, чтобы получить все строки.
|-
|'''101 (SQLITE_DONE)'''
|Завершено
|<code>sqlite3_step()</code> завершил выполнение без ошибок. Все строки обработаны.
|}

=== Архиватор PostgreSQL ===
Архиватор PostgreSQL предназначен для сохранения значений параметров в базы данных под управлением сервера PostgreSQL.

=== Прореживание данных ===
Прореживание данных (data thinning) — это процесс фильтрации и уменьшения количества точек данных, сохраняемых в архиве. Вместо того чтобы записывать каждое полученное значение, система анализирует поток данных и сохраняет только те значения, которые представляют значимое изменение.

'''Назначение прореживания'''

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

* '''Снижение нагрузки на архив''': Меньшее количество записей означает более быструю работу базы данных.
* '''Ускорение отображения графиков''': Нужно обрабатывать меньше точек для построения трендов.
* '''Сохранение только значимых изменений''': Система отфильтровывает шум и оставляет только те изменения, которые важны для анализа технологического процесса.
'''Общий принцип работы'''

Алгоритм прореживания работает по простому принципу:

# SCADA-система получает новое значение от источника данных.
# Она сравнивает это значение с последним, которое было сохранено в архив.
# Если изменение превышает заранее настроенный '''допуск''' (tolerance), новое значение сохраняется.
# Если изменение меньше допуска, значение пропускается.

Кроме того, существует параметр "'''Период обязательной записи"'''. Если с момента последней записи прошло больше времени, чем указано в этом параметре, новое значение будет сохранено '''независимо от его изменения'''. Это гарантирует, что записи в архив будут сохраняться не реже заданной периодичности, даже если сигнал не меняется. Ключевая идея: "'''Сохраняем только то, что заметно изменилось, но не реже, чем задано".'''

'''Как подобрать допуск?'''

* '''Слишком малый допуск''' приведёт к записи избыточных данных, и архив будет быстро расти.
* '''Слишком большой допуск''' может привести к потере мелких, но значимых изменений в сигнале.

Выбор правильного допуска — это компромисс между детализацией данных и размером архива.
==== Типы алгоритмов прореживания ====
В системе доступны несколько алгоритмов, которые определяют, как именно вычисляется «значимость» изменения. Выбор алгоритма зависит от характера сигнала и требований к точности данных.

# [[Узлы проекта AgavaSCADA/AgavaPLC#Абсолютный допуск|Абсолютный допуск]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от последнего значения|Процент от последнего значения]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего N последних|Процент от среднего N последних]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего по временному окну|Процент от среднего по временному окну]]

'''Обозначения и определения'''

В дальнейшем используются следующие обозначения (для числовых сигналов):

* <math>x_{in}</math> — текущее измерение сигнала, полученное от источника данных к моменту обработки (кандидат на запись).
* <math>x_{ref}</math> — последнее сохранённое числовое значение сигнала в архиве на момент обработки (опорное значение).
* <math>|\Delta| = |x_{in} - x_{ref}|</math> — абсолютная величина изменения между текущим измерением и последним сохранённым значением.
* <math>\bar{x}_N</math> — арифметическое среднее последних <math>N</math> сохранённых числовых значений.
* <math>\bar{x}_T</math> — среднее всех сохранённых числовых значений, чьи метки времени попадают в временное окно длительности <math>T</math> миллисекунд.
* <math>\varepsilon</math> — машинная точность для чисел двойной точности; используется для формальной проверки «близости к нулю».
* <math>tolerance</math> — допуск: абсолютный (в физических единицах) или относительный (в процентах), в зависимости от выбранного алгоритма.

'''Настройки в Свойствах архиватора, общие для всех типов прореживания'''

* '''Включить прореживание''' — включает/выключает применение алгоритма прореживания при записи значений. При выключении все поступающие значения сохраняются без фильтрации.
* '''Тип допуска''' — выбирает алгоритм сравнения.
* '''Период обязательной записи (мс)''' — максимальный допустимый промежуток между двумя записями одного сигнала. Если за это время значимого изменения не произошло, ближайшее поступившее значение будет записано принудительно. 0 — отключить принудительную запись.

===== Абсолютный допуск =====
'''Принцип:'''

Новое значение сохраняется, если модуль изменения больше установленного порога в физических единицах.

<math display="block">|\Delta| > tolerance</math>

'''Когда использовать:'''

* Если диапазон сигнала стабилен и известен заранее.
* Для параметров вроде температуры, давления, уровня жидкости, где фиксированное изменение имеет одинаковую интерпретацию по всей шкале.

'''Преимущества:'''

* Обеспечивает предсказуемое и детерминированное поведение независимо от текущего масштаба значения.
* Не требует накопления или хранения дополнительных данных (окон/истории), вычислительно прост.
* Удобен при наличии нормативно заданных пределов точности в физических единицах.

'''Ограничения:'''

* Не масштабируется на широкий динамический диапазон: один и тот же порог может быть слишком грубым для малых значений и слишком чувствительным для больших.
* Требует аккуратного подбора порога под единицы измерения и разрешение датчика; при неверной калибровке возможны либо избыточные записи, либо потеря значимых мелких изменений.
* Не учитывает относительный контекст изменения (например, 1 единица при значении 10 и при значении 10 000 трактуется одинаково).

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — абсолютный порог в физических единицах сигнала. Определяет значение <math>tolerance</math>.

===== Процент от последнего значения =====
'''Принцип:'''

Новое значение сохраняется, если относительное изменение относительно последнего сохранённого превышает заданный процент.

<math display="block">\frac{|\Delta|}{|x_{ref}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов, где важна относительная динамика, а не абсолютные величины.
* Для показателей с большим динамическим диапазоном, где относительная точность должна быть сопоставима на всех уровнях.

'''Преимущества:'''

* Масштабируемость: одинаково интерпретирует относительные изменения на низких и высоких уровнях сигнала.
* Не требует хранения окна значений; использует только последнее сохранённое значение, поэтому вычислительно лёгок.
* Быстро и корректно реагирует на пропорциональные изменения процесса (проценты), поддерживая заданную относительную чувствительность.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).
* При малых базовых значениях возможна повышенная чувствительность к шуму и микроколебаниям.
* Не подавляет высокочастотный шум сам по себе: при необходимости сочетать с обязательной записью по времени и корректной настройкой допуска.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

===== Процент от среднего N последних =====
'''Принцип:'''

Новое значение сохраняется, если изменение больше заданного процента от среднего по последним N сохранённым значениям.

<math display="block">\frac{|\Delta|}{|\bar{x}_{N}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с постоянным шумом или пульсациями, когда важно снижать чувствительность к случайным отклонениям.
* Для процессов с умеренной динамикой, где требуется устойчивость к «зубчатым» колебаниям.

'''Преимущества:'''

* Снижает чувствительность к высокочастотному шуму за счёт опоры на усреднение; сокращает объём записей на стационарных участках.
* Гибко настраивается параметром <math>N</math>: увеличение окна повышает устойчивость, уменьшение — повышает чувствительность и снижает задержку реакции.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).

* Инерционность: при резких скачках возможна задержка фиксации изменения, особенно при большом <math>N</math>.
* Усреднение может «сглаживать» и не фиксировать кратковременные, но важные пики; не подходит для задач, критичных к коротким экстремумам.
* Предполагает относительно стабильную частоту выборок; при сильно переменной частоте эффективная «временная» ширина окна становится непредсказуемой.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Размер окна среднего (<math>N</math>)''' — число последних сохранённых значений, по которым считается среднее. Большее <math>N</math> повышает устойчивость к шуму, но увеличивает инерционность реакции.

===== Процент от среднего по временному окну =====
'''Принцип:'''

Похож на предыдущий, но среднее считается не по количеству точек, а по всем значениям за заданный интервал времени.

<math display="block">\frac{|\Delta|}{|\bar{x}_{T}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с непостоянной частотой измерений (событийные, неравномерные потоки).
* В случаях, когда важно учитывать реальную временную протяжённость усреднения независимо от плотности измерений.

'''Преимущества:'''

* Корректно работает при переменной частоте выборок: окно фиксируется по времени, а не по числу точек.
* Более реалистично оценивает тренд во времени на участках с неравномерными измерениями.
* Управляемый компромисс между подавлением шума и чувствительностью за счёт выбора длительности окна.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. [[Узлы проекта AgavaSCADA/AgavaPLC#Примечание к алгоритмам 'Процент от…'|примечание]]).

* Более высокая ресурсоёмкость: требуется хранить и периодически «очищать» значения по условию выхода из временного окна; потребление памяти зависит от фактической скорости поступления данных.
* Инерционность, присущая усреднению: возможна задержка фиксации коротких, но значимых пиковых изменений.
* Критичен выбор длительности окна: слишком малое окно даёт мало подавления шума, слишком большое — чрезмерную инерцию и риск пропуска кратких событий.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Интервал архивирования''' — длительность временного окна <math>T</math> (мс), в пределах которого вычисляется среднее. При увеличении <math>T</math> растёт сглаживание и уменьшается чувствительность к кратким всплескам; при уменьшении — наоборот. Значения, чьи метки времени выходят за пределы окна, автоматически исключаются из расчёта.

===== Примечание к алгоритмам 'Процент от…' =====
При малых опорных значениях система автоматически переходит в абсолютный режим, чтобы избежать деления на величину, близкую к нулю, и связанных с этим скачков чувствительности. Этот механизм применяется ко всем алгоритмам, использующим относительное сравнение: «Процент от последнего», «Процент от среднего N», «Процент от среднего по временному окну» и обеспечивает стабильность критерия при слабых сигналах.

* Условия входа в режим абсолютного допуска:
** для «Процента от последнего»: <math>|x_{ref}| < \varepsilon</math>;
** для «Процента от среднего N»: <math>|\bar{x}_{N}| < \varepsilon</math>;
** для «Процента от среднего по времени»: <math>|\bar{x}_{T}| < \varepsilon</math>.
* Критерий в режиме абсолютного допуска: значение фиксируется, если <math>|\Delta| > tolerance</math>.
* Условие выхода: как только соответствующая базовая величина (<math>|x_{ref}|</math>, <math>|\bar{x}_{N}|</math> или <math>|\bar{x}_{T}|</math>) становится <math>\geq \varepsilon</math>, система автоматически возвращается к относительному критерию.
* Трактовка <math>tolerance</math>: используется то же значение настройки; в абсолютном режиме оно интерпретируется как порог в физических единицах сигнала.

===== Сравнение алгоритмов прореживания данных =====
{| class="wikitable"
!Критерий
!Абсолютный
!% от последнего
!% от среднего N
!% от среднего по времени
|-
|Единицы допуска
|Физические
|Проценты
|Проценты
|Проценты
|-
|Устойчивость к шуму
|Низкая
|Средняя
|Высокая
|Высокая
|-
|Реакция на резкие скачки
|Быстрая
|Быстрая
|Задержка (при большом N)
|Задержка
|-
|Подходит при переменной частоте
|Да
|Да
|Нет
|Да
|}

==Система журналирования==
Система ведения журналов событий предназначена для управления регистрацией и хранением событий. В базу данных записываются все системные события и события, генерируемые с помощью [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.A1.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D0.B0 .D1.82.D1.80.D0.B5.D0.B2.D0.BE.D0.B3|системы тревог]], которые соответствуют выбранному уровню сообщений.

Для ведения журналов используются узлы типа "Логгер".

===Порядок настройки системы===
Порядок настройки системы журналирования следующий:

#Добавить и [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9F.D0.BE.D1.80.D1.8F.D0.B4.D0.BE.D0.BA .D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8 .D1.81.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D1.8B|настроить систему тревог]] для генерации событий.
#Добавить в проект систему журналирования. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система журналирования».
#Добавить в систему журналирования логгер. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем нажать «Добавить узел» и выбрать нужный логгер.
#Настроить параметры логгера (см. разделы ниже).

=== Логгер SQLite===
Логгер SQLite предназначен для сохранения событий, возникающих в ходе исполнения прикладной программы в СУБД SQLite.

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

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

===Логгер файловый ===
Логгер файловый предназначен для сохранения журналов событий в текстовых файлах на накопителе. Логгер имеет минимальное количество настроек, и обычно используется для сохранения журнала событий в случае необходимости отладки работы прикладной программы без среды разработки.

===Логгер SMS===
Логгер SMS предназначен для SMS информирования с помощью субмодуля GRPS или внешнего GPRS модема.

Принцип работы логгера следующий:

#Логгер принимает возникающие события, фильтрует их согласно установленного уровня событий и выбранных групп.
#События, прошедшие фильтрацию, форматируются согласно установленного шаблона.
#Отформатированные сообщения отправляются через подключенный модем в виде SMS сообщения. Отправка сообщений производится на телефонные номера, записанные в телефонной книге на SIM-карте.

==Система проверки прав пользователей==
[[Файл:AgavaPLC-Окно привилегий.png|мини|494x494пкс|Окно привилегий]]
Система реализует механизм контроля доступа к узлам проекта и их функциях на основе ролей. Узлы при выполнении действий проверяют наличие установленных привилегий у авторизованного в данный момент пользователя.

=== Роли и пользователи ===
Система содержит в себе две подсистемы:
*Пользователи. Подсистема определяет пользователей, каждому из которых назначается логин/пароль и одна или несколько ролей.
*Роли. Роли хранят наборы доступных привилегий.
Отношения между пользователями, ролями и привилегиями можно описать следующим образом:

* Один пользователь может иметь несколько ролей.
* Одну роль могут иметь несколько пользователей.
* Одна роль может иметь несколько привилегий.
* Одна привилегия может принадлежать нескольким ролям.

=== Привилегии ===
[[Файл:AgavaPLC-Система проверки прав пользователей.png|мини|Система проверки прав пользователей]]
Для узлов системы доступна установка следующих привилегий:

Все узлы:

*Чтение значения.
*Запись значения.
Окна и фреймы:
*Открытие окна.
*Закрытие окна.

При установке привилегий на какой-либо узел, все подчиненные узлы получают те же привилегии с флагом "унаследована".

Если привилегия не установлена, то считается что действие, регулируемое привилегией, запрещено.

Значение унаследованных привилегий можно переопределить с помощью явного задания привилегии.
===Порядок настройки системы===
Привилегии настраиваются в отдельном окне привилегий, доступном в меню "Вид".

Порядок настройки системы проверки прав в версии AgavaSCADA 1.2 следующий:

#Добавить в проект систему проверки прав пользователей. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система проверки прав пользователей».
#Добавить в систему проверки прав пользователей узел «Роль». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Роли».
#Добавить в узел «Роли» необходимые роли. Для этого нажать ПКМ по узлу «Роли» в дереве проекта, затем выбрать «Добавить узел» - «Роль».
#Для каждой роли настроить привилегии в окне привилегий. Для этого необходимо нажать «Вид» - «Открыть привилегии». В открывшемся окне в выпадающем списке «Пользователь / роль» выбрать нужную роль. Затем, нажимая ПКМ по узлам и выбирая «Добавить привилегию» настроить все необходимые ограничения для данной роли.
#Добавить в систему проверки прав пользователей узел «Пользователи». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Добавить в узел «Пользователи» необходимых пользователей. Для этого нажать ПКМ по узлу «Пользователи» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Для каждого пользователя указать имя и пароль, которые будут использоваться при авторизации, и выбрать одну или несколько ролей.

== Сигналы, источники и операции ==
Регистры и другие узлы, добавленные в группу «Сигналы», являются внутренними для проекта и могут менять свои значения только с помощь скриптов или других узлов, с которыми они связаны.

Сигналы содержат в себе несколько подгрупп.

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

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

Первичное значение поступает на вход операции, производится вычисление. Если есть еще операции, то вычисленное значение после первой операции передается на вход второй. И так далее по всем операциям. Если операций больше нет, вычисленное значение устанавливается в качестве значения узла.

Все операции выполняются в порядке, в котором они заданы в соответствующих свойствах.

====Сигнал простой====
Узел типа "Сигнал простой" предназначен для хранения и обработки значения источника, или другого сигнала или операции. Позволяет произвести какие-либо действия с этим значением с помощью добавления нужных операций в свойство «Операции после чтения».

====Постоянная ====
Узел типа "Постоянная" предназначен для хранения данных выбранного формата и позволяет изменять их в ходе выполнения программы. Связывание с источником не предусмотрено. Изменение осуществляется с помощью специализированных функций или блока установки значения в задаче ПЛК.

====Массив====
Массив - совокупность каких-либо объектов, указанных в свойстве «Входные значения». Нумерация объектов в массиве начинается с 0. Может использоваться для взаимодействия с демультиплексором.

====Сигнал комплексный====
Сигнал используется для взаимодействия с виджетом «Цифровой индикатор». Позволяет контролировать входное значение и генерировать события переходу входного значения через уставки.

Содержит в себе свойства для настройки следующих параметров:

*ВАУ – верхняя аварийная уставка;
*ВПУ - верхняя предаварийная уставка;
*НПУ - нижняя предаварийная уставка;
*НАУ – нижняя аварийная уставка;
*ФНЧ – фильтр низких частот.

===Источник===
Источник - специальный тип узлов, предназначенных для передачи данных от внешних устройств.

====Регистр Modbus====
Регистр Modbus используется для приема и передачи данных по протоколам Modbus-RTU, Modbus-TCP. Данный тип узов также может использоваться для организации работы некоторых алгоритмов программы (например для взаимодействия с контроллером событий).

====Источник индексный====
Узел типа "Источник индексный" используется для обработки данных, полученных по протоколу Upd, а так же в массивах для индексации значений.

===Операция===
[[Файл:AgavaPLC-Входные значения операций.png|мини|Входные значения операций]]
Узлы типа "Операция" используются для реализации вычислительных алгоритмов в задаче ПЛК или отдельно, при их размещении в группе "Сигналы".

В качестве входных значений операций выбираются константные числа, другие узлы группы «Сигналы», регистры или блоки задачи ПЛК.

====Операция «Сложение»====
Выходным значением является сумма входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Вычитание»====
Выходным значением является разность первого входного значения и суммы всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Умножение»====
Выходным значением является произведение значений всех входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Деление»====
Выходным значением является результат от деления первого входного значения на произведение всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Условие»====
Узел типа "Операция условие" предназначен для сравнения значений двух узлов. Для условия задаются сравниваемые параметры и выбирается режим сравнения. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Пара условий»====
[[Файл:AgavaPLC-Операция «Пара условий».png|мини|Операция «Пара условий»]]
Операция содержит в себе два условия. Для каждого условия задаются индивидуальные сравнимаемые параметры и выбирается режим сравнения.

Выходное значение операции зависит от ее режима проверки – при выбранном режиме «Логическое ИЛИ» выходное значение равно логической «1» если одно из условий равно «1», при «Логическом И»- если оба условия равны «1».

====Операция «Логическое ИЛИ»====
Если одно из входных значений становится равно логической «1» (контакты замкнуты), то выходное значение становится логической «1» (выход включен).

====Операция «Логическое И»====
Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

====Операция «Логическое НЕ»====
Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

====Операция «Таймер»====
Таймер предназначен для выполнения каких-либо [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действий]] через одинаковые промежутки времени (например запись значения в узел). Промежуток между исполнениями действий задается в свойстве «Интервал срабатывания», а сами действия в свойстве «Действия OnTimer». Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

====Операция «Мультиплексор»====
Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...».

Например если в качестве входных значений указаны два регистра, то выходное значение мультиплексора будет формироваться следующим образом:
{| class="wikitable"
!Значение регистра 1
!Значение регистра 2
!Выходное значение
|-
|0
|0
|0
|-
|1
|0
|1
|-
|0
|1
|2
|-
|1
|1
|3
|}

====Операция «Демультиплексор»====
Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

====Операция «Генератор случайного числа»====
Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями. Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

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

Для выполнения скрипта, можно добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения. Другим способом вызова срабатывания скрипта является добавление его в [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.92.D1.8B.D0.BF.D0.BE.D0.BB.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5 .D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0.C2.BB|действие «Выполнение скрипта»]].

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

*void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

===Объект===
Узлы типа "Объект" предназначены для взаимодействия с аппаратными компонентами контроллера. Для всех объектов, являющихся субмодулями, необходимо указать слот, в котором они установлены. Доступ к значениям входов/выходов субмодуля осуществляется через его вложенные узлы.

'''ПЛК процессорный модуль'''

Предоставляет возможность регулирования подсветки экрана; включения и отключения индикаторов работы, аварии и программы.

'''ПЛК субмодуль DI'''

Позволяет получать доступ к значениям входов субмодуля DI.

'''ПЛК субмодуль R'''

Позволяет управлять значениями выходов субмодуля R.

'''ПЛК субмодуль SIM'''

Позволяет управлять значениями выходов субмодуля SIM.

'''ПЛК субмодуль DO6'''

Позволяет управлять значениями выходов субмодуля DO6.

'''ПЛК субмодуль AI'''

Позволяет получать доступ к значениям входов субмодуля AI и задавать их тип.

'''ПЛК субмодуль AIO'''

Позволяет получать доступ к значениям входов субмодуля AIO, управлять значениями выходов и задавать тип входов и выходов.

'''ПЛК субмодуль TMP'''

Позволяет получать доступ к значениям входов субмодуля TMP и задавать их тип.

==Задачи==
Группа «Задачи» предназначена для группировки узлов типа «Задача», которые используются для циклического или разового выполнения созданных пользователем алгоритмов.

===Задача ПЛК===
Данный узел предоставляет возможности для связывания между собой других узлов (таких как сигналы, субмодули ПЛК, постоянные и т. д.) в удобной графической форме (см. Рисунок 64). Для перехода к редактору необходимо щелкнуть правой кнопкой мыши на задачу ПЛК и выбрать в открывшемся контекстном меню команду «Открыть графическое представление» или дважды щелкнуть левой кнопкой мыши на задаче ПЛК в дереве проекта.

Рисунок 64 – Окно графического редактирования задачи «ПЛК-60»

Панель инструментов задачи ПЛК, расположенная в верхней части окна, содержит следующие элементы (см. Рисунок 16):

*Выпадающий список выбора режима подписи портов.
*Выпадающий список выбора режима подписи блоков.
*Кнопка запуска режима симулятора.
*Кнопка запуска онлайн отладки.
*Кнопка печати задачи.
*Инструменты управления симуляцией.

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

Созданную связь можно удалить, выделив ее левой кнопкой мыши и нажав клавишу "Del". Связь можно "разорвать", то есть добавить разрыв, нажав по ней правой кнопкой мыши и выбрав в контекстном меню команду «Добавить разрыв».

Для выделения нескольких блоков рамкой зажмите клавишу "Shift" и выделяйте блоки мышью с нажатой левой кнопкой.

Задача ПЛК предоставляет возможности для проведения тестирования и отладки проекта, описанные в разделе [[#Проверка и отладка проекта]].

====Блоки задачи ПЛК====
Помимо операций, описанных в разделе [[#Операция]], для реализации алгоритмов в задачу ПЛК можно добавлять блоки, описанные ниже.

'''Функциональный блок'''

Используется для выделения каких-либо действий в отдельный блок, для упрощения понимания работы алгоритма программы. Содержит входы, выходы и блоки, обеспечивающие работу внутренней логики. Позволяет проводить изолированную отладку, при которой значения на входах функционального блока вручную задаются пользователем. Блок, работающий в данном режиме выделяется черной рамкой. Для включения изолированной отладки необходимо открыть блок и нажать кнопку «Изолированная отладка» на панели управления задачей.

'''Блок установки значения'''

Блок осуществляет запись значения, поданного на вход in0, в узел, указанный в свойстве «Узел для чтения/записи»

'''Блок задержки'''

Блок задержки используется для создания задержки передачи значения с входа блока на выход на один цикл обработки задачи.

'''Блок «Битовое OR»'''

Для вычисления значения будет произведена операция "ИЛИ" над каждым битом значения в отдельности. Например: 1010 OR 0110 = 1110

'''Блок «Логическое И»'''

Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

'''Блок «Битовое AND»'''

Для вычисления значения будет произведена операция "И" над каждым битом значения в отдельности. Если все биты, стоящие на одинаковых позициях в двоичных представлениях значений, поступающих на входы блока, равны логической «1», то на выходе элемента в этой позиции появляется логическая «1» (выход включен). Например: 1010 AND 0110 = 0010

'''Блок «Логическое НЕ»'''

Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

'''Блок «Битовое XOR»'''

Если только на один из входов блока функции поступает логическая «1», то на выходе элемента появляется логическая «1». Если на входы блока функции поступают целочисленные значения, то операция будет произведена над каждым битом значения в отдельности. Например: 1010 XOR 0110 = 1100

'''Блок «Битовое SHR»'''

Побитовый логический сдвиг вправо используется для выполнения операции побитового логического сдвига операнда X вправо на N бит с дополнением нулями слева.

'''Блок «Битовое SHL»'''

Побитовый логический сдвиг влево используется для выполнения операции побитового логического сдвига операнда X влево на N бит с дополнением нулями справа.

'''Блок «Таймер»'''

Таймер предназначен для выполнения каких-либо действий (см. раздел 4.6) через одинаковые промежутки времени (например запись значения в узел).

'''Блок «Мультиплексор»'''

Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...»

'''Блок «Демультиплексор»'''

Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

'''Блок «Генератор случайного числа»'''

Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями.

'''Блок «Скрипт С++»'''

Операция «Скрипт С++» предназначена для реализации разнообразных алгоритмов на языке С++. Операция предусматривает реализацию одной или нескольких функций, выполняющих необходимые пользователю действия. Для выполнения скрипта, необходимо добавить его в качестве узла для задачи или задачи ПЛК.

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

* void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

'''Блок «Таймер с задержкой»'''

Таймер с задержкой используется для операции задержки передачи и/или отключения сигнала. На выходе таймера появится сигнал логической «1» с задержкой относительно фронта входного сигнала продолжительностью равной интервалу включения и выключится по спаду входного сигнала с задержкой продолжительностью равной интервалу выключения. В том случае, если необходимо использовать блок только как таймер с задержкой включения (отключения) интервал выключения (включения) устанавливается равным 0.

'''Блок «Генератор прямоугольных импульсов»'''

Генератор прямоугольных импульсов используется для формирования прямоугольных импульсов пульсации. На выходе генератора формируются импульсы с заданными параметрами длительности включенного и отключенного импульса на время действия управляющего сигнала на входе (сигнал логической «1»).

'''Блок «Триггер RS»'''

RS-триггер с приоритетом выключения используется для переключения с фиксацией состояния во время поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Триггер SR»'''

SR-триггер с приоритетом включения используется для переключения с фиксацией состояния в случае поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Детектор переднего фронта импульса»'''

Детектор переднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «0» в «1».

'''Блок «Детектор заднего фронта импульса»'''

Детектор заднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «1» в «0».

'''Блок «D-триггер»'''

D-триггер используется для формирования импульса включения выхода на интервал времени импульса на входе D, выходной интервал будет синхронизирован с тактовой частотой на входе С. На выходе Q триггера появится сигнал логической «1» по фронту тактовых импульсов на входе С при наличии сигнала логической «1» на входе D. Возврат выхода в сигнал логического «0» произойдет по фронту тактовых импульсов на входе С при наличии сигнала логического «0» на входе D. Вход Set принудительно устанавливает выход в состояние логической «1». Вход Reset является приоритетным и устанавливает выход в состояние логического «0».

'''Блок «Селектор»'''

Если на вход Value подается логическая «1», то результатом выполнения операции блока на выходе является входной сигнал ValueT. Если же Value равен логической «0», то результатом выполнения операции блока на выходе является входной сигнал ValueF.

'''Блок «Больше чем»'''

На выход подается логическая «1», если значение in0 больше чем значение in1.

'''Блок «Равенство»'''

На выход подается логическая «1», если значение in0 равно значению in1.

'''Блок «Абсолютное значение числа»'''

Результатом операции функции на выходе является модуль подаваемого на вход значения. Если число на входе положительное, то на выход подается само число, если отрицательное – положительное число, получаемое от перемены его знака с «-» на «+».

'''Блок «Возведение в степень»'''

Результатом операции функции на выходе является значение, равное значению in0, возведенному в степень значения N.

'''Блок «PID-регулятор»'''

Регулятор PID применяется для поддержания заданного значения параметра. На вход Pv подается текущее значение регулируемой величины, на Sp – ее заданное значение. С помощью изменения коэффициентов ПИД регулятора kP, kI и kD достигается оптимальный режим работы. Min задает минимальное значение на выходе, Max – максимальное. time - период регулятора (в мс.).

'''Блок «PWM-регулятор»'''

Применяется для преобразования аналогового сигнала в дискретный с помощью ШИМ. На вход in подается текущее значение регулируемой величины, Min задает минимальное значение на входе, Max – максимальное. time - период регулятора (в мс.)

==Устройства==
Группа «Устройства» предназначена для группировки узлов типа "Устройство", выполняющие разнообразные задачи, например работа с внешними накопителями и ПЗУ.

Retain-накопитель дает возможность хранить значения регистров, постоянных и сигналов в постоянной памяти контроллера, что позволяет им сохранять свои значения после отключения питания.

Для сохранения переменных необходимо перечислить их в свойстве «Узлы» и указать путь сохранения на выбранном накопителе.

== Отчеты==
{{Внимание|Тип=Восклицание желтый.png|Текст=Данный узел доступен только при исполнении проекта на настольном компьютере. На панелях оператора и контроллерах МПР этот узел не доступен.}}
Отчет – технологический документ, содержащий информацию о ходе производственного процесса, обработанную по заложенным в отчет алгоритмам. Отчеты формируются на основе макетов (статической части отчетов) путем добавления в них свойств и значений заданных параметров технологического процесса, которые формируются (выбираются из базы данных технологических параметров и проходят соответствующую обработку) по алгоритмам, размещенным в этих шаблонах.

Данные для отчета предоставляет выборка, осуществляющая получение данных и их обработку из базы данных.

===Создание нового отчета===
Создание любого отчета производится в два этапа.

#Создание необходимых узлов в конфигурации: сам отчет и необходимое количество выборок.
#Составление макета отчета.

Создание узла типа «Отчет» в конфигурации и выборок для него производится аналогично созданию узлов других типов. К станции добавляется узел типа «Отчеты» с помощью команды контекстного меню «Добавить узел», далее к узлу типа «Отчеты» добавляется отчет и к отчету добавляется необходимое количество выборок.

Выборка – специальный узел, предназначенный для выборки данных из архива и их обработки для последующего отображения в отчете.

Перед переходом к редактированию макета желательно проделать следующие операции:

*в свойстве отчета «Путь к файлу отчета» установить имя файла, в котором будет храниться макет отчета;
* в свойстве «Источники» выборки (выборок) отчета установить перечень архивных сигналов (коннекторов), которые будут выводиться в отчете.

===Редактирование макета отчета===
[[Файл:AgavaPLC–Редактор макета отчета.png|мини|Рисунок 42 – Редактор макета отчета]]
Для редактирования макета отчета необходимо переключиться из редактора конфигурации в редактор макета отчета с помощью команды «Открыть редактор макета отчета», доступной из контекстного меню дерева конфигурации, отображаемого при щелчке правой кнопкой мыши на узле типа «Отчет».

В окне редактора расположены:

*панели инструментов;
* панель объектов отчета;
*окно «Инспектор объектов»;
*окно «Инспектор данных»;
*окно «Инспектор скриптов»;
*область построения макета отчета;
*окно «Структура отчета».

Редактор макета позволяет вызывать команды сочетаниями клавиш:

*Ctrl + N – новый макет;
*Ctrl + O – загрузить макет;
*Ctrl + S – сохранить макет;
*Ctrl + Shift + S – сохранить макет под новым именем;
*Ctrl + P – предварительный просмотр;
*Ctrl + Z – отмена изменений;
*Ctrl + Shift + Z – возврат отмененных изменений;
* Ctrl + C – копировать объект;
*Ctrl + X – вырезать объект;
*Ctrl + V – вставить объект;
*Ctrl + Стрелки – переместить выделенный объект;
*Shift + Стрелки – изменить размер выделенных объектов;
*Del – удалить выделенные объекты;
*Shift + левая кнопка мыши – создать область выделения.

====Окно «Инспектор объектов»====
Окно «Инспектор объектов» содержит список свойств выделенного объекта и предназначено для их редактирования.

====Окно «Инспектор данных»====
Окно «Инспектор данных» содержит список доступных для использования источников данных (выборок) и предназначено для заполнения блока «Данные» элементами соответствующего типа.

====Окно «Инспектор скриптов»====
Окно «Инспектор скриптов» содержит список доступных для использования в отчете скриптов.

====Окно «Структура отчета»====
Окно «Структура отчет» отображает структуру отчета в виде дерева связанных элементов.

===Элементы отчета===
Для составления макета отчета доступны следующие элементы:

*текст;
*данные;
*изображение;
*фигура;
*компоновка (Layout).

====Текст====
Элемент «Текст» служит для вывода надписей или содержимого полей источников данных.

Объект «Текст» обладает очень широкими возможностями. Он умеет отображать текст, рамку, заливку. Текст может быть отображен любым шрифтом любого размера, цвета и стиля. Большинство настроек делаются визуально с помощью панелей инструментов.

Одна из самых главных особенностей этого универсального объекта – это возможность отображения не только статичного текста, но и текста с применением вычисляемых выражений. Причем, выражения могут располагаться в объекте вперемешку с текстом. Рассмотрим простой пример – поместим в объект «Текст» следующую строку: «Привет! Сегодня $S{now()}».

Если запустить отчет на построение, мы увидим приблизительно следующее: «Привет! Сегодня 20180803». В процессе построения отчета выражение в тексте, заключенное $S{}, было вычислено и полученное значение вставлено обратно в текст. Объект «Текст» может содержать любое количество выражений, смешанных с обычным текстом. В скобки можно заключать и одиночные переменные, и выражения, например, $S{1+2*(3+4)}. В выражениях можно использовать константы, переменные ($V{}), функции, поля БД ($D{}).

Свойства элемента «Текст»:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|alignment
|Выравнивание текста по вертикали и горизонтали
|-
|angle
|Поворот надписи
|-
|autoHeight
|Автоматический подбор высоты
|-
|autoWidth
|Автоматический подбор ширины
|-
|backgroundColor
|Цвет заливки
|-
|backgroundMode
|Режим заливки
|-
| backgroundOpacity
|Прозрачность заливки
|-
|borders
|Границы
|-
|content
|Содержимое объекта «Текст»
|-
|font
|Шрифт
|-
|fontColor
|Цвет шрифта
|-
| foregroundOpacity
|Прозрачность шрифта
|-
|geometry
|Размер и расположение объекта
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|margin
|Отступы
|-
|objectName
| Имя объекта
|-
|stretchToMaxHeight
|Установка значения высоты самого высокого объекта на бэнде
|-
|trimValue
|Удаление пробелов в начале и в конце надписи
|}

Для редактирования свойства «Content» используется диалоговое окно «Text Item Editor», вызов которого осуществляется двойным щелчком левой кнопки мыши на элементе «Текст».

Свойство «Content» может содержать:

*текст;
*значения переменных;
*значения полей из набора данных;
*значения, формируемые посредством исполнения скрипта.

Для вывода значений переменных используется синтаксис «$V{имяПеременной}» (без кавычек), для вывода значения поля данных – «$D{имяНабораДанных.ИмяПеременной}», для вывода результата исполнения скрипта – «$S{телоСкрипта}».

==== Изображение ====
Элемент для вывода изображений:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoSize
|Подгонять размер под размер изображения
|-
|borders
|Границы
|-
|content
|
|-
|datasource
|Источник данных
|-
|field
|Поле данных
|-
|geometry
|Размер и расположение
|-
|image
|Изображение
|-
| itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
| stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Фигура====
Элемент для вывода фигур:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
| geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|lineWidth
|Толщина линии
|-
|objectName
|Имя объекта
|-
|opacity
|Прозрачность
|-
|penStyle
|Стиль линии
|-
|shape
|Фигура
|-
|shapeBrush
|Стиль заливки
|-
|shapeBrushColor
|Цвет заливки
|-
|shapeColor
|Цвет фигуры
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Горизонтальная компоновка (Layout)====
Элемент, позволяющий объединять несколько элементов в группу:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
|geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

=== Разделы отчета (бэнды) ===
Бэнд предназначен для размещения других элементов отчета. Бэнд может быть нескольких типов:

*Report Header – заголовок отчета;
*Report Footer – завершение отчета;
*Page Header – верхний колонтитул страницы отчета;
*Page Footer – нижний колонтитул страницы отчета;
*Data – данные отчета;
* SubDetail – подчиненные данные отчета;
*SubDetailHeader – заголовок подчиненных данных;
*SubDetailFooter – завершение подчиненных данных;
*GroupHeader – заголовок группы;
*GroupFooter – завершение группы.

Бэнды применяются для логической группировки объектов. К примеру, размещение объекта на элементе «Данные» типа «Page Header», приводит к отображению этого объекта в верхней части каждой страницы готового отчета. Аналогичным образом «Page Footer» выводится внизу каждой страницы со всеми лежащими на нем объектами.

Общие для всех элементов «Данные» свойства:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoHeight
|Автоматический подбор высоты
|-
|backgroundColor
|Цвет заливки бэнда
|-
|borders
|Границы
|-
|geometry
|Размер
|-
|keepBottomSpace
|Сохранение отступа от нижней границы бэнда
|-
|objectName
|Имя объекта
|-
|printIfEmpty
|Отображение пустого бэнда
|-
|splittable
|Разделение бэнда, если он не влезает на страницу
|}

Report Footer:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|maxScalePercent
|Максимальный процент, на который можно уменьшить бенд, если он не влезает на страницу. Если бэнд даже после сжатия

не влезает на страницу, он будет перенесен полностью или частично – в зависимости от настроек бэнда
|}

Data:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|datasource
|Источник данных. Data-бэнд будет сформирован для каждой строки в источнике данных
|-
|keepFooterTogether
|Если Report Footer не влезает на страницу, то он будет перенесен на следующую страницу совместно с последним

экземпляром Data-бэнда
|-
|sliceLastRow
| Указывает генератору отчетов на то, можно ли разрезать последний экземпляр Data-бэнда или его нужно перенести

целиком
|}

Бэнды данного типа предназначены для вывода на печать данных из наборов. Набор данных - это заранее неизвестное количество строк (записей), каждая из которых содержит определенное количество колонок (полей).

SubDetail:
{| class="wikitable"
! Наименование свойства
!Описание
|-
|datasource
| Источник данных. SubDetail-бэнд будет сформирован для каждой строки в источнике данных
|}

SubDetailHeader, SubDetailFooter:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|printAlways
| Печатать, даже если SubDetail пустой
|}

GroupHeader:
{| class="wikitable"
!Наименование свойства
! Описание
|-
|groupFieldName
|Поле, по которому осуществляется группировка. Экземпляр GroupHeader будет формироваться при смене значения в этом поле
|}

===Функции===
==== Агрегатные функции ====
Агрегатные функции предназначены для обработки значений, содержащихся в резделах Data и SubDetail.

===== AVG - вычисление среднего значения =====
Пример использования:
$S{AVG("TextItem4","DataBand1");}

===== SUM - вычисление суммы значений =====
Пример использования:
$S{SUM("TextItem8","DataBand1");}

===== MIN =====

===== MAX =====

===== COUNT =====

==== Числовые функции ====

===== numberFormat - форматирование числа =====
Синтаксис:
numberFormat(значение, 'формат', точность)
Форматы:

* <code>'f'</code> — фиксированная запись (например, <code>"123.45"</code>);
* <code>'g'</code> — общий формат (автоматически выбирает между <code>'f'</code> и <code>'e'</code>);
* <code>'e'</code> — экспоненциальная запись (например, <code>"1.2345e+02"</code>);

Пример использования:
$S{numberFormat($D{fetcharchiverdata1.ArchiversSourceConnector0 (среднее)}, 'f', 3)} -> 123.495
[[Категория:AgavaSCADA/AgavaPLC]]

Узлы проекта AgavaSCADA/AgavaPLC

2025-10-29T12:18:16Z

SharipovRR:

== Узлы проекта ==
Узел - элементарная сущность проекта, осуществляющая хранение информации или реализующая определенный функционал. Каждый узел обладает набором [[Свойства узлов в AgavaSCADA/AgavaPLC|свойств]]. Все узлы, объединенные в иерархическую структуру, образуют проект.

== Проект ==
[[Файл:AgavaPLC–Дерево проекта.png|мини|Рисунок 21 – Дерево проекта]]
Узел "Проект" ("Корневой узел", "Корень") предназначен для хранения общей информации о проекте и связывания других узлов проекта.

== Станция ==
Станция – важнейший узел, управляющий работой собственных систем и выполняющий обмен данными с другими станциями. Физически станция представляет собой устройство, на котором исполняется проект (компьютер, панель оператора, МПР-60 или другое устройство).

Для использования в проекте доступны несколько типов станций. например:

* '''Станция''' - общий тип станции. Проекты с такой станцией могут выполняться на большинстве устройств - контроллеры, панели, персональные компьютеры. Чаще всего используется для проектов, предназначенных для выполнения на персональном компьютере.
* '''Панель ПО-40''' - специализированный тип для проектов на панелях оператора ПО-40. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.
* '''Панель ПО-50''' - специализированный тип для проектов на панелях оператора ПО-50. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.).
* '''Контроллер МПР-60''' - специализированный тип для проектов на программируемых реле МПР-60. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием устройства (светодиоды индикации и др.), использования корзины субмодулей.
* '''Контроллер ПЛК-70.A''' - специализированный тип для проектов, предназначенных для контроллеров АГАВА ПЛК-70.А. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием контроллера (светодиоды индикации и др.), использования корзины субмодулей.

При построении больших проектов станций в проекте может быть несколько, и они могут выполнять разные задачи. Например, станция-сервер выполняет сбор и регистрацию данных, клиентские станции выполняют визуализацию данных на рабочих местах и т. д.

Станции подчиняются узлы типа "Система" - Транспортная система, Система архивирования, Система визуализации и т. д.

== Транспортная система ==
Транспортная система управляет передачей данных по различным каналам связи. Система управляет работой "Транспортов" - узлов, выполняющих обмен данными с устройствами по определенному протоколу.

С одной стороны, транспортная система обращается непосредственно к сигналам и каналам устройства, а с другой стороны, представляет их в виде неких универсальных единиц – узлов-источников. Каждый источник однозначно соответствует определенному сигналу или параметру устройства. При изменении сигнала меняется и значение источника. При записи данных в источник производится подача команды устройству на установку определенного значения конкретного параметра.

Транспортная система допускает использование нескольких транспортов, что дает возможность одновременного обмена данными с большим количеством устройств по разным протоколам.

=== Транспорт ===
Транспорт предназначен для обмена данными с устройствами по определенному протоколу. Один транспорт, в зависимости от типа, позволяет обмениваться данными с одним или несколькими устройствами.

Доступны для использования следующие виды транспортов:

* Транспорт Modbus-TCP;
* Транспорт Modbus-RTU;
* Транспорт SNMP;
* Транспорт OPC UA;
* Транспорт OPC DA (только для Windows);
* Транспорт MQTT;
* Последовательный транспорт (устаревший);
* TCP/IP транспорт (устаревший).
Подробное описание транспортов приведено в отдельном документе "[[Транспорты AgavaSCADA/AgavaPLC]]".

==Система визуализации==
{{Внимание|Тип=Восклицание желтый.png|Текст=Система визуализации недоступна в проектах для контроллеров МПР}}

Задачей этой системы является отображение данных в виде набора мнемонических схем (экранов, мнемосхем), а также предоставление пользователю возможности управления.

Каждый экран позволяет в схематичном, понятном пользователю виде представить участок технологической схемы с отображением необходимых параметров технологического процесса.

Изображение на экране строится с помощью окон, на которых размещаются объекты визуализации – виджеты. Виджетами могут быть текстовые метки, изображения, в том числе анимированные, элементы управления, графики и т. д. Виджеты можно объединять в слои для удобного управления отображением виджетов.

Виджеты могут быть статическими и динамическими. Динамические виджеты привязаны к одному или нескольким сигналам и их отображение зависит от значений этих сигналов. Статические виджеты не имеют привязки к сигналам и их изображение всегда постоянно.

Для перехода по экранам, изменения значений параметров и иного управления служат специальные виджеты: кнопки управления, поля ввода и другие.

Для повышения быстродействия и увеличения комфортности работы с системой система визуализации хранит в памяти кэш из нескольких последних открытых экранов. Когда при последовательном открытии экранов этот кэш заполняется, наиболее старые экраны удаляются из него. Это связано с тем, что, как правило, в работе используются несколько одних и тех же экранов, которые отображают сводную информацию о техпроцессе и оператор в штатном режиме переключается только между ними. Сохраняя их в памяти, система ускоряет переключение между ними, поскольку при этом не требуется каждый раз создавать экран, все находящиеся на нем объекты и запускать процессы обновления параметров.

Когда экран переходит в кэш, обновление параметров на нем прекращается для снижения нагрузки на центральный процессор. Если все же необходимо, чтобы экран всегда производил обновление данных (по разным причинам), даже находясь в кэше, необходимо в его настройках включить опцию «Постоянно обновляемый».

Подчиненные типы узлов:

*фрейм;
*окно;
*композиция.

===Фрейм===
[[Файл:AgavaPLC–Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией.png|мини|Рисунок 23 – Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией]]
Фрейм – узел, предназначенный для группировки окон, отображаемых на определенном дисплее. Обеспечивает организацию окон в пространстве экрана, управление мониторами и границами отображения.

Если необходимо отобразить информацию на нескольких дисплеях одновременно, то для каждого из них нужно использовать отдельный фрейм. Окон во фрейме может быть несколько, однако они не могут накладываться друг на друга.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
|-
|Позиция X
|XCoord
|int
|Координата X левого верхнего угла фрейма
|Целое число
|-
|Позиция Y
|YCoord
|int
|Координата Y левого верхнего угла фрейма
|Целое число
|-
|Ширина
|XSize
|int
|Ширина фрейма в пикселях
|Целое число > 0
|-
|Высота
|YSize
|int
|Высота фрейма в пикселях
|Целое число > 0
|-
|Окна
|Windows
|NodesArray
|Список окон, принадлежащих фрейму
|Узлы типа: Window
|-
|Номер монитора
|DisplayNo
|int
|Номер монитора для отображения фрейма
|0 - по умолчанию
≥1 - конкретные мониторы
|-
|Тип границы
|BorderType
|enum
|Тип границы фрейма
|0: Не определен (ошибка)
1: Отсутствует

2: Фиксированная
|}

==== Позиция и размеры (XCoord, YCoord, XSize, YSize) ====

* '''Тип:''' int.
* '''Описание:''' Определяют положение и размеры фрейма на экране.
* '''Значения по умолчанию:''' (0, 0, 640, 480).
* '''Применение:''' Задание области экрана, которую занимает фрейм.

==== Окна (Windows) ====
'''Тип:''' NodesArray.

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

'''Особенности:'''

* Поддерживаются только узлы типа Window.

==== Номер монитора (DisplayNo) ====
'''Тип:''' int.

'''Описание:''' Определяет, на каком мониторе системы отображается фрейм. Значение 0 соответствует монитору по умолчанию.

'''Использование:'''

* 0 - основной монитор.
* 1, 2, ... - дополнительные мониторы.
* Свойство важно для многомониторных конфигураций.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип обрамления фрейма. Влияет на внешний вид и поведение границ.

'''Значения:'''

* '''Отсутствует''' - фрейм без видимых границ.
* '''Фиксированная''' - стандартная граница окна.
* '''Не определен''' - используется только для обработки ошибок.

==== Наследование привилегий ====
Фрейм автоматически добавляет доступные привилегии для работы с окнами:

* <code>OpenWindow</code> - привилегия на открытие окон.
* <code>CloseWindow</code> - привилегия на закрытие окон.

===Окна===
Окно – узел, осуществляющий отображение видеокадра (мнемонической схемы).

Существуют несколько видов окон:

1. «Форма», предназначенная для вывода простого набора данных без необходимости управления видимостью или внешним видом его элементов. Для вывода информации в такое окно кроме создания окна и добавления к нему виджетов ничего более не требуется.
[[Файл:AgavaPLC-Меню.png|мини|164x164пкс|Рисунок 24 — Внешний вид меню в среде исполнения]]
2. «Окно с композицией», предназначенное для вывода большого количества информации и позволяющее организовать группировку элементов по слоям, управлять внешним видом элементов, видимостью слоев и отдельных элементов, а также дающее возможность регулирования работы пользователя с элементами. Для вывода информации в такое окно нужно к окну привязать композицию, содержащую минимум один слой, в который уже добавляются виджеты.

=== Форма ===
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Модальность
|Modality
|enum
|Режим модальности окна
|0: Не определен (ошибка)
1: Немодальное

2: Модальное (Фрейм)

3: Модальное (Система)
|Чтение/Запись
|-
|Тип границы
|BorderType
|enum
|Тип границы окна
|0: Не определен (ошибка)
1: Фиксированная

2: Изменяемая

3: Отсутствует
|Чтение/Запись
|-
|Отображать строку заголовка
|TitleEnabled
|bool
|Отображать строку заголовка
|true/false
|Чтение/Запись
|-
|Отображать кнопку "Закрыть"
|CloseEnabled
|bool
|Отображать кнопку "Закрыть"
|true/false
|Чтение/Запись
|-
|Цвет фона
|BackgroundColor
|NColor
|Цвет фона окна
|Цвет в формате RGBA
|Чтение/Запись
|-
|Затемнение
|NeedDarkenApplication
|bool
|Затемнение других окон приложения при открытии этого окна
|true/false
|Чтение/Запись
|-
|Цвет затемнения
|ColorDarkenApplication
|NColor
|Цвет затемнения
|Цвет в формате RGBA
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов, мс
|0 - без задержки
>0 - интервал в мс
|Чтение/Запись
|-
|Действия OnShow
|ActionsOnShow
|NodesContainer
|Действия при показе окна
|Узлы типа: Action
|Чтение/Запись
|-
|Действия OnClose
|ActionsOnClose
|NodesContainer
|Действия при закрытии окна
|Узлы типа: Action
|Чтение/Запись
|}

==== Модальность (Modality) ====
'''Тип:''' enum.

'''Описание:''' Определяет поведение окна относительно других окон приложения.

'''Значения:'''

* '''Немодальное''' - позволяет взаимодействовать с другими окнами.
* '''Модальное (Фрейм)''' - блокирует взаимодействие с окнами в том же фрейме.
* '''Модальное (Система)''' - блокирует все окна приложения.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип и поведение границ окна.

'''Значения:'''

* '''Фиксированная''' - окно нельзя изменять размер.
* '''Изменяемая''' - пользователь может изменять размер окна.
* '''Отсутствует''' - окно без видимых границ.

==== Управление заголовком (TitleEnabled, CloseEnabled) ====
'''Тип:''' bool.

'''Описание:''' Контролируют отображение элементов заголовка окна.

==== Фон и затемнение (BackgroundColor, NeedDarkenApplication, ColorDarkenApplication) ====
'''Тип:''' NColor, bool, NColor.

'''Описание:''' Управляют визуальным оформлением окна и его влиянием на другие окна.

'''Особенности:'''

* Затемнение применяется только при NeedDarkenApplication = true.
* Цвет затемнения по умолчанию: черный с прозрачностью 50%.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Определяет частоту обновления виджетов в окне.

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчики событий (ActionsOnShow, ActionsOnClose) ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых при показе и закрытии окна.

=== Окно с композицией ===
Данный узел имеет те же свойства, что и форма, а также собственные:
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Композиция
|CompositionId
|NodeLink
|Основная композиция окна
|Узлы типа: CompositionLayered, CompositionTemplated
|Чтение/Запись
|-
|Описание текущей композиции
|CurrentCompositionDesc
|string
|Описание текущей загруженной композиции
|Автоматически формируется
|Только чтение
|}

==== Композиция (CompositionId) ====
'''Тип:''' NodeLink.

'''Описание:''' Ссылка на композицию, отображаемую в окне.

'''Поддерживаемые типы:''' CompositionLayered, CompositionTemplated.

==== Описание текущей композиции (CurrentCompositionDesc) ====
'''Тип:''' string.

'''Описание:''' Автоматически обновляемое описание загруженной композиции.

'''Особенности:''' Свойство только для чтения, обновляется системой автоматически.[[Файл:AgavaPLC-Настройка меню в среде разработки.png|мини|226x226пкс|Рисунок 25 — Настройка меню в среде разработки]]

===Композиция===
Композиция – узел, представляющий составленную при разработке проекта мнемоническую схему в виде набора элементов визуализации (виджетов), сгруппированных в один или несколько слоев.

Композиция дает возможность организовать виджеты в слои, видимостью которых можно управлять во время работы проекта.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Размеры
|Size
|NSize
|Размеры композиции
|Структура {ширина, высота}
|Чтение/Запись
|-
|Кэширование
|Cacheable
|bool
|Кэширование данных композиции для быстрого повторного открытия
|true/false
|Чтение/Запись
|-
|Источник интервала обновления
|UpdateIntervalSource
|enum
|Определяет источник интервала обновления виджетов
|0: Окно
1: Композиция
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов в миллисекундах
|Целое число ≥ 0
|Чтение/Запись
|-
|Действия OnLoad
|ActionsOnLoad
|NodesContainer
|Действия при загрузке композиции
|Узлы типа: Action
|Чтение/Запись
|}

==== Размеры (Size) ====
'''Тип:''' NSize (ширина, высота).

'''Описание:''' Определяет размеры композиции в пикселях. По умолчанию установлены значения 800x600.

==== Кэширование (Cacheable) ====
'''Тип:''' bool.

'''Описание:''' Включает или отключает кэширование данных композиции. При включенном кэшировании композиция сохраняется в памяти для быстрого повторного открытия.

'''Преимущества кэширования:'''

* Быстрое переключение между композициями.
* Снижение нагрузки на систему при частом использовании.
* Сохранение состояния элементов.

'''Рекомендации:''' Включать для часто используемых композиций, отключать для редко используемых или ресурсоемких.

==== Источник интервала обновления (UpdateIntervalSource) ====
'''Тип:''' enum.

'''Описание:''' Определяет, откуда виджеты композиции получают интервал обновления.

'''Значения:'''

* '''Окно''' - интервал обновления наследуется от родительского окна.
* '''Композиция''' - используется собственный интервал обновления композиции.

'''Применение:''' Централизованное управление производительностью через окно или индивидуальная настройка для каждой композиции.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Задает интервал обновления виджетов в миллисекундах. При значении 0 отрисовка виджетов выполняется без задержки (максимальная частота).

'''Особенности:'''

* 0 - обновление без задержек (может создать высокую нагрузку).
* > 0 - обновление с заданным интервалом. Учитывается только при UpdateIntervalSource = "Композиция"

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчик событий ActionsOnLoad ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых после загрузки композиции <code>AS 1.6.27+</code>.

===Слой===
Слой – набор виджетов, объединенных каким-то общим структурным признаком. В многослойных композициях слой обеспечивает организацию виджетов в z-порядке, управление видимостью и взаимодействием с пользователем. С помошью свойства "Видимость" слоя можно управлять видимостью виджетов, размещенных на слое.

Свойства
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Z-Порядок
|ZOrder
|int
|Порядок слоя в композиции
|Целое число (чем выше значение, тем выше слой)
|Чтение/Запись
|-
|Прозрачность для действий
|ActionTransparency
|enum
|Определяет поведение слоя при взаимодействии с пользователем
|0: Не определен (ошибка)
1: Непрозрачный

2: Прозрачный
|Чтение/Запись
|-
|Видимость
|Visible
|bool
|Видимость слоя и всех его виджетов
|true/false
|Чтение/Запись
|}

==== Z-Порядок (ZOrder) ====
'''Тип:''' int

'''Описание:''' Определяет порядок отображения слоя относительно других слоев в композиции. Слои с большим значением ZOrder отображаются поверх слоев с меньшим значением.

'''Пример использования:'''

* Фоновый слой: ZOrder = 1.
* Основной контент: ZOrder = 2.
* Контекстные виджеты: ZOrder = 3.

==== Прозрачность для действий (ActionTransparency) ====
'''Тип:''' enum

'''Описание:''' Управляет взаимодействием слоя с пользовательскими действиями (клики, наведения и т.д.)

'''Значения:'''

* '''Непрозрачный''' - слой полностью перехватывает пользовательские действия, элементы под ним недоступны, даже если они видимы.
* '''Прозрачный''' - пользовательские действия проходят сквозь слой к элементам ниже.

Обратите внимание: если на слое размещается изображение с прозрачной областью, то такие виджеты не позволяют пользователю взаимодействовать с видимыми и размещенными под ним виджетами.

==== Видимость (Visible) ====
'''Тип:''' bool

'''Описание:''' Определяет видимость всего слоя и всех его дочерних виджетов. При значении false слой и все его содержимое становится невидимым.

'''Применение:''' Временное скрытие виджетов или переключение их видимости.

===Виджет===
Виджет – элемент визуализации, предназначенный для отображения информации в заданном виде.

===Меню===
Меню – элемент визуализации, сочетающий в себе несколько виджетов «Кнопка». Используется для более удобного управления проектом (см. Рисунок 24).

Для добавления меню, необходимо в среде разработки назначить [[Универсальная среда разработки#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.9E.D1.82.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5 .D0.BC.D0.B5.D0.BD.D1.8E.C2.BB|действие «Отображение меню»]] для кнопки (или любого другого виджета). После добавления действия необходимо выделить его и нажать на кнопку настроек на панели вверху окна действий. Открывшееся окно (см. Рисунок 25) содержит дерево со структурой меню, в который можно добавлять элементы двух типов:

*меню – элемент, который позволяет группировать элементы меню, выводя их в виде раскрывающегося списка. На рисунках 24 и 25 этим элементом являются кнопки «Арочник» и «БПО».
*элемент меню – элемент, который предоставляет функционал, аналогичный [[Универсальная среда разработки#.D0.92.D0.B8.D0.B4.D0.B6.D0.B5.D1.82 .C2.AB.D0.9A.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0.C2.BB|виджету «Кнопка»]]. Для добавления действия, выполняющегося при нажатии на элемент меню в среде исполнения, необходимо нажать на него ПКМ в дереве структуры меню и выбрать "Создать действие". На рисунках 24 и 25 этим элементом являются кнопки «Котельная», «Котёл №1», «Котёл №2» и «Котёл №3».

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

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

# Добавить дополнительные фреймы, чтобы их количество в проекте соответствовало количеству дисплеев. Каждому фрейму назначить порядковый номер, начиная с 1. Фреймы связываются с дисплеями по номеру.
# Добавить дополнительное окно (или окна, если в исходном фрейме их несколько или дополнительных фреймов больше одного).
# Добавить в дополнительные фреймы созданные на этапе 2 окна, чтобы повторить структуру основоного фрейма.

Базовая настройка на этом закончена. После запуска такого проекта на двух или более дисплеях должны отображаться созданные окна.

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

===Виджеты===
====Виджет «Текстовая метка»====
[[Файл:AgavaPLC–Примеры оформления виджетов типа "Текстовая метка".png|мини|Рисунок 26 – Примеры оформления виджетов типа "Текстовая метка"]]
Виджет «Текстовая метка» – наиболее часто применяемый виджет, с помощью которого можно реализовать разные способы отображения текстовой информации.

Виджет «Текстовая метка» может использоваться для отображения статичного текста, значений параметров (одного или нескольких) и их комбинаций.

При необходимости отображения значений параметров они указываются в свойстве «Источник». Для задания определенного формата отображения используются спецификаторы формата в стиле языка «Си»:

*%f – значение в виде числа с плавающей точкой;
* %s – строка;
*%i – целое число со знаком;
*%u – целое число без знака;
* %d – целое число со знаком в десятичной системе исчисления.

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

Для отображения знака «%» необходимо указать его дважды: «%%».

===== Отображение нескольких значений =====
Одна текстовая метка может использоваться для отображения нескольких значений. Для этого все значения, которые нужно отобразить, указываются в свойстве «Источник», а в свойстве «Текст» указываются последовательно несколько спецификаторов формата соответственно порядку перечисления значений в свойстве «Источник».

Пример: текстовая метка, отображающая текущую позицию в очереди:

* Текст: <code>Позиция %i из %i</code>
* Источник: два узла из проекта.

=====Модификаторы спецификаторов формата=====

======Модификатор минимальной ширины поля======
Целое число, расположенное между знаком % и кодом формата, играет роль модификатора минимальной ширины поля. Если указан модификатор минимальной ширины поля, то, чтобы ширина поля вывода была не меньше указанной минимальной величины, вывод при необходимости будет дополнен пробелами. Если же выводятся строки или числа, которые длиннее указанного минимума, то они все равно будут отображаться полностью. По умолчанию для дополнения используются пробелы. А если для этого надо использовать нули, то перед модификатором ширины поля следует поместить 0. Например, %05i означает, что любое число, количество цифр которого меньше пяти, будет дополнено таким количеством нулей, чтобы состоять из пяти цифр.

Примеры
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%i
|10
|-
|10.123
|%d
|10
|-
|10.123
|%05i
|00010
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
| 10.1
|-
|10.123
|%10f
|<пробел>10.123000
|-
|10.123
|%012f
|00010.123000
|}

======Модификатор точности======
Модификатор точности следует за модификатором минимальной ширины поля (если таковой имеется). Он состоит из точки и расположенного за ней целого числа. Значение этого модификатора зависит от типа данных, к которым его применяют.

Когда модификатор точности применяется к данным с плавающей точкой, для преобразования которых используются спецификаторы преобразования %f, %e или %E, то он определяет количество выводимых десятичных разрядов. Например, %10.4f означает, что ширина поля вывода будет не менее 10 символов, причем для десятичных разрядов будет отведено четыре позиции.

Если модификатор точности применяется к %g или %G, то он определяет количество значащих цифр.

Примененный к строкам, модификатор точности определяет максимальную длину поля. Например, %5.7s означает, что длина выводимой строки будет составлять минимум пять и максимум семь символов. Если строка окажется длиннее, чем максимальная длина поля, то конечные символы выводиться не будут.

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

Примеры:
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
|10.1
|-
|10.123
|%10.4f
|<пробел><пробел><пробел>10.1230
|-
|10.123
|%010.3f
|000010.123
|-
| Это простая проверка
|%10.15s
|Это простая про
|}

====Виджет «Условная метка» ====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условная метка".png|мини|Рисунок 27 – Список сопоставлений виджета "Условная метка"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условная_метка%22.png]]
Виджет «Условная метка» позволяет изменять выводимую строку в соответствии с изменениями привязанной к ней переменной.

Задать соответствие текста необходимому условию можно в свойстве «Список сопоставлений».

==== Виджет «Изображение»====
Виджет «Изображение» предназначен для отображения на окнах статичных изображений форматов png, gif, jpg, bmp или анимированных изображений в формате gif. Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Условное изображение»====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условное изображение".png|мини|Рисунок 28 – Список сопоставлений виджета "Условное изображение"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условное_изображение%22.png]]
Виджет «Условное изображение» позволяет изменять отображаемое изображение в соответствии с изменениями привязанной к нему переменной.

Задать соответствие изображения необходимому условию можно в свойстве «Список сопоставлений».

====Виджет «Движущееся изображение»====
Виджет предназначен для отображения на окнах изображений, перемещающихся в пределах области виджета. В основном используются на экране спящего режима.

Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Кнопка»====
Виджет «Кнопка» предназначен для реализации функций управления:

*ввод данных;
*передача управляющих воздействий;
* смена режима работы АРМ или иного устройства, исполняющего проект.

Выполнение всех функций виджета обеспечивается с помощью узлов типа «Действие», добавляемых в соответствующее свойство (см. раздел [[#Действия]]).

====Виджет «Гистограмма»====
[[Файл:AgavaPLC–Виджет "Гистограмма".png|мини|Рисунок 29 – Виджет "Гистограмма"|ссылка=Файл:AgavaPLC–Виджет_%22Гистограмма%22.png]]
Виджет предназначен для отображения значений сигналов в виде столбчатой диаграммы.

Виджету необходимо задать источник (регистр/сигнал, с которого он будет получать данные), а также минимальное и максимальное значения.

====Виджет «Исторический график»====
Виджет «Исторический график» предназначен для отображения графиков параметров на двухкоординатной области изображения с привязкой к осям времени и значений.

Виджет может работать с данными, архивируемыми в БД, и напрямую с сигналами, значения которых вычисляются в ходе работы.

При работе с архивируемыми данными интервал обновления графика зависит от режима выдачи значения у базы данных: при выборе сохраняемых в БД он будет соответствовать интервалу архивирования, а при сохраненных в БД - интервалу сохранения БД на диск. Независимо от режима выдачи, график не может обновляться меньше чем за 300 мс.

При работе напрямую с сигналами график обновляется при изменении значения сигнала, но также не чаще чем раз в 300 мс.
[[Файл:AgavaPLC–Экран «Архив» с виджетом «Исторический график».png|мини|Рисунок 30 – Виджет «Исторический график». Области кнопок-пиктограмм. В нижней части отображена легенда]]
Виджет «Исторический график» состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода данных.

На виджете имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 28):

#область пиктограмм графика;
#область пиктограмм оси времени (X);
#область пиктограмм оси значений (Y);
#область легенды.

В области пиктограмм графика слева направо расположены следующие кнопки-пиктограммы:

* кнопка переключения режима отображения точек на всех кривых;
* кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси времени (X) слева направо расположены следующие кнопки-пиктограммы:

*кнопка открытия окна выбора интервала времени для оси Х, текст кнопки отображает текущий выбранный интервал, например: 5М – 5 минут, 6Ч – 6 часов, 30М – 30 минут;
*кнопка-индикатор включения следящего режима.

В области пиктограмм оси значений (Y) расположена кнопка-пиктограмма «A» – кнопка переключения режима автоматического масштабирования значений.

=====Легенда=====
[[Файл:AgavaPLC–Легенда с четырьмя выключенными параметрами.png|мини|Рисунок 31 – Легенда с четырьмя выключенными параметрами]]
Легенда – специальная область в нижней части экрана архива, предназначенная для отображения параметров (наименование, текущее значение и т. д.) выводимых графиков в виде таблицы. Для ознакомления с примерным видом легенды см. Рисунок 31. Информация о каждом сигнале в легенде выводится в несколько колонок:

*«Цвет» – индицирует цвет, которым выводится соответствующая кривая на графике, колонка «Цвет» позволяет нажатием переключать видимость соответствующей кривой на графике (см. Рисунок 29). Также в колонке "Цвет" отображается номер пера, которым выводится кривая параметра на графике;
* «Имя» («Наименование») – содержит наименование параметра;
*«Время» – содержит время последнего зарегистрированного значения параметра;
*«Значение» – содержит последнее зарегистрированное значение параметра.

=====Режимы просмотра графиков=====
Пользователю доступно два режима просмотра графиков:

*следящий режим;
*режим просмотра истории.

В следящем режиме на графике всегда отображаются актуальные значения параметров, тренд периодически дочитывает поступившие данные из базы и обновляет графики.

В режиме просмотра истории на графике отображаются исторические значения параметров. Просмотр истории технологического процесса осуществляется с помощью кнопок перемещения по осям и кнопок изменения масштаба.

Режим просмотра истории включается автоматически при прокрутке графика назад по времени.

=====Визирная линия=====
[[Файл:AgavaPLC–График в режиме просмотра истории с установленной визирной линией.png|мини|Рисунок 32 – График в режиме просмотра истории с установленной визирной линией]]
Для просмотра значений параметров в нужный момент времени служит визирная линия, отображаемая на графике как вертикальная линия.

При щелчке левой кнопкой мыши (ЛКМ) в области графиков визирная линия будет отображена в выбранном месте графика.

В точке пересечения визирной линии и кривых параметров отображаются значения этих параметров. Также в нижней части области графиков, возле оси времени, визирная линия отображает время.

====Виджет «График кусочно-линейной функции»====
Виджет предназначен для отображения графика зависимости двух параметров, расположенном на осях X и Y.
[[Файл:AgavaPLC–Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм..png|мини|Рисунок 33 – Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм.]]
Виджет состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода графика.

На области вывода графика виджета имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 33):

#Область пиктограмм графика.
#Область пиктограмм оси первого параметра (X).
#Область пиктограмм оси второго параметра (Y).

В области пиктограмм графика расположены следующие кнопки-пиктограммы:

*кнопка переключения режима отображения точек на всех кривых;
*кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси первого (X) и второго (Y) параметров расположены кнопки-пиктограммы «А» – кнопка переключения режима автоматического масштабирования значений.[[Файл:AgavaPLC–Виджет "Список событий".png|мини|Рисунок 34 – Виджет "Список событий"|ссылка=Файл:AgavaPLC–Виджет_%22Список_событий%22.png]]
====Виджет «Список событий»====
[[Файл:AgavaPLC–Окно выбора интервала.png|мини|Рисунок 35 – Окно выбора интервала]]Виджет предназначен для отображения регистрируемых событий в работе.

В верхней части виджета расположена панель управления (1).

Панель управления содержит органы управления журналом:

*кнопка отображения фильтра событий;
*кнопка включения следящего режима журнала;
*кнопка изменения интервала на один день назад;
*кнопка-индикатор выбора интервала, за который отображаются события;
*кнопка изменения интервала на один день вперед;
*кнопка вызова окна со списком активных тревог.

Ниже панели управления, в основном поле экрана, расположена таблица, содержащая зарегистрированные события.

Заголовок таблицы позволяет изменять порядок столбцов и включать сортировку по столбцам. Например, возможно включение сортировки событий сначала по времени, затем по группе. Заголовок таблицы имеет возможность отключения / включения отображения любого столбца.

При большом количестве записей в правой части таблицы появляется полоса прокрутки, позволяющая пролистывать список событий.

Нажатие на кнопку-индикатор выбора интервала вызывает окно выбора интервала (см. Рисунок 35):[[Файл:AgavaPLC–Окно "Фильтр".png|мини|Рисунок 36 – Окно "Фильтр"|ссылка=Файл:AgavaPLC–Окно_%22Фильтр%22.png]]После выбора нужного интервала для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события за выбранный интервал.
Нажатие на кнопку отображения окна фильтра вызывает соответствующее окно. Окно фильтра позволяет изменить содержимое основного окна журнала событий путем выбора групп и подгрупп событий, перечисленных в окне фильтра (см. Рисунок 36).

После выбора нужных групп и подгрупп для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события, принадлежащих выбранным группам.

====Виджет «Ввод значения»====
Виджет «Ввод значения» предназначен для отображения значения привязанного сигнала и его редактирования.
[[Файл:AgavaPLC–Виджет «Ввод значения» с отображением экранной цифровой клавиатуры.png|мини|Рисунок 37 – Виджет «Ввод значения» с отображением экранной цифровой клавиатуры|212x212пкс]]
После выбора узла для чтения/записи и соответствующего типа значения необходимо выбрать нужный тип ввода в разделе «Оформление».

Доступны следующие типы ввода:

*кнопки изменения – при нажатии на виджет появляются кнопки увеличения и уменьшения на заданный шаг изменения;
*кнопка редактирования – при нажатии на виджет появляется кнопка, при клике на которую открывается экранная цифровая клавиатура;

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

====Виджет «Выбор значения из списка»====
[[Файл:AgavaPLC–Виджет «Выбор значения из списка».png|мини|Рисунок 38 – Виджет «Выбор значения из списка»]]
Виджет «Выбор значения из списка» предназначен для отображения значения привязанного сигнала и его изменения в удобном для пользователя текстовом виде (см. Рисунок 37).

С помощью свойства «Список сопоставлений» задается соответствие между значением сигнала и выводимой в виджете строкой.

При нажатии на кнопку в правой части виджета отображается список всех сопоставлений. При выборе нужного элемента в списке в установленный узел производится запись нового значения.

====Виджет «Флаг»====
[[Файл:AgavaPLC–Варианты внешнего вида виджета «Флаг».png|мини|Рисунок 39 – Варианты внешнего вида виджета «Флаг»]]
Виджет «Флаг» предназначен для отображения значения и изменения булевой переменной (true/false). Состояние true отображается в виде галочки (см. Рисунок 38).

При нажатии на виджет значение переменной изменяется на противоположное.

В случае, если флаг необходимо использовать только для отображения информации, поставьте галочку в свойстве «Отключен»

====Виджет «Отчет»====
[[Файл:AgavaPLC–Виджет «Отчет» в режиме отображения сформированного отчета.png|мини|Рисунок 40 – Виджет «Отчет» в режиме отображения сформированного отчета]]
Виджет «Отчет» предназначен для формирования отчетов по заранее спроектированному макету.

Подробный порядок создания и редактирования отчетов приведен в разделе [[#Отчеты]].
[[Файл:AgavaPLC–Окно выбора интервала отчета.png|мини|Рисунок 41 – Окно выбора интервала отчета]]
В верхней части виджета размещена панель управления, содержащая кнопки вызова команд:

* печать сформированного отчета на установленном в системе принтере;
*сохранение сформированного отчета в файле формата PDF;
*переход к предыдущей странице отчета;
*переход к следующей странице отчета;
*масштабирование экрана по ширине листа отчета;
*масштабирование экрана по высоте листа отчета.

При формировании отчета для изменения интервала времени, за который будет формироваться отчет, необходимо на панели управления щелкнуть кнопку выбора интервала (на ней отображается текущий выбранный интервал, например, «Начало суток без смещения – Конец суток без смещения»). Далее появится окно «Интервал», в котором можно выбрать начало и конец интервала (см. Рисунок 41).

В качестве начала и конца интервала можно выбрать как конкретную дату по календарю, так относительную, например, «Начало дня», "Конец недели". После выбора желаемого интервала необходимо нажать кнопку «ОК».

Выбранный интервал отобразится на панели управления отчетом. Для формирования отчета за выбранный интервал необходимо нажать кнопку «Сформировать отчет». Через некоторое время, после загрузки данных из БД и их обработки, экран обновится и сформированный отчет за выбранный интервал будет отображен.

{{Шаблон:Действия AgavaSCADA/AgavaPLC}}

==Система тревог==
Система тревог предназначена для оповещения пользователя об обнаруженных нарушениях.

Система содержит два типа узлов:

*Группа событий.
*Контроллер событий.

===Группа событий===
Группа событий – узел, предназначенный для взаимодействия с виджетом «Список событий». Группы событий позволяют группировать события по какому-то признаку, например по уровню тревоги (авария, предупреждение, квитирование и т.д.), технологическому участку и т.д.

Для каждой группы можно выбрать свой цвет шрифта и фона, которые будут использоваться для вывода событий, принадлежащих этой группе в виджете "Список событий".

В свойстве «Описание» группы событий указывается текст, который будет отображаться в фильтре списка событий.

===Монитор событий===
Монитор событий (ранее - Контроллер событий) – узел, реализующий логику проверки соответствия выбранных сигналов контролируемым условиям. Контроллеры событий выполняют всю работу по проверке значений контролируемых параметров и выполнению соответствующих действий.

Монитор событий проверяет значения заданных узлов на соответствие заданным условиям и при их совпадении выполняет заданные действия.

В качестве действий можно указать не только действие "Создание события", но и другие (см. раздел [[#Действия]]).
[[Файл:AgavaPLC-Cистема тревог.png|мини|Cистема тревог]]

===Порядок настройки системы===
Порядок настройки системы тревог следующий:
#Добавить в проект систему тревог. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система тревог».
#Добавить узел «События» в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Группа» - «События». При необходимости настроить цвет шрифта и фона, которые будут отображаться у события в окне тревог или журнале.
#Добавить нужные [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|группы событий]] в узел «События». Для этого нажать ПКМ по узлу «События» в дереве проекта, затем выбрать «Добавить узел» - «Группа событий».
#Добавить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9A.D0.BE.D0.BD.D1.82.D1.80.D0.BE.D0.BB.D0.BB.D0.B5.D1.80 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|контроллеры событий]] в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Контроллер событий».
#Добавить в свойство «Сигналы» контроллеров событий узлы, состояние которых необходимо контролировать.
#Задать для этих узлов контролируемые условия в соответствующем свойстве контроллера событий.
#Настроить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действия]], которые будут выполняться при выполнении контролируемого условия. Для вывода аварий, предупреждений или информационных сообщений необходимо добавить действие «Создание события».
# Настроить действие «Создание события». В его свойстве «Группа событий» указать группу из созданных в пункте 2. Ввести тексты сообщения активации и деактивации (при необходимости), указать уровень события. Теперь, при срабатывании контролируемого условия, будет появляться окно тревог с сообщением активации.

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

Архивация параметров производится с помощью архиваторов. Архиваторы SQLite и PostgreSQL могут выполнять [[Узлы проекта AgavaSCADA/AgavaPLC#Прореживание данных|прореживание данных]].
[[Файл:AgavaPLC-Настройка архиватора.png|мини|505x505пкс|Настройка архиватора]]

===Порядок настройки системы===
Для сохранения истории изменения значений параметров в БД необходимо выполнить следующие действия:

#Добавить в проект систему архивации. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система архивации».
#Добавить в систему архивации архиватор. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем выбрать «Добавить узел» - «Архиватор в БД SQLite».
#Настроить параметры архиватора, такие как: путь до файла БД, интервал архивирования (как часто система архивации будет опрашивать значение параметра), интервал сохранения БД на диск (как часто эти значения будут записываться в постоянную память), разбиение БД (будет ли система архивации создавать новый файл БД каждые сутки), период хранения и режим выдачи значений для построения графика (сохраняемые значения будут обновляться с частотой интервала архивирования, а сохраненные - с частотой интервала сохранения).
#Добавить параметры в коннекторы база данных. Для этого необходимо открыть свойство архиватора «Коннекторы БД», выбрать «Создать новый» - «Коннектор БД». После этого нужно нажать по добавленному коннектору, открыть его свойство «Сигналы» и добавить параметр, значение которого необходимо сохранять в БД.

=== Архиватор SQLite===
Архиватор SQLite предназначен для сохранения значений параметров в БД формата SQLite.

Для извлечения и просмотра баз данных формата SQLite с устройств может использоваться программа «[[Архиватор]]».

====Свойства узла "Архиватор SQLite"====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
| Путь до файла БД
|FilePath
|STRING
|Чтение / запись
|Путь до файла БД. Абсолютный или относительный.
|-
|Интервал архивирования
|Interval
|INT
|Чтение / запись
|Интервал архивирования, мс.
|-
|Период хранения
|Retention
|INT
|Чтение / запись
|Период хранения, дней.
|-
|Разбиение БД
|DBSplitting
|BOOL
|Чтение / запись
|Разбиение БД на файлы. При включении база данных будет разделяться на отдельныйе файлы, содержащие данные за одни сутки.
|-
|Интервал сохранения БД на диск
|StoringInterval
|INT
|Чтение / запись
|Интервал сохранения БД на диск, мс.
|-
|Режим выдачи значений
|ValueReturnMode
|ENUM
|Чтение / запись
|Режим выдачи значений. Режим "Сохраняемые в БД" - данные выдаются сразу после получения архиватором, возможно до фактического сохранения в БД. Режим "Сохраненные в БД" - данные выдаются только после фактической записи в БД на диск.
|-
|Коннекторы БД
|Signals
|NODESARRAY
|Чтение / запись
|Список коннекторов, содержащих сигналы для архивирования.
|-
|Текущий размер БД
|DBCurrentSize
|INT
|Только чтение
|Текущий размер БД, Мб.
|-
|Максимальный размер БД
|DBMaxSize
|INT
|Только чтение
|Максимальный размер БД, Мб.
|-
|Состояние БД
|DBStatus
|INT
|Только чтение
|Состояние БД.
|}

=== Архиватор PostgreSQL ===
Архиватор PostgreSQL предназначен для сохранения значений параметров в базы данных под управлением сервера PostgreSQL.

=== Прореживание данных ===
Прореживание данных (data thinning) — это процесс фильтрации и уменьшения количества точек данных, сохраняемых в архиве. Вместо того чтобы записывать каждое полученное значение, система анализирует поток данных и сохраняет только те значения, которые представляют значимое изменение.

'''Назначение прореживания'''

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

* '''Снижение нагрузки на архив''': Меньшее количество записей означает более быструю работу базы данных.
* '''Ускорение отображения графиков''': Нужно обрабатывать меньше точек для построения трендов.
* '''Сохранение только значимых изменений''': Система отфильтровывает шум и оставляет только те изменения, которые важны для анализа технологического процесса.
'''Общий принцип работы'''

Алгоритм прореживания работает по простому принципу:

# SCADA-система получает новое значение от источника данных.
# Она сравнивает это значение с последним, которое было сохранено в архив.
# Если изменение превышает заранее настроенный '''допуск''' (tolerance), новое значение сохраняется.
# Если изменение меньше допуска, значение пропускается.

Кроме того, существует параметр "'''Период обязательной записи"'''. Если с момента последней записи прошло больше времени, чем указано в этом параметре, новое значение будет сохранено '''независимо от его изменения'''. Это гарантирует, что записи в архив будут сохраняться не реже заданной периодичности, даже если сигнал не меняется. Ключевая идея: "'''Сохраняем только то, что заметно изменилось, но не реже, чем задано".'''

'''Как подобрать допуск?'''

* '''Слишком малый допуск''' приведёт к записи избыточных данных, и архив будет быстро расти.
* '''Слишком большой допуск''' может привести к потере мелких, но значимых изменений в сигнале.

Выбор правильного допуска — это компромисс между детализацией данных и размером архива.
==== Типы алгоритмов прореживания ====
В системе доступны несколько алгоритмов, которые определяют, как именно вычисляется «значимость» изменения. Выбор алгоритма зависит от характера сигнала и требований к точности данных.

# [[Узлы проекта AgavaSCADA/AgavaPLC#Абсолютный допуск|Абсолютный допуск]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от последнего значения|Процент от последнего значения]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего N последних|Процент от среднего N последних]]
# [[Узлы проекта AgavaSCADA/AgavaPLC#Процент от среднего по временному окну|Процент от среднего по временному окну]]

'''Обозначения и определения'''

В дальнейшем используются следующие обозначения (для числовых сигналов):

* <math>x_{in}</math> — текущее измерение сигнала, полученное от источника данных к моменту обработки (кандидат на запись).
* <math>x_{ref}</math> — последнее сохранённое числовое значение сигнала в архиве на момент обработки (опорное значение).
* <math>|\Delta| = |x_{in} - x_{ref}|</math> — абсолютная величина изменения между текущим измерением и последним сохранённым значением.
* <math>\bar{x}_N</math> — арифметическое среднее последних <math>N</math> сохранённых числовых значений.
* <math>\bar{x}_T</math> — среднее всех сохранённых числовых значений, чьи метки времени попадают в временное окно длительности <math>T</math> миллисекунд.
* <math>\varepsilon</math> — машинная точность для чисел двойной точности; используется для формальной проверки «близости к нулю».
* <math>tolerance</math> — допуск: абсолютный (в физических единицах) или относительный (в процентах), в зависимости от выбранного алгоритма.

'''Настройки в Свойствах архиватора, общие для всех типов прореживания'''

* '''Включить прореживание''' — включает/выключает применение алгоритма прореживания при записи значений. При выключении все поступающие значения сохраняются без фильтрации.
* '''Тип допуска''' — выбирает алгоритм сравнения.
* '''Период обязательной записи (мс)''' — максимальный допустимый промежуток между двумя записями одного сигнала. Если за это время значимого изменения не произошло, ближайшее поступившее значение будет записано принудительно. 0 — отключить принудительную запись.

===== Абсолютный допуск =====
'''Принцип:'''

Новое значение сохраняется, если модуль изменения больше установленного порога в физических единицах.

<math display="block">|\Delta| > tolerance</math>

'''Когда использовать:'''

* Если диапазон сигнала стабилен и известен заранее.
* Для параметров вроде температуры, давления, уровня жидкости, где фиксированное изменение имеет одинаковую интерпретацию по всей шкале.

'''Преимущества:'''

* Обеспечивает предсказуемое и детерминированное поведение независимо от текущего масштаба значения.
* Не требует накопления или хранения дополнительных данных (окон/истории), вычислительно прост.
* Удобен при наличии нормативно заданных пределов точности в физических единицах.

'''Ограничения:'''

* Не масштабируется на широкий динамический диапазон: один и тот же порог может быть слишком грубым для малых значений и слишком чувствительным для больших.
* Требует аккуратного подбора порога под единицы измерения и разрешение датчика; при неверной калибровке возможны либо избыточные записи, либо потеря значимых мелких изменений.
* Не учитывает относительный контекст изменения (например, 1 единица при значении 10 и при значении 10 000 трактуется одинаково).

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — абсолютный порог в физических единицах сигнала. Определяет значение <math>tolerance</math>.

===== Процент от последнего значения =====
'''Принцип:'''

Новое значение сохраняется, если относительное изменение относительно последнего сохранённого превышает заданный процент.

<math display="block">\frac{|\Delta|}{|x_{ref}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов, где важна относительная динамика, а не абсолютные величины.
* Для показателей с большим динамическим диапазоном, где относительная точность должна быть сопоставима на всех уровнях.

'''Преимущества:'''

* Масштабируемость: одинаково интерпретирует относительные изменения на низких и высоких уровнях сигнала.
* Не требует хранения окна значений; использует только последнее сохранённое значение, поэтому вычислительно лёгок.
* Быстро и корректно реагирует на пропорциональные изменения процесса (проценты), поддерживая заданную относительную чувствительность.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).
* При малых базовых значениях возможна повышенная чувствительность к шуму и микроколебаниям.
* Не подавляет высокочастотный шум сам по себе: при необходимости сочетать с обязательной записью по времени и корректной настройкой допуска.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

===== Процент от среднего N последних =====
'''Принцип:'''

Новое значение сохраняется, если изменение больше заданного процента от среднего по последним N сохранённым значениям.

<math display="block">\frac{|\Delta|}{|\bar{x}_{N}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с постоянным шумом или пульсациями, когда важно снижать чувствительность к случайным отклонениям.
* Для процессов с умеренной динамикой, где требуется устойчивость к «зубчатым» колебаниям.

'''Преимущества:'''

* Снижает чувствительность к высокочастотному шуму за счёт опоры на усреднение; сокращает объём записей на стационарных участках.
* Гибко настраивается параметром <math>N</math>: увеличение окна повышает устойчивость, уменьшение — повышает чувствительность и снижает задержку реакции.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).

* Инерционность: при резких скачках возможна задержка фиксации изменения, особенно при большом <math>N</math>.
* Усреднение может «сглаживать» и не фиксировать кратковременные, но важные пики; не подходит для задач, критичных к коротким экстремумам.
* Предполагает относительно стабильную частоту выборок; при сильно переменной частоте эффективная «временная» ширина окна становится непредсказуемой.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Размер окна среднего (<math>N</math>)''' — число последних сохранённых значений, по которым считается среднее. Большее <math>N</math> повышает устойчивость к шуму, но увеличивает инерционность реакции.

===== Процент от среднего по временному окну =====
'''Принцип:'''

Похож на предыдущий, но среднее считается не по количеству точек, а по всем значениям за заданный интервал времени.

<math display="block">\frac{|\Delta|}{|\bar{x}_{T}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с непостоянной частотой измерений (событийные, неравномерные потоки).
* В случаях, когда важно учитывать реальную временную протяжённость усреднения независимо от плотности измерений.

'''Преимущества:'''

* Корректно работает при переменной частоте выборок: окно фиксируется по времени, а не по числу точек.
* Более реалистично оценивает тренд во времени на участках с неравномерными измерениями.
* Управляемый компромисс между подавлением шума и чувствительностью за счёт выбора длительности окна.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).

* Более высокая ресурсоёмкость: требуется хранить и периодически «очищать» значения по условию выхода из временного окна; потребление памяти зависит от фактической скорости поступления данных.
* Инерционность, присущая усреднению: возможна задержка фиксации коротких, но значимых пиковых изменений.
* Критичен выбор длительности окна: слишком малое окно даёт мало подавления шума, слишком большое — чрезмерную инерцию и риск пропуска кратких событий.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Интервал архивирования''' — длительность временного окна <math>T</math> (мс), в пределах которого вычисляется среднее. При увеличении <math>T</math> растёт сглаживание и уменьшается чувствительность к кратким всплескам; при уменьшении — наоборот. Значения, чьи метки времени выходят за пределы окна, автоматически исключаются из расчёта.

===== Примечание к алгоритмам 'Процент от…' =====
При малых опорных значениях система автоматически переходит в абсолютный режим, чтобы избежать деления на величину, близкую к нулю, и связанных с этим скачков чувствительности. Этот механизм применяется ко всем алгоритмам, использующим относительное сравнение: «Процент от последнего», «Процент от среднего N», «Процент от среднего по временному окну» и обеспечивает стабильность критерия при слабых сигналах.

* Условия входа в режим абсолютного допуска:
** для «Процента от последнего»: <math>|x_{ref}| < \varepsilon</math>;
** для «Процента от среднего N»: <math>|\bar{x}_{N}| < \varepsilon</math>;
** для «Процента от среднего по времени»: <math>|\bar{x}_{T}| < \varepsilon</math>.
* Критерий в режиме абсолютного допуска: значение фиксируется, если <math>|\Delta| > tolerance</math>.
* Условие выхода: как только соответствующая базовая величина (<math>|x_{ref}|</math>, <math>|\bar{x}_{N}|</math> или <math>|\bar{x}_{T}|</math>) становится <math>\geq \varepsilon</math>, система автоматически возвращается к относительному критерию.
* Трактовка <math>tolerance</math>: используется то же значение настройки; в абсолютном режиме оно интерпретируется как порог в физических единицах сигнала.

===== Сравнение алгоритмов прореживания данных =====
{| class="wikitable"
!Критерий
!Абсолютный
!% от последнего
!% от среднего N
!% от среднего по времени
|-
|Единицы допуска
|Физические
|Проценты
|Проценты
|Проценты
|-
|Устойчивость к шуму
|Низкая
|Средняя
|Высокая
|Высокая
|-
|Реакция на резкие скачки
|Быстрая
|Быстрая
|Задержка (при большом N)
|Задержка
|-
|Подходит при переменной частоте
|Да
|Да
|Нет
|Да
|}

==Система журналирования==
Система ведения журналов событий предназначена для управления регистрацией и хранением событий. В базу данных записываются все системные события и события, генерируемые с помощью [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.A1.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D0.B0 .D1.82.D1.80.D0.B5.D0.B2.D0.BE.D0.B3|системы тревог]], которые соответствуют выбранному уровню сообщений.

Для ведения журналов используются узлы типа "Логгер".

===Порядок настройки системы===
Порядок настройки системы журналирования следующий:

#Добавить и [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9F.D0.BE.D1.80.D1.8F.D0.B4.D0.BE.D0.BA .D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8 .D1.81.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D1.8B|настроить систему тревог]] для генерации событий.
#Добавить в проект систему журналирования. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система журналирования».
#Добавить в систему журналирования логгер. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем нажать «Добавить узел» и выбрать нужный логгер.
#Настроить параметры логгера (см. разделы ниже).

=== Логгер SQLite===
Логгер SQLite предназначен для сохранения событий, возникающих в ходе исполнения прикладной программы в СУБД SQLite.

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

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

===Логгер файловый ===
Логгер файловый предназначен для сохранения журналов событий в текстовых файлах на накопителе. Логгер имеет минимальное количество настроек, и обычно используется для сохранения журнала событий в случае необходимости отладки работы прикладной программы без среды разработки.

===Логгер SMS===
Логгер SMS предназначен для SMS информирования с помощью субмодуля GRPS или внешнего GPRS модема.

Принцип работы логгера следующий:

#Логгер принимает возникающие события, фильтрует их согласно установленного уровня событий и выбранных групп.
#События, прошедшие фильтрацию, форматируются согласно установленного шаблона.
#Отформатированные сообщения отправляются через подключенный модем в виде SMS сообщения. Отправка сообщений производится на телефонные номера, записанные в телефонной книге на SIM-карте.

==Система проверки прав пользователей==
[[Файл:AgavaPLC-Окно привилегий.png|мини|494x494пкс|Окно привилегий]]
Система реализует механизм контроля доступа к узлам проекта и их функциях на основе ролей. Узлы при выполнении действий проверяют наличие установленных привилегий у авторизованного в данный момент пользователя.

=== Роли и пользователи ===
Система содержит в себе две подсистемы:
*Пользователи. Подсистема определяет пользователей, каждому из которых назначается логин/пароль и одна или несколько ролей.
*Роли. Роли хранят наборы доступных привилегий.
Отношения между пользователями, ролями и привилегиями можно описать следующим образом:

* Один пользователь может иметь несколько ролей.
* Одну роль могут иметь несколько пользователей.
* Одна роль может иметь несколько привилегий.
* Одна привилегия может принадлежать нескольким ролям.

=== Привилегии ===
[[Файл:AgavaPLC-Система проверки прав пользователей.png|мини|Система проверки прав пользователей]]
Для узлов системы доступна установка следующих привилегий:

Все узлы:

*Чтение значения.
*Запись значения.
Окна и фреймы:
*Открытие окна.
*Закрытие окна.

При установке привилегий на какой-либо узел, все подчиненные узлы получают те же привилегии с флагом "унаследована".

Если привилегия не установлена, то считается что действие, регулируемое привилегией, запрещено.

Значение унаследованных привилегий можно переопределить с помощью явного задания привилегии.
===Порядок настройки системы===
Привилегии настраиваются в отдельном окне привилегий, доступном в меню "Вид".

Порядок настройки системы проверки прав в версии AgavaSCADA 1.2 следующий:

#Добавить в проект систему проверки прав пользователей. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система проверки прав пользователей».
#Добавить в систему проверки прав пользователей узел «Роль». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Роли».
#Добавить в узел «Роли» необходимые роли. Для этого нажать ПКМ по узлу «Роли» в дереве проекта, затем выбрать «Добавить узел» - «Роль».
#Для каждой роли настроить привилегии в окне привилегий. Для этого необходимо нажать «Вид» - «Открыть привилегии». В открывшемся окне в выпадающем списке «Пользователь / роль» выбрать нужную роль. Затем, нажимая ПКМ по узлам и выбирая «Добавить привилегию» настроить все необходимые ограничения для данной роли.
#Добавить в систему проверки прав пользователей узел «Пользователи». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Добавить в узел «Пользователи» необходимых пользователей. Для этого нажать ПКМ по узлу «Пользователи» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Для каждого пользователя указать имя и пароль, которые будут использоваться при авторизации, и выбрать одну или несколько ролей.

== Сигналы, источники и операции ==
Регистры и другие узлы, добавленные в группу «Сигналы», являются внутренними для проекта и могут менять свои значения только с помощь скриптов или других узлов, с которыми они связаны.

Сигналы содержат в себе несколько подгрупп.

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

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

Первичное значение поступает на вход операции, производится вычисление. Если есть еще операции, то вычисленное значение после первой операции передается на вход второй. И так далее по всем операциям. Если операций больше нет, вычисленное значение устанавливается в качестве значения узла.

Все операции выполняются в порядке, в котором они заданы в соответствующих свойствах.

====Сигнал простой====
Узел типа "Сигнал простой" предназначен для хранения и обработки значения источника, или другого сигнала или операции. Позволяет произвести какие-либо действия с этим значением с помощью добавления нужных операций в свойство «Операции после чтения».

====Постоянная ====
Узел типа "Постоянная" предназначен для хранения данных выбранного формата и позволяет изменять их в ходе выполнения программы. Связывание с источником не предусмотрено. Изменение осуществляется с помощью специализированных функций или блока установки значения в задаче ПЛК.

====Массив====
Массив - совокупность каких-либо объектов, указанных в свойстве «Входные значения». Нумерация объектов в массиве начинается с 0. Может использоваться для взаимодействия с демультиплексором.

====Сигнал комплексный====
Сигнал используется для взаимодействия с виджетом «Цифровой индикатор». Позволяет контролировать входное значение и генерировать события переходу входного значения через уставки.

Содержит в себе свойства для настройки следующих параметров:

*ВАУ – верхняя аварийная уставка;
*ВПУ - верхняя предаварийная уставка;
*НПУ - нижняя предаварийная уставка;
*НАУ – нижняя аварийная уставка;
*ФНЧ – фильтр низких частот.

===Источник===
Источник - специальный тип узлов, предназначенных для передачи данных от внешних устройств.

====Регистр Modbus====
Регистр Modbus используется для приема и передачи данных по протоколам Modbus-RTU, Modbus-TCP. Данный тип узов также может использоваться для организации работы некоторых алгоритмов программы (например для взаимодействия с контроллером событий).

====Источник индексный====
Узел типа "Источник индексный" используется для обработки данных, полученных по протоколу Upd, а так же в массивах для индексации значений.

===Операция===
[[Файл:AgavaPLC-Входные значения операций.png|мини|Входные значения операций]]
Узлы типа "Операция" используются для реализации вычислительных алгоритмов в задаче ПЛК или отдельно, при их размещении в группе "Сигналы".

В качестве входных значений операций выбираются константные числа, другие узлы группы «Сигналы», регистры или блоки задачи ПЛК.

====Операция «Сложение»====
Выходным значением является сумма входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Вычитание»====
Выходным значением является разность первого входного значения и суммы всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Умножение»====
Выходным значением является произведение значений всех входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Деление»====
Выходным значением является результат от деления первого входного значения на произведение всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Условие»====
Узел типа "Операция условие" предназначен для сравнения значений двух узлов. Для условия задаются сравниваемые параметры и выбирается режим сравнения. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Пара условий»====
[[Файл:AgavaPLC-Операция «Пара условий».png|мини|Операция «Пара условий»]]
Операция содержит в себе два условия. Для каждого условия задаются индивидуальные сравнимаемые параметры и выбирается режим сравнения.

Выходное значение операции зависит от ее режима проверки – при выбранном режиме «Логическое ИЛИ» выходное значение равно логической «1» если одно из условий равно «1», при «Логическом И»- если оба условия равны «1».

====Операция «Логическое ИЛИ»====
Если одно из входных значений становится равно логической «1» (контакты замкнуты), то выходное значение становится логической «1» (выход включен).

====Операция «Логическое И»====
Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

====Операция «Логическое НЕ»====
Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

====Операция «Таймер»====
Таймер предназначен для выполнения каких-либо [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действий]] через одинаковые промежутки времени (например запись значения в узел). Промежуток между исполнениями действий задается в свойстве «Интервал срабатывания», а сами действия в свойстве «Действия OnTimer». Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

====Операция «Мультиплексор»====
Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...».

Например если в качестве входных значений указаны два регистра, то выходное значение мультиплексора будет формироваться следующим образом:
{| class="wikitable"
!Значение регистра 1
!Значение регистра 2
!Выходное значение
|-
|0
|0
|0
|-
|1
|0
|1
|-
|0
|1
|2
|-
|1
|1
|3
|}

====Операция «Демультиплексор»====
Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

====Операция «Генератор случайного числа»====
Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями. Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

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

Для выполнения скрипта, можно добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения. Другим способом вызова срабатывания скрипта является добавление его в [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.92.D1.8B.D0.BF.D0.BE.D0.BB.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5 .D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0.C2.BB|действие «Выполнение скрипта»]].

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

*void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

===Объект===
Узлы типа "Объект" предназначены для взаимодействия с аппаратными компонентами контроллера. Для всех объектов, являющихся субмодулями, необходимо указать слот, в котором они установлены. Доступ к значениям входов/выходов субмодуля осуществляется через его вложенные узлы.

'''ПЛК процессорный модуль'''

Предоставляет возможность регулирования подсветки экрана; включения и отключения индикаторов работы, аварии и программы.

'''ПЛК субмодуль DI'''

Позволяет получать доступ к значениям входов субмодуля DI.

'''ПЛК субмодуль R'''

Позволяет управлять значениями выходов субмодуля R.

'''ПЛК субмодуль SIM'''

Позволяет управлять значениями выходов субмодуля SIM.

'''ПЛК субмодуль DO6'''

Позволяет управлять значениями выходов субмодуля DO6.

'''ПЛК субмодуль AI'''

Позволяет получать доступ к значениям входов субмодуля AI и задавать их тип.

'''ПЛК субмодуль AIO'''

Позволяет получать доступ к значениям входов субмодуля AIO, управлять значениями выходов и задавать тип входов и выходов.

'''ПЛК субмодуль TMP'''

Позволяет получать доступ к значениям входов субмодуля TMP и задавать их тип.

==Задачи==
Группа «Задачи» предназначена для группировки узлов типа «Задача», которые используются для циклического или разового выполнения созданных пользователем алгоритмов.

===Задача ПЛК===
Данный узел предоставляет возможности для связывания между собой других узлов (таких как сигналы, субмодули ПЛК, постоянные и т. д.) в удобной графической форме (см. Рисунок 64). Для перехода к редактору необходимо щелкнуть правой кнопкой мыши на задачу ПЛК и выбрать в открывшемся контекстном меню команду «Открыть графическое представление» или дважды щелкнуть левой кнопкой мыши на задаче ПЛК в дереве проекта.

Рисунок 64 – Окно графического редактирования задачи «ПЛК-60»

Панель инструментов задачи ПЛК, расположенная в верхней части окна, содержит следующие элементы (см. Рисунок 16):

*Выпадающий список выбора режима подписи портов.
*Выпадающий список выбора режима подписи блоков.
*Кнопка запуска режима симулятора.
*Кнопка запуска онлайн отладки.
*Кнопка печати задачи.
*Инструменты управления симуляцией.

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

Созданную связь можно удалить, выделив ее левой кнопкой мыши и нажав клавишу "Del". Связь можно "разорвать", то есть добавить разрыв, нажав по ней правой кнопкой мыши и выбрав в контекстном меню команду «Добавить разрыв».

Для выделения нескольких блоков рамкой зажмите клавишу "Shift" и выделяйте блоки мышью с нажатой левой кнопкой.

Задача ПЛК предоставляет возможности для проведения тестирования и отладки проекта, описанные в разделе [[#Проверка и отладка проекта]].

====Блоки задачи ПЛК====
Помимо операций, описанных в разделе [[#Операция]], для реализации алгоритмов в задачу ПЛК можно добавлять блоки, описанные ниже.

'''Функциональный блок'''

Используется для выделения каких-либо действий в отдельный блок, для упрощения понимания работы алгоритма программы. Содержит входы, выходы и блоки, обеспечивающие работу внутренней логики. Позволяет проводить изолированную отладку, при которой значения на входах функционального блока вручную задаются пользователем. Блок, работающий в данном режиме выделяется черной рамкой. Для включения изолированной отладки необходимо открыть блок и нажать кнопку «Изолированная отладка» на панели управления задачей.

'''Блок установки значения'''

Блок осуществляет запись значения, поданного на вход in0, в узел, указанный в свойстве «Узел для чтения/записи»

'''Блок задержки'''

Блок задержки используется для создания задержки передачи значения с входа блока на выход на один цикл обработки задачи.

'''Блок «Битовое OR»'''

Для вычисления значения будет произведена операция "ИЛИ" над каждым битом значения в отдельности. Например: 1010 OR 0110 = 1110

'''Блок «Логическое И»'''

Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

'''Блок «Битовое AND»'''

Для вычисления значения будет произведена операция "И" над каждым битом значения в отдельности. Если все биты, стоящие на одинаковых позициях в двоичных представлениях значений, поступающих на входы блока, равны логической «1», то на выходе элемента в этой позиции появляется логическая «1» (выход включен). Например: 1010 AND 0110 = 0010

'''Блок «Логическое НЕ»'''

Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

'''Блок «Битовое XOR»'''

Если только на один из входов блока функции поступает логическая «1», то на выходе элемента появляется логическая «1». Если на входы блока функции поступают целочисленные значения, то операция будет произведена над каждым битом значения в отдельности. Например: 1010 XOR 0110 = 1100

'''Блок «Битовое SHR»'''

Побитовый логический сдвиг вправо используется для выполнения операции побитового логического сдвига операнда X вправо на N бит с дополнением нулями слева.

'''Блок «Битовое SHL»'''

Побитовый логический сдвиг влево используется для выполнения операции побитового логического сдвига операнда X влево на N бит с дополнением нулями справа.

'''Блок «Таймер»'''

Таймер предназначен для выполнения каких-либо действий (см. раздел 4.6) через одинаковые промежутки времени (например запись значения в узел).

'''Блок «Мультиплексор»'''

Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...»

'''Блок «Демультиплексор»'''

Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

'''Блок «Генератор случайного числа»'''

Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями.

'''Блок «Скрипт С++»'''

Операция «Скрипт С++» предназначена для реализации разнообразных алгоритмов на языке С++. Операция предусматривает реализацию одной или нескольких функций, выполняющих необходимые пользователю действия. Для выполнения скрипта, необходимо добавить его в качестве узла для задачи или задачи ПЛК.

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

* void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

'''Блок «Таймер с задержкой»'''

Таймер с задержкой используется для операции задержки передачи и/или отключения сигнала. На выходе таймера появится сигнал логической «1» с задержкой относительно фронта входного сигнала продолжительностью равной интервалу включения и выключится по спаду входного сигнала с задержкой продолжительностью равной интервалу выключения. В том случае, если необходимо использовать блок только как таймер с задержкой включения (отключения) интервал выключения (включения) устанавливается равным 0.

'''Блок «Генератор прямоугольных импульсов»'''

Генератор прямоугольных импульсов используется для формирования прямоугольных импульсов пульсации. На выходе генератора формируются импульсы с заданными параметрами длительности включенного и отключенного импульса на время действия управляющего сигнала на входе (сигнал логической «1»).

'''Блок «Триггер RS»'''

RS-триггер с приоритетом выключения используется для переключения с фиксацией состояния во время поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Триггер SR»'''

SR-триггер с приоритетом включения используется для переключения с фиксацией состояния в случае поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Детектор переднего фронта импульса»'''

Детектор переднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «0» в «1».

'''Блок «Детектор заднего фронта импульса»'''

Детектор заднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «1» в «0».

'''Блок «D-триггер»'''

D-триггер используется для формирования импульса включения выхода на интервал времени импульса на входе D, выходной интервал будет синхронизирован с тактовой частотой на входе С. На выходе Q триггера появится сигнал логической «1» по фронту тактовых импульсов на входе С при наличии сигнала логической «1» на входе D. Возврат выхода в сигнал логического «0» произойдет по фронту тактовых импульсов на входе С при наличии сигнала логического «0» на входе D. Вход Set принудительно устанавливает выход в состояние логической «1». Вход Reset является приоритетным и устанавливает выход в состояние логического «0».

'''Блок «Селектор»'''

Если на вход Value подается логическая «1», то результатом выполнения операции блока на выходе является входной сигнал ValueT. Если же Value равен логической «0», то результатом выполнения операции блока на выходе является входной сигнал ValueF.

'''Блок «Больше чем»'''

На выход подается логическая «1», если значение in0 больше чем значение in1.

'''Блок «Равенство»'''

На выход подается логическая «1», если значение in0 равно значению in1.

'''Блок «Абсолютное значение числа»'''

Результатом операции функции на выходе является модуль подаваемого на вход значения. Если число на входе положительное, то на выход подается само число, если отрицательное – положительное число, получаемое от перемены его знака с «-» на «+».

'''Блок «Возведение в степень»'''

Результатом операции функции на выходе является значение, равное значению in0, возведенному в степень значения N.

'''Блок «PID-регулятор»'''

Регулятор PID применяется для поддержания заданного значения параметра. На вход Pv подается текущее значение регулируемой величины, на Sp – ее заданное значение. С помощью изменения коэффициентов ПИД регулятора kP, kI и kD достигается оптимальный режим работы. Min задает минимальное значение на выходе, Max – максимальное. time - период регулятора (в мс.).

'''Блок «PWM-регулятор»'''

Применяется для преобразования аналогового сигнала в дискретный с помощью ШИМ. На вход in подается текущее значение регулируемой величины, Min задает минимальное значение на входе, Max – максимальное. time - период регулятора (в мс.)

==Устройства==
Группа «Устройства» предназначена для группировки узлов типа "Устройство", выполняющие разнообразные задачи, например работа с внешними накопителями и ПЗУ.

Retain-накопитель дает возможность хранить значения регистров, постоянных и сигналов в постоянной памяти контроллера, что позволяет им сохранять свои значения после отключения питания.

Для сохранения переменных необходимо перечислить их в свойстве «Узлы» и указать путь сохранения на выбранном накопителе.

== Отчеты==
{{Внимание|Тип=Восклицание желтый.png|Текст=Данный узел доступен только при исполнении проекта на настольном компьютере. На панелях оператора и контроллерах МПР этот узел не доступен.}}
Отчет – технологический документ, содержащий информацию о ходе производственного процесса, обработанную по заложенным в отчет алгоритмам. Отчеты формируются на основе макетов (статической части отчетов) путем добавления в них свойств и значений заданных параметров технологического процесса, которые формируются (выбираются из базы данных технологических параметров и проходят соответствующую обработку) по алгоритмам, размещенным в этих шаблонах.

Данные для отчета предоставляет выборка, осуществляющая получение данных и их обработку из базы данных.

===Создание нового отчета===
Создание любого отчета производится в два этапа.

#Создание необходимых узлов в конфигурации: сам отчет и необходимое количество выборок.
#Составление макета отчета.

Создание узла типа «Отчет» в конфигурации и выборок для него производится аналогично созданию узлов других типов. К станции добавляется узел типа «Отчеты» с помощью команды контекстного меню «Добавить узел», далее к узлу типа «Отчеты» добавляется отчет и к отчету добавляется необходимое количество выборок.

Выборка – специальный узел, предназначенный для выборки данных из архива и их обработки для последующего отображения в отчете.

Перед переходом к редактированию макета желательно проделать следующие операции:

*в свойстве отчета «Путь к файлу отчета» установить имя файла, в котором будет храниться макет отчета;
* в свойстве «Источники» выборки (выборок) отчета установить перечень архивных сигналов (коннекторов), которые будут выводиться в отчете.

===Редактирование макета отчета===
[[Файл:AgavaPLC–Редактор макета отчета.png|мини|Рисунок 42 – Редактор макета отчета]]
Для редактирования макета отчета необходимо переключиться из редактора конфигурации в редактор макета отчета с помощью команды «Открыть редактор макета отчета», доступной из контекстного меню дерева конфигурации, отображаемого при щелчке правой кнопкой мыши на узле типа «Отчет».

В окне редактора расположены:

*панели инструментов;
* панель объектов отчета;
*окно «Инспектор объектов»;
*окно «Инспектор данных»;
*окно «Инспектор скриптов»;
*область построения макета отчета;
*окно «Структура отчета».

Редактор макета позволяет вызывать команды сочетаниями клавиш:

*Ctrl + N – новый макет;
*Ctrl + O – загрузить макет;
*Ctrl + S – сохранить макет;
*Ctrl + Shift + S – сохранить макет под новым именем;
*Ctrl + P – предварительный просмотр;
*Ctrl + Z – отмена изменений;
*Ctrl + Shift + Z – возврат отмененных изменений;
* Ctrl + C – копировать объект;
*Ctrl + X – вырезать объект;
*Ctrl + V – вставить объект;
*Ctrl + Стрелки – переместить выделенный объект;
*Shift + Стрелки – изменить размер выделенных объектов;
*Del – удалить выделенные объекты;
*Shift + левая кнопка мыши – создать область выделения.

====Окно «Инспектор объектов»====
Окно «Инспектор объектов» содержит список свойств выделенного объекта и предназначено для их редактирования.

====Окно «Инспектор данных»====
Окно «Инспектор данных» содержит список доступных для использования источников данных (выборок) и предназначено для заполнения блока «Данные» элементами соответствующего типа.

====Окно «Инспектор скриптов»====
Окно «Инспектор скриптов» содержит список доступных для использования в отчете скриптов.

====Окно «Структура отчета»====
Окно «Структура отчет» отображает структуру отчета в виде дерева связанных элементов.

===Элементы отчета===
Для составления макета отчета доступны следующие элементы:

*текст;
*данные;
*изображение;
*фигура;
*компоновка (Layout).

====Текст====
Элемент «Текст» служит для вывода надписей или содержимого полей источников данных.

Объект «Текст» обладает очень широкими возможностями. Он умеет отображать текст, рамку, заливку. Текст может быть отображен любым шрифтом любого размера, цвета и стиля. Большинство настроек делаются визуально с помощью панелей инструментов.

Одна из самых главных особенностей этого универсального объекта – это возможность отображения не только статичного текста, но и текста с применением вычисляемых выражений. Причем, выражения могут располагаться в объекте вперемешку с текстом. Рассмотрим простой пример – поместим в объект «Текст» следующую строку: «Привет! Сегодня $S{now()}».

Если запустить отчет на построение, мы увидим приблизительно следующее: «Привет! Сегодня 20180803». В процессе построения отчета выражение в тексте, заключенное $S{}, было вычислено и полученное значение вставлено обратно в текст. Объект «Текст» может содержать любое количество выражений, смешанных с обычным текстом. В скобки можно заключать и одиночные переменные, и выражения, например, $S{1+2*(3+4)}. В выражениях можно использовать константы, переменные ($V{}), функции, поля БД ($D{}).

Свойства элемента «Текст»:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|alignment
|Выравнивание текста по вертикали и горизонтали
|-
|angle
|Поворот надписи
|-
|autoHeight
|Автоматический подбор высоты
|-
|autoWidth
|Автоматический подбор ширины
|-
|backgroundColor
|Цвет заливки
|-
|backgroundMode
|Режим заливки
|-
| backgroundOpacity
|Прозрачность заливки
|-
|borders
|Границы
|-
|content
|Содержимое объекта «Текст»
|-
|font
|Шрифт
|-
|fontColor
|Цвет шрифта
|-
| foregroundOpacity
|Прозрачность шрифта
|-
|geometry
|Размер и расположение объекта
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|margin
|Отступы
|-
|objectName
| Имя объекта
|-
|stretchToMaxHeight
|Установка значения высоты самого высокого объекта на бэнде
|-
|trimValue
|Удаление пробелов в начале и в конце надписи
|}

Для редактирования свойства «Content» используется диалоговое окно «Text Item Editor», вызов которого осуществляется двойным щелчком левой кнопки мыши на элементе «Текст».

Свойство «Content» может содержать:

*текст;
*значения переменных;
*значения полей из набора данных;
*значения, формируемые посредством исполнения скрипта.

Для вывода значений переменных используется синтаксис «$V{имяПеременной}» (без кавычек), для вывода значения поля данных – «$D{имяНабораДанных.ИмяПеременной}», для вывода результата исполнения скрипта – «$S{телоСкрипта}».

==== Изображение ====
Элемент для вывода изображений:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoSize
|Подгонять размер под размер изображения
|-
|borders
|Границы
|-
|content
|
|-
|datasource
|Источник данных
|-
|field
|Поле данных
|-
|geometry
|Размер и расположение
|-
|image
|Изображение
|-
| itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
| stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Фигура====
Элемент для вывода фигур:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
| geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|lineWidth
|Толщина линии
|-
|objectName
|Имя объекта
|-
|opacity
|Прозрачность
|-
|penStyle
|Стиль линии
|-
|shape
|Фигура
|-
|shapeBrush
|Стиль заливки
|-
|shapeBrushColor
|Цвет заливки
|-
|shapeColor
|Цвет фигуры
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Горизонтальная компоновка (Layout)====
Элемент, позволяющий объединять несколько элементов в группу:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
|geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

=== Разделы отчета (бэнды) ===
Бэнд предназначен для размещения других элементов отчета. Бэнд может быть нескольких типов:

*Report Header – заголовок отчета;
*Report Footer – завершение отчета;
*Page Header – верхний колонтитул страницы отчета;
*Page Footer – нижний колонтитул страницы отчета;
*Data – данные отчета;
* SubDetail – подчиненные данные отчета;
*SubDetailHeader – заголовок подчиненных данных;
*SubDetailFooter – завершение подчиненных данных;
*GroupHeader – заголовок группы;
*GroupFooter – завершение группы.

Бэнды применяются для логической группировки объектов. К примеру, размещение объекта на элементе «Данные» типа «Page Header», приводит к отображению этого объекта в верхней части каждой страницы готового отчета. Аналогичным образом «Page Footer» выводится внизу каждой страницы со всеми лежащими на нем объектами.

Общие для всех элементов «Данные» свойства:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoHeight
|Автоматический подбор высоты
|-
|backgroundColor
|Цвет заливки бэнда
|-
|borders
|Границы
|-
|geometry
|Размер
|-
|keepBottomSpace
|Сохранение отступа от нижней границы бэнда
|-
|objectName
|Имя объекта
|-
|printIfEmpty
|Отображение пустого бэнда
|-
|splittable
|Разделение бэнда, если он не влезает на страницу
|}

Report Footer:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|maxScalePercent
|Максимальный процент, на который можно уменьшить бенд, если он не влезает на страницу. Если бэнд даже после сжатия

не влезает на страницу, он будет перенесен полностью или частично – в зависимости от настроек бэнда
|}

Data:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|datasource
|Источник данных. Data-бэнд будет сформирован для каждой строки в источнике данных
|-
|keepFooterTogether
|Если Report Footer не влезает на страницу, то он будет перенесен на следующую страницу совместно с последним

экземпляром Data-бэнда
|-
|sliceLastRow
| Указывает генератору отчетов на то, можно ли разрезать последний экземпляр Data-бэнда или его нужно перенести

целиком
|}

Бэнды данного типа предназначены для вывода на печать данных из наборов. Набор данных - это заранее неизвестное количество строк (записей), каждая из которых содержит определенное количество колонок (полей).

SubDetail:
{| class="wikitable"
! Наименование свойства
!Описание
|-
|datasource
| Источник данных. SubDetail-бэнд будет сформирован для каждой строки в источнике данных
|}

SubDetailHeader, SubDetailFooter:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|printAlways
| Печатать, даже если SubDetail пустой
|}

GroupHeader:
{| class="wikitable"
!Наименование свойства
! Описание
|-
|groupFieldName
|Поле, по которому осуществляется группировка. Экземпляр GroupHeader будет формироваться при смене значения в этом поле
|}

===Функции===
==== Агрегатные функции ====
Агрегатные функции предназначены для обработки значений, содержащихся в резделах Data и SubDetail.

===== AVG - вычисление среднего значения =====
Пример использования:
$S{AVG("TextItem4","DataBand1");}

===== SUM - вычисление суммы значений =====
Пример использования:
$S{SUM("TextItem8","DataBand1");}

===== MIN =====

===== MAX =====

===== COUNT =====

==== Числовые функции ====

===== numberFormat - форматирование числа =====
Синтаксис:
numberFormat(значение, 'формат', точность)
Форматы:

* <code>'f'</code> — фиксированная запись (например, <code>"123.45"</code>);
* <code>'g'</code> — общий формат (автоматически выбирает между <code>'f'</code> и <code>'e'</code>);
* <code>'e'</code> — экспоненциальная запись (например, <code>"1.2345e+02"</code>);

Пример использования:
$S{numberFormat($D{fetcharchiverdata1.ArchiversSourceConnector0 (среднее)}, 'f', 3)} -> 123.495
[[Категория:AgavaSCADA/AgavaPLC]]

Узлы проекта AgavaSCADA/AgavaPLC

2025-10-29T11:56:45Z

SharipovRR:

== Узлы проекта ==
Узел - элементарная сущность проекта, осуществляющая хранение информации или реализующая определенный функционал. Каждый узел обладает набором [[Свойства узлов в AgavaPLC/AgavaSCADA|свойств]]. Все узлы, объединенные в иерархическую структуру, образуют проект.

== Проект ==
[[Файл:AgavaPLC–Дерево проекта.png|мини|Рисунок 21 – Дерево проекта]]
Узел "Проект" ("Корневой узел", "Корень") предназначен для хранения общей информации о проекте и связывания других узлов проекта.

== Станция ==
Станция – важнейший узел, управляющий работой собственных систем и выполняющий обмен данными с другими станциями. Физически станция представляет собой устройство, на котором исполняется проект (компьютер, панель оператора, МПР-60 или другое устройство).

Для использования в проекте доступны несколько типов станций. например:

* '''Станция''' - общий тип станции. Проекты с такой станцией могут выполняться на большинстве устройств - контроллеры, панели, персональные компьютеры. Чаще всего используется для проектов, предназначенных для выполнения на персональном компьютере.
* '''Панель ПО-40''' - специализированный тип для проектов на панелях оператора ПО-40. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.
* '''Панель ПО-50''' - специализированный тип для проектов на панелях оператора ПО-50. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.).
* '''Контроллер МПР-60''' - специализированный тип для проектов на программируемых реле МПР-60. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.

При построении больших проектов станций в проекте может быть несколько, и они могут выполнять разные задачи. Например, станция-сервер выполняет сбор и регистрацию данных, клиентские станции выполняют визуализацию данных на рабочих местах и т. д.

Станции подчиняются узлы типа "Система" - Транспортная система, Система архивирования, Система визуализации и т. д.

== Транспортная система ==
Транспортная система управляет передачей данных по различным каналам связи. Система управляет работой "Транспортов" - узлов, выполняющих обмен данными с устройствами по определенному протоколу.

С одной стороны, транспортная система обращается непосредственно к сигналам и каналам устройства, а с другой стороны, представляет их в виде неких универсальных единиц – узлов-источников. Каждый источник однозначно соответствует определенному сигналу или параметру устройства. При изменении сигнала меняется и значение источника. При записи данных в источник производится подача команды устройству на установку определенного значения конкретного параметра.

Транспортная система допускает использование нескольких транспортов, что дает возможность одновременного обмена данными с большим количеством устройств по разным протоколам.

=== Транспорт ===
Транспорт предназначен для обмена данными с устройствами по определенному протоколу. Один транспорт, в зависимости от типа, позволяет обмениваться данными с одним или несколькими устройствами.

Доступны для использования следующие виды транспортов:

* Транспорт Modbus-TCP;
* Транспорт Modbus-RTU;
* Транспорт SNMP;
* Транспорт OPC UA;
* Транспорт OPC DA (только для Windows);
* Транспорт MQTT;
* Последовательный транспорт (устаревший);
* TCP/IP транспорт (устаревший).
Подробное описание транспортов приведено в отдельном документе "[[Транспорты AgavaSCADA/AgavaPLC]]".

==Система визуализации==
{{Внимание|Тип=Восклицание желтый.png|Текст=Система визуализации недоступна в проектах для контроллеров МПР}}

Задачей этой системы является отображение данных в виде набора мнемонических схем (экранов, мнемосхем), а также предоставление пользователю возможности управления.

Каждый экран позволяет в схематичном, понятном пользователю виде представить участок технологической схемы с отображением необходимых параметров технологического процесса.

Изображение на экране строится с помощью окон, на которых размещаются объекты визуализации – виджеты. Виджетами могут быть текстовые метки, изображения, в том числе анимированные, элементы управления, графики и т. д. Виджеты можно объединять в слои для удобного управления отображением виджетов.

Виджеты могут быть статическими и динамическими. Динамические виджеты привязаны к одному или нескольким сигналам и их отображение зависит от значений этих сигналов. Статические виджеты не имеют привязки к сигналам и их изображение всегда постоянно.

Для перехода по экранам, изменения значений параметров и иного управления служат специальные виджеты: кнопки управления, поля ввода и другие.

Для повышения быстродействия и увеличения комфортности работы с системой система визуализации хранит в памяти кэш из нескольких последних открытых экранов. Когда при последовательном открытии экранов этот кэш заполняется, наиболее старые экраны удаляются из него. Это связано с тем, что, как правило, в работе используются несколько одних и тех же экранов, которые отображают сводную информацию о техпроцессе и оператор в штатном режиме переключается только между ними. Сохраняя их в памяти, система ускоряет переключение между ними, поскольку при этом не требуется каждый раз создавать экран, все находящиеся на нем объекты и запускать процессы обновления параметров.

Когда экран переходит в кэш, обновление параметров на нем прекращается для снижения нагрузки на центральный процессор. Если все же необходимо, чтобы экран всегда производил обновление данных (по разным причинам), даже находясь в кэше, необходимо в его настройках включить опцию «Постоянно обновляемый».

Подчиненные типы узлов:

*фрейм;
*окно;
*композиция.

===Фрейм===
[[Файл:AgavaPLC–Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией.png|мини|Рисунок 23 – Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией]]
Фрейм – узел, предназначенный для группировки окон, отображаемых на определенном дисплее. Обеспечивает организацию окон в пространстве экрана, управление мониторами и границами отображения.

Если необходимо отобразить информацию на нескольких дисплеях одновременно, то для каждого из них нужно использовать отдельный фрейм. Окон во фрейме может быть несколько, однако они не могут накладываться друг на друга.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
|-
|Позиция X
|XCoord
|int
|Координата X левого верхнего угла фрейма
|Целое число
|-
|Позиция Y
|YCoord
|int
|Координата Y левого верхнего угла фрейма
|Целое число
|-
|Ширина
|XSize
|int
|Ширина фрейма в пикселях
|Целое число > 0
|-
|Высота
|YSize
|int
|Высота фрейма в пикселях
|Целое число > 0
|-
|Окна
|Windows
|NodesArray
|Список окон, принадлежащих фрейму
|Узлы типа: Window
|-
|Номер монитора
|DisplayNo
|int
|Номер монитора для отображения фрейма
|0 - по умолчанию
≥1 - конкретные мониторы
|-
|Тип границы
|BorderType
|enum
|Тип границы фрейма
|0: Не определен (ошибка)
1: Отсутствует

2: Фиксированная
|}

==== Позиция и размеры (XCoord, YCoord, XSize, YSize) ====

* '''Тип:''' int.
* '''Описание:''' Определяют положение и размеры фрейма на экране.
* '''Значения по умолчанию:''' (0, 0, 640, 480).
* '''Применение:''' Задание области экрана, которую занимает фрейм.

==== Окна (Windows) ====
'''Тип:''' NodesArray.

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

'''Особенности:'''

* Поддерживаются только узлы типа Window.

==== Номер монитора (DisplayNo) ====
'''Тип:''' int.

'''Описание:''' Определяет, на каком мониторе системы отображается фрейм. Значение 0 соответствует монитору по умолчанию.

'''Использование:'''

* 0 - основной монитор.
* 1, 2, ... - дополнительные мониторы.
* Свойство важно для многомониторных конфигураций.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип обрамления фрейма. Влияет на внешний вид и поведение границ.

'''Значения:'''

* '''Отсутствует''' - фрейм без видимых границ.
* '''Фиксированная''' - стандартная граница окна.
* '''Не определен''' - используется только для обработки ошибок.

==== Наследование привилегий ====
Фрейм автоматически добавляет доступные привилегии для работы с окнами:

* <code>OpenWindow</code> - привилегия на открытие окон.
* <code>CloseWindow</code> - привилегия на закрытие окон.

===Окна===
Окно – узел, осуществляющий отображение видеокадра (мнемонической схемы).

Существуют несколько видов окон:

1. «Форма», предназначенная для вывода простого набора данных без необходимости управления видимостью или внешним видом его элементов. Для вывода информации в такое окно кроме создания окна и добавления к нему виджетов ничего более не требуется.
[[Файл:AgavaPLC-Меню.png|мини|164x164пкс|Рисунок 24 — Внешний вид меню в среде исполнения]]
2. «Окно с композицией», предназначенное для вывода большого количества информации и позволяющее организовать группировку элементов по слоям, управлять внешним видом элементов, видимостью слоев и отдельных элементов, а также дающее возможность регулирования работы пользователя с элементами. Для вывода информации в такое окно нужно к окну привязать композицию, содержащую минимум один слой, в который уже добавляются виджеты.

=== Форма ===
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Модальность
|Modality
|enum
|Режим модальности окна
|0: Не определен (ошибка)
1: Немодальное

2: Модальное (Фрейм)

3: Модальное (Система)
|Чтение/Запись
|-
|Тип границы
|BorderType
|enum
|Тип границы окна
|0: Не определен (ошибка)
1: Фиксированная

2: Изменяемая

3: Отсутствует
|Чтение/Запись
|-
|Отображать строку заголовка
|TitleEnabled
|bool
|Отображать строку заголовка
|true/false
|Чтение/Запись
|-
|Отображать кнопку "Закрыть"
|CloseEnabled
|bool
|Отображать кнопку "Закрыть"
|true/false
|Чтение/Запись
|-
|Цвет фона
|BackgroundColor
|NColor
|Цвет фона окна
|Цвет в формате RGBA
|Чтение/Запись
|-
|Затемнение
|NeedDarkenApplication
|bool
|Затемнение других окон приложения при открытии этого окна
|true/false
|Чтение/Запись
|-
|Цвет затемнения
|ColorDarkenApplication
|NColor
|Цвет затемнения
|Цвет в формате RGBA
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов, мс
|0 - без задержки
>0 - интервал в мс
|Чтение/Запись
|-
|Действия OnShow
|ActionsOnShow
|NodesContainer
|Действия при показе окна
|Узлы типа: Action
|Чтение/Запись
|-
|Действия OnClose
|ActionsOnClose
|NodesContainer
|Действия при закрытии окна
|Узлы типа: Action
|Чтение/Запись
|}

==== Модальность (Modality) ====
'''Тип:''' enum.

'''Описание:''' Определяет поведение окна относительно других окон приложения.

'''Значения:'''

* '''Немодальное''' - позволяет взаимодействовать с другими окнами.
* '''Модальное (Фрейм)''' - блокирует взаимодействие с окнами в том же фрейме.
* '''Модальное (Система)''' - блокирует все окна приложения.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип и поведение границ окна.

'''Значения:'''

* '''Фиксированная''' - окно нельзя изменять размер.
* '''Изменяемая''' - пользователь может изменять размер окна.
* '''Отсутствует''' - окно без видимых границ.

==== Управление заголовком (TitleEnabled, CloseEnabled) ====
'''Тип:''' bool.

'''Описание:''' Контролируют отображение элементов заголовка окна.

==== Фон и затемнение (BackgroundColor, NeedDarkenApplication, ColorDarkenApplication) ====
'''Тип:''' NColor, bool, NColor.

'''Описание:''' Управляют визуальным оформлением окна и его влиянием на другие окна.

'''Особенности:'''

* Затемнение применяется только при NeedDarkenApplication = true.
* Цвет затемнения по умолчанию: черный с прозрачностью 50%.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Определяет частоту обновления виджетов в окне.

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчики событий (ActionsOnShow, ActionsOnClose) ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых при показе и закрытии окна.

=== Окно с композицией ===
Данный узел имеет те же свойства, что и форма, а также собственные:
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Композиция
|CompositionId
|NodeLink
|Основная композиция окна
|Узлы типа: CompositionLayered, CompositionTemplated
|Чтение/Запись
|-
|Описание текущей композиции
|CurrentCompositionDesc
|string
|Описание текущей загруженной композиции
|Автоматически формируется
|Только чтение
|}

==== Композиция (CompositionId) ====
'''Тип:''' NodeLink.

'''Описание:''' Ссылка на композицию, отображаемую в окне.

'''Поддерживаемые типы:''' CompositionLayered, CompositionTemplated.

==== Описание текущей композиции (CurrentCompositionDesc) ====
'''Тип:''' string.

'''Описание:''' Автоматически обновляемое описание загруженной композиции.

'''Особенности:''' Свойство только для чтения, обновляется системой автоматически.[[Файл:AgavaPLC-Настройка меню в среде разработки.png|мини|226x226пкс|Рисунок 25 — Настройка меню в среде разработки]]

===Композиция===
Композиция – узел, представляющий составленную при разработке проекта мнемоническую схему в виде набора элементов визуализации (виджетов), сгруппированных в один или несколько слоев.

Композиция дает возможность организовать виджеты в слои, видимостью которых можно управлять во время работы проекта.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Размеры
|Size
|NSize
|Размеры композиции
|Структура {ширина, высота}
|Чтение/Запись
|-
|Кэширование
|Cacheable
|bool
|Кэширование данных композиции для быстрого повторного открытия
|true/false
|Чтение/Запись
|-
|Источник интервала обновления
|UpdateIntervalSource
|enum
|Определяет источник интервала обновления виджетов
|0: Окно
1: Композиция
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов в миллисекундах
|Целое число ≥ 0
|Чтение/Запись
|-
|Действия OnLoad
|ActionsOnLoad
|NodesContainer
|Действия при загрузке композиции
|Узлы типа: Action
|Чтение/Запись
|}

==== Размеры (Size) ====
'''Тип:''' NSize (ширина, высота).

'''Описание:''' Определяет размеры композиции в пикселях. По умолчанию установлены значения 800x600.

==== Кэширование (Cacheable) ====
'''Тип:''' bool.

'''Описание:''' Включает или отключает кэширование данных композиции. При включенном кэшировании композиция сохраняется в памяти для быстрого повторного открытия.

'''Преимущества кэширования:'''

* Быстрое переключение между композициями.
* Снижение нагрузки на систему при частом использовании.
* Сохранение состояния элементов.

'''Рекомендации:''' Включать для часто используемых композиций, отключать для редко используемых или ресурсоемких.

==== Источник интервала обновления (UpdateIntervalSource) ====
'''Тип:''' enum.

'''Описание:''' Определяет, откуда виджеты композиции получают интервал обновления.

'''Значения:'''

* '''Окно''' - интервал обновления наследуется от родительского окна.
* '''Композиция''' - используется собственный интервал обновления композиции.

'''Применение:''' Централизованное управление производительностью через окно или индивидуальная настройка для каждой композиции.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Задает интервал обновления виджетов в миллисекундах. При значении 0 отрисовка виджетов выполняется без задержки (максимальная частота).

'''Особенности:'''

* 0 - обновление без задержек (может создать высокую нагрузку).
* > 0 - обновление с заданным интервалом. Учитывается только при UpdateIntervalSource = "Композиция"

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчик событий ActionsOnLoad ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых после загрузки композиции <code>AS 1.6.27+</code>.

===Слой===
Слой – набор виджетов, объединенных каким-то общим структурным признаком. В многослойных композициях слой обеспечивает организацию виджетов в z-порядке, управление видимостью и взаимодействием с пользователем. С помошью свойства "Видимость" слоя можно управлять видимостью виджетов, размещенных на слое.

Свойства
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Z-Порядок
|ZOrder
|int
|Порядок слоя в композиции
|Целое число (чем выше значение, тем выше слой)
|Чтение/Запись
|-
|Прозрачность для действий
|ActionTransparency
|enum
|Определяет поведение слоя при взаимодействии с пользователем
|0: Не определен (ошибка)
1: Непрозрачный

2: Прозрачный
|Чтение/Запись
|-
|Видимость
|Visible
|bool
|Видимость слоя и всех его виджетов
|true/false
|Чтение/Запись
|}

==== Z-Порядок (ZOrder) ====
'''Тип:''' int

'''Описание:''' Определяет порядок отображения слоя относительно других слоев в композиции. Слои с большим значением ZOrder отображаются поверх слоев с меньшим значением.

'''Пример использования:'''

* Фоновый слой: ZOrder = 1.
* Основной контент: ZOrder = 2.
* Контекстные виджеты: ZOrder = 3.

==== Прозрачность для действий (ActionTransparency) ====
'''Тип:''' enum

'''Описание:''' Управляет взаимодействием слоя с пользовательскими действиями (клики, наведения и т.д.)

'''Значения:'''

* '''Непрозрачный''' - слой полностью перехватывает пользовательские действия, элементы под ним недоступны, даже если они видимы.
* '''Прозрачный''' - пользовательские действия проходят сквозь слой к элементам ниже.

Обратите внимание: если на слое размещается изображение с прозрачной областью, то такие виджеты не позволяют пользователю взаимодействовать с видимыми и размещенными под ним виджетами.

==== Видимость (Visible) ====
'''Тип:''' bool

'''Описание:''' Определяет видимость всего слоя и всех его дочерних виджетов. При значении false слой и все его содержимое становится невидимым.

'''Применение:''' Временное скрытие виджетов или переключение их видимости.

===Виджет===
Виджет – элемент визуализации, предназначенный для отображения информации в заданном виде.

===Меню===
Меню – элемент визуализации, сочетающий в себе несколько виджетов «Кнопка». Используется для более удобного управления проектом (см. Рисунок 24).

Для добавления меню, необходимо в среде разработки назначить [[Универсальная среда разработки#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.9E.D1.82.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5 .D0.BC.D0.B5.D0.BD.D1.8E.C2.BB|действие «Отображение меню»]] для кнопки (или любого другого виджета). После добавления действия необходимо выделить его и нажать на кнопку настроек на панели вверху окна действий. Открывшееся окно (см. Рисунок 25) содержит дерево со структурой меню, в который можно добавлять элементы двух типов:

*меню – элемент, который позволяет группировать элементы меню, выводя их в виде раскрывающегося списка. На рисунках 24 и 25 этим элементом являются кнопки «Арочник» и «БПО».
*элемент меню – элемент, который предоставляет функционал, аналогичный [[Универсальная среда разработки#.D0.92.D0.B8.D0.B4.D0.B6.D0.B5.D1.82 .C2.AB.D0.9A.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0.C2.BB|виджету «Кнопка»]]. Для добавления действия, выполняющегося при нажатии на элемент меню в среде исполнения, необходимо нажать на него ПКМ в дереве структуры меню и выбрать "Создать действие". На рисунках 24 и 25 этим элементом являются кнопки «Котельная», «Котёл №1», «Котёл №2» и «Котёл №3».

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

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

# Добавить дополнительные фреймы, чтобы их количество в проекте соответствовало количеству дисплеев. Каждому фрейму назначить порядковый номер, начиная с 1. Фреймы связываются с дисплеями по номеру.
# Добавить дополнительное окно (или окна, если в исходном фрейме их несколько или дополнительных фреймов больше одного).
# Добавить в дополнительные фреймы созданные на этапе 2 окна, чтобы повторить структуру основоного фрейма.

Базовая настройка на этом закончена. После запуска такого проекта на двух или более дисплеях должны отображаться созданные окна.

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

===Виджеты===
====Виджет «Текстовая метка»====
[[Файл:AgavaPLC–Примеры оформления виджетов типа "Текстовая метка".png|мини|Рисунок 26 – Примеры оформления виджетов типа "Текстовая метка"]]
Виджет «Текстовая метка» – наиболее часто применяемый виджет, с помощью которого можно реализовать разные способы отображения текстовой информации.

Виджет «Текстовая метка» может использоваться для отображения статичного текста, значений параметров (одного или нескольких) и их комбинаций.

При необходимости отображения значений параметров они указываются в свойстве «Источник». Для задания определенного формата отображения используются спецификаторы формата в стиле языка «Си»:

*%f – значение в виде числа с плавающей точкой;
* %s – строка;
*%i – целое число со знаком;
*%u – целое число без знака;
* %d – целое число со знаком в десятичной системе исчисления.

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

Для отображения знака «%» необходимо указать его дважды: «%%».

===== Отображение нескольких значений =====
Одна текстовая метка может использоваться для отображения нескольких значений. Для этого все значения, которые нужно отобразить, указываются в свойстве «Источник», а в свойстве «Текст» указываются последовательно несколько спецификаторов формата соответственно порядку перечисления значений в свойстве «Источник».

Пример: текстовая метка, отображающая текущую позицию в очереди:

* Текст: <code>Позиция %i из %i</code>
* Источник: два узла из проекта.

=====Модификаторы спецификаторов формата=====

======Модификатор минимальной ширины поля======
Целое число, расположенное между знаком % и кодом формата, играет роль модификатора минимальной ширины поля. Если указан модификатор минимальной ширины поля, то, чтобы ширина поля вывода была не меньше указанной минимальной величины, вывод при необходимости будет дополнен пробелами. Если же выводятся строки или числа, которые длиннее указанного минимума, то они все равно будут отображаться полностью. По умолчанию для дополнения используются пробелы. А если для этого надо использовать нули, то перед модификатором ширины поля следует поместить 0. Например, %05i означает, что любое число, количество цифр которого меньше пяти, будет дополнено таким количеством нулей, чтобы состоять из пяти цифр.

Примеры
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%i
|10
|-
|10.123
|%d
|10
|-
|10.123
|%05i
|00010
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
| 10.1
|-
|10.123
|%10f
|<пробел>10.123000
|-
|10.123
|%012f
|00010.123000
|}

======Модификатор точности======
Модификатор точности следует за модификатором минимальной ширины поля (если таковой имеется). Он состоит из точки и расположенного за ней целого числа. Значение этого модификатора зависит от типа данных, к которым его применяют.

Когда модификатор точности применяется к данным с плавающей точкой, для преобразования которых используются спецификаторы преобразования %f, %e или %E, то он определяет количество выводимых десятичных разрядов. Например, %10.4f означает, что ширина поля вывода будет не менее 10 символов, причем для десятичных разрядов будет отведено четыре позиции.

Если модификатор точности применяется к %g или %G, то он определяет количество значащих цифр.

Примененный к строкам, модификатор точности определяет максимальную длину поля. Например, %5.7s означает, что длина выводимой строки будет составлять минимум пять и максимум семь символов. Если строка окажется длиннее, чем максимальная длина поля, то конечные символы выводиться не будут.

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

Примеры:
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
|10.1
|-
|10.123
|%10.4f
|<пробел><пробел><пробел>10.1230
|-
|10.123
|%010.3f
|000010.123
|-
| Это простая проверка
|%10.15s
|Это простая про
|}

====Виджет «Условная метка» ====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условная метка".png|мини|Рисунок 27 – Список сопоставлений виджета "Условная метка"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условная_метка%22.png]]
Виджет «Условная метка» позволяет изменять выводимую строку в соответствии с изменениями привязанной к ней переменной.

Задать соответствие текста необходимому условию можно в свойстве «Список сопоставлений».

==== Виджет «Изображение»====
Виджет «Изображение» предназначен для отображения на окнах статичных изображений форматов png, gif, jpg, bmp или анимированных изображений в формате gif. Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Условное изображение»====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условное изображение".png|мини|Рисунок 28 – Список сопоставлений виджета "Условное изображение"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условное_изображение%22.png]]
Виджет «Условное изображение» позволяет изменять отображаемое изображение в соответствии с изменениями привязанной к нему переменной.

Задать соответствие изображения необходимому условию можно в свойстве «Список сопоставлений».

====Виджет «Движущееся изображение»====
Виджет предназначен для отображения на окнах изображений, перемещающихся в пределах области виджета. В основном используются на экране спящего режима.

Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Кнопка»====
Виджет «Кнопка» предназначен для реализации функций управления:

*ввод данных;
*передача управляющих воздействий;
* смена режима работы АРМ или иного устройства, исполняющего проект.

Выполнение всех функций виджета обеспечивается с помощью узлов типа «Действие», добавляемых в соответствующее свойство (см. раздел [[#Действия]]).

====Виджет «Гистограмма»====
[[Файл:AgavaPLC–Виджет "Гистограмма".png|мини|Рисунок 29 – Виджет "Гистограмма"|ссылка=Файл:AgavaPLC–Виджет_%22Гистограмма%22.png]]
Виджет предназначен для отображения значений сигналов в виде столбчатой диаграммы.

Виджету необходимо задать источник (регистр/сигнал, с которого он будет получать данные), а также минимальное и максимальное значения.

====Виджет «Исторический график»====
Виджет «Исторический график» предназначен для отображения графиков параметров на двухкоординатной области изображения с привязкой к осям времени и значений.

Виджет может работать с данными, архивируемыми в БД, и напрямую с сигналами, значения которых вычисляются в ходе работы.

При работе с архивируемыми данными интервал обновления графика зависит от режима выдачи значения у базы данных: при выборе сохраняемых в БД он будет соответствовать интервалу архивирования, а при сохраненных в БД - интервалу сохранения БД на диск. Независимо от режима выдачи, график не может обновляться меньше чем за 300 мс.

При работе напрямую с сигналами график обновляется при изменении значения сигнала, но также не чаще чем раз в 300 мс.
[[Файл:AgavaPLC–Экран «Архив» с виджетом «Исторический график».png|мини|Рисунок 30 – Виджет «Исторический график». Области кнопок-пиктограмм. В нижней части отображена легенда]]
Виджет «Исторический график» состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода данных.

На виджете имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 28):

#область пиктограмм графика;
#область пиктограмм оси времени (X);
#область пиктограмм оси значений (Y);
#область легенды.

В области пиктограмм графика слева направо расположены следующие кнопки-пиктограммы:

* кнопка переключения режима отображения точек на всех кривых;
* кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси времени (X) слева направо расположены следующие кнопки-пиктограммы:

*кнопка открытия окна выбора интервала времени для оси Х, текст кнопки отображает текущий выбранный интервал, например: 5М – 5 минут, 6Ч – 6 часов, 30М – 30 минут;
*кнопка-индикатор включения следящего режима.

В области пиктограмм оси значений (Y) расположена кнопка-пиктограмма «A» – кнопка переключения режима автоматического масштабирования значений.

=====Легенда=====
[[Файл:AgavaPLC–Легенда с четырьмя выключенными параметрами.png|мини|Рисунок 31 – Легенда с четырьмя выключенными параметрами]]
Легенда – специальная область в нижней части экрана архива, предназначенная для отображения параметров (наименование, текущее значение и т. д.) выводимых графиков в виде таблицы. Для ознакомления с примерным видом легенды см. Рисунок 31. Информация о каждом сигнале в легенде выводится в несколько колонок:

*«Цвет» – индицирует цвет, которым выводится соответствующая кривая на графике, колонка «Цвет» позволяет нажатием переключать видимость соответствующей кривой на графике (см. Рисунок 29). Также в колонке "Цвет" отображается номер пера, которым выводится кривая параметра на графике;
* «Имя» («Наименование») – содержит наименование параметра;
*«Время» – содержит время последнего зарегистрированного значения параметра;
*«Значение» – содержит последнее зарегистрированное значение параметра.

=====Режимы просмотра графиков=====
Пользователю доступно два режима просмотра графиков:

*следящий режим;
*режим просмотра истории.

В следящем режиме на графике всегда отображаются актуальные значения параметров, тренд периодически дочитывает поступившие данные из базы и обновляет графики.

В режиме просмотра истории на графике отображаются исторические значения параметров. Просмотр истории технологического процесса осуществляется с помощью кнопок перемещения по осям и кнопок изменения масштаба.

Режим просмотра истории включается автоматически при прокрутке графика назад по времени.

=====Визирная линия=====
[[Файл:AgavaPLC–График в режиме просмотра истории с установленной визирной линией.png|мини|Рисунок 32 – График в режиме просмотра истории с установленной визирной линией]]
Для просмотра значений параметров в нужный момент времени служит визирная линия, отображаемая на графике как вертикальная линия.

При щелчке левой кнопкой мыши (ЛКМ) в области графиков визирная линия будет отображена в выбранном месте графика.

В точке пересечения визирной линии и кривых параметров отображаются значения этих параметров. Также в нижней части области графиков, возле оси времени, визирная линия отображает время.

====Виджет «График кусочно-линейной функции»====
Виджет предназначен для отображения графика зависимости двух параметров, расположенном на осях X и Y.
[[Файл:AgavaPLC–Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм..png|мини|Рисунок 33 – Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм.]]
Виджет состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода графика.

На области вывода графика виджета имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 33):

#Область пиктограмм графика.
#Область пиктограмм оси первого параметра (X).
#Область пиктограмм оси второго параметра (Y).

В области пиктограмм графика расположены следующие кнопки-пиктограммы:

*кнопка переключения режима отображения точек на всех кривых;
*кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси первого (X) и второго (Y) параметров расположены кнопки-пиктограммы «А» – кнопка переключения режима автоматического масштабирования значений.[[Файл:AgavaPLC–Виджет "Список событий".png|мини|Рисунок 34 – Виджет "Список событий"|ссылка=Файл:AgavaPLC–Виджет_%22Список_событий%22.png]]
====Виджет «Список событий»====
[[Файл:AgavaPLC–Окно выбора интервала.png|мини|Рисунок 35 – Окно выбора интервала]]Виджет предназначен для отображения регистрируемых событий в работе.

В верхней части виджета расположена панель управления (1).

Панель управления содержит органы управления журналом:

*кнопка отображения фильтра событий;
*кнопка включения следящего режима журнала;
*кнопка изменения интервала на один день назад;
*кнопка-индикатор выбора интервала, за который отображаются события;
*кнопка изменения интервала на один день вперед;
*кнопка вызова окна со списком активных тревог.

Ниже панели управления, в основном поле экрана, расположена таблица, содержащая зарегистрированные события.

Заголовок таблицы позволяет изменять порядок столбцов и включать сортировку по столбцам. Например, возможно включение сортировки событий сначала по времени, затем по группе. Заголовок таблицы имеет возможность отключения / включения отображения любого столбца.

При большом количестве записей в правой части таблицы появляется полоса прокрутки, позволяющая пролистывать список событий.

Нажатие на кнопку-индикатор выбора интервала вызывает окно выбора интервала (см. Рисунок 35):[[Файл:AgavaPLC–Окно "Фильтр".png|мини|Рисунок 36 – Окно "Фильтр"|ссылка=Файл:AgavaPLC–Окно_%22Фильтр%22.png]]После выбора нужного интервала для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события за выбранный интервал.
Нажатие на кнопку отображения окна фильтра вызывает соответствующее окно. Окно фильтра позволяет изменить содержимое основного окна журнала событий путем выбора групп и подгрупп событий, перечисленных в окне фильтра (см. Рисунок 36).

После выбора нужных групп и подгрупп для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события, принадлежащих выбранным группам.

====Виджет «Ввод значения»====
Виджет «Ввод значения» предназначен для отображения значения привязанного сигнала и его редактирования.
[[Файл:AgavaPLC–Виджет «Ввод значения» с отображением экранной цифровой клавиатуры.png|мини|Рисунок 37 – Виджет «Ввод значения» с отображением экранной цифровой клавиатуры|212x212пкс]]
После выбора узла для чтения/записи и соответствующего типа значения необходимо выбрать нужный тип ввода в разделе «Оформление».

Доступны следующие типы ввода:

*кнопки изменения – при нажатии на виджет появляются кнопки увеличения и уменьшения на заданный шаг изменения;
*кнопка редактирования – при нажатии на виджет появляется кнопка, при клике на которую открывается экранная цифровая клавиатура;

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

====Виджет «Выбор значения из списка»====
[[Файл:AgavaPLC–Виджет «Выбор значения из списка».png|мини|Рисунок 38 – Виджет «Выбор значения из списка»]]
Виджет «Выбор значения из списка» предназначен для отображения значения привязанного сигнала и его изменения в удобном для пользователя текстовом виде (см. Рисунок 37).

С помощью свойства «Список сопоставлений» задается соответствие между значением сигнала и выводимой в виджете строкой.

При нажатии на кнопку в правой части виджета отображается список всех сопоставлений. При выборе нужного элемента в списке в установленный узел производится запись нового значения.

====Виджет «Флаг»====
[[Файл:AgavaPLC–Варианты внешнего вида виджета «Флаг».png|мини|Рисунок 39 – Варианты внешнего вида виджета «Флаг»]]
Виджет «Флаг» предназначен для отображения значения и изменения булевой переменной (true/false). Состояние true отображается в виде галочки (см. Рисунок 38).

При нажатии на виджет значение переменной изменяется на противоположное.

В случае, если флаг необходимо использовать только для отображения информации, поставьте галочку в свойстве «Отключен»

====Виджет «Отчет»====
[[Файл:AgavaPLC–Виджет «Отчет» в режиме отображения сформированного отчета.png|мини|Рисунок 40 – Виджет «Отчет» в режиме отображения сформированного отчета]]
Виджет «Отчет» предназначен для формирования отчетов по заранее спроектированному макету.

Подробный порядок создания и редактирования отчетов приведен в разделе [[#Отчеты]].
[[Файл:AgavaPLC–Окно выбора интервала отчета.png|мини|Рисунок 41 – Окно выбора интервала отчета]]
В верхней части виджета размещена панель управления, содержащая кнопки вызова команд:

* печать сформированного отчета на установленном в системе принтере;
*сохранение сформированного отчета в файле формата PDF;
*переход к предыдущей странице отчета;
*переход к следующей странице отчета;
*масштабирование экрана по ширине листа отчета;
*масштабирование экрана по высоте листа отчета.

При формировании отчета для изменения интервала времени, за который будет формироваться отчет, необходимо на панели управления щелкнуть кнопку выбора интервала (на ней отображается текущий выбранный интервал, например, «Начало суток без смещения – Конец суток без смещения»). Далее появится окно «Интервал», в котором можно выбрать начало и конец интервала (см. Рисунок 41).

В качестве начала и конца интервала можно выбрать как конкретную дату по календарю, так относительную, например, «Начало дня», "Конец недели". После выбора желаемого интервала необходимо нажать кнопку «ОК».

Выбранный интервал отобразится на панели управления отчетом. Для формирования отчета за выбранный интервал необходимо нажать кнопку «Сформировать отчет». Через некоторое время, после загрузки данных из БД и их обработки, экран обновится и сформированный отчет за выбранный интервал будет отображен.

{{Шаблон:Действия AgavaSCADA/AgavaPLC}}

==Система тревог==
Система тревог предназначена для оповещения пользователя об обнаруженных нарушениях.

Система содержит два типа узлов:

*Группа событий.
*Контроллер событий.

===Группа событий===
Группа событий – узел, предназначенный для взаимодействия с виджетом «Список событий». Группы событий позволяют группировать события по какому-то признаку, например по уровню тревоги (авария, предупреждение, квитирование и т.д.), технологическому участку и т.д.

Для каждой группы можно выбрать свой цвет шрифта и фона, которые будут использоваться для вывода событий, принадлежащих этой группе в виджете "Список событий".

В свойстве «Описание» группы событий указывается текст, который будет отображаться в фильтре списка событий.

===Монитор событий===
Монитор событий (ранее - Контроллер событий) – узел, реализующий логику проверки соответствия выбранных сигналов контролируемым условиям. Контроллеры событий выполняют всю работу по проверке значений контролируемых параметров и выполнению соответствующих действий.

Монитор событий проверяет значения заданных узлов на соответствие заданным условиям и при их совпадении выполняет заданные действия.

В качестве действий можно указать не только действие "Создание события", но и другие (см. раздел [[#Действия]]).
[[Файл:AgavaPLC-Cистема тревог.png|мини|Cистема тревог]]

===Порядок настройки системы===
Порядок настройки системы тревог следующий:
#Добавить в проект систему тревог. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система тревог».
#Добавить узел «События» в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Группа» - «События». При необходимости настроить цвет шрифта и фона, которые будут отображаться у события в окне тревог или журнале.
#Добавить нужные [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|группы событий]] в узел «События». Для этого нажать ПКМ по узлу «События» в дереве проекта, затем выбрать «Добавить узел» - «Группа событий».
#Добавить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9A.D0.BE.D0.BD.D1.82.D1.80.D0.BE.D0.BB.D0.BB.D0.B5.D1.80 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|контроллеры событий]] в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Контроллер событий».
#Добавить в свойство «Сигналы» контроллеров событий узлы, состояние которых необходимо контролировать.
#Задать для этих узлов контролируемые условия в соответствующем свойстве контроллера событий.
#Настроить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действия]], которые будут выполняться при выполнении контролируемого условия. Для вывода аварий, предупреждений или информационных сообщений необходимо добавить действие «Создание события».
# Настроить действие «Создание события». В его свойстве «Группа событий» указать группу из созданных в пункте 2. Ввести тексты сообщения активации и деактивации (при необходимости), указать уровень события. Теперь, при срабатывании контролируемого условия, будет появляться окно тревог с сообщением активации.

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

Архивация параметров производится с помощью архиваторов.
[[Файл:AgavaPLC-Настройка архиватора.png|мини|505x505пкс|Настройка архиватора]]

===Порядок настройки системы===
Для сохранения истории изменения значений параметров в БД необходимо выполнить следующие действия:

#Добавить в проект систему архивации. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система архивации».
#Добавить в систему архивации архиватор. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем выбрать «Добавить узел» - «Архиватор в БД SQLite».
#Настроить параметры архиватора, такие как: путь до файла БД, интервал архивирования (как часто система архивации будет опрашивать значение параметра), интервал сохранения БД на диск (как часто эти значения будут записываться в постоянную память), разбиение БД (будет ли система архивации создавать новый файл БД каждые сутки), период хранения и режим выдачи значений для построения графика (сохраняемые значения будут обновляться с частотой интервала архивирования, а сохраненные - с частотой интервала сохранения).
#Добавить параметры в коннекторы база данных. Для этого необходимо открыть свойство архиватора «Коннекторы БД», выбрать «Создать новый» - «Коннектор БД». После этого нужно нажать по добавленному коннектору, открыть его свойство «Сигналы» и добавить параметр, значение которого необходимо сохранять в БД.

=== Архиватор SQLite===
Архиватор SQLite предназначен для сохранения значений параметров в БД формата SQLite.

Для извлечения и просмотра баз данных формата SQLite с устройств может использоваться программа «[[Архиватор]]».

====Свойства узла "Архиватор SQLite"====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
| Путь до файла БД
|FilePath
|STRING
|Чтение / запись
|Путь до файла БД. Абсолютный или относительный.
|-
|Интервал архивирования
|Interval
|INT
|Чтение / запись
|Интервал архивирования, мс.
|-
|Период хранения
|Retention
|INT
|Чтение / запись
|Период хранения, дней.
|-
|Разбиение БД
|DBSplitting
|BOOL
|Чтение / запись
|Разбиение БД на файлы. При включении база данных будет разделяться на отдельныйе файлы, содержащие данные за одни сутки.
|-
|Интервал сохранения БД на диск
|StoringInterval
|INT
|Чтение / запись
|Интервал сохранения БД на диск, мс.
|-
|Режим выдачи значений
|ValueReturnMode
|ENUM
|Чтение / запись
|Режим выдачи значений. Режим "Сохраняемые в БД" - данные выдаются сразу после получения архиватором, возможно до фактического сохранения в БД. Режим "Сохраненные в БД" - данные выдаются только после фактической записи в БД на диск.
|-
|Коннекторы БД
|Signals
|NODESARRAY
|Чтение / запись
|Список коннекторов, содержащих сигналы для архивирования.
|-
|Текущий размер БД
|DBCurrentSize
|INT
|Только чтение
|Текущий размер БД, Мб.
|-
|Максимальный размер БД
|DBMaxSize
|INT
|Только чтение
|Максимальный размер БД, Мб.
|-
|Состояние БД
|DBStatus
|INT
|Только чтение
|Состояние БД.
|}

=== Архиватор PostgreSQL ===
Архиватор PostgreSQL предназначен для сохранения значений параметров в базы данных под управлением сервера PostgreSQL.

=== Прореживание данных ===
Прореживание данных (data thinning) — это процесс фильтрации и уменьшения количества точек данных, сохраняемых в архиве. Вместо того чтобы записывать каждое полученное значение, система анализирует поток данных и сохраняет только те значения, которые представляют значимое изменение.

'''Назначение прореживания'''

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

* '''Снижение нагрузки на архив''': Меньшее количество записей означает более быструю работу базы данных.
* '''Ускорение отображения графиков''': Нужно обрабатывать меньше точек для построения трендов.
* '''Сохранение только значимых изменений''': Система отфильтровывает шум и оставляет только те изменения, которые важны для анализа технологического процесса.
'''Общий принцип работы'''

Алгоритм прореживания работает по простому принципу:

# SCADA-система получает новое значение от источника данных.
# Она сравнивает это значение с последним, которое было сохранено в архив.
# Если изменение превышает заранее настроенный '''допуск''' (tolerance), новое значение сохраняется.
# Если изменение меньше допуска, значение пропускается.

Кроме того, существует параметр "'''Период обязательной записи"'''. Если с момента последней записи прошло больше времени, чем указано в этом параметре, новое значение будет сохранено '''независимо от его изменения'''. Это гарантирует, что записи в архив будут сохраняться не реже заданной периодичности, даже если сигнал не меняется. Ключевая идея: "'''Сохраняем только то, что заметно изменилось, но не реже, чем задано".'''

'''Как подобрать допуск?'''

* '''Слишком малый допуск''' приведёт к записи избыточных данных, и архив будет быстро расти.
* '''Слишком большой допуск''' может привести к потере мелких, но значимых изменений в сигнале.

Выбор правильного допуска — это компромисс между детализацией данных и размером архива.
----

==== Типы алгоритмов прореживания ====
В системе доступны несколько алгоритмов, которые определяют, как именно вычисляется «значимость» изменения. Выбор алгоритма зависит от характера сигнала и требований к точности данных.

# Абсолютный допуск
# Процент от последнего значения
# Процент от среднего N последних
# Процент от среднего по временному окну

'''Обозначения и определения'''

В дальнейшем используются следующие обозначения (для числовых сигналов):

* <math>x_{in}</math> — текущее измерение сигнала, полученное от источника данных к моменту обработки (кандидат на запись).
* <math>x_{ref}</math> — последнее сохранённое числовое значение сигнала в архиве на момент обработки (опорное значение).
* <math>|\Delta| = |x_{in} - x_{ref}|</math> — абсолютная величина изменения между текущим измерением и последним сохранённым значением.
* <math>\bar{x}_N</math> — арифметическое среднее последних <math>N</math> сохранённых числовых значений.
* <math>\bar{x}_T</math> — среднее всех сохранённых числовых значений, чьи метки времени попадают в временное окно длительности <math>T</math> миллисекунд.
* <math>\varepsilon</math> — машинная точность для чисел двойной точности; используется для формальной проверки «близости к нулю».
* <math>tolerance</math> — допуск: абсолютный (в физических единицах) или относительный (в процентах), в зависимости от выбранного алгоритма.

'''Настройки в Свойствах архиватора, общие для всех типов прореживания'''

* '''Включить прореживание''' — включает/выключает применение алгоритма прореживания при записи значений. При выключении все поступающие значения сохраняются без фильтрации.
* '''Тип допуска''' — выбирает алгоритм сравнения.
* '''Период обязательной записи (мс)''' — максимальный допустимый промежуток между двумя записями одного сигнала. Если за это время значимого изменения не произошло, ближайшее поступившее значение будет записано принудительно. 0 — отключить принудительную запись.

----

===== Абсолютный допуск =====
'''Принцип:'''

Новое значение сохраняется, если модуль изменения больше установленного порога в физических единицах.

<math display="block">|\Delta| > tolerance</math>

'''Когда использовать:'''

* Если диапазон сигнала стабилен и известен заранее.
* Для параметров вроде температуры, давления, уровня жидкости, где фиксированное изменение имеет одинаковую интерпретацию по всей шкале.

'''Преимущества:'''

* Обеспечивает предсказуемое и детерминированное поведение независимо от текущего масштаба значения.
* Не требует накопления или хранения дополнительных данных (окон/истории), вычислительно прост.
* Удобен при наличии нормативно заданных пределов точности в физических единицах.

'''Ограничения:'''

* Не масштабируется на широкий динамический диапазон: один и тот же порог может быть слишком грубым для малых значений и слишком чувствительным для больших.
* Требует аккуратного подбора порога под единицы измерения и разрешение датчика; при неверной калибровке возможны либо избыточные записи, либо потеря значимых мелких изменений.
* Не учитывает относительный контекст изменения (например, 1 единица при значении 10 и при значении 10 000 трактуется одинаково).

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — абсолютный порог в физических единицах сигнала. Определяет значение <math>tolerance</math>.

----

===== Процент от последнего значения =====
'''Принцип:'''

Новое значение сохраняется, если относительное изменение относительно последнего сохранённого превышает заданный процент.

<math display="block">\frac{|\Delta|}{|x_{ref}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов, где важна относительная динамика, а не абсолютные величины.
* Для показателей с большим динамическим диапазоном, где относительная точность должна быть сопоставима на всех уровнях.

'''Преимущества:'''

* Масштабируемость: одинаково интерпретирует относительные изменения на низких и высоких уровнях сигнала.
* Не требует хранения окна значений; использует только последнее сохранённое значение, поэтому вычислительно лёгок.
* Быстро и корректно реагирует на пропорциональные изменения процесса (проценты), поддерживая заданную относительную чувствительность.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).
* При малых базовых значениях возможна повышенная чувствительность к шуму и микроколебаниям.
* Не подавляет высокочастотный шум сам по себе: при необходимости сочетать с обязательной записью по времени и корректной настройкой допуска.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

----

===== Процент от среднего N последних =====
'''Принцип:'''

Новое значение сохраняется, если изменение больше заданного процента от среднего по последним N сохранённым значениям.

<math display="block">\frac{|\Delta|}{|\bar{x}_{N}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с постоянным шумом или пульсациями, когда важно снижать чувствительность к случайным отклонениям.
* Для процессов с умеренной динамикой, где требуется устойчивость к «зубчатым» колебаниям.

'''Преимущества:'''

* Снижает чувствительность к высокочастотному шуму за счёт опоры на усреднение; сокращает объём записей на стационарных участках.
* Гибко настраивается параметром <math>N</math>: увеличение окна повышает устойчивость, уменьшение — повышает чувствительность и снижает задержку реакции.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).

* Инерционность: при резких скачках возможна задержка фиксации изменения, особенно при большом <math>N</math>.
* Усреднение может «сглаживать» и не фиксировать кратковременные, но важные пики; не подходит для задач, критичных к коротким экстремумам.
* Предполагает относительно стабильную частоту выборок; при сильно переменной частоте эффективная «временная» ширина окна становится непредсказуемой.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Размер окна среднего (<math>N</math>)''' — число последних сохранённых значений, по которым считается среднее. Большее <math>N</math> повышает устойчивость к шуму, но увеличивает инерционность реакции.

----

===== Процент от среднего по временному окну =====
'''Принцип:'''

Похож на предыдущий, но среднее считается не по количеству точек, а по всем значениям за заданный интервал времени.

<math display="block">\frac{|\Delta|}{|\bar{x}_{T}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с непостоянной частотой измерений (событийные, неравномерные потоки).
* В случаях, когда важно учитывать реальную временную протяжённость усреднения независимо от плотности измерений.

'''Преимущества:'''

* Корректно работает при переменной частоте выборок: окно фиксируется по времени, а не по числу точек.
* Более реалистично оценивает тренд во времени на участках с неравномерными измерениями.
* Управляемый компромисс между подавлением шума и чувствительностью за счёт выбора длительности окна.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).

* Более высокая ресурсоёмкость: требуется хранить и периодически «очищать» значения по условию выхода из временного окна; потребление памяти зависит от фактической скорости поступления данных.
* Инерционность, присущая усреднению: возможна задержка фиксации коротких, но значимых пиковых изменений.
* Критичен выбор длительности окна: слишком малое окно даёт мало подавления шума, слишком большое — чрезмерную инерцию и риск пропуска кратких событий.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Интервал архивирования''' — длительность временного окна <math>T</math> (мс), в пределах которого вычисляется среднее. При увеличении <math>T</math> растёт сглаживание и уменьшается чувствительность к кратким всплескам; при уменьшении — наоборот. Значения, чьи метки времени выходят за пределы окна, автоматически исключаются из расчёта.

===== Примечание к алгоритмам 'Процент от…' =====
При малых опорных значениях система автоматически переходит в абсолютный режим, чтобы избежать деления на величину, близкую к нулю, и связанных с этим скачков чувствительности. Этот механизм применяется ко всем алгоритмам, использующим относительное сравнение: «Процент от последнего», «Процент от среднего N», «Процент от среднего по временному окну» и обеспечивает стабильность критерия при слабых сигналах.

* Условия входа в режим абсолютного допуска:
** для «Процента от последнего»: <math>|x_{ref}| < \varepsilon</math>;
** для «Процента от среднего N»: <math>|\bar{x}_{N}| < \varepsilon</math>;
** для «Процента от среднего по времени»: <math>|\bar{x}_{T}| < \varepsilon</math>.
* Критерий в режиме абсолютного допуска: значение фиксируется, если <math>|\Delta| > tolerance</math>.
* Условие выхода: как только соответствующая базовая величина (<math>|x_{ref}|</math>, <math>|\bar{x}_{N}|</math> или <math>|\bar{x}_{T}|</math>) становится <math>\geq \varepsilon</math>, система автоматически возвращается к относительному критерию.
* Трактовка <math>tolerance</math>: используется то же значение настройки; в абсолютном режиме оно интерпретируется как порог в физических единицах сигнала.

===== Сравнение алгоритмов прореживания данных =====
{| class="wikitable"
!Критерий
!Абсолютный
!% от последнего
!% от среднего N
!% от среднего по времени
|-
|Единицы допуска
|Физические
|Проценты
|Проценты
|Проценты
|-
|Устойчивость к шуму
|Низкая
|Средняя
|Высокая
|Высокая
|-
|Реакция на резкие скачки
|Быстрая
|Быстрая
|Задержка (при большом N)
|Задержка
|-
|Подходит при переменной частоте
|Да
|Да
|Нет
|Да
|}

==Система журналирования==
Система ведения журналов событий предназначена для управления регистрацией и хранением событий. В базу данных записываются все системные события и события, генерируемые с помощью [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.A1.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D0.B0 .D1.82.D1.80.D0.B5.D0.B2.D0.BE.D0.B3|системы тревог]], которые соответствуют выбранному уровню сообщений.

Для ведения журналов используются узлы типа "Логгер".

===Порядок настройки системы===
Порядок настройки системы журналирования следующий:

#Добавить и [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9F.D0.BE.D1.80.D1.8F.D0.B4.D0.BE.D0.BA .D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8 .D1.81.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D1.8B|настроить систему тревог]] для генерации событий.
#Добавить в проект систему журналирования. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система журналирования».
#Добавить в систему журналирования логгер. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем нажать «Добавить узел» и выбрать нужный логгер.
#Настроить параметры логгера (см. разделы ниже).

=== Логгер SQLite===
Логгер SQLite предназначен для сохранения событий, возникающих в ходе исполнения прикладной программы в СУБД SQLite.

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

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

===Логгер файловый ===
Логгер файловый предназначен для сохранения журналов событий в текстовых файлах на накопителе. Логгер имеет минимальное количество настроек, и обычно используется для сохранения журнала событий в случае необходимости отладки работы прикладной программы без среды разработки.

===Логгер SMS===
Логгер SMS предназначен для SMS информирования с помощью субмодуля GRPS или внешнего GPRS модема.

Принцип работы логгера следующий:

#Логгер принимает возникающие события, фильтрует их согласно установленного уровня событий и выбранных групп.
#События, прошедшие фильтрацию, форматируются согласно установленного шаблона.
#Отформатированные сообщения отправляются через подключенный модем в виде SMS сообщения. Отправка сообщений производится на телефонные номера, записанные в телефонной книге на SIM-карте.

==Система проверки прав пользователей==
[[Файл:AgavaPLC-Окно привилегий.png|мини|494x494пкс|Окно привилегий]]
Система реализует механизм контроля доступа к узлам проекта и их функциях на основе ролей. Узлы при выполнении действий проверяют наличие установленных привилегий у авторизованного в данный момент пользователя.

=== Роли и пользователи ===
Система содержит в себе две подсистемы:
*Пользователи. Подсистема определяет пользователей, каждому из которых назначается логин/пароль и одна или несколько ролей.
*Роли. Роли хранят наборы доступных привилегий.
Отношения между пользователями, ролями и привилегиями можно описать следующим образом:

* Один пользователь может иметь несколько ролей.
* Одну роль могут иметь несколько пользователей.
* Одна роль может иметь несколько привилегий.
* Одна привилегия может принадлежать нескольким ролям.

=== Привилегии ===
[[Файл:AgavaPLC-Система проверки прав пользователей.png|мини|Система проверки прав пользователей]]
Для узлов системы доступна установка следующих привилегий:

Все узлы:

*Чтение значения.
*Запись значения.
Окна и фреймы:
*Открытие окна.
*Закрытие окна.

При установке привилегий на какой-либо узел, все подчиненные узлы получают те же привилегии с флагом "унаследована".

Если привилегия не установлена, то считается что действие, регулируемое привилегией, запрещено.

Значение унаследованных привилегий можно переопределить с помощью явного задания привилегии.
===Порядок настройки системы===
Привилегии настраиваются в отдельном окне привилегий, доступном в меню "Вид".

Порядок настройки системы проверки прав в версии AgavaSCADA 1.2 следующий:

#Добавить в проект систему проверки прав пользователей. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система проверки прав пользователей».
#Добавить в систему проверки прав пользователей узел «Роль». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Роли».
#Добавить в узел «Роли» необходимые роли. Для этого нажать ПКМ по узлу «Роли» в дереве проекта, затем выбрать «Добавить узел» - «Роль».
#Для каждой роли настроить привилегии в окне привилегий. Для этого необходимо нажать «Вид» - «Открыть привилегии». В открывшемся окне в выпадающем списке «Пользователь / роль» выбрать нужную роль. Затем, нажимая ПКМ по узлам и выбирая «Добавить привилегию» настроить все необходимые ограничения для данной роли.
#Добавить в систему проверки прав пользователей узел «Пользователи». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Добавить в узел «Пользователи» необходимых пользователей. Для этого нажать ПКМ по узлу «Пользователи» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Для каждого пользователя указать имя и пароль, которые будут использоваться при авторизации, и выбрать одну или несколько ролей.

== Сигналы, источники и операции ==
Регистры и другие узлы, добавленные в группу «Сигналы», являются внутренними для проекта и могут менять свои значения только с помощь скриптов или других узлов, с которыми они связаны.

Сигналы содержат в себе несколько подгрупп.

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

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

Первичное значение поступает на вход операции, производится вычисление. Если есть еще операции, то вычисленное значение после первой операции передается на вход второй. И так далее по всем операциям. Если операций больше нет, вычисленное значение устанавливается в качестве значения узла.

Все операции выполняются в порядке, в котором они заданы в соответствующих свойствах.

====Сигнал простой====
Узел типа "Сигнал простой" предназначен для хранения и обработки значения источника, или другого сигнала или операции. Позволяет произвести какие-либо действия с этим значением с помощью добавления нужных операций в свойство «Операции после чтения».

====Постоянная ====
Узел типа "Постоянная" предназначен для хранения данных выбранного формата и позволяет изменять их в ходе выполнения программы. Связывание с источником не предусмотрено. Изменение осуществляется с помощью специализированных функций или блока установки значения в задаче ПЛК.

====Массив====
Массив - совокупность каких-либо объектов, указанных в свойстве «Входные значения». Нумерация объектов в массиве начинается с 0. Может использоваться для взаимодействия с демультиплексором.

====Сигнал комплексный====
Сигнал используется для взаимодействия с виджетом «Цифровой индикатор». Позволяет контролировать входное значение и генерировать события переходу входного значения через уставки.

Содержит в себе свойства для настройки следующих параметров:

*ВАУ – верхняя аварийная уставка;
*ВПУ - верхняя предаварийная уставка;
*НПУ - нижняя предаварийная уставка;
*НАУ – нижняя аварийная уставка;
*ФНЧ – фильтр низких частот.

===Источник===
Источник - специальный тип узлов, предназначенных для передачи данных от внешних устройств.

====Регистр Modbus====
Регистр Modbus используется для приема и передачи данных по протоколам Modbus-RTU, Modbus-TCP. Данный тип узов также может использоваться для организации работы некоторых алгоритмов программы (например для взаимодействия с контроллером событий).

====Источник индексный====
Узел типа "Источник индексный" используется для обработки данных, полученных по протоколу Upd, а так же в массивах для индексации значений.

===Операция===
[[Файл:AgavaPLC-Входные значения операций.png|мини|Входные значения операций]]
Узлы типа "Операция" используются для реализации вычислительных алгоритмов в задаче ПЛК или отдельно, при их размещении в группе "Сигналы".

В качестве входных значений операций выбираются константные числа, другие узлы группы «Сигналы», регистры или блоки задачи ПЛК.

====Операция «Сложение»====
Выходным значением является сумма входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Вычитание»====
Выходным значением является разность первого входного значения и суммы всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Умножение»====
Выходным значением является произведение значений всех входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Деление»====
Выходным значением является результат от деления первого входного значения на произведение всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Условие»====
Узел типа "Операция условие" предназначен для сравнения значений двух узлов. Для условия задаются сравниваемые параметры и выбирается режим сравнения. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Пара условий»====
[[Файл:AgavaPLC-Операция «Пара условий».png|мини|Операция «Пара условий»]]
Операция содержит в себе два условия. Для каждого условия задаются индивидуальные сравнимаемые параметры и выбирается режим сравнения.

Выходное значение операции зависит от ее режима проверки – при выбранном режиме «Логическое ИЛИ» выходное значение равно логической «1» если одно из условий равно «1», при «Логическом И»- если оба условия равны «1».

====Операция «Логическое ИЛИ»====
Если одно из входных значений становится равно логической «1» (контакты замкнуты), то выходное значение становится логической «1» (выход включен).

====Операция «Логическое И»====
Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

====Операция «Логическое НЕ»====
Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

====Операция «Таймер»====
Таймер предназначен для выполнения каких-либо [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действий]] через одинаковые промежутки времени (например запись значения в узел). Промежуток между исполнениями действий задается в свойстве «Интервал срабатывания», а сами действия в свойстве «Действия OnTimer». Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

====Операция «Мультиплексор»====
Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...».

Например если в качестве входных значений указаны два регистра, то выходное значение мультиплексора будет формироваться следующим образом:
{| class="wikitable"
!Значение регистра 1
!Значение регистра 2
!Выходное значение
|-
|0
|0
|0
|-
|1
|0
|1
|-
|0
|1
|2
|-
|1
|1
|3
|}

====Операция «Демультиплексор»====
Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

====Операция «Генератор случайного числа»====
Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями. Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

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

Для выполнения скрипта, можно добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения. Другим способом вызова срабатывания скрипта является добавление его в [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.92.D1.8B.D0.BF.D0.BE.D0.BB.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5 .D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0.C2.BB|действие «Выполнение скрипта»]].

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

*void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

===Объект===
Узлы типа "Объект" предназначены для взаимодействия с аппаратными компонентами контроллера. Для всех объектов, являющихся субмодулями, необходимо указать слот, в котором они установлены. Доступ к значениям входов/выходов субмодуля осуществляется через его вложенные узлы.

'''ПЛК процессорный модуль'''

Предоставляет возможность регулирования подсветки экрана; включения и отключения индикаторов работы, аварии и программы.

'''ПЛК субмодуль DI'''

Позволяет получать доступ к значениям входов субмодуля DI.

'''ПЛК субмодуль R'''

Позволяет управлять значениями выходов субмодуля R.

'''ПЛК субмодуль SIM'''

Позволяет управлять значениями выходов субмодуля SIM.

'''ПЛК субмодуль DO6'''

Позволяет управлять значениями выходов субмодуля DO6.

'''ПЛК субмодуль AI'''

Позволяет получать доступ к значениям входов субмодуля AI и задавать их тип.

'''ПЛК субмодуль AIO'''

Позволяет получать доступ к значениям входов субмодуля AIO, управлять значениями выходов и задавать тип входов и выходов.

'''ПЛК субмодуль TMP'''

Позволяет получать доступ к значениям входов субмодуля TMP и задавать их тип.

==Задачи==
Группа «Задачи» предназначена для группировки узлов типа «Задача», которые используются для циклического или разового выполнения созданных пользователем алгоритмов.

===Задача ПЛК===
Данный узел предоставляет возможности для связывания между собой других узлов (таких как сигналы, субмодули ПЛК, постоянные и т. д.) в удобной графической форме (см. Рисунок 64). Для перехода к редактору необходимо щелкнуть правой кнопкой мыши на задачу ПЛК и выбрать в открывшемся контекстном меню команду «Открыть графическое представление» или дважды щелкнуть левой кнопкой мыши на задаче ПЛК в дереве проекта.

Рисунок 64 – Окно графического редактирования задачи «ПЛК-60»

Панель инструментов задачи ПЛК, расположенная в верхней части окна, содержит следующие элементы (см. Рисунок 16):

*Выпадающий список выбора режима подписи портов.
*Выпадающий список выбора режима подписи блоков.
*Кнопка запуска режима симулятора.
*Кнопка запуска онлайн отладки.
*Кнопка печати задачи.
*Инструменты управления симуляцией.

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

Созданную связь можно удалить, выделив ее левой кнопкой мыши и нажав клавишу "Del". Связь можно "разорвать", то есть добавить разрыв, нажав по ней правой кнопкой мыши и выбрав в контекстном меню команду «Добавить разрыв».

Для выделения нескольких блоков рамкой зажмите клавишу "Shift" и выделяйте блоки мышью с нажатой левой кнопкой.

Задача ПЛК предоставляет возможности для проведения тестирования и отладки проекта, описанные в разделе [[#Проверка и отладка проекта]].

====Блоки задачи ПЛК====
Помимо операций, описанных в разделе [[#Операция]], для реализации алгоритмов в задачу ПЛК можно добавлять блоки, описанные ниже.

'''Функциональный блок'''

Используется для выделения каких-либо действий в отдельный блок, для упрощения понимания работы алгоритма программы. Содержит входы, выходы и блоки, обеспечивающие работу внутренней логики. Позволяет проводить изолированную отладку, при которой значения на входах функционального блока вручную задаются пользователем. Блок, работающий в данном режиме выделяется черной рамкой. Для включения изолированной отладки необходимо открыть блок и нажать кнопку «Изолированная отладка» на панели управления задачей.

'''Блок установки значения'''

Блок осуществляет запись значения, поданного на вход in0, в узел, указанный в свойстве «Узел для чтения/записи»

'''Блок задержки'''

Блок задержки используется для создания задержки передачи значения с входа блока на выход на один цикл обработки задачи.

'''Блок «Битовое OR»'''

Для вычисления значения будет произведена операция "ИЛИ" над каждым битом значения в отдельности. Например: 1010 OR 0110 = 1110

'''Блок «Логическое И»'''

Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

'''Блок «Битовое AND»'''

Для вычисления значения будет произведена операция "И" над каждым битом значения в отдельности. Если все биты, стоящие на одинаковых позициях в двоичных представлениях значений, поступающих на входы блока, равны логической «1», то на выходе элемента в этой позиции появляется логическая «1» (выход включен). Например: 1010 AND 0110 = 0010

'''Блок «Логическое НЕ»'''

Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

'''Блок «Битовое XOR»'''

Если только на один из входов блока функции поступает логическая «1», то на выходе элемента появляется логическая «1». Если на входы блока функции поступают целочисленные значения, то операция будет произведена над каждым битом значения в отдельности. Например: 1010 XOR 0110 = 1100

'''Блок «Битовое SHR»'''

Побитовый логический сдвиг вправо используется для выполнения операции побитового логического сдвига операнда X вправо на N бит с дополнением нулями слева.

'''Блок «Битовое SHL»'''

Побитовый логический сдвиг влево используется для выполнения операции побитового логического сдвига операнда X влево на N бит с дополнением нулями справа.

'''Блок «Таймер»'''

Таймер предназначен для выполнения каких-либо действий (см. раздел 4.6) через одинаковые промежутки времени (например запись значения в узел).

'''Блок «Мультиплексор»'''

Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...»

'''Блок «Демультиплексор»'''

Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

'''Блок «Генератор случайного числа»'''

Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями.

'''Блок «Скрипт С++»'''

Операция «Скрипт С++» предназначена для реализации разнообразных алгоритмов на языке С++. Операция предусматривает реализацию одной или нескольких функций, выполняющих необходимые пользователю действия. Для выполнения скрипта, необходимо добавить его в качестве узла для задачи или задачи ПЛК.

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

* void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

'''Блок «Таймер с задержкой»'''

Таймер с задержкой используется для операции задержки передачи и/или отключения сигнала. На выходе таймера появится сигнал логической «1» с задержкой относительно фронта входного сигнала продолжительностью равной интервалу включения и выключится по спаду входного сигнала с задержкой продолжительностью равной интервалу выключения. В том случае, если необходимо использовать блок только как таймер с задержкой включения (отключения) интервал выключения (включения) устанавливается равным 0.

'''Блок «Генератор прямоугольных импульсов»'''

Генератор прямоугольных импульсов используется для формирования прямоугольных импульсов пульсации. На выходе генератора формируются импульсы с заданными параметрами длительности включенного и отключенного импульса на время действия управляющего сигнала на входе (сигнал логической «1»).

'''Блок «Триггер RS»'''

RS-триггер с приоритетом выключения используется для переключения с фиксацией состояния во время поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Триггер SR»'''

SR-триггер с приоритетом включения используется для переключения с фиксацией состояния в случае поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Детектор переднего фронта импульса»'''

Детектор переднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «0» в «1».

'''Блок «Детектор заднего фронта импульса»'''

Детектор заднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «1» в «0».

'''Блок «D-триггер»'''

D-триггер используется для формирования импульса включения выхода на интервал времени импульса на входе D, выходной интервал будет синхронизирован с тактовой частотой на входе С. На выходе Q триггера появится сигнал логической «1» по фронту тактовых импульсов на входе С при наличии сигнала логической «1» на входе D. Возврат выхода в сигнал логического «0» произойдет по фронту тактовых импульсов на входе С при наличии сигнала логического «0» на входе D. Вход Set принудительно устанавливает выход в состояние логической «1». Вход Reset является приоритетным и устанавливает выход в состояние логического «0».

'''Блок «Селектор»'''

Если на вход Value подается логическая «1», то результатом выполнения операции блока на выходе является входной сигнал ValueT. Если же Value равен логической «0», то результатом выполнения операции блока на выходе является входной сигнал ValueF.

'''Блок «Больше чем»'''

На выход подается логическая «1», если значение in0 больше чем значение in1.

'''Блок «Равенство»'''

На выход подается логическая «1», если значение in0 равно значению in1.

'''Блок «Абсолютное значение числа»'''

Результатом операции функции на выходе является модуль подаваемого на вход значения. Если число на входе положительное, то на выход подается само число, если отрицательное – положительное число, получаемое от перемены его знака с «-» на «+».

'''Блок «Возведение в степень»'''

Результатом операции функции на выходе является значение, равное значению in0, возведенному в степень значения N.

'''Блок «PID-регулятор»'''

Регулятор PID применяется для поддержания заданного значения параметра. На вход Pv подается текущее значение регулируемой величины, на Sp – ее заданное значение. С помощью изменения коэффициентов ПИД регулятора kP, kI и kD достигается оптимальный режим работы. Min задает минимальное значение на выходе, Max – максимальное. time - период регулятора (в мс.).

'''Блок «PWM-регулятор»'''

Применяется для преобразования аналогового сигнала в дискретный с помощью ШИМ. На вход in подается текущее значение регулируемой величины, Min задает минимальное значение на входе, Max – максимальное. time - период регулятора (в мс.)

==Устройства==
Группа «Устройства» предназначена для группировки узлов типа "Устройство", выполняющие разнообразные задачи, например работа с внешними накопителями и ПЗУ.

Retain-накопитель дает возможность хранить значения регистров, постоянных и сигналов в постоянной памяти контроллера, что позволяет им сохранять свои значения после отключения питания.

Для сохранения переменных необходимо перечислить их в свойстве «Узлы» и указать путь сохранения на выбранном накопителе.

== Отчеты==
{{Внимание|Тип=Восклицание желтый.png|Текст=Данный узел доступен только при исполнении проекта на настольном компьютере. На панелях оператора и контроллерах МПР этот узел не доступен.}}
Отчет – технологический документ, содержащий информацию о ходе производственного процесса, обработанную по заложенным в отчет алгоритмам. Отчеты формируются на основе макетов (статической части отчетов) путем добавления в них свойств и значений заданных параметров технологического процесса, которые формируются (выбираются из базы данных технологических параметров и проходят соответствующую обработку) по алгоритмам, размещенным в этих шаблонах.

Данные для отчета предоставляет выборка, осуществляющая получение данных и их обработку из базы данных.

===Создание нового отчета===
Создание любого отчета производится в два этапа.

#Создание необходимых узлов в конфигурации: сам отчет и необходимое количество выборок.
#Составление макета отчета.

Создание узла типа «Отчет» в конфигурации и выборок для него производится аналогично созданию узлов других типов. К станции добавляется узел типа «Отчеты» с помощью команды контекстного меню «Добавить узел», далее к узлу типа «Отчеты» добавляется отчет и к отчету добавляется необходимое количество выборок.

Выборка – специальный узел, предназначенный для выборки данных из архива и их обработки для последующего отображения в отчете.

Перед переходом к редактированию макета желательно проделать следующие операции:

*в свойстве отчета «Путь к файлу отчета» установить имя файла, в котором будет храниться макет отчета;
* в свойстве «Источники» выборки (выборок) отчета установить перечень архивных сигналов (коннекторов), которые будут выводиться в отчете.

===Редактирование макета отчета===
[[Файл:AgavaPLC–Редактор макета отчета.png|мини|Рисунок 42 – Редактор макета отчета]]
Для редактирования макета отчета необходимо переключиться из редактора конфигурации в редактор макета отчета с помощью команды «Открыть редактор макета отчета», доступной из контекстного меню дерева конфигурации, отображаемого при щелчке правой кнопкой мыши на узле типа «Отчет».

В окне редактора расположены:

*панели инструментов;
* панель объектов отчета;
*окно «Инспектор объектов»;
*окно «Инспектор данных»;
*окно «Инспектор скриптов»;
*область построения макета отчета;
*окно «Структура отчета».

Редактор макета позволяет вызывать команды сочетаниями клавиш:

*Ctrl + N – новый макет;
*Ctrl + O – загрузить макет;
*Ctrl + S – сохранить макет;
*Ctrl + Shift + S – сохранить макет под новым именем;
*Ctrl + P – предварительный просмотр;
*Ctrl + Z – отмена изменений;
*Ctrl + Shift + Z – возврат отмененных изменений;
* Ctrl + C – копировать объект;
*Ctrl + X – вырезать объект;
*Ctrl + V – вставить объект;
*Ctrl + Стрелки – переместить выделенный объект;
*Shift + Стрелки – изменить размер выделенных объектов;
*Del – удалить выделенные объекты;
*Shift + левая кнопка мыши – создать область выделения.

====Окно «Инспектор объектов»====
Окно «Инспектор объектов» содержит список свойств выделенного объекта и предназначено для их редактирования.

====Окно «Инспектор данных»====
Окно «Инспектор данных» содержит список доступных для использования источников данных (выборок) и предназначено для заполнения блока «Данные» элементами соответствующего типа.

====Окно «Инспектор скриптов»====
Окно «Инспектор скриптов» содержит список доступных для использования в отчете скриптов.

====Окно «Структура отчета»====
Окно «Структура отчет» отображает структуру отчета в виде дерева связанных элементов.

===Элементы отчета===
Для составления макета отчета доступны следующие элементы:

*текст;
*данные;
*изображение;
*фигура;
*компоновка (Layout).

====Текст====
Элемент «Текст» служит для вывода надписей или содержимого полей источников данных.

Объект «Текст» обладает очень широкими возможностями. Он умеет отображать текст, рамку, заливку. Текст может быть отображен любым шрифтом любого размера, цвета и стиля. Большинство настроек делаются визуально с помощью панелей инструментов.

Одна из самых главных особенностей этого универсального объекта – это возможность отображения не только статичного текста, но и текста с применением вычисляемых выражений. Причем, выражения могут располагаться в объекте вперемешку с текстом. Рассмотрим простой пример – поместим в объект «Текст» следующую строку: «Привет! Сегодня $S{now()}».

Если запустить отчет на построение, мы увидим приблизительно следующее: «Привет! Сегодня 20180803». В процессе построения отчета выражение в тексте, заключенное $S{}, было вычислено и полученное значение вставлено обратно в текст. Объект «Текст» может содержать любое количество выражений, смешанных с обычным текстом. В скобки можно заключать и одиночные переменные, и выражения, например, $S{1+2*(3+4)}. В выражениях можно использовать константы, переменные ($V{}), функции, поля БД ($D{}).

Свойства элемента «Текст»:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|alignment
|Выравнивание текста по вертикали и горизонтали
|-
|angle
|Поворот надписи
|-
|autoHeight
|Автоматический подбор высоты
|-
|autoWidth
|Автоматический подбор ширины
|-
|backgroundColor
|Цвет заливки
|-
|backgroundMode
|Режим заливки
|-
| backgroundOpacity
|Прозрачность заливки
|-
|borders
|Границы
|-
|content
|Содержимое объекта «Текст»
|-
|font
|Шрифт
|-
|fontColor
|Цвет шрифта
|-
| foregroundOpacity
|Прозрачность шрифта
|-
|geometry
|Размер и расположение объекта
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|margin
|Отступы
|-
|objectName
| Имя объекта
|-
|stretchToMaxHeight
|Установка значения высоты самого высокого объекта на бэнде
|-
|trimValue
|Удаление пробелов в начале и в конце надписи
|}

Для редактирования свойства «Content» используется диалоговое окно «Text Item Editor», вызов которого осуществляется двойным щелчком левой кнопки мыши на элементе «Текст».

Свойство «Content» может содержать:

*текст;
*значения переменных;
*значения полей из набора данных;
*значения, формируемые посредством исполнения скрипта.

Для вывода значений переменных используется синтаксис «$V{имяПеременной}» (без кавычек), для вывода значения поля данных – «$D{имяНабораДанных.ИмяПеременной}», для вывода результата исполнения скрипта – «$S{телоСкрипта}».

==== Изображение ====
Элемент для вывода изображений:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoSize
|Подгонять размер под размер изображения
|-
|borders
|Границы
|-
|content
|
|-
|datasource
|Источник данных
|-
|field
|Поле данных
|-
|geometry
|Размер и расположение
|-
|image
|Изображение
|-
| itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
| stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Фигура====
Элемент для вывода фигур:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
| geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|lineWidth
|Толщина линии
|-
|objectName
|Имя объекта
|-
|opacity
|Прозрачность
|-
|penStyle
|Стиль линии
|-
|shape
|Фигура
|-
|shapeBrush
|Стиль заливки
|-
|shapeBrushColor
|Цвет заливки
|-
|shapeColor
|Цвет фигуры
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Горизонтальная компоновка (Layout)====
Элемент, позволяющий объединять несколько элементов в группу:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
|geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

=== Разделы отчета (бэнды) ===
Бэнд предназначен для размещения других элементов отчета. Бэнд может быть нескольких типов:

*Report Header – заголовок отчета;
*Report Footer – завершение отчета;
*Page Header – верхний колонтитул страницы отчета;
*Page Footer – нижний колонтитул страницы отчета;
*Data – данные отчета;
* SubDetail – подчиненные данные отчета;
*SubDetailHeader – заголовок подчиненных данных;
*SubDetailFooter – завершение подчиненных данных;
*GroupHeader – заголовок группы;
*GroupFooter – завершение группы.

Бэнды применяются для логической группировки объектов. К примеру, размещение объекта на элементе «Данные» типа «Page Header», приводит к отображению этого объекта в верхней части каждой страницы готового отчета. Аналогичным образом «Page Footer» выводится внизу каждой страницы со всеми лежащими на нем объектами.

Общие для всех элементов «Данные» свойства:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoHeight
|Автоматический подбор высоты
|-
|backgroundColor
|Цвет заливки бэнда
|-
|borders
|Границы
|-
|geometry
|Размер
|-
|keepBottomSpace
|Сохранение отступа от нижней границы бэнда
|-
|objectName
|Имя объекта
|-
|printIfEmpty
|Отображение пустого бэнда
|-
|splittable
|Разделение бэнда, если он не влезает на страницу
|}

Report Footer:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|maxScalePercent
|Максимальный процент, на который можно уменьшить бенд, если он не влезает на страницу. Если бэнд даже после сжатия

не влезает на страницу, он будет перенесен полностью или частично – в зависимости от настроек бэнда
|}

Data:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|datasource
|Источник данных. Data-бэнд будет сформирован для каждой строки в источнике данных
|-
|keepFooterTogether
|Если Report Footer не влезает на страницу, то он будет перенесен на следующую страницу совместно с последним

экземпляром Data-бэнда
|-
|sliceLastRow
| Указывает генератору отчетов на то, можно ли разрезать последний экземпляр Data-бэнда или его нужно перенести

целиком
|}

Бэнды данного типа предназначены для вывода на печать данных из наборов. Набор данных - это заранее неизвестное количество строк (записей), каждая из которых содержит определенное количество колонок (полей).

SubDetail:
{| class="wikitable"
! Наименование свойства
!Описание
|-
|datasource
| Источник данных. SubDetail-бэнд будет сформирован для каждой строки в источнике данных
|}

SubDetailHeader, SubDetailFooter:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|printAlways
| Печатать, даже если SubDetail пустой
|}

GroupHeader:
{| class="wikitable"
!Наименование свойства
! Описание
|-
|groupFieldName
|Поле, по которому осуществляется группировка. Экземпляр GroupHeader будет формироваться при смене значения в этом поле
|}

===Функции===
==== Агрегатные функции ====
Агрегатные функции предназначены для обработки значений, содержащихся в резделах Data и SubDetail.

===== AVG - вычисление среднего значения =====
Пример использования:
$S{AVG("TextItem4","DataBand1");}

===== SUM - вычисление суммы значений =====
Пример использования:
$S{SUM("TextItem8","DataBand1");}

===== MIN =====

===== MAX =====

===== COUNT =====

==== Числовые функции ====

===== numberFormat - форматирование числа =====
Синтаксис:
numberFormat(значение, 'формат', точность)
Форматы:

* <code>'f'</code> — фиксированная запись (например, <code>"123.45"</code>);
* <code>'g'</code> — общий формат (автоматически выбирает между <code>'f'</code> и <code>'e'</code>);
* <code>'e'</code> — экспоненциальная запись (например, <code>"1.2345e+02"</code>);

Пример использования:
$S{numberFormat($D{fetcharchiverdata1.ArchiversSourceConnector0 (среднее)}, 'f', 3)} -> 123.495
[[Категория:AgavaSCADA/AgavaPLC]]

Узлы проекта AgavaSCADA/AgavaPLC

2025-10-29T11:52:11Z

SharipovRR: /* Архиватор PostgreSQL */

== Узлы проекта ==
Узел - элементарная сущность проекта, осуществляющая хранение информации или реализующая определенный функционал. Каждый узел обладает набором [[Свойства узлов в AgavaPLC/AgavaSCADA|свойств]]. Все узлы, объединенные в иерархическую структуру, образуют проект.

== Проект ==
[[Файл:AgavaPLC–Дерево проекта.png|мини|Рисунок 21 – Дерево проекта]]
Узел "Проект" ("Корневой узел", "Корень") предназначен для хранения общей информации о проекте и связывания других узлов проекта.

== Станция ==
Станция – важнейший узел, управляющий работой собственных систем и выполняющий обмен данными с другими станциями. Физически станция представляет собой устройство, на котором исполняется проект (компьютер, панель оператора, МПР-60 или другое устройство).

Для использования в проекте доступны несколько типов станций. например:

* '''Станция''' - общий тип станции. Проекты с такой станцией могут выполняться на большинстве устройств - контроллеры, панели, персональные компьютеры. Чаще всего используется для проектов, предназначенных для выполнения на персональном компьютере.
* '''Панель ПО-40''' - специализированный тип для проектов на панелях оператора ПО-40. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.
* '''Панель ПО-50''' - специализированный тип для проектов на панелях оператора ПО-50. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.).
* '''Контроллер МПР-60''' - специализированный тип для проектов на программируемых реле МПР-60. Станция такого типа по отношению к общему дополнительно предоставляет возможность управления оборудованием панели оператора (светодиоды индикации и др.), использования корзины субмодулей.

При построении больших проектов станций в проекте может быть несколько, и они могут выполнять разные задачи. Например, станция-сервер выполняет сбор и регистрацию данных, клиентские станции выполняют визуализацию данных на рабочих местах и т. д.

Станции подчиняются узлы типа "Система" - Транспортная система, Система архивирования, Система визуализации и т. д.

== Транспортная система ==
Транспортная система управляет передачей данных по различным каналам связи. Система управляет работой "Транспортов" - узлов, выполняющих обмен данными с устройствами по определенному протоколу.

С одной стороны, транспортная система обращается непосредственно к сигналам и каналам устройства, а с другой стороны, представляет их в виде неких универсальных единиц – узлов-источников. Каждый источник однозначно соответствует определенному сигналу или параметру устройства. При изменении сигнала меняется и значение источника. При записи данных в источник производится подача команды устройству на установку определенного значения конкретного параметра.

Транспортная система допускает использование нескольких транспортов, что дает возможность одновременного обмена данными с большим количеством устройств по разным протоколам.

=== Транспорт ===
Транспорт предназначен для обмена данными с устройствами по определенному протоколу. Один транспорт, в зависимости от типа, позволяет обмениваться данными с одним или несколькими устройствами.

Доступны для использования следующие виды транспортов:

* Транспорт Modbus-TCP;
* Транспорт Modbus-RTU;
* Транспорт SNMP;
* Транспорт OPC UA;
* Транспорт OPC DA (только для Windows);
* Транспорт MQTT;
* Последовательный транспорт (устаревший);
* TCP/IP транспорт (устаревший).
Подробное описание транспортов приведено в отдельном документе "[[Транспорты AgavaSCADA/AgavaPLC]]".

==Система визуализации==
{{Внимание|Тип=Восклицание желтый.png|Текст=Система визуализации недоступна в проектах для контроллеров МПР}}

Задачей этой системы является отображение данных в виде набора мнемонических схем (экранов, мнемосхем), а также предоставление пользователю возможности управления.

Каждый экран позволяет в схематичном, понятном пользователю виде представить участок технологической схемы с отображением необходимых параметров технологического процесса.

Изображение на экране строится с помощью окон, на которых размещаются объекты визуализации – виджеты. Виджетами могут быть текстовые метки, изображения, в том числе анимированные, элементы управления, графики и т. д. Виджеты можно объединять в слои для удобного управления отображением виджетов.

Виджеты могут быть статическими и динамическими. Динамические виджеты привязаны к одному или нескольким сигналам и их отображение зависит от значений этих сигналов. Статические виджеты не имеют привязки к сигналам и их изображение всегда постоянно.

Для перехода по экранам, изменения значений параметров и иного управления служат специальные виджеты: кнопки управления, поля ввода и другие.

Для повышения быстродействия и увеличения комфортности работы с системой система визуализации хранит в памяти кэш из нескольких последних открытых экранов. Когда при последовательном открытии экранов этот кэш заполняется, наиболее старые экраны удаляются из него. Это связано с тем, что, как правило, в работе используются несколько одних и тех же экранов, которые отображают сводную информацию о техпроцессе и оператор в штатном режиме переключается только между ними. Сохраняя их в памяти, система ускоряет переключение между ними, поскольку при этом не требуется каждый раз создавать экран, все находящиеся на нем объекты и запускать процессы обновления параметров.

Когда экран переходит в кэш, обновление параметров на нем прекращается для снижения нагрузки на центральный процессор. Если все же необходимо, чтобы экран всегда производил обновление данных (по разным причинам), даже находясь в кэше, необходимо в его настройках включить опцию «Постоянно обновляемый».

Подчиненные типы узлов:

*фрейм;
*окно;
*композиция.

===Фрейм===
[[Файл:AgavaPLC–Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией.png|мини|Рисунок 23 – Пример структуры сложного фрейма, состоящего из двух форм и одного окна с многослойной композицией]]
Фрейм – узел, предназначенный для группировки окон, отображаемых на определенном дисплее. Обеспечивает организацию окон в пространстве экрана, управление мониторами и границами отображения.

Если необходимо отобразить информацию на нескольких дисплеях одновременно, то для каждого из них нужно использовать отдельный фрейм. Окон во фрейме может быть несколько, однако они не могут накладываться друг на друга.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
|-
|Позиция X
|XCoord
|int
|Координата X левого верхнего угла фрейма
|Целое число
|-
|Позиция Y
|YCoord
|int
|Координата Y левого верхнего угла фрейма
|Целое число
|-
|Ширина
|XSize
|int
|Ширина фрейма в пикселях
|Целое число > 0
|-
|Высота
|YSize
|int
|Высота фрейма в пикселях
|Целое число > 0
|-
|Окна
|Windows
|NodesArray
|Список окон, принадлежащих фрейму
|Узлы типа: Window
|-
|Номер монитора
|DisplayNo
|int
|Номер монитора для отображения фрейма
|0 - по умолчанию
≥1 - конкретные мониторы
|-
|Тип границы
|BorderType
|enum
|Тип границы фрейма
|0: Не определен (ошибка)
1: Отсутствует

2: Фиксированная
|}

==== Позиция и размеры (XCoord, YCoord, XSize, YSize) ====

* '''Тип:''' int.
* '''Описание:''' Определяют положение и размеры фрейма на экране.
* '''Значения по умолчанию:''' (0, 0, 640, 480).
* '''Применение:''' Задание области экрана, которую занимает фрейм.

==== Окна (Windows) ====
'''Тип:''' NodesArray.

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

'''Особенности:'''

* Поддерживаются только узлы типа Window.

==== Номер монитора (DisplayNo) ====
'''Тип:''' int.

'''Описание:''' Определяет, на каком мониторе системы отображается фрейм. Значение 0 соответствует монитору по умолчанию.

'''Использование:'''

* 0 - основной монитор.
* 1, 2, ... - дополнительные мониторы.
* Свойство важно для многомониторных конфигураций.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип обрамления фрейма. Влияет на внешний вид и поведение границ.

'''Значения:'''

* '''Отсутствует''' - фрейм без видимых границ.
* '''Фиксированная''' - стандартная граница окна.
* '''Не определен''' - используется только для обработки ошибок.

==== Наследование привилегий ====
Фрейм автоматически добавляет доступные привилегии для работы с окнами:

* <code>OpenWindow</code> - привилегия на открытие окон.
* <code>CloseWindow</code> - привилегия на закрытие окон.

===Окна===
Окно – узел, осуществляющий отображение видеокадра (мнемонической схемы).

Существуют несколько видов окон:

1. «Форма», предназначенная для вывода простого набора данных без необходимости управления видимостью или внешним видом его элементов. Для вывода информации в такое окно кроме создания окна и добавления к нему виджетов ничего более не требуется.
[[Файл:AgavaPLC-Меню.png|мини|164x164пкс|Рисунок 24 — Внешний вид меню в среде исполнения]]
2. «Окно с композицией», предназначенное для вывода большого количества информации и позволяющее организовать группировку элементов по слоям, управлять внешним видом элементов, видимостью слоев и отдельных элементов, а также дающее возможность регулирования работы пользователя с элементами. Для вывода информации в такое окно нужно к окну привязать композицию, содержащую минимум один слой, в который уже добавляются виджеты.

=== Форма ===
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Модальность
|Modality
|enum
|Режим модальности окна
|0: Не определен (ошибка)
1: Немодальное

2: Модальное (Фрейм)

3: Модальное (Система)
|Чтение/Запись
|-
|Тип границы
|BorderType
|enum
|Тип границы окна
|0: Не определен (ошибка)
1: Фиксированная

2: Изменяемая

3: Отсутствует
|Чтение/Запись
|-
|Отображать строку заголовка
|TitleEnabled
|bool
|Отображать строку заголовка
|true/false
|Чтение/Запись
|-
|Отображать кнопку "Закрыть"
|CloseEnabled
|bool
|Отображать кнопку "Закрыть"
|true/false
|Чтение/Запись
|-
|Цвет фона
|BackgroundColor
|NColor
|Цвет фона окна
|Цвет в формате RGBA
|Чтение/Запись
|-
|Затемнение
|NeedDarkenApplication
|bool
|Затемнение других окон приложения при открытии этого окна
|true/false
|Чтение/Запись
|-
|Цвет затемнения
|ColorDarkenApplication
|NColor
|Цвет затемнения
|Цвет в формате RGBA
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов, мс
|0 - без задержки
>0 - интервал в мс
|Чтение/Запись
|-
|Действия OnShow
|ActionsOnShow
|NodesContainer
|Действия при показе окна
|Узлы типа: Action
|Чтение/Запись
|-
|Действия OnClose
|ActionsOnClose
|NodesContainer
|Действия при закрытии окна
|Узлы типа: Action
|Чтение/Запись
|}

==== Модальность (Modality) ====
'''Тип:''' enum.

'''Описание:''' Определяет поведение окна относительно других окон приложения.

'''Значения:'''

* '''Немодальное''' - позволяет взаимодействовать с другими окнами.
* '''Модальное (Фрейм)''' - блокирует взаимодействие с окнами в том же фрейме.
* '''Модальное (Система)''' - блокирует все окна приложения.

==== Тип границы (BorderType) ====
'''Тип:''' enum.

'''Описание:''' Определяет тип и поведение границ окна.

'''Значения:'''

* '''Фиксированная''' - окно нельзя изменять размер.
* '''Изменяемая''' - пользователь может изменять размер окна.
* '''Отсутствует''' - окно без видимых границ.

==== Управление заголовком (TitleEnabled, CloseEnabled) ====
'''Тип:''' bool.

'''Описание:''' Контролируют отображение элементов заголовка окна.

==== Фон и затемнение (BackgroundColor, NeedDarkenApplication, ColorDarkenApplication) ====
'''Тип:''' NColor, bool, NColor.

'''Описание:''' Управляют визуальным оформлением окна и его влиянием на другие окна.

'''Особенности:'''

* Затемнение применяется только при NeedDarkenApplication = true.
* Цвет затемнения по умолчанию: черный с прозрачностью 50%.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Определяет частоту обновления виджетов в окне.

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчики событий (ActionsOnShow, ActionsOnClose) ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых при показе и закрытии окна.

=== Окно с композицией ===
Данный узел имеет те же свойства, что и форма, а также собственные:
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Композиция
|CompositionId
|NodeLink
|Основная композиция окна
|Узлы типа: CompositionLayered, CompositionTemplated
|Чтение/Запись
|-
|Описание текущей композиции
|CurrentCompositionDesc
|string
|Описание текущей загруженной композиции
|Автоматически формируется
|Только чтение
|}

==== Композиция (CompositionId) ====
'''Тип:''' NodeLink.

'''Описание:''' Ссылка на композицию, отображаемую в окне.

'''Поддерживаемые типы:''' CompositionLayered, CompositionTemplated.

==== Описание текущей композиции (CurrentCompositionDesc) ====
'''Тип:''' string.

'''Описание:''' Автоматически обновляемое описание загруженной композиции.

'''Особенности:''' Свойство только для чтения, обновляется системой автоматически.[[Файл:AgavaPLC-Настройка меню в среде разработки.png|мини|226x226пкс|Рисунок 25 — Настройка меню в среде разработки]]

===Композиция===
Композиция – узел, представляющий составленную при разработке проекта мнемоническую схему в виде набора элементов визуализации (виджетов), сгруппированных в один или несколько слоев.

Композиция дает возможность организовать виджеты в слои, видимостью которых можно управлять во время работы проекта.
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Размеры
|Size
|NSize
|Размеры композиции
|Структура {ширина, высота}
|Чтение/Запись
|-
|Кэширование
|Cacheable
|bool
|Кэширование данных композиции для быстрого повторного открытия
|true/false
|Чтение/Запись
|-
|Источник интервала обновления
|UpdateIntervalSource
|enum
|Определяет источник интервала обновления виджетов
|0: Окно
1: Композиция
|Чтение/Запись
|-
|Интервал обновления
|UpdateInterval
|int
|Интервал обновления виджетов в миллисекундах
|Целое число ≥ 0
|Чтение/Запись
|-
|Действия OnLoad
|ActionsOnLoad
|NodesContainer
|Действия при загрузке композиции
|Узлы типа: Action
|Чтение/Запись
|}

==== Размеры (Size) ====
'''Тип:''' NSize (ширина, высота).

'''Описание:''' Определяет размеры композиции в пикселях. По умолчанию установлены значения 800x600.

==== Кэширование (Cacheable) ====
'''Тип:''' bool.

'''Описание:''' Включает или отключает кэширование данных композиции. При включенном кэшировании композиция сохраняется в памяти для быстрого повторного открытия.

'''Преимущества кэширования:'''

* Быстрое переключение между композициями.
* Снижение нагрузки на систему при частом использовании.
* Сохранение состояния элементов.

'''Рекомендации:''' Включать для часто используемых композиций, отключать для редко используемых или ресурсоемких.

==== Источник интервала обновления (UpdateIntervalSource) ====
'''Тип:''' enum.

'''Описание:''' Определяет, откуда виджеты композиции получают интервал обновления.

'''Значения:'''

* '''Окно''' - интервал обновления наследуется от родительского окна.
* '''Композиция''' - используется собственный интервал обновления композиции.

'''Применение:''' Централизованное управление производительностью через окно или индивидуальная настройка для каждой композиции.

==== Интервал обновления (UpdateInterval) ====
'''Тип:''' int.

'''Описание:''' Задает интервал обновления виджетов в миллисекундах. При значении 0 отрисовка виджетов выполняется без задержки (максимальная частота).

'''Особенности:'''

* 0 - обновление без задержек (может создать высокую нагрузку).
* > 0 - обновление с заданным интервалом. Учитывается только при UpdateIntervalSource = "Композиция"

'''Рекомендации:'''

* 0 - 100 мс для композиций с критичным временем отклика.
* 100 - 500 мс хорошо подходит для большинства случаев.
* более 1000 мс - для статических или редко меняющихся данных.

==== Обработчик событий ActionsOnLoad ====
'''Тип:''' NodesContainer.

'''Описание:''' Коллекции действий, выполняемых после загрузки композиции <code>AS 1.6.27+</code>.

===Слой===
Слой – набор виджетов, объединенных каким-то общим структурным признаком. В многослойных композициях слой обеспечивает организацию виджетов в z-порядке, управление видимостью и взаимодействием с пользователем. С помошью свойства "Видимость" слоя можно управлять видимостью виджетов, размещенных на слое.

Свойства
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Описание
!Допустимые значения
!Режим доступа
|-
|Z-Порядок
|ZOrder
|int
|Порядок слоя в композиции
|Целое число (чем выше значение, тем выше слой)
|Чтение/Запись
|-
|Прозрачность для действий
|ActionTransparency
|enum
|Определяет поведение слоя при взаимодействии с пользователем
|0: Не определен (ошибка)
1: Непрозрачный

2: Прозрачный
|Чтение/Запись
|-
|Видимость
|Visible
|bool
|Видимость слоя и всех его виджетов
|true/false
|Чтение/Запись
|}

==== Z-Порядок (ZOrder) ====
'''Тип:''' int

'''Описание:''' Определяет порядок отображения слоя относительно других слоев в композиции. Слои с большим значением ZOrder отображаются поверх слоев с меньшим значением.

'''Пример использования:'''

* Фоновый слой: ZOrder = 1.
* Основной контент: ZOrder = 2.
* Контекстные виджеты: ZOrder = 3.

==== Прозрачность для действий (ActionTransparency) ====
'''Тип:''' enum

'''Описание:''' Управляет взаимодействием слоя с пользовательскими действиями (клики, наведения и т.д.)

'''Значения:'''

* '''Непрозрачный''' - слой полностью перехватывает пользовательские действия, элементы под ним недоступны, даже если они видимы.
* '''Прозрачный''' - пользовательские действия проходят сквозь слой к элементам ниже.

Обратите внимание: если на слое размещается изображение с прозрачной областью, то такие виджеты не позволяют пользователю взаимодействовать с видимыми и размещенными под ним виджетами.

==== Видимость (Visible) ====
'''Тип:''' bool

'''Описание:''' Определяет видимость всего слоя и всех его дочерних виджетов. При значении false слой и все его содержимое становится невидимым.

'''Применение:''' Временное скрытие виджетов или переключение их видимости.

===Виджет===
Виджет – элемент визуализации, предназначенный для отображения информации в заданном виде.

===Меню===
Меню – элемент визуализации, сочетающий в себе несколько виджетов «Кнопка». Используется для более удобного управления проектом (см. Рисунок 24).

Для добавления меню, необходимо в среде разработки назначить [[Универсальная среда разработки#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.9E.D1.82.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5 .D0.BC.D0.B5.D0.BD.D1.8E.C2.BB|действие «Отображение меню»]] для кнопки (или любого другого виджета). После добавления действия необходимо выделить его и нажать на кнопку настроек на панели вверху окна действий. Открывшееся окно (см. Рисунок 25) содержит дерево со структурой меню, в который можно добавлять элементы двух типов:

*меню – элемент, который позволяет группировать элементы меню, выводя их в виде раскрывающегося списка. На рисунках 24 и 25 этим элементом являются кнопки «Арочник» и «БПО».
*элемент меню – элемент, который предоставляет функционал, аналогичный [[Универсальная среда разработки#.D0.92.D0.B8.D0.B4.D0.B6.D0.B5.D1.82 .C2.AB.D0.9A.D0.BD.D0.BE.D0.BF.D0.BA.D0.B0.C2.BB|виджету «Кнопка»]]. Для добавления действия, выполняющегося при нажатии на элемент меню в среде исполнения, необходимо нажать на него ПКМ в дереве структуры меню и выбрать "Создать действие". На рисунках 24 и 25 этим элементом являются кнопки «Котельная», «Котёл №1», «Котёл №2» и «Котёл №3».

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

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

# Добавить дополнительные фреймы, чтобы их количество в проекте соответствовало количеству дисплеев. Каждому фрейму назначить порядковый номер, начиная с 1. Фреймы связываются с дисплеями по номеру.
# Добавить дополнительное окно (или окна, если в исходном фрейме их несколько или дополнительных фреймов больше одного).
# Добавить в дополнительные фреймы созданные на этапе 2 окна, чтобы повторить структуру основоного фрейма.

Базовая настройка на этом закончена. После запуска такого проекта на двух или более дисплеях должны отображаться созданные окна.

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

===Виджеты===
====Виджет «Текстовая метка»====
[[Файл:AgavaPLC–Примеры оформления виджетов типа "Текстовая метка".png|мини|Рисунок 26 – Примеры оформления виджетов типа "Текстовая метка"]]
Виджет «Текстовая метка» – наиболее часто применяемый виджет, с помощью которого можно реализовать разные способы отображения текстовой информации.

Виджет «Текстовая метка» может использоваться для отображения статичного текста, значений параметров (одного или нескольких) и их комбинаций.

При необходимости отображения значений параметров они указываются в свойстве «Источник». Для задания определенного формата отображения используются спецификаторы формата в стиле языка «Си»:

*%f – значение в виде числа с плавающей точкой;
* %s – строка;
*%i – целое число со знаком;
*%u – целое число без знака;
* %d – целое число со знаком в десятичной системе исчисления.

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

Для отображения знака «%» необходимо указать его дважды: «%%».

===== Отображение нескольких значений =====
Одна текстовая метка может использоваться для отображения нескольких значений. Для этого все значения, которые нужно отобразить, указываются в свойстве «Источник», а в свойстве «Текст» указываются последовательно несколько спецификаторов формата соответственно порядку перечисления значений в свойстве «Источник».

Пример: текстовая метка, отображающая текущую позицию в очереди:

* Текст: <code>Позиция %i из %i</code>
* Источник: два узла из проекта.

=====Модификаторы спецификаторов формата=====

======Модификатор минимальной ширины поля======
Целое число, расположенное между знаком % и кодом формата, играет роль модификатора минимальной ширины поля. Если указан модификатор минимальной ширины поля, то, чтобы ширина поля вывода была не меньше указанной минимальной величины, вывод при необходимости будет дополнен пробелами. Если же выводятся строки или числа, которые длиннее указанного минимума, то они все равно будут отображаться полностью. По умолчанию для дополнения используются пробелы. А если для этого надо использовать нули, то перед модификатором ширины поля следует поместить 0. Например, %05i означает, что любое число, количество цифр которого меньше пяти, будет дополнено таким количеством нулей, чтобы состоять из пяти цифр.

Примеры
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%i
|10
|-
|10.123
|%d
|10
|-
|10.123
|%05i
|00010
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
| 10.1
|-
|10.123
|%10f
|<пробел>10.123000
|-
|10.123
|%012f
|00010.123000
|}

======Модификатор точности======
Модификатор точности следует за модификатором минимальной ширины поля (если таковой имеется). Он состоит из точки и расположенного за ней целого числа. Значение этого модификатора зависит от типа данных, к которым его применяют.

Когда модификатор точности применяется к данным с плавающей точкой, для преобразования которых используются спецификаторы преобразования %f, %e или %E, то он определяет количество выводимых десятичных разрядов. Например, %10.4f означает, что ширина поля вывода будет не менее 10 символов, причем для десятичных разрядов будет отведено четыре позиции.

Если модификатор точности применяется к %g или %G, то он определяет количество значащих цифр.

Примененный к строкам, модификатор точности определяет максимальную длину поля. Например, %5.7s означает, что длина выводимой строки будет составлять минимум пять и максимум семь символов. Если строка окажется длиннее, чем максимальная длина поля, то конечные символы выводиться не будут.

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

Примеры:
{| class="wikitable"
!Значение
!Спецификатор формата
!Выводимое значение
|-
|10.123
|%f
|10.123000
|-
|10.123
|%.1f
|10.1
|-
|10.123
|%10.4f
|<пробел><пробел><пробел>10.1230
|-
|10.123
|%010.3f
|000010.123
|-
| Это простая проверка
|%10.15s
|Это простая про
|}

====Виджет «Условная метка» ====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условная метка".png|мини|Рисунок 27 – Список сопоставлений виджета "Условная метка"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условная_метка%22.png]]
Виджет «Условная метка» позволяет изменять выводимую строку в соответствии с изменениями привязанной к ней переменной.

Задать соответствие текста необходимому условию можно в свойстве «Список сопоставлений».

==== Виджет «Изображение»====
Виджет «Изображение» предназначен для отображения на окнах статичных изображений форматов png, gif, jpg, bmp или анимированных изображений в формате gif. Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Условное изображение»====
[[Файл:AgavaPLC–Список сопоставлений виджета "Условное изображение".png|мини|Рисунок 28 – Список сопоставлений виджета "Условное изображение"|ссылка=Файл:AgavaPLC–Список_сопоставлений_виджета_%22Условное_изображение%22.png]]
Виджет «Условное изображение» позволяет изменять отображаемое изображение в соответствии с изменениями привязанной к нему переменной.

Задать соответствие изображения необходимому условию можно в свойстве «Список сопоставлений».

====Виджет «Движущееся изображение»====
Виджет предназначен для отображения на окнах изображений, перемещающихся в пределах области виджета. В основном используются на экране спящего режима.

Отображаемая картинка выбирается в разделе «Оформление» - «Изображение». Она должна находиться в папке проекта.

====Виджет «Кнопка»====
Виджет «Кнопка» предназначен для реализации функций управления:

*ввод данных;
*передача управляющих воздействий;
* смена режима работы АРМ или иного устройства, исполняющего проект.

Выполнение всех функций виджета обеспечивается с помощью узлов типа «Действие», добавляемых в соответствующее свойство (см. раздел [[#Действия]]).

====Виджет «Гистограмма»====
[[Файл:AgavaPLC–Виджет "Гистограмма".png|мини|Рисунок 29 – Виджет "Гистограмма"|ссылка=Файл:AgavaPLC–Виджет_%22Гистограмма%22.png]]
Виджет предназначен для отображения значений сигналов в виде столбчатой диаграммы.

Виджету необходимо задать источник (регистр/сигнал, с которого он будет получать данные), а также минимальное и максимальное значения.

====Виджет «Исторический график»====
Виджет «Исторический график» предназначен для отображения графиков параметров на двухкоординатной области изображения с привязкой к осям времени и значений.

Виджет может работать с данными, архивируемыми в БД, и напрямую с сигналами, значения которых вычисляются в ходе работы.

При работе с архивируемыми данными интервал обновления графика зависит от режима выдачи значения у базы данных: при выборе сохраняемых в БД он будет соответствовать интервалу архивирования, а при сохраненных в БД - интервалу сохранения БД на диск. Независимо от режима выдачи, график не может обновляться меньше чем за 300 мс.

При работе напрямую с сигналами график обновляется при изменении значения сигнала, но также не чаще чем раз в 300 мс.
[[Файл:AgavaPLC–Экран «Архив» с виджетом «Исторический график».png|мини|Рисунок 30 – Виджет «Исторический график». Области кнопок-пиктограмм. В нижней части отображена легенда]]
Виджет «Исторический график» состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода данных.

На виджете имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 28):

#область пиктограмм графика;
#область пиктограмм оси времени (X);
#область пиктограмм оси значений (Y);
#область легенды.

В области пиктограмм графика слева направо расположены следующие кнопки-пиктограммы:

* кнопка переключения режима отображения точек на всех кривых;
* кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси времени (X) слева направо расположены следующие кнопки-пиктограммы:

*кнопка открытия окна выбора интервала времени для оси Х, текст кнопки отображает текущий выбранный интервал, например: 5М – 5 минут, 6Ч – 6 часов, 30М – 30 минут;
*кнопка-индикатор включения следящего режима.

В области пиктограмм оси значений (Y) расположена кнопка-пиктограмма «A» – кнопка переключения режима автоматического масштабирования значений.

=====Легенда=====
[[Файл:AgavaPLC–Легенда с четырьмя выключенными параметрами.png|мини|Рисунок 31 – Легенда с четырьмя выключенными параметрами]]
Легенда – специальная область в нижней части экрана архива, предназначенная для отображения параметров (наименование, текущее значение и т. д.) выводимых графиков в виде таблицы. Для ознакомления с примерным видом легенды см. Рисунок 31. Информация о каждом сигнале в легенде выводится в несколько колонок:

*«Цвет» – индицирует цвет, которым выводится соответствующая кривая на графике, колонка «Цвет» позволяет нажатием переключать видимость соответствующей кривой на графике (см. Рисунок 29). Также в колонке "Цвет" отображается номер пера, которым выводится кривая параметра на графике;
* «Имя» («Наименование») – содержит наименование параметра;
*«Время» – содержит время последнего зарегистрированного значения параметра;
*«Значение» – содержит последнее зарегистрированное значение параметра.

=====Режимы просмотра графиков=====
Пользователю доступно два режима просмотра графиков:

*следящий режим;
*режим просмотра истории.

В следящем режиме на графике всегда отображаются актуальные значения параметров, тренд периодически дочитывает поступившие данные из базы и обновляет графики.

В режиме просмотра истории на графике отображаются исторические значения параметров. Просмотр истории технологического процесса осуществляется с помощью кнопок перемещения по осям и кнопок изменения масштаба.

Режим просмотра истории включается автоматически при прокрутке графика назад по времени.

=====Визирная линия=====
[[Файл:AgavaPLC–График в режиме просмотра истории с установленной визирной линией.png|мини|Рисунок 32 – График в режиме просмотра истории с установленной визирной линией]]
Для просмотра значений параметров в нужный момент времени служит визирная линия, отображаемая на графике как вертикальная линия.

При щелчке левой кнопкой мыши (ЛКМ) в области графиков визирная линия будет отображена в выбранном месте графика.

В точке пересечения визирной линии и кривых параметров отображаются значения этих параметров. Также в нижней части области графиков, возле оси времени, визирная линия отображает время.

====Виджет «График кусочно-линейной функции»====
Виджет предназначен для отображения графика зависимости двух параметров, расположенном на осях X и Y.
[[Файл:AgavaPLC–Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм..png|мини|Рисунок 33 – Виджет «График кусочно-линейной функции». Области кнопок-пиктограмм.]]
Виджет состоит из нескольких областей:

*область осей Х, Y;
*область легенды, содержащей список кривых и их параметры (цвет кривой, наименование кривой, текущее значение, время последнего зарегистрированного значения);
*область вывода графика.

На области вывода графика виджета имеются несколько областей, содержащих кнопки-пиктограммы управления внешним видом графика (см. Рисунок 33):

#Область пиктограмм графика.
#Область пиктограмм оси первого параметра (X).
#Область пиктограмм оси второго параметра (Y).

В области пиктограмм графика расположены следующие кнопки-пиктограммы:

*кнопка переключения режима отображения точек на всех кривых;
*кнопка переключения видимости легенды;
*кнопка включения режима визирной линии.

В области пиктограмм оси первого (X) и второго (Y) параметров расположены кнопки-пиктограммы «А» – кнопка переключения режима автоматического масштабирования значений.[[Файл:AgavaPLC–Виджет "Список событий".png|мини|Рисунок 34 – Виджет "Список событий"|ссылка=Файл:AgavaPLC–Виджет_%22Список_событий%22.png]]
====Виджет «Список событий»====
[[Файл:AgavaPLC–Окно выбора интервала.png|мини|Рисунок 35 – Окно выбора интервала]]Виджет предназначен для отображения регистрируемых событий в работе.

В верхней части виджета расположена панель управления (1).

Панель управления содержит органы управления журналом:

*кнопка отображения фильтра событий;
*кнопка включения следящего режима журнала;
*кнопка изменения интервала на один день назад;
*кнопка-индикатор выбора интервала, за который отображаются события;
*кнопка изменения интервала на один день вперед;
*кнопка вызова окна со списком активных тревог.

Ниже панели управления, в основном поле экрана, расположена таблица, содержащая зарегистрированные события.

Заголовок таблицы позволяет изменять порядок столбцов и включать сортировку по столбцам. Например, возможно включение сортировки событий сначала по времени, затем по группе. Заголовок таблицы имеет возможность отключения / включения отображения любого столбца.

При большом количестве записей в правой части таблицы появляется полоса прокрутки, позволяющая пролистывать список событий.

Нажатие на кнопку-индикатор выбора интервала вызывает окно выбора интервала (см. Рисунок 35):[[Файл:AgavaPLC–Окно "Фильтр".png|мини|Рисунок 36 – Окно "Фильтр"|ссылка=Файл:AgavaPLC–Окно_%22Фильтр%22.png]]После выбора нужного интервала для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события за выбранный интервал.
Нажатие на кнопку отображения окна фильтра вызывает соответствующее окно. Окно фильтра позволяет изменить содержимое основного окна журнала событий путем выбора групп и подгрупп событий, перечисленных в окне фильтра (см. Рисунок 36).

После выбора нужных групп и подгрупп для сохранения выбора необходимо нажать кнопку «ОК». После сохранения будут отображены зарегистрированные события, принадлежащих выбранным группам.

====Виджет «Ввод значения»====
Виджет «Ввод значения» предназначен для отображения значения привязанного сигнала и его редактирования.
[[Файл:AgavaPLC–Виджет «Ввод значения» с отображением экранной цифровой клавиатуры.png|мини|Рисунок 37 – Виджет «Ввод значения» с отображением экранной цифровой клавиатуры|212x212пкс]]
После выбора узла для чтения/записи и соответствующего типа значения необходимо выбрать нужный тип ввода в разделе «Оформление».

Доступны следующие типы ввода:

*кнопки изменения – при нажатии на виджет появляются кнопки увеличения и уменьшения на заданный шаг изменения;
*кнопка редактирования – при нажатии на виджет появляется кнопка, при клике на которую открывается экранная цифровая клавиатура;

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

====Виджет «Выбор значения из списка»====
[[Файл:AgavaPLC–Виджет «Выбор значения из списка».png|мини|Рисунок 38 – Виджет «Выбор значения из списка»]]
Виджет «Выбор значения из списка» предназначен для отображения значения привязанного сигнала и его изменения в удобном для пользователя текстовом виде (см. Рисунок 37).

С помощью свойства «Список сопоставлений» задается соответствие между значением сигнала и выводимой в виджете строкой.

При нажатии на кнопку в правой части виджета отображается список всех сопоставлений. При выборе нужного элемента в списке в установленный узел производится запись нового значения.

====Виджет «Флаг»====
[[Файл:AgavaPLC–Варианты внешнего вида виджета «Флаг».png|мини|Рисунок 39 – Варианты внешнего вида виджета «Флаг»]]
Виджет «Флаг» предназначен для отображения значения и изменения булевой переменной (true/false). Состояние true отображается в виде галочки (см. Рисунок 38).

При нажатии на виджет значение переменной изменяется на противоположное.

В случае, если флаг необходимо использовать только для отображения информации, поставьте галочку в свойстве «Отключен»

====Виджет «Отчет»====
[[Файл:AgavaPLC–Виджет «Отчет» в режиме отображения сформированного отчета.png|мини|Рисунок 40 – Виджет «Отчет» в режиме отображения сформированного отчета]]
Виджет «Отчет» предназначен для формирования отчетов по заранее спроектированному макету.

Подробный порядок создания и редактирования отчетов приведен в разделе [[#Отчеты]].
[[Файл:AgavaPLC–Окно выбора интервала отчета.png|мини|Рисунок 41 – Окно выбора интервала отчета]]
В верхней части виджета размещена панель управления, содержащая кнопки вызова команд:

* печать сформированного отчета на установленном в системе принтере;
*сохранение сформированного отчета в файле формата PDF;
*переход к предыдущей странице отчета;
*переход к следующей странице отчета;
*масштабирование экрана по ширине листа отчета;
*масштабирование экрана по высоте листа отчета.

При формировании отчета для изменения интервала времени, за который будет формироваться отчет, необходимо на панели управления щелкнуть кнопку выбора интервала (на ней отображается текущий выбранный интервал, например, «Начало суток без смещения – Конец суток без смещения»). Далее появится окно «Интервал», в котором можно выбрать начало и конец интервала (см. Рисунок 41).

В качестве начала и конца интервала можно выбрать как конкретную дату по календарю, так относительную, например, «Начало дня», "Конец недели". После выбора желаемого интервала необходимо нажать кнопку «ОК».

Выбранный интервал отобразится на панели управления отчетом. Для формирования отчета за выбранный интервал необходимо нажать кнопку «Сформировать отчет». Через некоторое время, после загрузки данных из БД и их обработки, экран обновится и сформированный отчет за выбранный интервал будет отображен.

{{Шаблон:Действия AgavaSCADA/AgavaPLC}}

==Система тревог==
Система тревог предназначена для оповещения пользователя об обнаруженных нарушениях.

Система содержит два типа узлов:

*Группа событий.
*Контроллер событий.

===Группа событий===
Группа событий – узел, предназначенный для взаимодействия с виджетом «Список событий». Группы событий позволяют группировать события по какому-то признаку, например по уровню тревоги (авария, предупреждение, квитирование и т.д.), технологическому участку и т.д.

Для каждой группы можно выбрать свой цвет шрифта и фона, которые будут использоваться для вывода событий, принадлежащих этой группе в виджете "Список событий".

В свойстве «Описание» группы событий указывается текст, который будет отображаться в фильтре списка событий.

===Монитор событий===
Монитор событий (ранее - Контроллер событий) – узел, реализующий логику проверки соответствия выбранных сигналов контролируемым условиям. Контроллеры событий выполняют всю работу по проверке значений контролируемых параметров и выполнению соответствующих действий.

Монитор событий проверяет значения заданных узлов на соответствие заданным условиям и при их совпадении выполняет заданные действия.

В качестве действий можно указать не только действие "Создание события", но и другие (см. раздел [[#Действия]]).
[[Файл:AgavaPLC-Cистема тревог.png|мини|Cистема тревог]]

===Порядок настройки системы===
Порядок настройки системы тревог следующий:
#Добавить в проект систему тревог. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система тревог».
#Добавить узел «События» в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Группа» - «События». При необходимости настроить цвет шрифта и фона, которые будут отображаться у события в окне тревог или журнале.
#Добавить нужные [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.93.D1.80.D1.83.D0.BF.D0.BF.D0.B0 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|группы событий]] в узел «События». Для этого нажать ПКМ по узлу «События» в дереве проекта, затем выбрать «Добавить узел» - «Группа событий».
#Добавить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9A.D0.BE.D0.BD.D1.82.D1.80.D0.BE.D0.BB.D0.BB.D0.B5.D1.80 .D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9|контроллеры событий]] в систему тревог. Для этого нажать ПКМ по системе тревог в дереве проекта, затем выбрать «Добавить узел» - «Контроллер событий».
#Добавить в свойство «Сигналы» контроллеров событий узлы, состояние которых необходимо контролировать.
#Задать для этих узлов контролируемые условия в соответствующем свойстве контроллера событий.
#Настроить [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действия]], которые будут выполняться при выполнении контролируемого условия. Для вывода аварий, предупреждений или информационных сообщений необходимо добавить действие «Создание события».
# Настроить действие «Создание события». В его свойстве «Группа событий» указать группу из созданных в пункте 2. Ввести тексты сообщения активации и деактивации (при необходимости), указать уровень события. Теперь, при срабатывании контролируемого условия, будет появляться окно тревог с сообщением активации.

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

Архивация параметров производится с помощью архиваторов.
[[Файл:AgavaPLC-Настройка архиватора.png|мини|505x505пкс|Настройка архиватора]]

===Порядок настройки системы===
Для сохранения истории изменения значений параметров в БД необходимо выполнить следующие действия:

#Добавить в проект систему архивации. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система архивации».
#Добавить в систему архивации архиватор. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем выбрать «Добавить узел» - «Архиватор в БД SQLite».
#Настроить параметры архиватора, такие как: путь до файла БД, интервал архивирования (как часто система архивации будет опрашивать значение параметра), интервал сохранения БД на диск (как часто эти значения будут записываться в постоянную память), разбиение БД (будет ли система архивации создавать новый файл БД каждые сутки), период хранения и режим выдачи значений для построения графика (сохраняемые значения будут обновляться с частотой интервала архивирования, а сохраненные - с частотой интервала сохранения).
#Добавить параметры в коннекторы база данных. Для этого необходимо открыть свойство архиватора «Коннекторы БД», выбрать «Создать новый» - «Коннектор БД». После этого нужно нажать по добавленному коннектору, открыть его свойство «Сигналы» и добавить параметр, значение которого необходимо сохранять в БД.

=== Архиватор SQLite===
Архиватор SQLite предназначен для сохранения значений параметров в БД формата SQLite.

Для извлечения и просмотра баз данных формата SQLite с устройств может использоваться программа «[[Архиватор]]».

====Свойства узла "Архиватор SQLite"====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
| Путь до файла БД
|FilePath
|STRING
|Чтение / запись
|Путь до файла БД. Абсолютный или относительный.
|-
|Интервал архивирования
|Interval
|INT
|Чтение / запись
|Интервал архивирования, мс.
|-
|Период хранения
|Retention
|INT
|Чтение / запись
|Период хранения, дней.
|-
|Разбиение БД
|DBSplitting
|BOOL
|Чтение / запись
|Разбиение БД на файлы. При включении база данных будет разделяться на отдельныйе файлы, содержащие данные за одни сутки.
|-
|Интервал сохранения БД на диск
|StoringInterval
|INT
|Чтение / запись
|Интервал сохранения БД на диск, мс.
|-
|Режим выдачи значений
|ValueReturnMode
|ENUM
|Чтение / запись
|Режим выдачи значений. Режим "Сохраняемые в БД" - данные выдаются сразу после получения архиватором, возможно до фактического сохранения в БД. Режим "Сохраненные в БД" - данные выдаются только после фактической записи в БД на диск.
|-
|Коннекторы БД
|Signals
|NODESARRAY
|Чтение / запись
|Список коннекторов, содержащих сигналы для архивирования.
|-
|Текущий размер БД
|DBCurrentSize
|INT
|Только чтение
|Текущий размер БД, Мб.
|-
|Максимальный размер БД
|DBMaxSize
|INT
|Только чтение
|Максимальный размер БД, Мб.
|-
|Состояние БД
|DBStatus
|INT
|Только чтение
|Состояние БД.
|}

=== Архиватор PostgreSQL ===
Архиватор PostgreSQL предназначен для сохранения значений параметров в базы данных под управлением сервера PostgreSQL.

=== Прореживание данных ===
Прореживание данных (data thinning) — это процесс фильтрации и уменьшения количества точек данных, сохраняемых в архиве. Вместо того чтобы записывать каждое полученное значение, система анализирует поток данных и сохраняет только те значения, которые представляют значимое изменение.

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

* '''Снижение нагрузки на архив''': Меньшее количество записей означает более быструю работу базы данных.
* '''Ускорение отображения графиков''': Нужно обрабатывать меньше точек для построения трендов.
* '''Сохранение только значимых изменений''': Система отфильтровывает шум и оставляет только те изменения, которые важны для анализа технологического процесса.

==== Общий принцип работы ====
Алгоритм прореживания работает по простому принципу:

# SCADA-система получает новое значение от источника данных.
# Она сравнивает это значение с последним, которое было сохранено в архив.
# Если изменение превышает заранее настроенный '''допуск''' (tolerance), новое значение сохраняется.
# Если изменение меньше допуска, значение пропускается.

Кроме того, существует параметр "'''Период обязательной записи"'''. Если с момента последней записи прошло больше времени, чем указано в этом параметре, новое значение будет сохранено '''независимо от его изменения'''. Это гарантирует, что записи в архив будут сохраняться не реже заданной периодичности, даже если сигнал не меняется. Ключевая идея: "'''Сохраняем только то, что заметно изменилось, но не реже, чем задано".'''

'''Как подобрать допуск?'''

* '''Слишком малый допуск''' приведёт к записи избыточных данных, и архив будет быстро расти.
* '''Слишком большой допуск''' может привести к потере мелких, но значимых изменений в сигнале.

Выбор правильного допуска — это компромисс между детализацией данных и размером архива.
----

==== Типы алгоритмов прореживания ====
В системе доступны несколько алгоритмов, которые определяют, как именно вычисляется «значимость» изменения. Выбор алгоритма зависит от характера сигнала и требований к точности данных.

# Абсолютный допуск
# Процент от последнего значения
# Процент от среднего N последних
# Процент от среднего по временному окну

'''Обозначения и определения'''

В дальнейшем используются следующие обозначения (для числовых сигналов):

* <math>x_{in}</math> — текущее измерение сигнала, полученное от источника данных к моменту обработки (кандидат на запись).
* <math>x_{ref}</math> — последнее сохранённое числовое значение сигнала в архиве на момент обработки (опорное значение).
* <math>|\Delta| = |x_{in} - x_{ref}|</math> — абсолютная величина изменения между текущим измерением и последним сохранённым значением.
* <math>\bar{x}_N</math> — арифметическое среднее последних <math>N</math> сохранённых числовых значений.
* <math>\bar{x}_T</math> — среднее всех сохранённых числовых значений, чьи метки времени попадают в временное окно длительности <math>T</math> миллисекунд.
* <math>\varepsilon</math> — машинная точность для чисел двойной точности; используется для формальной проверки «близости к нулю».
* <math>tolerance</math> — допуск: абсолютный (в физических единицах) или относительный (в процентах), в зависимости от выбранного алгоритма.

'''Настройки в Свойствах архиватора, общие для всех типов прореживания'''

* '''Включить прореживание''' — включает/выключает применение алгоритма прореживания при записи значений. При выключении все поступающие значения сохраняются без фильтрации.
* '''Тип допуска''' — выбирает алгоритм сравнения.
* '''Период обязательной записи (мс)''' — максимальный допустимый промежуток между двумя записями одного сигнала. Если за это время значимого изменения не произошло, ближайшее поступившее значение будет записано принудительно. 0 — отключить принудительную запись.

----

==== Абсолютный допуск ====
'''Принцип:'''

Новое значение сохраняется, если модуль изменения больше установленного порога в физических единицах.

<math display="block">|\Delta| > tolerance</math>

'''Когда использовать:'''

* Если диапазон сигнала стабилен и известен заранее.
* Для параметров вроде температуры, давления, уровня жидкости, где фиксированное изменение имеет одинаковую интерпретацию по всей шкале.

'''Преимущества:'''

* Обеспечивает предсказуемое и детерминированное поведение независимо от текущего масштаба значения.
* Не требует накопления или хранения дополнительных данных (окон/истории), вычислительно прост.
* Удобен при наличии нормативно заданных пределов точности в физических единицах.

'''Ограничения:'''

* Не масштабируется на широкий динамический диапазон: один и тот же порог может быть слишком грубым для малых значений и слишком чувствительным для больших.
* Требует аккуратного подбора порога под единицы измерения и разрешение датчика; при неверной калибровке возможны либо избыточные записи, либо потеря значимых мелких изменений.
* Не учитывает относительный контекст изменения (например, 1 единица при значении 10 и при значении 10 000 трактуется одинаково).

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — абсолютный порог в физических единицах сигнала. Определяет значение <math>tolerance</math>.

----

==== Процент от последнего значения ====
'''Принцип:'''

Новое значение сохраняется, если относительное изменение относительно последнего сохранённого превышает заданный процент.

<math display="block">\frac{|\Delta|}{|x_{ref}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов, где важна относительная динамика, а не абсолютные величины.
* Для показателей с большим динамическим диапазоном, где относительная точность должна быть сопоставима на всех уровнях.

'''Преимущества:'''

* Масштабируемость: одинаково интерпретирует относительные изменения на низких и высоких уровнях сигнала.
* Не требует хранения окна значений; использует только последнее сохранённое значение, поэтому вычислительно лёгок.
* Быстро и корректно реагирует на пропорциональные изменения процесса (проценты), поддерживая заданную относительную чувствительность.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).
* При малых базовых значениях возможна повышенная чувствительность к шуму и микроколебаниям.
* Не подавляет высокочастотный шум сам по себе: при необходимости сочетать с обязательной записью по времени и корректной настройкой допуска.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

----

==== Процент от среднего N последних ====
'''Принцип:'''

Новое значение сохраняется, если изменение больше заданного процента от среднего по последним N сохранённым значениям.

<math display="block">\frac{|\Delta|}{|\bar{x}_{N}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с постоянным шумом или пульсациями, когда важно снижать чувствительность к случайным отклонениям.
* Для процессов с умеренной динамикой, где требуется устойчивость к «зубчатым» колебаниям.

'''Преимущества:'''

* Снижает чувствительность к высокочастотному шуму за счёт опоры на усреднение; сокращает объём записей на стационарных участках.
* Гибко настраивается параметром <math>N</math>: увеличение окна повышает устойчивость, уменьшение — повышает чувствительность и снижает задержку реакции.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).

* Инерционность: при резких скачках возможна задержка фиксации изменения, особенно при большом <math>N</math>.
* Усреднение может «сглаживать» и не фиксировать кратковременные, но важные пики; не подходит для задач, критичных к коротким экстремумам.
* Предполагает относительно стабильную частоту выборок; при сильно переменной частоте эффективная «временная» ширина окна становится непредсказуемой.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Размер окна среднего (<math>N</math>)''' — число последних сохранённых значений, по которым считается среднее. Большее <math>N</math> повышает устойчивость к шуму, но увеличивает инерционность реакции.

----

==== Процент от среднего по временному окну ====
'''Принцип:'''

Похож на предыдущий, но среднее считается не по количеству точек, а по всем значениям за заданный интервал времени.

<math display="block">\frac{|\Delta|}{|\bar{x}_{T}|} \times{100} > tolerance</math>

'''Когда использовать:'''

* Для сигналов с непостоянной частотой измерений (событийные, неравномерные потоки).
* В случаях, когда важно учитывать реальную временную протяжённость усреднения независимо от плотности измерений.

'''Преимущества:'''

* Корректно работает при переменной частоте выборок: окно фиксируется по времени, а не по числу точек.
* Более реалистично оценивает тренд во времени на участках с неравномерными измерениями.
* Управляемый компромисс между подавлением шума и чувствительностью за счёт выбора длительности окна.

'''Ограничения:'''

* В окрестности нуля относительная метрика становится нестабильной (см. примечание).

* Более высокая ресурсоёмкость: требуется хранить и периодически «очищать» значения по условию выхода из временного окна; потребление памяти зависит от фактической скорости поступления данных.
* Инерционность, присущая усреднению: возможна задержка фиксации коротких, но значимых пиковых изменений.
* Критичен выбор длительности окна: слишком малое окно даёт мало подавления шума, слишком большое — чрезмерную инерцию и риск пропуска кратких событий.

'''Настройки в Свойствах архиватора:'''

* '''Допуск''' — относительный порог в процентах. Определяет значение <math>tolerance</math>.

* '''Интервал архивирования''' — длительность временного окна <math>T</math> (мс), в пределах которого вычисляется среднее. При увеличении <math>T</math> растёт сглаживание и уменьшается чувствительность к кратким всплескам; при уменьшении — наоборот. Значения, чьи метки времени выходят за пределы окна, автоматически исключаются из расчёта.

==== Примечание к алгоритмам 'Процент от…' ====
При малых опорных значениях система автоматически переходит в абсолютный режим, чтобы избежать деления на величину, близкую к нулю, и связанных с этим скачков чувствительности. Этот механизм применяется ко всем алгоритмам, использующим относительное сравнение: «Процент от последнего», «Процент от среднего N», «Процент от среднего по временному окну» и обеспечивает стабильность критерия при слабых сигналах.

* Условия входа в режим абсолютного допуска:
** для «Процента от последнего»: <math>|x_{ref}| < \varepsilon</math>;
** для «Процента от среднего N»: <math>|\bar{x}_{N}| < \varepsilon</math>;
** для «Процента от среднего по времени»: <math>|\bar{x}_{T}| < \varepsilon</math>.
* Критерий в режиме абсолютного допуска: значение фиксируется, если <math>|\Delta| > tolerance</math>.
* Условие выхода: как только соответствующая базовая величина (<math>|x_{ref}|</math>, <math>|\bar{x}_{N}|</math> или <math>|\bar{x}_{T}|</math>) становится <math>\geq \varepsilon</math>, система автоматически возвращается к относительному критерию.
* Трактовка <math>tolerance</math>: используется то же значение настройки; в абсолютном режиме оно интерпретируется как порог в физических единицах сигнала.

=== Сравнение алгоритмов прореживания данных ===
{| class="wikitable"
!Критерий
!Абсолютный
!% от последнего
!% от среднего N
!% от среднего по времени
|-
|Единицы допуска
|Физические
|Проценты
|Проценты
|Проценты
|-
|Устойчивость к шуму
|Низкая
|Средняя
|Высокая
|Высокая
|-
|Реакция на резкие скачки
|Быстрая
|Быстрая
|Задержка (при большом N)
|Задержка
|-
|Подходит при переменной частоте
|Да
|Да
|Нет
|Да
|}

==Система журналирования==
Система ведения журналов событий предназначена для управления регистрацией и хранением событий. В базу данных записываются все системные события и события, генерируемые с помощью [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.A1.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D0.B0 .D1.82.D1.80.D0.B5.D0.B2.D0.BE.D0.B3|системы тревог]], которые соответствуют выбранному уровню сообщений.

Для ведения журналов используются узлы типа "Логгер".

===Порядок настройки системы===
Порядок настройки системы журналирования следующий:

#Добавить и [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.9F.D0.BE.D1.80.D1.8F.D0.B4.D0.BE.D0.BA .D0.BD.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8 .D1.81.D0.B8.D1.81.D1.82.D0.B5.D0.BC.D1.8B|настроить систему тревог]] для генерации событий.
#Добавить в проект систему журналирования. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система журналирования».
#Добавить в систему журналирования логгер. Для этого нажать ПКМ по узлу «Система архивации» в дереве проекта, затем нажать «Добавить узел» и выбрать нужный логгер.
#Настроить параметры логгера (см. разделы ниже).

=== Логгер SQLite===
Логгер SQLite предназначен для сохранения событий, возникающих в ходе исполнения прикладной программы в СУБД SQLite.

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

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

===Логгер файловый ===
Логгер файловый предназначен для сохранения журналов событий в текстовых файлах на накопителе. Логгер имеет минимальное количество настроек, и обычно используется для сохранения журнала событий в случае необходимости отладки работы прикладной программы без среды разработки.

===Логгер SMS===
Логгер SMS предназначен для SMS информирования с помощью субмодуля GRPS или внешнего GPRS модема.

Принцип работы логгера следующий:

#Логгер принимает возникающие события, фильтрует их согласно установленного уровня событий и выбранных групп.
#События, прошедшие фильтрацию, форматируются согласно установленного шаблона.
#Отформатированные сообщения отправляются через подключенный модем в виде SMS сообщения. Отправка сообщений производится на телефонные номера, записанные в телефонной книге на SIM-карте.

==Система проверки прав пользователей==
[[Файл:AgavaPLC-Окно привилегий.png|мини|494x494пкс|Окно привилегий]]
Система реализует механизм контроля доступа к узлам проекта и их функциях на основе ролей. Узлы при выполнении действий проверяют наличие установленных привилегий у авторизованного в данный момент пользователя.

=== Роли и пользователи ===
Система содержит в себе две подсистемы:
*Пользователи. Подсистема определяет пользователей, каждому из которых назначается логин/пароль и одна или несколько ролей.
*Роли. Роли хранят наборы доступных привилегий.
Отношения между пользователями, ролями и привилегиями можно описать следующим образом:

* Один пользователь может иметь несколько ролей.
* Одну роль могут иметь несколько пользователей.
* Одна роль может иметь несколько привилегий.
* Одна привилегия может принадлежать нескольким ролям.

=== Привилегии ===
[[Файл:AgavaPLC-Система проверки прав пользователей.png|мини|Система проверки прав пользователей]]
Для узлов системы доступна установка следующих привилегий:

Все узлы:

*Чтение значения.
*Запись значения.
Окна и фреймы:
*Открытие окна.
*Закрытие окна.

При установке привилегий на какой-либо узел, все подчиненные узлы получают те же привилегии с флагом "унаследована".

Если привилегия не установлена, то считается что действие, регулируемое привилегией, запрещено.

Значение унаследованных привилегий можно переопределить с помощью явного задания привилегии.
===Порядок настройки системы===
Привилегии настраиваются в отдельном окне привилегий, доступном в меню "Вид".

Порядок настройки системы проверки прав в версии AgavaSCADA 1.2 следующий:

#Добавить в проект систему проверки прав пользователей. Для этого нажать ПКМ по узлу «Станция» в дереве проекта, затем выбрать «Добавить узел» - «Система» - «Система проверки прав пользователей».
#Добавить в систему проверки прав пользователей узел «Роль». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Роли».
#Добавить в узел «Роли» необходимые роли. Для этого нажать ПКМ по узлу «Роли» в дереве проекта, затем выбрать «Добавить узел» - «Роль».
#Для каждой роли настроить привилегии в окне привилегий. Для этого необходимо нажать «Вид» - «Открыть привилегии». В открывшемся окне в выпадающем списке «Пользователь / роль» выбрать нужную роль. Затем, нажимая ПКМ по узлам и выбирая «Добавить привилегию» настроить все необходимые ограничения для данной роли.
#Добавить в систему проверки прав пользователей узел «Пользователи». Для этого нажать ПКМ по узлу «Система проверки прав пользователей» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Добавить в узел «Пользователи» необходимых пользователей. Для этого нажать ПКМ по узлу «Пользователи» в дереве проекта, затем выбрать «Добавить узел» - «Пользователи».
#Для каждого пользователя указать имя и пароль, которые будут использоваться при авторизации, и выбрать одну или несколько ролей.

== Сигналы, источники и операции ==
Регистры и другие узлы, добавленные в группу «Сигналы», являются внутренними для проекта и могут менять свои значения только с помощь скриптов или других узлов, с которыми они связаны.

Сигналы содержат в себе несколько подгрупп.

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

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

Первичное значение поступает на вход операции, производится вычисление. Если есть еще операции, то вычисленное значение после первой операции передается на вход второй. И так далее по всем операциям. Если операций больше нет, вычисленное значение устанавливается в качестве значения узла.

Все операции выполняются в порядке, в котором они заданы в соответствующих свойствах.

====Сигнал простой====
Узел типа "Сигнал простой" предназначен для хранения и обработки значения источника, или другого сигнала или операции. Позволяет произвести какие-либо действия с этим значением с помощью добавления нужных операций в свойство «Операции после чтения».

====Постоянная ====
Узел типа "Постоянная" предназначен для хранения данных выбранного формата и позволяет изменять их в ходе выполнения программы. Связывание с источником не предусмотрено. Изменение осуществляется с помощью специализированных функций или блока установки значения в задаче ПЛК.

====Массив====
Массив - совокупность каких-либо объектов, указанных в свойстве «Входные значения». Нумерация объектов в массиве начинается с 0. Может использоваться для взаимодействия с демультиплексором.

====Сигнал комплексный====
Сигнал используется для взаимодействия с виджетом «Цифровой индикатор». Позволяет контролировать входное значение и генерировать события переходу входного значения через уставки.

Содержит в себе свойства для настройки следующих параметров:

*ВАУ – верхняя аварийная уставка;
*ВПУ - верхняя предаварийная уставка;
*НПУ - нижняя предаварийная уставка;
*НАУ – нижняя аварийная уставка;
*ФНЧ – фильтр низких частот.

===Источник===
Источник - специальный тип узлов, предназначенных для передачи данных от внешних устройств.

====Регистр Modbus====
Регистр Modbus используется для приема и передачи данных по протоколам Modbus-RTU, Modbus-TCP. Данный тип узов также может использоваться для организации работы некоторых алгоритмов программы (например для взаимодействия с контроллером событий).

====Источник индексный====
Узел типа "Источник индексный" используется для обработки данных, полученных по протоколу Upd, а так же в массивах для индексации значений.

===Операция===
[[Файл:AgavaPLC-Входные значения операций.png|мини|Входные значения операций]]
Узлы типа "Операция" используются для реализации вычислительных алгоритмов в задаче ПЛК или отдельно, при их размещении в группе "Сигналы".

В качестве входных значений операций выбираются константные числа, другие узлы группы «Сигналы», регистры или блоки задачи ПЛК.

====Операция «Сложение»====
Выходным значением является сумма входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Вычитание»====
Выходным значением является разность первого входного значения и суммы всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Умножение»====
Выходным значением является произведение значений всех входных значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Деление»====
Выходным значением является результат от деления первого входного значения на произведение всех последующих значений. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Условие»====
Узел типа "Операция условие" предназначен для сравнения значений двух узлов. Для условия задаются сравниваемые параметры и выбирается режим сравнения. В качестве входных значений можно выбирать как узлы, так и конкретные числа формата int или double.

====Операция «Пара условий»====
[[Файл:AgavaPLC-Операция «Пара условий».png|мини|Операция «Пара условий»]]
Операция содержит в себе два условия. Для каждого условия задаются индивидуальные сравнимаемые параметры и выбирается режим сравнения.

Выходное значение операции зависит от ее режима проверки – при выбранном режиме «Логическое ИЛИ» выходное значение равно логической «1» если одно из условий равно «1», при «Логическом И»- если оба условия равны «1».

====Операция «Логическое ИЛИ»====
Если одно из входных значений становится равно логической «1» (контакты замкнуты), то выходное значение становится логической «1» (выход включен).

====Операция «Логическое И»====
Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

====Операция «Логическое НЕ»====
Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

====Операция «Таймер»====
Таймер предназначен для выполнения каких-либо [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D1.8F|действий]] через одинаковые промежутки времени (например запись значения в узел). Промежуток между исполнениями действий задается в свойстве «Интервал срабатывания», а сами действия в свойстве «Действия OnTimer». Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

====Операция «Мультиплексор»====
Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...».

Например если в качестве входных значений указаны два регистра, то выходное значение мультиплексора будет формироваться следующим образом:
{| class="wikitable"
!Значение регистра 1
!Значение регистра 2
!Выходное значение
|-
|0
|0
|0
|-
|1
|0
|1
|-
|0
|1
|2
|-
|1
|1
|3
|}

====Операция «Демультиплексор»====
Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

====Операция «Генератор случайного числа»====
Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями. Для работы операции ее необходимо добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения.

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

Для выполнения скрипта, можно добавить в свойство «Узлы» [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.97.D0.B0.D0.B4.D0.B0.D1.87.D0.B8|задачи]] с периодическим или разовым режимом выполнения. Другим способом вызова срабатывания скрипта является добавление его в [[Узлы проекта AgavaSCADA/AgavaPLC#.D0.94.D0.B5.D0.B9.D1.81.D1.82.D0.B2.D0.B8.D0.B5 .C2.AB.D0.92.D1.8B.D0.BF.D0.BE.D0.BB.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5 .D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0.C2.BB|действие «Выполнение скрипта»]].

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

*void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

===Объект===
Узлы типа "Объект" предназначены для взаимодействия с аппаратными компонентами контроллера. Для всех объектов, являющихся субмодулями, необходимо указать слот, в котором они установлены. Доступ к значениям входов/выходов субмодуля осуществляется через его вложенные узлы.

'''ПЛК процессорный модуль'''

Предоставляет возможность регулирования подсветки экрана; включения и отключения индикаторов работы, аварии и программы.

'''ПЛК субмодуль DI'''

Позволяет получать доступ к значениям входов субмодуля DI.

'''ПЛК субмодуль R'''

Позволяет управлять значениями выходов субмодуля R.

'''ПЛК субмодуль SIM'''

Позволяет управлять значениями выходов субмодуля SIM.

'''ПЛК субмодуль DO6'''

Позволяет управлять значениями выходов субмодуля DO6.

'''ПЛК субмодуль AI'''

Позволяет получать доступ к значениям входов субмодуля AI и задавать их тип.

'''ПЛК субмодуль AIO'''

Позволяет получать доступ к значениям входов субмодуля AIO, управлять значениями выходов и задавать тип входов и выходов.

'''ПЛК субмодуль TMP'''

Позволяет получать доступ к значениям входов субмодуля TMP и задавать их тип.

==Задачи==
Группа «Задачи» предназначена для группировки узлов типа «Задача», которые используются для циклического или разового выполнения созданных пользователем алгоритмов.

===Задача ПЛК===
Данный узел предоставляет возможности для связывания между собой других узлов (таких как сигналы, субмодули ПЛК, постоянные и т. д.) в удобной графической форме (см. Рисунок 64). Для перехода к редактору необходимо щелкнуть правой кнопкой мыши на задачу ПЛК и выбрать в открывшемся контекстном меню команду «Открыть графическое представление» или дважды щелкнуть левой кнопкой мыши на задаче ПЛК в дереве проекта.

Рисунок 64 – Окно графического редактирования задачи «ПЛК-60»

Панель инструментов задачи ПЛК, расположенная в верхней части окна, содержит следующие элементы (см. Рисунок 16):

*Выпадающий список выбора режима подписи портов.
*Выпадающий список выбора режима подписи блоков.
*Кнопка запуска режима симулятора.
*Кнопка запуска онлайн отладки.
*Кнопка печати задачи.
*Инструменты управления симуляцией.

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

Созданную связь можно удалить, выделив ее левой кнопкой мыши и нажав клавишу "Del". Связь можно "разорвать", то есть добавить разрыв, нажав по ней правой кнопкой мыши и выбрав в контекстном меню команду «Добавить разрыв».

Для выделения нескольких блоков рамкой зажмите клавишу "Shift" и выделяйте блоки мышью с нажатой левой кнопкой.

Задача ПЛК предоставляет возможности для проведения тестирования и отладки проекта, описанные в разделе [[#Проверка и отладка проекта]].

====Блоки задачи ПЛК====
Помимо операций, описанных в разделе [[#Операция]], для реализации алгоритмов в задачу ПЛК можно добавлять блоки, описанные ниже.

'''Функциональный блок'''

Используется для выделения каких-либо действий в отдельный блок, для упрощения понимания работы алгоритма программы. Содержит входы, выходы и блоки, обеспечивающие работу внутренней логики. Позволяет проводить изолированную отладку, при которой значения на входах функционального блока вручную задаются пользователем. Блок, работающий в данном режиме выделяется черной рамкой. Для включения изолированной отладки необходимо открыть блок и нажать кнопку «Изолированная отладка» на панели управления задачей.

'''Блок установки значения'''

Блок осуществляет запись значения, поданного на вход in0, в узел, указанный в свойстве «Узел для чтения/записи»

'''Блок задержки'''

Блок задержки используется для создания задержки передачи значения с входа блока на выход на один цикл обработки задачи.

'''Блок «Битовое OR»'''

Для вычисления значения будет произведена операция "ИЛИ" над каждым битом значения в отдельности. Например: 1010 OR 0110 = 1110

'''Блок «Логическое И»'''

Если все входные значения становятся равны логической «1», выходное значение становится логической «1» (выход включен).

'''Блок «Битовое AND»'''

Для вычисления значения будет произведена операция "И" над каждым битом значения в отдельности. Если все биты, стоящие на одинаковых позициях в двоичных представлениях значений, поступающих на входы блока, равны логической «1», то на выходе элемента в этой позиции появляется логическая «1» (выход включен). Например: 1010 AND 0110 = 0010

'''Блок «Логическое НЕ»'''

Если входное значение блока становится равно логическому «0», то выходное значение становится логической «1», и наоборот.

'''Блок «Битовое XOR»'''

Если только на один из входов блока функции поступает логическая «1», то на выходе элемента появляется логическая «1». Если на входы блока функции поступают целочисленные значения, то операция будет произведена над каждым битом значения в отдельности. Например: 1010 XOR 0110 = 1100

'''Блок «Битовое SHR»'''

Побитовый логический сдвиг вправо используется для выполнения операции побитового логического сдвига операнда X вправо на N бит с дополнением нулями слева.

'''Блок «Битовое SHL»'''

Побитовый логический сдвиг влево используется для выполнения операции побитового логического сдвига операнда X влево на N бит с дополнением нулями справа.

'''Блок «Таймер»'''

Таймер предназначен для выполнения каких-либо действий (см. раздел 4.6) через одинаковые промежутки времени (например запись значения в узел).

'''Блок «Мультиплексор»'''

Мультплексор осуществляет перевод нескольких булевых переменных в целочисленное значение по формуле: «выход = вход1 + вход2*2^1 + вход3*2^2 + ...»

'''Блок «Демультиплексор»'''

Демультиплексор осуществляет перевод целочисленных значений из массива в несколько булевых переменных, при этом включается выход, номер которого соответствует числу из массива (например первый элемент массива равен 5, на пятом выходе появится значение true). Нумерация выходов начинается с нуля.

'''Блок «Генератор случайного числа»'''

Выходным значением является случайное число в диапазоне между указанным минимальным и максимальным значениями.

'''Блок «Скрипт С++»'''

Операция «Скрипт С++» предназначена для реализации разнообразных алгоритмов на языке С++. Операция предусматривает реализацию одной или нескольких функций, выполняющих необходимые пользователю действия. Для выполнения скрипта, необходимо добавить его в качестве узла для задачи или задачи ПЛК.

Пример скрипта, выполняющего получение значения определенного узла и запись измененного значения в другой узел:
float val()
{
float f = GetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Random2");
float f1 = f*100.0;
SetNodeValueAsFloat("/Конфигурация1/stationSimple1/Signals1/Constant3", f1);
return f*10.0;
}
Приведенный выше скрипт возвращает исходное значение, умноженное на 10. Возвращаемое таким образом значение записывается в выход операции для возможности считывания в других операциях, скриптах и т. д.

Скрипты могут возвращать значения следующих типов:

* void;
*float;
*double;
*int.

Подробное описание реализации языка С++ в AgavaSCADA/AgavaPLC приведено на странице "[[Описание языка С++ в AgavaPLC]]".

'''Блок «Таймер с задержкой»'''

Таймер с задержкой используется для операции задержки передачи и/или отключения сигнала. На выходе таймера появится сигнал логической «1» с задержкой относительно фронта входного сигнала продолжительностью равной интервалу включения и выключится по спаду входного сигнала с задержкой продолжительностью равной интервалу выключения. В том случае, если необходимо использовать блок только как таймер с задержкой включения (отключения) интервал выключения (включения) устанавливается равным 0.

'''Блок «Генератор прямоугольных импульсов»'''

Генератор прямоугольных импульсов используется для формирования прямоугольных импульсов пульсации. На выходе генератора формируются импульсы с заданными параметрами длительности включенного и отключенного импульса на время действия управляющего сигнала на входе (сигнал логической «1»).

'''Блок «Триггер RS»'''

RS-триггер с приоритетом выключения используется для переключения с фиксацией состояния во время поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Триггер SR»'''

SR-триггер с приоритетом включения используется для переключения с фиксацией состояния в случае поступления коротких импульсов на соответствующий вход. На выходе появится логическая «1» по фронту сигнала на входе Set, которая будет сброшена в «0», при поступлении импульса на вход Reset.

'''Блок «Детектор переднего фронта импульса»'''

Детектор переднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «0» в «1».

'''Блок «Детектор заднего фронта импульса»'''

Детектор заднего фронта импульса используется в случае необходимости иметь реакцию на изменение состояния дискретного входного сигнала. На выходе генерируется единичный импульс при изменении состояния входа из «1» в «0».

'''Блок «D-триггер»'''

D-триггер используется для формирования импульса включения выхода на интервал времени импульса на входе D, выходной интервал будет синхронизирован с тактовой частотой на входе С. На выходе Q триггера появится сигнал логической «1» по фронту тактовых импульсов на входе С при наличии сигнала логической «1» на входе D. Возврат выхода в сигнал логического «0» произойдет по фронту тактовых импульсов на входе С при наличии сигнала логического «0» на входе D. Вход Set принудительно устанавливает выход в состояние логической «1». Вход Reset является приоритетным и устанавливает выход в состояние логического «0».

'''Блок «Селектор»'''

Если на вход Value подается логическая «1», то результатом выполнения операции блока на выходе является входной сигнал ValueT. Если же Value равен логической «0», то результатом выполнения операции блока на выходе является входной сигнал ValueF.

'''Блок «Больше чем»'''

На выход подается логическая «1», если значение in0 больше чем значение in1.

'''Блок «Равенство»'''

На выход подается логическая «1», если значение in0 равно значению in1.

'''Блок «Абсолютное значение числа»'''

Результатом операции функции на выходе является модуль подаваемого на вход значения. Если число на входе положительное, то на выход подается само число, если отрицательное – положительное число, получаемое от перемены его знака с «-» на «+».

'''Блок «Возведение в степень»'''

Результатом операции функции на выходе является значение, равное значению in0, возведенному в степень значения N.

'''Блок «PID-регулятор»'''

Регулятор PID применяется для поддержания заданного значения параметра. На вход Pv подается текущее значение регулируемой величины, на Sp – ее заданное значение. С помощью изменения коэффициентов ПИД регулятора kP, kI и kD достигается оптимальный режим работы. Min задает минимальное значение на выходе, Max – максимальное. time - период регулятора (в мс.).

'''Блок «PWM-регулятор»'''

Применяется для преобразования аналогового сигнала в дискретный с помощью ШИМ. На вход in подается текущее значение регулируемой величины, Min задает минимальное значение на входе, Max – максимальное. time - период регулятора (в мс.)

==Устройства==
Группа «Устройства» предназначена для группировки узлов типа "Устройство", выполняющие разнообразные задачи, например работа с внешними накопителями и ПЗУ.

Retain-накопитель дает возможность хранить значения регистров, постоянных и сигналов в постоянной памяти контроллера, что позволяет им сохранять свои значения после отключения питания.

Для сохранения переменных необходимо перечислить их в свойстве «Узлы» и указать путь сохранения на выбранном накопителе.

== Отчеты==
{{Внимание|Тип=Восклицание желтый.png|Текст=Данный узел доступен только при исполнении проекта на настольном компьютере. На панелях оператора и контроллерах МПР этот узел не доступен.}}
Отчет – технологический документ, содержащий информацию о ходе производственного процесса, обработанную по заложенным в отчет алгоритмам. Отчеты формируются на основе макетов (статической части отчетов) путем добавления в них свойств и значений заданных параметров технологического процесса, которые формируются (выбираются из базы данных технологических параметров и проходят соответствующую обработку) по алгоритмам, размещенным в этих шаблонах.

Данные для отчета предоставляет выборка, осуществляющая получение данных и их обработку из базы данных.

===Создание нового отчета===
Создание любого отчета производится в два этапа.

#Создание необходимых узлов в конфигурации: сам отчет и необходимое количество выборок.
#Составление макета отчета.

Создание узла типа «Отчет» в конфигурации и выборок для него производится аналогично созданию узлов других типов. К станции добавляется узел типа «Отчеты» с помощью команды контекстного меню «Добавить узел», далее к узлу типа «Отчеты» добавляется отчет и к отчету добавляется необходимое количество выборок.

Выборка – специальный узел, предназначенный для выборки данных из архива и их обработки для последующего отображения в отчете.

Перед переходом к редактированию макета желательно проделать следующие операции:

*в свойстве отчета «Путь к файлу отчета» установить имя файла, в котором будет храниться макет отчета;
* в свойстве «Источники» выборки (выборок) отчета установить перечень архивных сигналов (коннекторов), которые будут выводиться в отчете.

===Редактирование макета отчета===
[[Файл:AgavaPLC–Редактор макета отчета.png|мини|Рисунок 42 – Редактор макета отчета]]
Для редактирования макета отчета необходимо переключиться из редактора конфигурации в редактор макета отчета с помощью команды «Открыть редактор макета отчета», доступной из контекстного меню дерева конфигурации, отображаемого при щелчке правой кнопкой мыши на узле типа «Отчет».

В окне редактора расположены:

*панели инструментов;
* панель объектов отчета;
*окно «Инспектор объектов»;
*окно «Инспектор данных»;
*окно «Инспектор скриптов»;
*область построения макета отчета;
*окно «Структура отчета».

Редактор макета позволяет вызывать команды сочетаниями клавиш:

*Ctrl + N – новый макет;
*Ctrl + O – загрузить макет;
*Ctrl + S – сохранить макет;
*Ctrl + Shift + S – сохранить макет под новым именем;
*Ctrl + P – предварительный просмотр;
*Ctrl + Z – отмена изменений;
*Ctrl + Shift + Z – возврат отмененных изменений;
* Ctrl + C – копировать объект;
*Ctrl + X – вырезать объект;
*Ctrl + V – вставить объект;
*Ctrl + Стрелки – переместить выделенный объект;
*Shift + Стрелки – изменить размер выделенных объектов;
*Del – удалить выделенные объекты;
*Shift + левая кнопка мыши – создать область выделения.

====Окно «Инспектор объектов»====
Окно «Инспектор объектов» содержит список свойств выделенного объекта и предназначено для их редактирования.

====Окно «Инспектор данных»====
Окно «Инспектор данных» содержит список доступных для использования источников данных (выборок) и предназначено для заполнения блока «Данные» элементами соответствующего типа.

====Окно «Инспектор скриптов»====
Окно «Инспектор скриптов» содержит список доступных для использования в отчете скриптов.

====Окно «Структура отчета»====
Окно «Структура отчет» отображает структуру отчета в виде дерева связанных элементов.

===Элементы отчета===
Для составления макета отчета доступны следующие элементы:

*текст;
*данные;
*изображение;
*фигура;
*компоновка (Layout).

====Текст====
Элемент «Текст» служит для вывода надписей или содержимого полей источников данных.

Объект «Текст» обладает очень широкими возможностями. Он умеет отображать текст, рамку, заливку. Текст может быть отображен любым шрифтом любого размера, цвета и стиля. Большинство настроек делаются визуально с помощью панелей инструментов.

Одна из самых главных особенностей этого универсального объекта – это возможность отображения не только статичного текста, но и текста с применением вычисляемых выражений. Причем, выражения могут располагаться в объекте вперемешку с текстом. Рассмотрим простой пример – поместим в объект «Текст» следующую строку: «Привет! Сегодня $S{now()}».

Если запустить отчет на построение, мы увидим приблизительно следующее: «Привет! Сегодня 20180803». В процессе построения отчета выражение в тексте, заключенное $S{}, было вычислено и полученное значение вставлено обратно в текст. Объект «Текст» может содержать любое количество выражений, смешанных с обычным текстом. В скобки можно заключать и одиночные переменные, и выражения, например, $S{1+2*(3+4)}. В выражениях можно использовать константы, переменные ($V{}), функции, поля БД ($D{}).

Свойства элемента «Текст»:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|alignment
|Выравнивание текста по вертикали и горизонтали
|-
|angle
|Поворот надписи
|-
|autoHeight
|Автоматический подбор высоты
|-
|autoWidth
|Автоматический подбор ширины
|-
|backgroundColor
|Цвет заливки
|-
|backgroundMode
|Режим заливки
|-
| backgroundOpacity
|Прозрачность заливки
|-
|borders
|Границы
|-
|content
|Содержимое объекта «Текст»
|-
|font
|Шрифт
|-
|fontColor
|Цвет шрифта
|-
| foregroundOpacity
|Прозрачность шрифта
|-
|geometry
|Размер и расположение объекта
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|margin
|Отступы
|-
|objectName
| Имя объекта
|-
|stretchToMaxHeight
|Установка значения высоты самого высокого объекта на бэнде
|-
|trimValue
|Удаление пробелов в начале и в конце надписи
|}

Для редактирования свойства «Content» используется диалоговое окно «Text Item Editor», вызов которого осуществляется двойным щелчком левой кнопки мыши на элементе «Текст».

Свойство «Content» может содержать:

*текст;
*значения переменных;
*значения полей из набора данных;
*значения, формируемые посредством исполнения скрипта.

Для вывода значений переменных используется синтаксис «$V{имяПеременной}» (без кавычек), для вывода значения поля данных – «$D{имяНабораДанных.ИмяПеременной}», для вывода результата исполнения скрипта – «$S{телоСкрипта}».

==== Изображение ====
Элемент для вывода изображений:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoSize
|Подгонять размер под размер изображения
|-
|borders
|Границы
|-
|content
|
|-
|datasource
|Источник данных
|-
|field
|Поле данных
|-
|geometry
|Размер и расположение
|-
|image
|Изображение
|-
| itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
| stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Фигура====
Элемент для вывода фигур:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
| geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|lineWidth
|Толщина линии
|-
|objectName
|Имя объекта
|-
|opacity
|Прозрачность
|-
|penStyle
|Стиль линии
|-
|shape
|Фигура
|-
|shapeBrush
|Стиль заливки
|-
|shapeBrushColor
|Цвет заливки
|-
|shapeColor
|Цвет фигуры
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

====Горизонтальная компоновка (Layout)====
Элемент, позволяющий объединять несколько элементов в группу:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|borders
|Границы
|-
|geometry
|Размер и расположение
|-
|itemLocation
|Расположение объекта (страница или бэнд)
|-
|objectName
|Имя объекта
|-
|stretchToMaxHeight
|Устанавливать значение высоты самого высокого объекта на бэнде
|}

=== Разделы отчета (бэнды) ===
Бэнд предназначен для размещения других элементов отчета. Бэнд может быть нескольких типов:

*Report Header – заголовок отчета;
*Report Footer – завершение отчета;
*Page Header – верхний колонтитул страницы отчета;
*Page Footer – нижний колонтитул страницы отчета;
*Data – данные отчета;
* SubDetail – подчиненные данные отчета;
*SubDetailHeader – заголовок подчиненных данных;
*SubDetailFooter – завершение подчиненных данных;
*GroupHeader – заголовок группы;
*GroupFooter – завершение группы.

Бэнды применяются для логической группировки объектов. К примеру, размещение объекта на элементе «Данные» типа «Page Header», приводит к отображению этого объекта в верхней части каждой страницы готового отчета. Аналогичным образом «Page Footer» выводится внизу каждой страницы со всеми лежащими на нем объектами.

Общие для всех элементов «Данные» свойства:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|autoHeight
|Автоматический подбор высоты
|-
|backgroundColor
|Цвет заливки бэнда
|-
|borders
|Границы
|-
|geometry
|Размер
|-
|keepBottomSpace
|Сохранение отступа от нижней границы бэнда
|-
|objectName
|Имя объекта
|-
|printIfEmpty
|Отображение пустого бэнда
|-
|splittable
|Разделение бэнда, если он не влезает на страницу
|}

Report Footer:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|maxScalePercent
|Максимальный процент, на который можно уменьшить бенд, если он не влезает на страницу. Если бэнд даже после сжатия

не влезает на страницу, он будет перенесен полностью или частично – в зависимости от настроек бэнда
|}

Data:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|datasource
|Источник данных. Data-бэнд будет сформирован для каждой строки в источнике данных
|-
|keepFooterTogether
|Если Report Footer не влезает на страницу, то он будет перенесен на следующую страницу совместно с последним

экземпляром Data-бэнда
|-
|sliceLastRow
| Указывает генератору отчетов на то, можно ли разрезать последний экземпляр Data-бэнда или его нужно перенести

целиком
|}

Бэнды данного типа предназначены для вывода на печать данных из наборов. Набор данных - это заранее неизвестное количество строк (записей), каждая из которых содержит определенное количество колонок (полей).

SubDetail:
{| class="wikitable"
! Наименование свойства
!Описание
|-
|datasource
| Источник данных. SubDetail-бэнд будет сформирован для каждой строки в источнике данных
|}

SubDetailHeader, SubDetailFooter:
{| class="wikitable"
!Наименование свойства
!Описание
|-
|printAlways
| Печатать, даже если SubDetail пустой
|}

GroupHeader:
{| class="wikitable"
!Наименование свойства
! Описание
|-
|groupFieldName
|Поле, по которому осуществляется группировка. Экземпляр GroupHeader будет формироваться при смене значения в этом поле
|}

===Функции===
==== Агрегатные функции ====
Агрегатные функции предназначены для обработки значений, содержащихся в резделах Data и SubDetail.

===== AVG - вычисление среднего значения =====
Пример использования:
$S{AVG("TextItem4","DataBand1");}

===== SUM - вычисление суммы значений =====
Пример использования:
$S{SUM("TextItem8","DataBand1");}

===== MIN =====

===== MAX =====

===== COUNT =====

==== Числовые функции ====

===== numberFormat - форматирование числа =====
Синтаксис:
numberFormat(значение, 'формат', точность)
Форматы:

* <code>'f'</code> — фиксированная запись (например, <code>"123.45"</code>);
* <code>'g'</code> — общий формат (автоматически выбирает между <code>'f'</code> и <code>'e'</code>);
* <code>'e'</code> — экспоненциальная запись (например, <code>"1.2345e+02"</code>);

Пример использования:
$S{numberFormat($D{fetcharchiverdata1.ArchiversSourceConnector0 (среднее)}, 'f', 3)} -> 123.495
[[Категория:AgavaSCADA/AgavaPLC]]

Перечень изменений AgavaSCADA/AgavaPLC 1.6

2025-09-04T08:55:40Z

SharipovRR: /* Узлы */

Основные изменения в сравнении с версией 1.2:

# Добавлена возможность создания программ на языке C++ в соответствии с подходом, описанным в стандарте МЭК 61131-3.
# Продолжение развития объектной модели и возможности разработки программ, начатых в версии <code>AS 1.5</code>. [[Объектная модель AgavaSCADA/AgavaPLC]].
# Добавлена поддержка локального и онлайн (удаленного) отладчика.
# Для редактирования текстов программ, функций и классов внедрен новый, удобный и функциональный текстовый редактор, подобный распространенному VSCode.
# Транспорты MQTT, SNMP, МЭК 60870-5-101, МЭК 60870-5-104 портированы на ПК с ОС Linux x64 и контроллеры АГАВА.
# Реализован новый архиватор в БД PostgreSQL.
# Добавлена поддержка ресурсов и библиотек ресурсов.
# Добавлена Web-визуализация. См. пример <code>MultiImageLabel</code>.
# Разработан ряд примеров, демонстрирующих новые возможности: <code>PIDRegulator</code>, <code>Leds</code>, <code>Wdt</code>, <code>AgavaAnalogInput</code>, <code>WidgetAgavaInput</code>, <code>Pump</code>, <code>MultiImageLabel</code> и другие.
Также запланировано добавление новых возможностей:
# Поддержка языка ST МЭК 61131-3 (Structured text).
# Поддержка распределенных проектов.
# Поддержка сохранения в проекте информации о целевой системе.
# Конфигурирование целевых устройств из проекта.
# Создание расширений для среды разработки с помощью SDK.
Перевод разработанных ранее проектов на актуальную версию описан в документе [[Миграция проектов AgavaSCADA/AgavaPLC]].

== 1.6.20-r0ad724e1e636 от 2025-08-08 ==

=== Узлы ===

# Добавлена функция <code>int StoreMessage(int iMessageLevel, string strMessage, string strGroup).</code>
# Добавлена возможность вызова методов экземпляров объектов из действий.
# Исправлено выполнение действия <code>Создание события</code>, теперь возможно создание событий из обработчиков.
# В тренды графиков добавлено свойство <code>Единицы измерения</code>.
# Добавлен межстанционный транспорт. Для станций добавлено свойство <code>Роль</code>. Станция с ролью <code>Клиент</code> производит подключение к удаленным станциям с ролью <code>Сервер</code> и уведомляет об изменениях источников и сигналов.
# Устранена ошибочная генерация нескольких дублирующихся событий при работе контроллеров событий.
# В окне <code>Фильтр</code> виджета <code>Список событий</code> размер элементов теперь зависит от свойства системы тревог <code>Размер кнопки</code>.
# Доработаны транспорты <code>Modbus</code>:
#* добавлена [[Транспорты AgavaSCADA/AgavaPLC#Этап 2. Объединение команд записи (функции 15 и 16)|группировка команд записи]] для функций 15 и 16;
#* реализована [[Транспорты AgavaSCADA/AgavaPLC#Этап 1. Дедупликация при постановке в очередь|дедупликация команд записи]].
# Доработан транспорт OPC-UA:
#* исправлены типы свойств;
#* сервер теперь привязывается к порту, указанному в свойстве <code>Адрес</code> (ранее всегда использовался 4840).

=== Среда разработки ===

# Устранена ошибка при перетаскивании разделителя столбцов.
# Свойство "Аргументы" программы сделано скрытым.
# Добавлена возможность размещения определений классов в приложении в подгруппах любой вложенности.

== 1.6.19-r89b594033f4d от 2025-09-02 ==

=== Узлы ===

# Реализовано определение локальной станции для запуска проекта.
# Исправлен запуск узла типа <code>Сигнал простой</code>.

=== Среда разработки ===

# В мастер создания проектов добавлена поддержка АГАВА ПЛК-70.А.
# Исправлена конвертация виджетов <code>Ввод значения</code> при обновлении проекта с версии 1.2.
# Исправлена ошибка в окне настройки исторического графика, связанная с одновременным удалением нескольких трендов.
# Доработана проверка проекта перед сохранением конфигурации. При обнаружении критических ошибок - отказ сохранения.
# Добавлена проверки станций на использование адреса 127.0.0.1, на дублирующиеся IP-адреса.

== 1.6.18-r4a325427448b от 2025-08-06 ==

=== Узлы ===

# Доработана установка аргументов в вызываемые методы экземпляров (добавлен тип <code>string</code> для некоторых сценариев).
# Доработаны узлы <code>Транспорт Modbus-TCP</code>, <code>Транспорт Modbus-RTU</code>:
#* Добавлен узел типа <code>Счетчик</code>, хранящий признак активного подключения к устройству с заданным Modbus адресом.
# Доработан узел <code>Транспорт Modbus-TCP</code>:
#* Реализовано множественное подключение клиентов в режиме работы <code>Сервер</code>.
#* Доработан режим <code>Сервер</code>: добавлена возможность настройки таймаута активности клиента и максимального количества подключений к серверу.
# Узел <code>Шаблонная композиция</code> убран из списка доступных типов для группы "Композиции".
# Исправлена критическая ошибка, изредка возникавшая при переключении окон.
# Исправлена ошибка выполнения действия Закрытие окна.

=== Среда разработки ===

# Исправлена функция просмотра и редактирования списка источников формы.

#

== 1.6.17-r1f70359a00b4 от 2025-08-01 ==

=== Узлы ===

# Исправлена ошибка передачи аргументов типов <code>float</code>, <code>double</code> в методы классов.
# Исправлено связывание свойств экземпляров базовых типов с узлами проекта.
# Доработан вызов методов типа <code>void</code> классов для исключения критических ошибок.
# Для кривых графиков изменена толщина линии по умолчанию на <code>1</code>.
# Исправлена ошибка в команде <code>Сохранить архив проекта</code> - устранено ошибочное создание дубликатов некоторых используемых проектом файлов.
# Доработано восстановление <code>retain</code> - добавлена возможность восстановления в свойства экземпляров классов.
# Изменена конвертация <code>Result</code> в другие типы.

=== Среда разработки ===

# Исправлены ошибки работы отладчика с точками останова в методах и свойствах классов.
# Изменен уровень ошибок компиляции при поиске путей в проекте (Get/SetNodeValueAs... и др.) с <code>Ошибка</code> на <code>Предупреждение</code>.
# Реализовано связывание виджетов со свойствами узлов путем перетаскивания.
# Добавлено местное (inplace) редактирование свойств типа <code>SignalValue</code> в диалоге редактирования сопоставлений, например в окне редактирования сопоставлений виджета <code>Выпадающий список</code>.
# Уточнено сообщение об ошибочном открытии проекта из папки <code>.autosave</code>.
# Доработано окно выбора узлов - кнопка <code>ОК</code> теперь является кнопкой по умолчанию.

=== Примеры ===

# Добавлен пример SQLiteDecimation, демонстрирующий возможности прореживания при записи архива SQLite.
# Доработан пример TestEventsAlarms.

== 1.6.16-r4dc07fc875a4 от 2025-07-18 ==

=== Узлы ===

# Доработан системный транспорт <code>TransportSystem2</code> - изменена процедура остановка сервера для устранения незавершенных соединений.
# Доработаны виджеты <code>Гистограмма</code> и <code>Кнопка</code> - исправлена работа с источником.
# Доработано действие <code>Запуск процесса</code> - исправлен запуск процесса.

=== Среда разработки ===

# Восстановлено обновление BuildNo и даты сборки проекта.

=== ASLauncher ===

# Убрано диалоговое окно с сообщением о частых попытках перезапуска при выходе.
# При запуске приложений из `.desktop` файлов добавлена проверка, что логирование в указанные файлы возможно.
# В файлы логов добавлена информация о версии приложения.

== 1.6.15-r710146e4389e от 2025-07-09 ==

=== Узлы ===

# Узел Система тревог - добавлены настройки окна тревог (ширина, высота, перенос строк в сообщениях).
# Исправлена ошибка в проверке прав на закрытие фрейма, из-за чего в некоторых проектах без системы проверки прав закрытие фрейма не работало.
# Виджет <code>Список событий</code> - исправлена ошибка при работе с диалогом ожидания.
# Действие <code>Авторизация пользователя</code> - добавлено свойство <code>Запрашивать пароль</code>. Действие с включенным свойством <code>Запрашивать пароль</code> будет отображать окно авторизации без возможности смены пользователя.
# Реализована возможность инициализации свойств экземпляров объектов постоянными значениями, задаваемыми в среде разработки (доступны типы bool, int, uint, long, ulong, double, string).
# Для транспортов <code>Modbus-RTU</code>, <code>Modbus-TCP</code> добавлена очистка очереди команд при (ре)старте обмена.

=== Среда разработки ===

# Добавлена поддержка нового системного транспорта. Для подключения к панелям оператора и контроллерам из среды разработки необходимо обновить среду исполнения до версии 1.6.15 или более новой.
# Добавлена иконка для приложения [[Универсальная среда разработки Agava]] (впервые с версии 1.0!).
# Исправлены критические ошибки в webvisu из-за отсутствия qml модулей.

=== Среда исполнения ===

# Откорректировано оформление окна авторизации с целью улучшения привлекательности.

=== Примеры ===

# Добавлены примеры <code>MultiImageLabel</code>, <code>LayersDemo</code>. Пример <code>MultiImageLabel</code> дополнен демонстрацией webvisu.
# Добавлены примеры <code>OpcUaDemo</code>, <code>OpcUaClientDemo</code>.

'''Версия переведена в стабильную стадию.'''

== 1.6.14-r1c61c35c3da4 от 2025-06-20 ==

=== Среда разработки ===

# Добавлена возможность регулирования частоты обновления форм и экранов с композициями. Добавлено свойство "Интервал обновления" для экранов и композиций.
# У виджета "График" изменен форматтер оси времени по умолчанию с "dd.MM.yy hh:mm:ss" на "dd.MM.yyyy hh:mm:ss".

=== Среда исполнения ===

# Оптимизирован вывод информации на экран - исключена повторная отрисовка виджетов, при записи значений в их свойства из скриптов и программ.
# Реализовано профилирование вызова базовых методов и работы с контекстами.
# Реализован вывод информации о перерисовке виджетов в консоль с настройкой через файл as.ini.

=== Примеры ===

# Добавлен пример <code>WindowUpdateRate</code>, демонстрирующий возможность ограничения частоты обновления окон.

== 1.6.13-r13248581de39 от 2025-06-17 ==

=== Среда разработки ===

# Исправлена ошибка функции "Просмотр событий", из-за которой некорректно выдавались события в проектах без логгеров.
# Реализовано копирование станций ПК-40, ПК-50, ПК-60.
# Устранено сохранение в архив проекта файлов .bi?, хранящихся в подпапках, начинающихся с точки. Например .autosave, .backup
# Разрешено добавление приложений к станциям ПО-40, ПО-50, ПО-60.
# Убрана зависимость от библиотеки libclang.

=== Среда исполнения ===

# Реализован вывод информации о регионах перерисовки окон в консоль с настройкой через файл as.ini.
# Доработаны методы BasicSignal::GetValue, BasicSignal::SetValue для корректного обращения к узлам проекта.
# Исправлена ошибка в работе со светодиодами станции ПК-40.
# Исправлено создание BasicSource("path"), BasicSignal("path"), BasicWidget("path") в программах. Теперь появилась возможность доступа ко всем свойствам узла проекта, а не только к свойствам, определенным в BasicNode.
# Добавлена проверка типа при создании экземпляра BasicSource (ОМ).

=== Примеры ===

# Разработан пример <code>Leds</code>, демонстрирующий работу со светодиодами ПО-50 из программы с использованием объектной модели.

=== ASLauncher ===

# Добавлен скрипт для восстановления <code>explorer.exe</code> в качестве оболочки рабочего стола после установки ASLauncher.

== 1.6.12-r17b244111a8c от 2025-05-30 ==

=== Среда разработки ===

# Исправлена ошибка, возникавшая при перемещении узлов в дереве проекта, из-за которой перемещаемые узлы пропадали.
# Добавлено текстовое описание при появлении окна с ошибками, например при сохранении проекта.
# Узел <code>Операция Пара условий</code> - исправлены имена свойств. В проектах версии 1.2 операция не работала в режиме проверки двух условий. '''Необходимо проверить корректность настроек при переходе с версии 1.2.'''
# Исправлена ошибка определения уровня логгеров при вызове команды <code>Просмотр событий</code>, из-за которой при наличии в проекте логгеров с уровнями логгирования <code>INFO</code> в окно событий не попадали события ниже уровнем.

=== Среда исполнения ===

# Оптимизация узла <code>Транспорт TCP</code>.
# Оптимизирована система журналирования.

== 1.6.8-r915d8d477fa4 от 2025-05-14 ==

=== Среда разработки ===
# Исправлено несоответствие настроек узла <code>Действие "Команда узлу"</code> и фактически исполняемых команд. '''При обновлении на эту версию необходимо проверить корректность настроек всех улов типа <code>Действие "Команда узлу"</code>.'''

[[Категория:AgavaSCADA/AgavaPLC]]
__NOTOC__

Транспорты AgavaSCADA/AgavaPLC

2025-09-04T08:46:39Z

SharipovRR: /* Транспорты Modbus-RTU, Modbus-TCP */

==Транспорты Modbus-RTU, Modbus-TCP==
Данные виды транспортов предназначены для приема и передачи данных по протоколу Modbus. Поддерживаются последовательные и Ethernet подключения, а также [[Транспорты AgavaSCADA/AgavaPLC#Оптимизации операций записи в Modbus|некоторые оптимизации команд записи]].
===Узлы===
*TransportModbus-RTU - транспорт, работающий по последовательным линиям связи.
*TransportModbus-TCP - транспорт, работающий по ethernet.
*ModbusRegister - источник типа "Регистр Modbus".
====TransportModbus-RTU====
Узел, представляющий транспорт Modbus, работающий по последовательным линиям связи RS-485, RS-422, RS-232.
=====Доступные дочерние узлы=====
*Группа узлов
*ModbusRegister
=====Свойства=====

==== TransportModbus-TCP ====
Узел, представляющий транспорт Modbus, работающий по линиям связи Ethernet.
=====Доступные дочерние узлы=====
*Группа узлов
*ModbusRegister
=====Свойства=====

==== ModbusRegister ====
Узел, представляющий источник типа "Регистр Modbus".

===== Доступные дочерние узлы =====
Нет

=====Свойства=====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
|Устройство
|DeviceAddr
|INT
|Чтение / запись
|
|-
|Функция чтения
|ReadFunction
|INT
|Чтение / запись
|
|-
|Регистр чтения
|ReadRegister
|INT
|Чтение / запись
|
|-
|Размер регистра
|ParamSize
|INT
|Чтение / запись
|
|-
|Приоритет
|Priority
|INT
|Чтение / запись
|
|-
|Функция записи
|WriteFunction
|INT
|Чтение / запись
|
|-
|Регистр записи
|WriteRegister
|INT
|Чтение / запись
|
|-
|Тип значения
|ValueType
|INT
|Чтение / запись
|
|-
|Порядок байт
|ByteOrder
|INT
|Чтение / запись
|
|-
|Операции после чтения
|OperationsOnRead
|NODESARRAY
|Чтение / запись
|
|-
|Операции перед записью
|OperationsOnWrite
|NODESARRAY
|Чтение / запись
|
|-
|Узел для чтения/записи
|SourceId
|NODE
|Чтение / запись
|
|}Устройство

Функция чтения

Регистр чтения

Размер регистра

Приоритет

Функция записи

Регистр записи

Тип значения

Порядок байт

Операции после чтения

Операции перед записью

Узел для чтения/записи

=== Оптимизации операций записи в Modbus ===

* '''Цель''': уменьшить трафик и задержки и ускорить достижение согласованного состояния на устройстве.
* '''Область применения''': операции записи функций 5/6/15/16; чтение не оптимизируется.

==== Модель команды и терминология ====

* '''Что содержит команда''': идентификатор устройства (<code>Slave ID</code>), номер функции (<code>func</code>), адрес или диапазон адресов, и полезную нагрузку (значения для записи).
** Для функций 5 и 6 записывается один адрес.
** Для функций 15 и 16 может записываться непрерывный диапазон адресов.
* При сравнении двух команд '''одинаковыми командами''' считаются те, у которых полностью совпадают <code>Slave ID</code>, функция и адрес регистра.
* '''Смежными диапазонами''' являются диапазоны, между которыми нет разрыва — один начинается сразу после другого. Примеры: смежные — <code>1..4</code> и <code>5..8</code>; <code>10..10</code> и <code>11..15</code>. Не смежные — <code>1..4</code> и <code>6..8</code> (разрыв), <code>3..7</code> и <code>5..9</code> (перекрытие).
* '''Неподтверждённой записью''', является та, которая находится в очереди и ещё не была отправлена драйвером на устройство.

==== Этап 1. Дедупликация при постановке в очередь ====

* '''Назначение''': убрать лишние повторные записи одного и того же адреса, если между ними не было попытки отправки на устройство.
* '''Принцип дедупликации''': Если в очереди уже есть неподтверждённая запись для того же <code>Slave ID</code>, той же функции и того же адреса, то новая запись заменяет значение в существующей, а сама в очередь не добавляется.
* '''Что не дедуплицируется''':
** Разные адреса, разные функции или разные устройства.
** Операции чтения.
** Объединение диапазонов — отдельный механизм (см. Этап 2).
* '''Эффект''':
** Снижается нагрузка на канал и устройство при частых обновлениях одного тега.
** В устройство уходит самое свежее значение на момент отправки.

==== Этап 2. Объединение команд записи (функции 15 и 16) ====

* '''Назначение''': сократить число запросов, объединив записи в соседние адреса в один непрерывный блок.
* '''Что объединяется''':
** Функция 15 (Write Multiple Coils): катушки с непрерывными адресами.
** Функция 16 (Write Multiple Registers): регистры хранения с непрерывными адресами.
** Только записи с одинаковыми <code>Slave ID</code> и одинаковой функцией (15 или 16).
* '''Условия объединения''': Несколько записей с одинаковыми <code>Slave ID</code> и функцией 15 или 16, чьи адресные диапазоны идут подряд без разрывов, объединяются в одну запись с общим диапазоном от минимального до максимального адреса.
* '''Формирование буфера значений''':
** Для 15: формируется массив булевых значений по адресам в объединённом диапазоне.
** Для 16: формируется массив 16-битных слов по адресам в объединённом диапазоне.
*** 32-битные типы (Int32/UInt32/Float32) занимают два 16-битных слова.
*** Соблюдается заданный порядок слов (Normal/Inverse).
** Если для одного адреса есть несколько кандидатов, берётся самое свежее значение на момент отправки.
* '''Порядок и атомарность''':
** Адреса в блоке упорядочиваются по возрастанию.
** Отправка выполняется одной операцией: <code>writeCoils</code> (15) или <code>writeRegisters</code> (16).
** Логирование отражает одну агрегированную запись.
* '''Что не объединяется''':
** Разные <code>Slave ID</code> или разные функции (15 и 16 не смешиваются).
** Диапазоны с разрывами.
** Операции чтения и иные типы команд.

==== Ограничения ====

# Ограничение длины кадра устройства/драйвера может приводить к разбиению больших блоков.
# Объединение выполняется на этапе подготовки к отправке; до него действует дедупликация.
# При ошибке статусы возвращаются для всей агрегированной операции, повторы — по общей логике.

==== Примеры ====

* '''Дедупликация''':
** Три записи в один регистр: 10 → 20 → 30. В очереди остаётся одна запись; отправляется значение 30.
** Две записи в разные регистры: обе будут отправлены независимо.
** Записи в один адрес, но с разными функциями (например, 5 и 15): считаются разными и отправляются раздельно.
* '''Объединение 15/16''':
** Функция 16: записи 40010..40011 и 40012 объединяются в 40010..40012 и уходят одной операцией.
** Функция 15: записи катушек 1..4 и 5..8 объединяются в 1..8 и отправляются одной операцией.
{{Шаблон:AgavaSCADA_плагин_OPC_UA}}
{{Шаблон:AgavaSCADA_плагин_SNMP}}

[[Категория:AgavaSCADA/AgavaPLC]]

Транспорты AgavaSCADA/AgavaPLC

2025-09-04T08:37:15Z

SharipovRR: /* Транспорты Modbus-RTU, Modbus-TCP */

==Транспорты Modbus-RTU, Modbus-TCP==
Данные виды транспортов предназначены для приема и передачи данных по протоколу Modbus. Поддерживаются последовательные и Ethernet подключения, а также некоторые оптимизации команд записи.
===Узлы===
*TransportModbus-RTU - транспорт, работающий по последовательным линиям связи.
*TransportModbus-TCP - транспорт, работающий по ethernet.
*ModbusRegister - источник типа "Регистр Modbus".
====TransportModbus-RTU====
Узел, представляющий транспорт Modbus, работающий по последовательным линиям связи RS-485, RS-422, RS-232.
=====Доступные дочерние узлы=====
*Группа узлов
*ModbusRegister
=====Свойства=====

==== TransportModbus-TCP ====
Узел, представляющий транспорт Modbus, работающий по линиям связи Ethernet.
=====Доступные дочерние узлы=====
*Группа узлов
*ModbusRegister
=====Свойства=====

==== ModbusRegister ====
Узел, представляющий источник типа "Регистр Modbus".

===== Доступные дочерние узлы =====
Нет

=====Свойства=====
{| class="wikitable"
!Наименование свойства
!Идентификатор
!Тип
!Доступ
!Описание
|-
|Устройство
|DeviceAddr
|INT
|Чтение / запись
|
|-
|Функция чтения
|ReadFunction
|INT
|Чтение / запись
|
|-
|Регистр чтения
|ReadRegister
|INT
|Чтение / запись
|
|-
|Размер регистра
|ParamSize
|INT
|Чтение / запись
|
|-
|Приоритет
|Priority
|INT
|Чтение / запись
|
|-
|Функция записи
|WriteFunction
|INT
|Чтение / запись
|
|-
|Регистр записи
|WriteRegister
|INT
|Чтение / запись
|
|-
|Тип значения
|ValueType
|INT
|Чтение / запись
|
|-
|Порядок байт
|ByteOrder
|INT
|Чтение / запись
|
|-
|Операции после чтения
|OperationsOnRead
|NODESARRAY
|Чтение / запись
|
|-
|Операции перед записью
|OperationsOnWrite
|NODESARRAY
|Чтение / запись
|
|-
|Узел для чтения/записи
|SourceId
|NODE
|Чтение / запись
|
|}Устройство

Функция чтения

Регистр чтения

Размер регистра

Приоритет

Функция записи

Регистр записи

Тип значения

Порядок байт

Операции после чтения

Операции перед записью

Узел для чтения/записи

=== Оптимизации операций записи в Modbus ===

* '''Цель''': уменьшить трафик и задержки и ускорить достижение согласованного состояния на устройстве.
* '''Область применения''': операции записи функций 5/6/15/16; чтение не оптимизируется.

==== Модель команды и терминология ====

* '''Что содержит команда''': идентификатор устройства (<code>Slave ID</code>), номер функции (<code>func</code>), адрес или диапазон адресов, и полезную нагрузку (значения для записи).
** Для функций 5 и 6 записывается один адрес.
** Для функций 15 и 16 может записываться непрерывный диапазон адресов.
* При сравнении двух команд '''одинаковыми командами''' считаются те, у которых полностью совпадают <code>Slave ID</code>, функция и адрес регистра.
* '''Смежными диапазонами''' являются диапазоны, между которыми нет разрыва — один начинается сразу после другого. Примеры: смежные — <code>1..4</code> и <code>5..8</code>; <code>10..10</code> и <code>11..15</code>. Не смежные — <code>1..4</code> и <code>6..8</code> (разрыв), <code>3..7</code> и <code>5..9</code> (перекрытие).
* '''Неподтверждённой записью''', является та, которая находится в очереди и ещё не была отправлена драйвером на устройство.

==== Этап 1. Дедупликация при постановке в очередь ====

* '''Назначение''': убрать лишние повторные записи одного и того же адреса, если между ними не было попытки отправки на устройство.
* '''Принцип дедупликации''': Если в очереди уже есть неподтверждённая запись для того же <code>Slave ID</code>, той же функции и того же адреса, то новая запись заменяет значение в существующей, а сама в очередь не добавляется.
* '''Что не дедуплицируется''':
** Разные адреса, разные функции или разные устройства.
** Операции чтения.
** Объединение диапазонов — отдельный механизм (см. Этап 2).
* '''Эффект''':
** Снижается нагрузка на канал и устройство при частых обновлениях одного тега.
** В устройство уходит самое свежее значение на момент отправки.

==== Этап 2. Объединение команд записи (функции 15 и 16) ====

* '''Назначение''': сократить число запросов, объединив записи в соседние адреса в один непрерывный блок.
* '''Что объединяется''':
** Функция 15 (Write Multiple Coils): катушки с непрерывными адресами.
** Функция 16 (Write Multiple Registers): регистры хранения с непрерывными адресами.
** Только записи с одинаковыми <code>Slave ID</code> и одинаковой функцией (15 или 16).
* '''Условия объединения''': Несколько записей с одинаковыми <code>Slave ID</code> и функцией 15 или 16, чьи адресные диапазоны идут подряд без разрывов, объединяются в одну запись с общим диапазоном от минимального до максимального адреса.
* '''Формирование буфера значений''':
** Для 15: формируется массив булевых значений по адресам в объединённом диапазоне.
** Для 16: формируется массив 16-битных слов по адресам в объединённом диапазоне.
*** 32-битные типы (Int32/UInt32/Float32) занимают два 16-битных слова.
*** Соблюдается заданный порядок слов (Normal/Inverse).
** Если для одного адреса есть несколько кандидатов, берётся самое свежее значение на момент отправки.
* '''Порядок и атомарность''':
** Адреса в блоке упорядочиваются по возрастанию.
** Отправка выполняется одной операцией: <code>writeCoils</code> (15) или <code>writeRegisters</code> (16).
** Логирование отражает одну агрегированную запись.
* '''Что не объединяется''':
** Разные <code>Slave ID</code> или разные функции (15 и 16 не смешиваются).
** Диапазоны с разрывами.
** Операции чтения и иные типы команд.

==== Ограничения ====

# Ограничение длины кадра устройства/драйвера может приводить к разбиению больших блоков.
# Объединение выполняется на этапе подготовки к отправке; до него действует дедупликация.
# При ошибке статусы возвращаются для всей агрегированной операции, повторы — по общей логике.

==== Примеры ====

* '''Дедупликация''':
** Три записи в один регистр: 10 → 20 → 30. В очереди остаётся одна запись; отправляется значение 30.
** Две записи в разные регистры: обе будут отправлены независимо.
** Записи в один адрес, но с разными функциями (например, 5 и 15): считаются разными и отправляются раздельно.
* '''Объединение 15/16''':
** Функция 16: записи 40010..40011 и 40012 объединяются в 40010..40012 и уходят одной операцией.
** Функция 15: записи катушек 1..4 и 5..8 объединяются в 1..8 и отправляются одной операцией.
{{Шаблон:AgavaSCADA_плагин_OPC_UA}}
{{Шаблон:AgavaSCADA_плагин_SNMP}}

[[Категория:AgavaSCADA/AgavaPLC]]

ASLauncher

2024-12-02T09:07:30Z

SharipovRR: /* Замена рабочего стола Windows */

ASLauncher - менеджер рабочего стола AgavaSCADA.

ASLauncher предназначен для использования совместно со средой исполнения и позволяет заменить собой штатную оболочку Windows.

ASLauncher реализует следующие функции:

* автозапуск AgavaSCADA;
* замена рабочего стола Windows;
* программный сторожевой таймер.

== Автозапуск AgavaSCADA ==

== Замена оболочки рабочего стола Windows 10 ==
Для настройки ASLauncher в качестве оболочки рабочего стола Windows 10 необходимо внести изменения в реестр операционной системы. Вызовем стандартную утилиту '''«Редактор реестра»''' с помощью сочетания клавиш <code>Win + R</code>, указав в качестве выполняемой программы <code>regedit</code>.

'''Внимание:''' Перед внесением изменений в реестр рекомендуется создать резервную копию.

=== Настройка автозапуска ASLauncher ===

# Чтобы ASLauncher автоматически запускался при старте операционной системы, необходимо добавить соответствующую запись в реестр. В '''«Редакторе реестра»''' перейдите в папку: <code>Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run</code>
# В правой части окна нажмите правой кнопкой мыши и выберите '''«Создать»''' → '''«Строковый параметр»'''. Присвойте ему имя <code>ASLauncher</code>.
# Для созданного параметра необходимо указать путь до исполняемого файла. Нажмите правой кнопкой мыши на записи <code>ASLauncher</code> и выберите пункт '''«Изменить...»'''. В поле '''«Значение»''' введите полный путь до исполняемого файла (например, <code>C:\aslauncher-bin\aslauncher.exe</code>).

=== Установка ASLauncher в качестве стандартной оболочки рабочего стола ===

# Чтобы сделать ASLauncher оболочкой рабочего стола по умолчанию, в '''«Редакторе реестра»''' перейдите в папку: <code>Компьютер\HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Winlogon</code>
# Найдите параметр <code>Shell</code> (по умолчанию его значение — <code>explorer.exe</code>). Если такого параметра нет, создайте новый '''«Строковый параметр»''' с именем <code>Shell</code>.
# Нажмите дважды на параметре <code>Shell</code> и замените его значение на полный путь до исполняемого файла ASLauncher (например, <code>C:\aslauncher-bin\aslauncher.exe</code>).

=== Отключение Error Reporting ===

# Для отключения отправки отчетов об ошибках, в '''«Редакторе реестра»''' перейдите к следующему разделу: <code>Компьютер\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Windows Error Reporting</code>
# В правой части окна найдите параметр <code>Disabled</code> типа <code>DWORD (32-бит)</code>. Если такого параметра нет, создайте его, нажав правой кнопкой мыши, выбрав '''«Создать»''' → '''«Параметр DWORD (32 бита)»''' и присвоив ему имя '''Disabled'''.
# Дважды щелкните по параметру <code>Disabled</code> и установите значение '''1''' в поле '''«Значение»'''. Нажмите '''«ОК»''' для сохранения изменений.

=== Примечание ===

# После внесения всех изменений перезагрузите компьютер, чтобы они вступили в силу.
# В результате замены стандартной оболочки рабочего стола Windows на ASLauncher, для пользователя блокируются все штатные функции Windows — запуск установленных программ, все операции с файлами на дисках и т. д. ASLauncher предоставляет пользователю собственный рабочий стол со следующими функциями:
#* Запуск среды исполнения.
#* Перезагрузка и выключение АРМ.
#* Просмотр текущей даты и времени.
#* Запуск штатной оболочки Windows.

== Конфигурирование ASLauncher, версия 1.2 ==
Все настройки ASLauncher хранятся в файле aslauncher.ini, размещаемом в папке с исполняемыми файлами AgavaSCADA.
[General]
ProcessFile="G:/workspace/AgavaScada/bin-win/rtu.exe"
RestartProcessAt=00:02
Wallpaper="./GNOME-Shell.jpg"

== Конфигурирование ASLauncher, версия 1.5 ==

=== Описание конфигурационного файла и его параметров ===
Данный раздел описывает структуру и назначение конфигурационного файла формата <code>.ini</code>, используемого в нашем приложении. Этот файл содержит настройки для обоев рабочего стола и путей к лог-файлам приложения и связанных процессов.

==== Общая структура <code>.ini</code> файла ====
Файл <code>.ini</code> состоит из разделов и пар ключ-значение:

* '''Разделы''': обозначаются названием в квадратных скобках, например, <code>[General]</code>.
* '''Ключи и значения''': пары вида <code>Ключ=Значение</code>, определяющие настройку.

Образец общей структуры <code>.ini</code> файла:
[SectionName]
Key1=Value1
Key2=Value2

==== Описание ключей и значений <code>.ini</code> файла ====
Секция <code>[General]</code> содержит основные настройки приложения.

* Ключ <code>Wallpaper</code>
** '''Описание''': Задает путь к изображению, используемому в качестве обоев рабочего стола.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>Wallpaper=/home/user/Images/wallpaper.png</code>

* Ключ <code>ProcessErrorLogFile</code>
** '''Описание''': Указывает путь к файлу, в который записываются ошибки основного процесса приложения.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ProcessErrorLogFile=/var/log/rtu/rtu_process_error.log</code>

* Ключ <code>ProcessStandardLogFile</code>
** '''Описание''': Указывает путь к файлу, в который записывается стандартный вывод основного процесса приложения.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ProcessStandardLogFile=/var/log/rtu/rtu_process_standard.log</code>

* Ключ <code>ASLauncherLogsDir</code>
** '''Описание''': Задает директорию для хранения файлов логирования ASLauncher и приложений рабочего стола.
** '''Тип''': Директория.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ASLauncherLogsDir=/var/log/aslauncher</code>
* Ключ <code>DesktopEntriesDir</code>
** '''Описание''': Задает директорию, в которой хранятся файлы записей рабочих столов (Desktop Entries) в формате <code>.desktop</code>. Эти файлы используются для запуска приложений и отображения их в меню или на панели запуска.
** '''Тип''': Директория.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>DesktopEntriesDir=/usr/share/aslauncher</code>

==== Примечание ====

* Все описанные параметры, за исключением <code>Wallpaper</code>, являются обязательными и должны иметь корректные значения для запуска и штатной работы программы. Параметр <code>Wallpaper</code> является необязательным и в случае его отсутствия фон рабочего стола будет залит черным цветом.

* Убедитесь, что все указанные пути существуют и имеют соответствующие права доступа для чтения и записи.

* Используйте абсолютные пути для обеспечения корректной работы независимо от текущей директории.

=== Документация для <code>.desktop</code> файлов ===
Файлы с расширением <code>.desktop</code> используются для описания приложений и их поведения в системе. Они позволяют интегрировать приложения в графическую оболочку, определяя, как они отображаются на рабочем столе, какие иконки используют, и как запускаются.

==== Общая структура <code>.desktop</code> файла ====
Файл состоит из секции <code>[Desktop Entry]</code> и набора ключей с соответствующими значениями. Пример файла:
[Desktop Entry]
Name=MyApp
Process=/usr/bin/myapp
Arguments=--mode test
Icon=/usr/share/icons/myapp.png
Type=Application
AutoLaunch=true
AutoRestartOnCrash=true
User=myuser
PasswordPrompt=false

==== Примечания ====

* Для некоторых ключей используются значения типа 'Логическое значение'. Возможные варианты значений для данного типа: <code>true</code>, <code>True</code> или <code>1</code> — для истинных значений и <code>false</code>, <code>False</code> или <code>0</code> — для ложных.
* Ключи и значения чувствительны к регистру — убедитесь, что вы используете правильный регистр для каждого ключа.
* Убедитесь, что все указанные пути существуют и доступны для чтения/запуска.
* Если иконка не отображается, значит, по меньшей мере одна пара ключ-значение содержит ошибку. Чтобы исправить это, проверьте файлы логирования ASLauncher — информация, которая поможет выявить и исправить эту ошибку, будет отображена там.

==== Описание ключей и значений <code>.desktop</code> файла ====

# Ключ <code>Name</code>
#* '''Описание''': Отображаемое имя приложения в меню или панели запуска.
#* '''Формат''': Строка.
#* '''Пример значения''': <code>Name=MyApp</code>
# Ключ <code>Process</code>
#* '''Описание''': Путь к исполняемому файлу приложения.
#* '''Формат''': Абсолютный путь.
#* '''Пример значения''': <code>Process=/usr/bin/myapp</code>
# Ключ <code>Arguments</code>
#* '''Описание''': Аргументы командной строки, передаваемые приложению при запуске.
#* '''Формат''': Строка с аргументами, разделенными пробелами.
#* '''Пример значения''': <code>Arguments=--mode test --verbose</code>
# Ключ <code>Icon</code>
#* '''Описание''': Путь к файлу иконки или имя иконки из темы значков.
#* '''Формат''': Абсолютный путь.
#* '''Пример значения''': <code>Icon=/usr/share/icons/hicolor/48x48/apps/myapp.png</code>
# Ключ <code>Type</code>
#* '''Описание''': Тип записи, определяет, как система будет обрабатывать файл.
#* '''Возможные значения''': <code>Application</code> — исполняемое приложение.
#* '''Пример значения''': <code>Type=Application</code>
# Ключ <code>AutoLaunch</code>
#* '''Описание''': Указывает, должно ли приложение запускаться автоматически при входе пользователя в систему.
#* '''Формат''': Логическое значение.
#* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code>
#* '''Пример значения''': <code>AutoLaunch=true</code>
# Ключ <code>AutoRestartOnCrash</code>
#* '''Описание''': Определяет, будет ли приложение автоматически перезапущено в случае сбоя или аварийного завершения.
#* '''Формат''': Логическое значение.
#* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code>
#* '''Пример значения''': <code>AutoRestartOnCrash=true</code>
# Ключ <code>User</code>
#* '''Описание''': Имя пользователя, от имени которого должно запускаться приложение.
#* '''Формат''': Строка.
#* '''[Если] Параметр отсутствует''': Приложение запускается из-под пользователя <code>root</code>.
#* '''Пример значения''': <code>User=john_doe</code>
# Ключ <code>PasswordPrompt</code>
#* '''Описание''': Указывает, необходимо ли запрашивать пароль при запуске приложения.
#* '''Формат''': Имя пользователя, пароль аккаунта которого должен быть введён.
#* '''Возможные значения''': <code>default</code> — будет запрошен пароль <code>123asd890</code>.
#* '''[Если] Параметр отсутствует:''' Пароль не запрашивается.
#* '''Пример значения''': <code>PasswordPrompt=default</code>

[[Категория:AgavaSCADA/AgavaPLC]]

ASLauncher

2024-10-07T11:48:54Z

SharipovRR: /* Конфигурирование ASLauncher */

ASLauncher - менеджер рабочего стола AgavaSCADA.

ASLauncher предназначен для использования совместно со средой исполнения и позволяет заменить собой штатную оболочку Windows.

ASLauncher реализует следующие функции:

* автозапуск AgavaSCADA;
* замена рабочего стола Windows;
* программный сторожевой таймер.

== Автозапуск AgavaSCADA ==

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

* Запуск среды исполнения.
* Перезагрузка и выключение АРМ.
* Просмотр текущей даты и времени.
* Запуск штатной оболочки Windows.

== Конфигурирование ASLauncher, версия 1.2 ==
Все настройки ASLauncher хранятся в файле aslauncher.ini, размещаемом в папке с исполняемыми файлами AgavaSCADA.
[General]
ProcessFile="G:/workspace/AgavaScada/bin-win/rtu.exe"
RestartProcessAt=00:02
Wallpaper="./GNOME-Shell.jpg"

== Конфигурирование ASLauncher, версия 1.5 ==

=== Описание конфигурационного файла и его параметров ===
Данный раздел описывает структуру и назначение конфигурационного файла формата <code>.ini</code>, используемого в нашем приложении. Этот файл содержит настройки для обоев рабочего стола и путей к лог-файлам приложения и связанных процессов.

==== Общая структура <code>.ini</code> файла ====
Файл <code>.ini</code> состоит из разделов и пар ключ-значение:

* '''Разделы''': обозначаются названием в квадратных скобках, например, <code>[General]</code>.
* '''Ключи и значения''': пары вида <code>Ключ=Значение</code>, определяющие настройку.

Образец общей структуры <code>.ini</code> файла:
[SectionName]
Key1=Value1
Key2=Value2

==== Описание ключей и значений <code>.ini</code> файла ====
Секция <code>[General]</code> содержит основные настройки приложения.

* Ключ <code>Wallpaper</code>
** '''Описание''': Задает путь к изображению, используемому в качестве обоев рабочего стола.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>Wallpaper=/home/user/Images/wallpaper.png</code>

* Ключ <code>ProcessErrorLogFile</code>
** '''Описание''': Указывает путь к файлу, в который записываются ошибки основного процесса приложения.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ProcessErrorLogFile=/var/log/rtu/rtu_process_error.log</code>

* Ключ <code>ProcessStandardLogFile</code>
** '''Описание''': Указывает путь к файлу, в который записывается стандартный вывод основного процесса приложения.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ProcessStandardLogFile=/var/log/rtu/rtu_process_standard.log</code>

* Ключ <code>ASLauncherLogsDir</code>
** '''Описание''': Задает директорию для хранения файлов логирования ASLauncher и приложений рабочего стола.
** '''Тип''': Директория.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ASLauncherLogsDir=/var/log/aslauncher</code>
* Ключ <code>DesktopEntriesDir</code>
** '''Описание''': Задает директорию, в которой хранятся файлы записей рабочих столов (Desktop Entries) в формате <code>.desktop</code>. Эти файлы используются для запуска приложений и отображения их в меню или на панели запуска.
** '''Тип''': Директория.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>DesktopEntriesDir=/usr/share/aslauncher</code>

==== Примечание ====

* Все описанные параметры, за исключением <code>Wallpaper</code>, являются обязательными и должны иметь корректные значения для запуска и штатной работы программы. Параметр <code>Wallpaper</code> является необязательным и в случае его отсутствия фон рабочего стола будет залит черным цветом.

* Убедитесь, что все указанные пути существуют и имеют соответствующие права доступа для чтения и записи.

* Используйте абсолютные пути для обеспечения корректной работы независимо от текущей директории.

=== Документация для <code>.desktop</code> файлов ===
Файлы с расширением <code>.desktop</code> используются для описания приложений и их поведения в системе. Они позволяют интегрировать приложения в графическую оболочку, определяя, как они отображаются на рабочем столе, какие иконки используют, и как запускаются.

==== Общая структура <code>.desktop</code> файла ====
Файл состоит из секции <code>[Desktop Entry]</code> и набора ключей с соответствующими значениями. Пример файла:
[Desktop Entry]
Name=MyApp
Process=/usr/bin/myapp
Arguments=--mode test
Icon=/usr/share/icons/myapp.png
Type=Application
AutoLaunch=true
AutoRestartOnCrash=true
User=myuser
PasswordPrompt=false

==== Примечания ====

* Для некоторых ключей используются значения типа 'Логическое значение'. Возможные варианты значений для данного типа: <code>true</code>, <code>True</code> или <code>1</code> — для истинных значений и <code>false</code>, <code>False</code> или <code>0</code> — для ложных.
* Ключи и значения чувствительны к регистру — убедитесь, что вы используете правильный регистр для каждого ключа.
* Убедитесь, что все указанные пути существуют и доступны для чтения/запуска.
* Если иконка не отображается, значит, по меньшей мере одна пара ключ-значение содержит ошибку. Чтобы исправить это, проверьте файлы логирования ASLauncher — информация, которая поможет выявить и исправить эту ошибку, будет отображена там.

==== Описание ключей и значений <code>.desktop</code> файла ====

# Ключ <code>Name</code>
#* '''Описание''': Отображаемое имя приложения в меню или панели запуска.
#* '''Формат''': Строка.
#* '''Пример значения''': <code>Name=MyApp</code>
# Ключ <code>Process</code>
#* '''Описание''': Путь к исполняемому файлу приложения.
#* '''Формат''': Абсолютный путь.
#* '''Пример значения''': <code>Process=/usr/bin/myapp</code>
# Ключ <code>Arguments</code>
#* '''Описание''': Аргументы командной строки, передаваемые приложению при запуске.
#* '''Формат''': Строка с аргументами, разделенными пробелами.
#* '''Пример значения''': <code>Arguments=--mode test --verbose</code>
# Ключ <code>Icon</code>
#* '''Описание''': Путь к файлу иконки или имя иконки из темы значков.
#* '''Формат''': Абсолютный путь.
#* '''Пример значения''': <code>Icon=/usr/share/icons/hicolor/48x48/apps/myapp.png</code>
# Ключ <code>Type</code>
#* '''Описание''': Тип записи, определяет, как система будет обрабатывать файл.
#* '''Возможные значения''': <code>Application</code> — исполняемое приложение.
#* '''Пример значения''': <code>Type=Application</code>
# Ключ <code>AutoLaunch</code>
#* '''Описание''': Указывает, должно ли приложение запускаться автоматически при входе пользователя в систему.
#* '''Формат''': Логическое значение.
#* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code>
#* '''Пример значения''': <code>AutoLaunch=true</code>
# Ключ <code>AutoRestartOnCrash</code>
#* '''Описание''': Определяет, будет ли приложение автоматически перезапущено в случае сбоя или аварийного завершения.
#* '''Формат''': Логическое значение.
#* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code>
#* '''Пример значения''': <code>AutoRestartOnCrash=true</code>
# Ключ <code>User</code>
#* '''Описание''': Имя пользователя, от имени которого должно запускаться приложение.
#* '''Формат''': Строка.
#* '''[Если] Параметр отсутствует''': Приложение запускается из-под пользователя <code>root</code>.
#* '''Пример значения''': <code>User=john_doe</code>
# Ключ <code>PasswordPrompt</code>
#* '''Описание''': Указывает, необходимо ли запрашивать пароль при запуске приложения.
#* '''Формат''': Имя пользователя, пароль аккаунта которого должен быть введён.
#* '''Возможные значения''': <code>default</code> — будет запрошен пароль <code>123asd890</code>.
#* '''[Если] Параметр отсутствует:''' Пароль не запрашивается.
#* '''Пример значения''': <code>PasswordPrompt=default</code>

[[Категория:AgavaSCADA/AgavaPLC]]

ASLauncher

2024-10-07T11:48:13Z

SharipovRR:

ASLauncher - менеджер рабочего стола AgavaSCADA.

ASLauncher предназначен для использования совместно со средой исполнения и позволяет заменить собой штатную оболочку Windows.

ASLauncher реализует следующие функции:

* автозапуск AgavaSCADA;
* замена рабочего стола Windows;
* программный сторожевой таймер.

== Автозапуск AgavaSCADA ==

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

* Запуск среды исполнения.
* Перезагрузка и выключение АРМ.
* Просмотр текущей даты и времени.
* Запуск штатной оболочки Windows.

== Конфигурирование ASLauncher ==
Все настройки ASLauncher хранятся в файле aslauncher.ini, размещаемом в папке с исполняемыми файлами AgavaSCADA.
[General]
ProcessFile="G:/workspace/AgavaScada/bin-win/rtu.exe"
RestartProcessAt=00:02
Wallpaper="./GNOME-Shell.jpg"

== Конфигурирование ASLauncher, версия 1.5 ==

=== Описание конфигурационного файла и его параметров ===
Данный раздел описывает структуру и назначение конфигурационного файла формата <code>.ini</code>, используемого в нашем приложении. Этот файл содержит настройки для обоев рабочего стола и путей к лог-файлам приложения и связанных процессов.

==== Общая структура <code>.ini</code> файла ====
Файл <code>.ini</code> состоит из разделов и пар ключ-значение:

* '''Разделы''': обозначаются названием в квадратных скобках, например, <code>[General]</code>.
* '''Ключи и значения''': пары вида <code>Ключ=Значение</code>, определяющие настройку.

Образец общей структуры <code>.ini</code> файла:
[SectionName]
Key1=Value1
Key2=Value2

==== Описание ключей и значений <code>.ini</code> файла ====
Секция <code>[General]</code> содержит основные настройки приложения.

* Ключ <code>Wallpaper</code>
** '''Описание''': Задает путь к изображению, используемому в качестве обоев рабочего стола.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>Wallpaper=/home/user/Images/wallpaper.png</code>

* Ключ <code>ProcessErrorLogFile</code>
** '''Описание''': Указывает путь к файлу, в который записываются ошибки основного процесса приложения.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ProcessErrorLogFile=/var/log/rtu/rtu_process_error.log</code>

* Ключ <code>ProcessStandardLogFile</code>
** '''Описание''': Указывает путь к файлу, в который записывается стандартный вывод основного процесса приложения.
** '''Тип''': Файл.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ProcessStandardLogFile=/var/log/rtu/rtu_process_standard.log</code>

* Ключ <code>ASLauncherLogsDir</code>
** '''Описание''': Задает директорию для хранения файлов логирования ASLauncher и приложений рабочего стола.
** '''Тип''': Директория.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>ASLauncherLogsDir=/var/log/aslauncher</code>
* Ключ <code>DesktopEntriesDir</code>
** '''Описание''': Задает директорию, в которой хранятся файлы записей рабочих столов (Desktop Entries) в формате <code>.desktop</code>. Эти файлы используются для запуска приложений и отображения их в меню или на панели запуска.
** '''Тип''': Директория.
** '''Формат''': Абсолютный путь.
** '''Пример значения''': <code>DesktopEntriesDir=/usr/share/aslauncher</code>

==== Примечание ====

* Все описанные параметры, за исключением <code>Wallpaper</code>, являются обязательными и должны иметь корректные значения для запуска и штатной работы программы. Параметр <code>Wallpaper</code> является необязательным и в случае его отсутствия фон рабочего стола будет залит черным цветом.

* Убедитесь, что все указанные пути существуют и имеют соответствующие права доступа для чтения и записи.

* Используйте абсолютные пути для обеспечения корректной работы независимо от текущей директории.

=== Документация для <code>.desktop</code> файлов ===
Файлы с расширением <code>.desktop</code> используются для описания приложений и их поведения в системе. Они позволяют интегрировать приложения в графическую оболочку, определяя, как они отображаются на рабочем столе, какие иконки используют, и как запускаются.

==== Общая структура <code>.desktop</code> файла ====
Файл состоит из секции <code>[Desktop Entry]</code> и набора ключей с соответствующими значениями. Пример файла:
[Desktop Entry]
Name=MyApp
Process=/usr/bin/myapp
Arguments=--mode test
Icon=/usr/share/icons/myapp.png
Type=Application
AutoLaunch=true
AutoRestartOnCrash=true
User=myuser
PasswordPrompt=false

==== Примечания ====

* Для некоторых ключей используются значения типа 'Логическое значение'. Возможные варианты значений для данного типа: <code>true</code>, <code>True</code> или <code>1</code> — для истинных значений и <code>false</code>, <code>False</code> или <code>0</code> — для ложных.
* Ключи и значения чувствительны к регистру — убедитесь, что вы используете правильный регистр для каждого ключа.
* Убедитесь, что все указанные пути существуют и доступны для чтения/запуска.
* Если иконка не отображается, значит, по меньшей мере одна пара ключ-значение содержит ошибку. Чтобы исправить это, проверьте файлы логирования ASLauncher — информация, которая поможет выявить и исправить эту ошибку, будет отображена там.

==== Описание ключей и значений <code>.desktop</code> файла ====

# Ключ <code>Name</code>
#* '''Описание''': Отображаемое имя приложения в меню или панели запуска.
#* '''Формат''': Строка.
#* '''Пример значения''': <code>Name=MyApp</code>
# Ключ <code>Process</code>
#* '''Описание''': Путь к исполняемому файлу приложения.
#* '''Формат''': Абсолютный путь.
#* '''Пример значения''': <code>Process=/usr/bin/myapp</code>
# Ключ <code>Arguments</code>
#* '''Описание''': Аргументы командной строки, передаваемые приложению при запуске.
#* '''Формат''': Строка с аргументами, разделенными пробелами.
#* '''Пример значения''': <code>Arguments=--mode test --verbose</code>
# Ключ <code>Icon</code>
#* '''Описание''': Путь к файлу иконки или имя иконки из темы значков.
#* '''Формат''': Абсолютный путь.
#* '''Пример значения''': <code>Icon=/usr/share/icons/hicolor/48x48/apps/myapp.png</code>
# Ключ <code>Type</code>
#* '''Описание''': Тип записи, определяет, как система будет обрабатывать файл.
#* '''Возможные значения''': <code>Application</code> — исполняемое приложение.
#* '''Пример значения''': <code>Type=Application</code>
# Ключ <code>AutoLaunch</code>
#* '''Описание''': Указывает, должно ли приложение запускаться автоматически при входе пользователя в систему.
#* '''Формат''': Логическое значение.
#* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code>
#* '''Пример значения''': <code>AutoLaunch=true</code>
# Ключ <code>AutoRestartOnCrash</code>
#* '''Описание''': Определяет, будет ли приложение автоматически перезапущено в случае сбоя или аварийного завершения.
#* '''Формат''': Логическое значение.
#* '''[Если] Параметр отсутствует''': Значение по умолчанию — <code>false</code>
#* '''Пример значения''': <code>AutoRestartOnCrash=true</code>
# Ключ <code>User</code>
#* '''Описание''': Имя пользователя, от имени которого должно запускаться приложение.
#* '''Формат''': Строка.
#* '''[Если] Параметр отсутствует''': Приложение запускается из-под пользователя <code>root</code>.
#* '''Пример значения''': <code>User=john_doe</code>
# Ключ <code>PasswordPrompt</code>
#* '''Описание''': Указывает, необходимо ли запрашивать пароль при запуске приложения.
#* '''Формат''': Имя пользователя, пароль аккаунта которого должен быть введён.
#* '''Возможные значения''': <code>default</code> — будет запрошен пароль <code>123asd890</code>.
#* '''[Если] Параметр отсутствует:''' Пароль не запрашивается.
#* '''Пример значения''': <code>PasswordPrompt=default</code>

[[Категория:AgavaSCADA/AgavaPLC]]