Просмотр кода страницы Дополнительные примитивы






== Введение ==

Начиная с версии 2.0.6 в программе АСУД.SCADA доступен ряд дополнительных примитивов (далее просто Примитивы).

'''Внимание!'''&nbsp;<br/> При размещении на карте большого количества доп. примитивов вам может потребоваться внести изменения в реестр windows&nbsp;<br/> в противном случае программа может на запускаться или завершаться с ошибкой при создании нового примитива(ов)<br/> Следует изменить значение ключей&nbsp;реестра&nbsp;
<pre>HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Windows\GDIProcessHandleQuota
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Windows\USERProcessHandleQuota</pre>

изменив значение по-умолчанию 10000 на 20000 (или 30000), и перезапустив&nbsp;АРМ.

С '''версии 2.3.9 сняты все ограничения''' в работе Дополнительных примитивов.

В предыдущих версиях существуют некоторые особенности (ограничениями в работе).

Ограничения в работе в версиях SCADA до 2.3.9:

*Не работает групповое выделение нескольких объектов путем выбора прямоугольной области мышкой. 
*Не работает трансформация объекта 
*В случае если примитив оказался вне видимой области экрана, Scada может его "потерять" 
*Не следует выделять "дополнительный" примитив одновременно со "стандартным" примитивом. 
*Плохо обрабатывается Scroll окна. Перед переключением в рабочий режим следует передвинуть scroll в левый верхний угол. 

Работает функционал:

*Одиночной настройки примитива 
*Копирования по Ctrl + движение мышкой 
*Копирование через главное меню между подвидами путем выбора объекта 
*Копирование нескольких объектов через главное меню, путем их последовательного выбора с нажатым Ctrl 
*Групповое позиционирование примитивов (по левому краю, по правому краю и т.п.) 

[[File:Addprimcopy.PNG|frameless|center|350px|Addprimcopy.PNG]]

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

Если свойства примитива не отображаются или отображаются некорректно, выполните клик на пустом месте карты , затем повторный клик на примитиве.

Shift + левый клик на выделенном примитиве открывает окно выбора тэга.&nbsp;

== База данных&nbsp; ==

Примитивы, позволяющие быстро визуализировать информацию из учетной БД original.gdb

&nbsp;

=== Информация о подключении к БД ===

Примитивы работают с БД напрямую и не требуют предварительной настройки Tekon OPC-сервера.&nbsp;

&nbsp;По умолчанию предполагается, что БД находится в папке с ОРС-сервером на '''локальной машине'''.

Если вам необходимо подключаться к БД, находящейся на удаленной машине и/или в другой папке,&nbsp; следует отредактировать файл ..\Scada\settings\tprim.conf и перезапустить SCADA.

Файл tprim.conf:

*DBIP - IP-адрес машины, на которой располагается БД. Если БД находится на локальной машине - оставить пустым. 
*DBPath - путь к файлу БД. По умолчанию, считается что БД находится в папке C:\1Tekon\ASUD Scada\OPC Server\origina.gdb 

'''Внимание!''' Если вы подключаетесь к БД на удаленной машине, предоставлять общий доступ к папке с БД на ней - '''нет необходимости'''.

В параметре DBPath символ \ следует указывать, как \\

Например: подключаться к БД на ПК 192.168.1.11, путь к файлу на удаленной машине&nbsp;C:\1Tekon\ASUD Scada\OPC Server\origina.gdb

Файл tprim.conf:
<pre>{
 "BadStatusDay": 2,
 "DBPath": "",
 "DBIP": "192.168.1.11"
}</pre>

Подключаться к БД на ПК 192.168.1.10, путь к файлу на удаленной машине&nbsp;C:\db\original.gdb

Файл tprim.conf:
<pre>{
 "BadStatusDay": 2,
 "DBPath": "C:\\db\\original.gdb",
 "DBIP": "192.168.1.10"
}</pre>

Если при подключении к БД возникнут&nbsp;проблемы, информация об этом будет отображена на Splash-скрине в момент запуска SCADA.

=== Сводный отчет ===

 Доступен с версии АСУД.SCADA 2.3.1

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

[[File:Db sv rep1.PNG|thumb|center|450px|Пример отображения данных]]

&nbsp;

Не требуется предварительная настройка ОРС-сервера. Примитив работает напрямую с локальной учетной БД ..\OPC Server\original.gdb

Дополнительно позволяет:

*отобразить статус опроса приборов учета 
*выполнить преобразовать единиц измерений 

Отображаются:

*Кварт. - номер квартиры (не отображается при указании в настройках диапазона квартир с 0 по 0) 
*Набор параметров измеряемых прибором учета 
*Дата - время последнего обмена данными с прибором учета 

Дополнительно могут быть отображены:

*Марка прибора учета 
*Серийный номер прибора учета 
*Комментарий - комментарий при регистрации в программе ASUDBase. 

Период обновления информации в рабочем режиме - не чаще 1 раза в минуту.

После размещения примитива на карте следует выполнить предварительные настройки (в окне свойств примитива):

*ID дома - идентификатор дома. Выбирается путем нажатия на кнопку "..." 
*Ресурс - тип учитываемого ресурса (ХВС, ГВС, Отопление, Электроэнергия) 
*ID параметра - идентификатор параметра в ASUDBase (или нескольких параметров через ";") 
*Название - название параметра (или нескольких параметров через ";") - отображается в шапке таблицы 
*Множитель - необязательный параметр. Коэффициент преобразования для параметра. Например, можно перевести кВт*ч из БД в ГКал. 
*Квартира с - отображать начиная с квартиры. При указании значения 0 будут отображаться данные общедомовых приборов учета. 
*Квартира по - отображать до квартиры 
*Название прибора - отображать ли столбец с типом прибора 
*Серийный номер - отображать ли столбец с идентификационным номером 
*Комментарий - отображать ли столбец комментарий 

'''Внимание!''' Следует всегда отображать столбец ''Серийный номер'', если:

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

Синий восклицательный знак отображается на примитиве если:

*отсутствует подключение к БД ..OPC Server \ original.gdb или отсутствует файл БД. 
*произошла ошибка при выполнении запроса к БД 
*настройки примитива (параметры поиска) выдают нулевой результат запроса (в БД нет данных). 

Для рисунка выше значения настроек могут быть следующими:

*ID дома - 1 
*Ресурс - Отопление 
*ID параметра - 11054; 11001 
*Название - W (ГКал);V (куб. м) 
*Множитель - 0,00086;1 
*Квартира с - 2 
*Квартира по - 11 
*Название прибора - Нет 
*Серийный номер - Нет 
*Комментарий - Нет 

Вы можете отображать в сводном отчете один или несколько параметров приборов учета.

Идентификаторы параметров следует посмотреть в программе ASUDBase, выбрав в Шаг 2 один из приборов, которые будут отображены в сводном отчете. Далее во вкладке Мгн. слева навести мышку в левую часть названия столбца Параметр и потянуть вправо. Откроется столбец PARAM с кодами параметров.

[[File:Db sv rep4.PNG|thumb|center|650px|Пример отображения данных]]

В общем случае сводный отчет имеет смысл строить по мгновенным (текущим) параметрам: вкладка Мгн., однако можно выбрать и другие вкладки. Не следует в одном отчете использовать идентификаторы параметров из разных вкладок Мгн, Час, Сут, Мес.

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

Поле Дата будет окрашено в СИНИЙ цвет в случае, если:

*оценка (параметр CODE во вкладке Мгн. программы ASUDBase) опрашиваемого прибора учета равна 0 (с прибором нет связи) 
*у прибора отсутствует понятие оценки (приборы учета, подключенные через TL-концентраторы КЦС, КЦС-М) и последние данные с прибора учета были получены более 2-х суток назад. 

Пример отображения данных счетчиков ГВС мест общего пользования [[File:Db sv rep2.PNG|thumb|center|550px|Пример отображения данных]]

Пример отображения данных общедомовых приборов учета Отопления [[File:Db sv rep3.PNG|thumb|center|550px|Пример отображения данных]]

&nbsp;

&nbsp;


=== Прибор учета ===

  '''Обновления:'''
 &nbsp;'''02-10-2019'''
 &nbsp;* добавлена возможность указать ID вручную
 &nbsp;21-08-2019
 &nbsp;* добавлена возможность не отображать указанные ParamID
 &nbsp;* исправлена перерисовка примитива в процессе перемещения в режиме настройки
  29-03-2018
  * исправлена реакция на настройку отображать <> 0
  16-11-2018
  * Отображение столбца Ед.изм только в случае необходимости
  * Оптимизация перерисовки примитива
  * Поддержка [[Скрипты|LUA-функций]]
  * Поддержка [[Text-функция|Text-функций]]

Позволяет в несколько кликов отобразить текущие значения выбранного устройства (аналог окна Шаг 2 в программе ASUDBase):

*общедомового прибора учета 
*контроллера Modbus, SNMP и т.п. с поддержкой [[Скрипты|LUA-скрипт]], [[Text-функция|Text-функций]] 

<gallery>
Db_pu_rep1.PNG|Отображение данных Прибор учета
Db_pu_rep1_1.JPG|Отображение данных Modbus-устройства
Файл:Db_pu_rep3.PNG|Отображение данных с границами
</gallery>

Ключевое преимущество - '''не требуется''' предварительная настройка ОРС-сервера. Примитив работает напрямую с локальной учетной БД ..\OPC Server\original.gdb

Дополнительно позволяет:

*отобразить статус опроса прибора учета 
*отобразить выход значений параметров за границы допустимых значений 

Период обновления информации в рабочем режиме - не чаще 1 раза в 10 секунд.

Синий восклицательный знак отображается на примитиве если:

*отсутствует подключение к БД ..OPC Server \ original.gdb или отсутствует файл БД. 
*произошла ошибка при выполнении запроса к БД 

После размещения примитива на карте следует выполнить предварительные настройки (в окне свойств примитива):

*ID прибора - идентификатор прибора учета в ASUDBase. Выбирается путем нажатия на кнопку "..." 
*Только <> 0 - отображать только не нулевые значения 
*[[Скрипты|Lua-функция]] - позволяет указать функцию замены значения выбранного параметра на строку - может применяться, например при отображении данных Modbus-устройства 
*[[Text-функция|Text-функция]] - выполняет действия аналогично Lua-функция 
*ParamID - временно отобразить идентификаторы параметров. Идентификаторы необходимы для настройки Lua (Text) - функций 
*Игнорировать - не отображать данные указанных ParamID 
*Ширина Значение - установить вручную ширину поля Значение. Следует указывать при использовании Lua (Text) - функций 

'''Замечание!&nbsp;'''В окне выбора ID-прибора отображаются только общедомовые приборы учета (квартира = 0), зарегистрированные в ASUDBase до момента старта SCADA. В случае необходимости отображения данных квартирного прибора учета, следует ввести ID самостоятельно, посмотрев его в программе ASUDBase (окно Шаг2 с введенным паролем, выбрав прибор учета).

[[Text-функция|Text-функции]] удобно применять, когда необходима простая замена вида "Параметр = Значение".

Если необходима побитовая операция или любое другое сложное преобразование исходного значения, следует применять [[Скрипты|Lua]].

Пример настройки параметр Lua-функции (Теxt-функция настраивается аналогично)
<pre><nowiki> 10061=lua1 </nowiki>
</pre>

Указываются идентификатор Параметра и функция.

Пример Lua-фунции
<pre><nowiki> function lua1 (val)
local RegToStr=
{
[0]="Зима",
[1]="Лето"
}
local s = RegToStr [val]
if s == nil 
&nbsp;  then return "Неизвестно: "..val
   else return "Режим: "..s 
end 
end</nowiki></pre>

Пример аналогичной Text-функции, файл text1.txt
<pre><nowiki> 0=Зима </nowiki>
<nowiki> 1=Лето </nowiki></pre>

[[File:Db pu rep2.PNG|thumb|center|450px|Окно выбора прибора учета]]

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

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

Поле Дата будет окрашено в СИНИЙ цвет в случае, если:

*оценка (параметр CODE во вкладке Мгн. программы ASUDBase) опрашиваемого прибора учета равна 0 (с прибором нет связи) 
*у прибора отсутствует понятие оценки (приборы учета, подключенные через TL-концентраторы КЦС, КЦС-М) и последние данные с прибора учета были получены более 2-х суток назад. 

Если для параметра в программе ASUDBase были указаны граничные значения (в окне Шаг 2, выбрать параметр, нажать правую кнопку мыши и выбрать Границы), то поле Значение может быть окрашено, в случае выхода параметра за границы указанного диапазона.

Если примитив отображает данные&nbsp;[[КИР-16_исп._TL-RS|КИР-16 исп. TL-RS]], подключенный по RS-интерфейсу, то вы можете использовать следующие [[Text-функция|Text-функции]] для отображения параметров:

*Err32 - ошибка устройства 
*АКБ - состояние аккумулятора 

Пример функции для Err32
<pre># BITSTR(, )
0=Норма
1=Корпус открыт
3=Неиспр.АКБ
4=Нет питания</pre>

Пример функции для АКБ
<pre>0=Норма
1=Отсутствует
3=Замкнут
4=Заряжается
7=Питание от АКБ
</pre>

=== 3-х фазный электросчетчик ===

 '''Обновления'''
 02-10-2019
 * возможность указать ID прибора вручную 
 Доступен в обновлении от 17.06.2017 АСУД.SCADA 2.3.1, 2.3.4

Позволяет в несколько кликов отобразить некоторые текущие значения выбранного 3-х фазного электросчетчика.

[[File:3f ele.JPG|thumb|center|450px|Пример отображения данных]]

Не требуется предварительная настройка ОРС-сервера. Примитив работает напрямую с локальной учетной БД ..\OPC Server\original.gdb

Дополнительно позволяет:

*отобразить статус опроса прибора учета 
*отобразить выход значений параметров за границы допустимых значений 

Период обновления информации в рабочем режиме - не чаще 1 раза в минуту.

Синий восклицательный знак отображается на примитиве если:

*примитив не настроен 
*отсутствует подключение к БД ..OPC Server \ original.gdb или отсутствует файл БД. 
*произошла ошибка при выполнении запроса к БД 
*оценка опроса прибора = 0 
*у прибора отсутствует понятие оценки (приборы учета, подключенные через TL-концентраторы КЦС, КЦС-М) и последние данные с прибора учета были получены более 2-х суток назад. 

После размещения примитива на карте следует выполнить предварительные настройки (в окне свойств примитива):

*ID прибора - идентификатор 3-х фазный электросчетчика в ASUDBase. Выбирается путем нажатия на кнопку "..." (см. примитив Прибор учета). 

'''Замечание!&nbsp;'''В окне выбора ID-прибора отображаются только общедомовые приборы учета (квартира = 0), зарегистрированные в ASUDBase до момента старта SCADA. В случае необходимости отображения данных квартирного прибора учета, следует ввести ID самостоятельно, посмотрев его в программе ASUDBase (окно Шаг2 с введенным паролем, выбрав прибор учета).

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

Если для параметра в программе ASUDBase были указаны граничные значения (в окне Шаг 2, выбрать параметр, нажать правую кнопку мыши и выбрать Границы), то поле Значение может быть окрашено, в случае выхода параметра за границы указанного диапазона.

В правом нижнем углу таблицы отображается время последнего опроса электросчетчика.

Параметр Коэфф.мощности рассчитывается как отношение Активной и Полной мощностей.

&nbsp;

=== Векторная диаграмма токов и напряжений ===

  '''Обновления'''
 &nbsp;02-10-2019
 &nbsp;* возможность указать ID прибора вручную

Позволяет в несколько кликов отобразить векторную диаграмму выбранного 3-х фазного электросчетчика.

[[File:3f diagram.JPG|thumb|center|450px|Пример отображения данных]]

Не требуется предварительная настройка ОРС-сервера. Примитив работает напрямую с локальной учетной БД ..\OPC Server\original.gdb

Дополнительно позволяет:

*отобразить статус опроса прибора учета 

Период обновления информации в рабочем режиме - не чаще 1 раза в минуту.

Синий восклицательный знак отображается на примитиве если:

*примитив не настроен 
*отсутствует подключение к БД ..OPC Server \ original.gdb или отсутствует файл БД. 
*произошла ошибка при выполнении запроса к БД 
*оценка опроса прибора = 0 
*у прибора отсутствует понятие оценки (приборы учета, подключенные через TL-концентраторы КЦС, КЦС-М) и последние данные с прибора учета были получены более 2-х суток назад. 

После размещения примитива на карте следует выполнить предварительные настройки (в окне свойств примитива):

*ID прибора - идентификатор 3-х фазный электросчетчика в ASUDBase. Выбирается путем нажатия на кнопку "..." (см. примитив Прибор учета). 
*Тип диаграммы 
**dtUI - диаграмма токов и напряжений 
**dtS - вектор полной мощности   
*Толщина линий - толщина линий стрелок 
*Толщина окружности - толщина окружности (0 - не отображать окружность) 
*Надпись - отображать ли надписи 
*Цвет фона - цвет заливки фона 

'''Замечание!&nbsp;'''В окне выбора ID-прибора отображаются только общедомовые приборы учета (квартира = 0), зарегистрированные в ASUDBase до момента старта SCADA. В случае необходимости отображения данных квартирного прибора учета, следует ввести ID самостоятельно, посмотрев его в программе ASUDBase (окно Шаг2 с введенным паролем, выбрав прибор учета).

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

== Компьютерная сеть&nbsp; ==

Примитивы, получающие информацию от устройств (сервисов) по компьютерной сети.&nbsp;

=== Отображение данных с IP-камер ===

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

Подробнее о настройке см. [http://wiki.tekon.ru/index.php/IP-камеры_(VLC-плагин) здесь]

&nbsp;

=== Состояние IP-устройств (КИО / КУН-IP) ===

 Доступен с версии АСУД.SCADA 2.3.8

Позволяет для устройств [[КУН-IP|КУН-IP]], [[КИО|КИО]]:

*визуализировать состояние доступности по сети: есть пинг, нет пинга; 
*схему питания: Основное, ИБП. 

[[File:Kio kun.JPG|center|350px|Kio kun.JPG]]

Начиная с версии 2.5.2 примитив выглядит следующим образом&nbsp;

[[File:Kio kun2.PNG|center|Kio kun2.PNG]]Вы можете вернуть предыдущий вариант отображения данных, указав 1&nbsp;в файле \settings\tprim.conf
<pre> "KIOInfoOldStyle": 1,</pre>

Удобно использовать при большем числе [[КУН-IP|КУН-IP]], [[КИО|КИО]] в системе.

Примитив имеет смысл располагать на главном виде SCADA.

 '''Внимание!''' 
 Следует отметить, что учитываются только те КУН-IP, КИО ОРС-сервера, сигналы которых визуализируются на данном АРМ.
 Т.е. на карте размещен примитив связанный с тегом:
 * для КИО - канал переговорной связи
 * для КУН-IP - канал переговорной связи или статус.

На примитиве отображается:

*Общее число визуализируемых [[КУН-IP|КУН-IP]] или [[КИО|КИО]]. 
*Красный - число устройств не доступных по сети (нет ответа на Ping-запрос) 
*Желтый - число устройств в режиме питания от ИБП 
*Зеленый - число устройств в нормальном режиме работы 

При нажатии на примитив в рабочем режиме открывается окно, в котором в табличной форме отображается состояние подключенных [[КУН-IP|КУН-IP]] или [[КИО|КИО]].

'''Настройка примитива'''

Просто разместите примитив на карте, укажите тип источника данных: КИО или КУН-IP.




=== HTML-страница ===

 Обновлние: 
 08-05-2024
 * по-умолчанию не выполнять обновление страницы
 07-05-2019
 * исправлена невозможность перетащить примитив в 2.4.х
 * добавлена возможность отключить Scroll

Позволяет отобразить WEB (HTML) страницу.

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

Данный примитив реализован на устаревшем IE-движке и в настоящее время зачастую не всегда способен&nbsp;корректно отображать WEB-контент.<br/> По-этому, если страница отображется некорректно, следует использовать примитив WebView.

Настройки примитива:

*URL - адрес отображаемой страницы 
*Период - период обновления страницы в секундах, по-умолчанию 0 (не&nbsp;обновлять)<br/> Период обновления следует указывать только для страниц, которые не выполняет обновление самостоятельно. 
*Scroll - отображать ли Scroll для web-страницы


=== WEBView ===

 Обновление:
 03-09-2024 
 * возможность игнорирования ошибки SSL-сертификата сайта
 08-05-2024
 * первая реализация

Позволяет отобразить WEB (HTML) страницу.

В отличие от примитива HTML-страница, позволяет корректно отображать сложный WEB-контент.

Поддержка примитива реализована в ОС Windows 10 и выше (для предыдущих версий Windows вы можете попробовать использовать примитив HTML-страница).

Привитив реализован на базе[https://developer.microsoft.com/ru-ru/microsoft-edge/webview2/?form=MA13LH#download Microsoft Edge WebView2].

Модуль не входит в базовый набор компонент SCADA. Следует скопировать из папки&nbsp; .. \ Scada \ modules_addon&nbsp; или [https://www.tekon.ru/software/2715 загрузить] файлы:

*&nbsp;webview.psm 
*WebView2Loader.dll&nbsp; 

в папку&nbsp; .. \ Scada \ modules

Поддержка WebView2 по-умолчанию присутствует в Windows 11 и выше, для Windows 10 следует предварительно загрузить и установить среду выполнения [https://developer.microsoft.com/ru-ru/microsoft-edge/webview2/?form=MA13LH#download WebView2]<br/> (выполните загрузку и установку&nbsp;актуальной х86 - версии,&nbsp;<br/> дополнительно, возможно,&nbsp;необходимо будет добавить разрешающее правило в брандмауэре Windows для исходящих подключений программы msedgewebview2.exe)&nbsp;

После запуска SCADA разместите примитив на выбранном виде карте.

[[File:Webview prim.PNG|center|Webview prim.PNG]]

Следует отметить, что примитив отображает WEB-страницу&nbsp; только в рабочем режиме. В режиме настройки отображается пустое окно.

Настройки примитива:

*URL - адрес отображаемой страницы 
*Период - период принудительного обновления страницы в секундах, по-умолчанию 0 (не обновлять)<br/> Период обновления следует указывать только для страниц, которые не выполняет обновление самостоятельно.

== Общие ==


=== График ===

Позволяет в графической форме контролировать изменение состояния от 1 до 3 величин.

[[File:Prim graphic.PNG|center|Примитив график]]

Общие настройки примитива:

*Заголовок - наименование графика 
*Цвет фона - цвет фона 
*Дискрет.(мин.) - дискретизация в минутах. При указании дискретизации = 0, новое значение добавляется на графике сразу после обновления. В противном случае добавляется одно среднее значение величины с указанной частой дискретизации. 
*Интервал (ч.) - число отображаемых часов назад с текущего момента на графике. Точки выходящие за указанный интервал будут автоматически удалены с графика. 
*Число графиков - 3 (значение не изменяется). 

Настройки для каждого графика:

*Тэг - тэг контролируемого параметра (обычно какого-то цифрового значения). 
*Цвет - цвет линии графика (не следует использовать серый цвет). 

При нажатии на график правой кнопкой мыши доступно контекстное меню:

*Метки - отображение меток на точках графика 
*Сохранить - сохранить точки графика в файл на диске. 

В случае если при обновлении значения ОРС_статус <> OPC_Quality_good (потеря связи с устройством) цвет соответствующей линии станет серым.

При завершении работы программы SCADA текущие точки графиков будут сохранены в tmp файле в папке ..\Scada\settings и восстановлены впоследствии при старте программы.

=== Анимированные изображения ===

SCADA поддерживает отображение анимированных изображений с помощью примитивов:

*Изображение 
*Набор изображений 

Поддерживается работа с GIF-анимацией.

Для работы с анимированными SVG файлами, выполните их предварительное преобразование в формат GIF с помощью утилиты&nbsp;[[Svg2Gif.EXE|Svg2Gif.EXE]]

=== Изображение ===
<pre>Обновления: 
15-12-2023
* Возможность указать состояние для анимированных GIF 
07-06-2022
* GIF-анимация
01-09-2021
* функция мерцания
01-12-2020
* примитив существенно обновлен
21-08-2019
* отслеживание изменений в коде Text-фунции (без необходимости перезапуска SCADA)
</pre>

В АСУД.SCADA 2.6.4 данный примитив был существенно переработан.<br/> Для предыдущих версий SCADA описание&nbsp; смотри&nbsp; [http://wiki.tekon.ru/index.php?title=Дополнительные_примитивы&oldid=7183#.D0.98.D0.B7.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D0.B5 здесь].&nbsp;

В версии 2.6.4 функционал примитива был разделен на два примитива:

*'''Изображение&nbsp; &nbsp;'''-&nbsp;&nbsp;отображает одно изображение, как классические примитивы АСУД.SCADA 
*'''Набор изображений''' - отображает то или иное изображение, в зависимости от значения входного сигнала. 

Примитив Изображение - отображает выбранную картинку с поддержкой механизма уведомлений.&nbsp;<br/> Т.е. фактически может работать так же, как и классический примитив из раздела Стандартные в SCADA.&nbsp;

Примитив позволяет выполнить привязку к:&nbsp;

*обычному дискретному сигналу 
**Норма:&nbsp;младший бит значения равен 0 
**Сигнал:&nbsp;иначе   
*числовому сигналу, при этом: 
**Норма:&nbsp;значение = 0 
**Сигнал:&nbsp;значение <> 0   

'''Внимание!'''<br/> Примитив не умеет работать с битовыми масками. Если вам нужно анализировать состояние второго или&nbsp;более страших бит, следует воспользоваться примитивами

*Набор изображений&nbsp; 
*LED-индикатор 

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

[[File:Scadasimplepic.PNG|center|Scadasimplepic.PNG]]

Поддерживаемые форматы изображений:

*JPG 
*PNG 
*BMP 
*GIF (статичный, анимированный) 
**до версии 2.7.15 анимированный GIF 
***неподвижен в состоянии сигнала - Норма 
***подвижен (анимация включена) - в состоянии сигнала - Авария, Ознакомлен   
**с версии 2.7.15 вы можете указать, в каком случае должна быть активна анимация&nbsp;   
*WMF 
*EMF 
*TIFF 
*[[Замечание_по_SVG_файлам|SVG]] 

Вы можете использовать предустановленные файлы изображений из папки ..\Scada\Images или использовать свои файлы изображений, скопированные на АРМ-диспетчера.

В процессе настройки примитива, используемые файлы изображений будут скопированы в папку&nbsp;'''..\Scada\settings\Images'''

В папке&nbsp;&nbsp;'''..\Scada\settings\Images&nbsp;'''допускается создавать вложенные папки.

Примитив способен отображать изображения любого размера.<br/> Однако по умолчанию его размер соответствует размеру классического примитива SCADA (ПГУ, Канал управления и т.п.), при этом размер изображения составляет 80 px. Поэтому, для соответствия размеров примитивов и наилучшему отображению изображений используйте:

*либо файлы SVG формата, 
*либо картинки разрешением 76 на 76&nbsp;пикселей.&nbsp;&nbsp; 

Если соответствие классическим примитивам не нужно - используйте любой размер изображения.

Рассмотрим настройки примитива.

{{:DopPrimBaseSettings}} {{:DopPrimBaseNotification}}

'''Дополнительные настройки:'''

*Погасить восклицательный знак&nbsp; - (''по умолчанию Нет'')&nbsp; не будет отображаться состояние авария/обработка на примитиве<br/> Может быть актуально для GIF-анимации<br/> Внимание! При этом должна&nbsp;быть включена настройка Автоподтверждение 
*ОЖ событие Сигнал&nbsp; - (''по умолчанию Нет'') отображать&nbsp;в оперативном журнале сообщение Сигнал вместо Авария. 
*Скрыть фон - (''по умолчанию Нет'') отображать фон примитива&nbsp; 
*Надпись - (''по умолчанию Нет'') &nbsp;отображать ли название неисправности на примитиве 
**В текущей версии надпись корректно отображается для примитивов на одноцветном&nbsp;фоне.<br/> Если фон не одноцветный - используете дополнительно примитив Надпись.   
*Изображение - файл изображения 
**Выберите файл из&nbsp;&nbsp;'''..\Scada\settings\Images&nbsp;'''или любой другой папки (после выбора файл будет автоматически скопирован в&nbsp;'''&nbsp;'''..\Scada\settings\Images)   
*Анимация GIF в норме - (по умолчанию Да) - анимация активна, когда сигнал находится в состоянии&nbsp;Норма. 
*Исходный размер - в случае выбора примитив будет оптимизирован под исходный размер изображения (для svg-изображений никаких действий произведено не будет) 
*Цвет фона - цвет фона определяется автоматически при создании изображения. Для наилучшего отображения картинки'''настройка должна всегда соответствовать''' цвету фона карты. Если вы меняете цвет фона подложки - по необходимости измените цвет фона изображения. 
*&nbsp;Прозрачность -&nbsp;режим прозрачности. Это дополнительная настройка изменять ее почти никогда не следует.&nbsp; 
**sptDefault (''по умолчанию'') - базовый режим&nbsp; 
**sptRectangle - изображение обрабатывается как прямоугольник   
*Прозрачность (цвет) - прозрачный цвет в изображении (в режиме прозрачности&nbsp;sptDefault). 
**Черный (по умолчанию) - почти всегда следует указывать черный.<br/> Если в изображении присутствует "рабочий" черный цвет, измените настройку.   
*Мерцание - примитив в сигнальном состоянии будет скрывать / отображать фон&nbsp;&nbsp;


=== Набор изображений ===
<pre>История версий:
15-12-2023
* Возможность указать состояние для анимированных GIF
2.7.6
* корректировка и проверка поведения примитива в различных режимах
* GIF-анимация
* Поддержка работы с битовыми масками (аналогично LED)
2.6.6
* возможность записи значений
Доступен с верии 2.6.4</pre>

Примитив отображает то или иное изображение, в зависимости от значения входного&nbsp;сигнала.

Примитив более универсален чем примитив Изображение,&nbsp;однако, чуть более сложный в плане настройки.

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

*Состояния контролируемого устройства или процесса, когда значение связанного числового Item определяет одно из его возможный состояний.<br/> Например: 
**0 - останов,&nbsp; 
**1 - тихий ход, 
**2 - 50&nbsp;% мощности, 
**3 - полная мощность.<br/> Или 
**0 - норма, 
**1 - авария 1, 
**2 - авария 2 и т.п.   
*Состояния с возможностью переключения режимов по нажатию на примитив.<br/> Например: переключиться из режима Пуск в Стоп и обратно. 
*Числового значения являющегося битовой маской состояний 
*Дискретного сигнала<br/> Отобразить разные картинки в состояниях Авария / Норма 
*Канала управления 

[[File:Scadamorepic.PNG|center|Scadamorepic.PNG]]Поддерживаемые форматы изображений:

*JPG 
*PNG 
*BMP 
*GIF (статичный, анимированный) 
**до версии 2.7.15 анимированный GIF 
***неподвижен в состоянии сигнала - Норма 
***подвижен (анимация включена) - в состоянии сигнала - Авария, Ознакомлен   
**с версии 2.7.15 вы можете указать, в каком случае должна быть активна анимация&nbsp;   
*WMF 
*EMF 
*TIFF 
*[[Замечание_по_SVG_файлам|SVG]] 

Вы можете использовать предустановленные файлы изображений из папки'''..\Scada\Images''' или использовать свои файлы изображений, перенеся их предварительно в&nbsp;папку&nbsp;'''..\Scada\settings\Images'''.

В папке&nbsp;&nbsp;'''..\Scada\settings\Images&nbsp;'''допускается создавать вложенные папки.

Примитив способен отображать изображения любого размера.<br/> Однако по умолчанию его размер соответствует размеру классического примитива SCADA (ПГУ, Канал управления и т.п.), при этом размер изображения составляет 76 px. Поэтому, для соответствия размеру классических&nbsp;примитивов и наилучшему отображению изображений используйте:

*либо файлы SVG формата, 
*либо картинки разрешением 76 на 76&nbsp;пикселей.&nbsp;&nbsp; 

Если соответствие размерам классическим примитивам не нужно - используйте любой размер изображения.<br/> Однако следует придерживаться правила, что все изображения одного примитива должны иметь одинаковый исходный размер (данное замечаение не относится к SVG-изображениям).

Отображаемые изображения задаются через [[Text-функция|Text-функцию]] или через [[Скрипты|LUA-функцию]].

Рассмотрим настройки примитива.

{{:DopPrimBaseSettings}} {{:DopPrimBaseNotification}}

'''Дополнительные настройки:'''

*Погасить восклицательный знак&nbsp; - (''по умолчанию Нет'')&nbsp; не будет отображаться состояние авария/обработка на примитиве<br/> Может быть актуально для GIF-анимации<br/> Внимание! При этом должна&nbsp;быть включена настройка Автоподтверждение 
*ОЖ событие Сигнал&nbsp; - (''по умолчанию Нет'') отображать&nbsp;в оперативном журнале сообщение Сигнал вместо Авария. 
*Иконка - (''по умолчанию Пусто'') отображать указанную иконку в облаке уведомления.<br/> Если не указано, то в качестве иконки уведомления будет использовано изображение (сигнальное),&nbsp;отбображаемое на примитиве в настоящий момент.<br/> В некоторых случаях, например, когда примитив отображает&nbsp;большие картинки (соответствующие тому или иному состоянию контролируемого устройства)&nbsp;может быть удобно, чтобы в облаке&nbsp;уведомлений отображалось только одно определенное изображение - тогда следует указать это изображение в данной настройке. 
*Скрыть фон - (''по умолчанию Нет'') отображать фон примитива&nbsp; 
*Надпись - (''по умолчанию Нет'') &nbsp;отображать ли название неисправности на примитиве 
**В текущей версии надпись корректно отображается для примитивов на одноцветном&nbsp;фоне.<br/> Если фон не одноцветный - используете дополнительно примитив Надпись.   
*Функция - тип функции обработки входного сигнала (подробнее см. далее) 
**sfText (''по умолчанию'') - использовать&nbsp;[[Text-функция|Text-функция]].&nbsp; 
**sfLUA - использовать LUA   
*LUA-функция - имя функции, если используется LUA 
*Text-функция - имя функции, если используется Text-функции 
*Запись значения - в случае, если примитив должен иметь возможность записи нового значения Item на сервер, определяет каким образом должно браться это значение 
**wtFunction -&nbsp; значение берется из поля "С:" функции&nbsp; (Text или LUA) 
**wtWindows - будет открыто окно выбора нового значения. Данный функционал доступен только для Text-функкций&nbsp;   
*Помощник ТФ - помощник создания Text-функции (подробнее см. далее) 
*Тестовая картинка - выберите одну из отображаемых картинок. Размер примитива будет изменен под размер выбранного изображения. 
*Анимация GIF в норме - (по умолчанию Да) - анимация активна, когда сигнал находится в состоянии&nbsp;Норма. 
*Исходный размер - в случае выбора примитив будет оптимизирован под размер отображаемого изображения (фактически делает тоже самое, что и Тестовая картинка)&nbsp; 
*Цвет фона - цвет фона определяется автоматически при создании изображения. Для наилучшего отображения картинки '''настройка должна всегда соответствовать''' цвету фона карты. Если вы меняете цвет фона карты - по необходимости измените цвет фона изображения. 
*&nbsp;Прозрачность -&nbsp;режим прозрачности. Это дополнительная настройка изменять ее почти никогда не следует.&nbsp; 
**sptDefault (''по умолчанию'') - базовый режим&nbsp; 
**sptRectangle - изображение обрабатывается как прямоугольник   
*Прозрачность (цвет) - прозрачный цвет в изображении (в режиме прозрачности&nbsp;sptDefault). 
**Черный (по умолчанию) - почти всегда следует указывать черный.<br/> Если в изображении присутствует "рабочий" черный цвет, измените эту&nbsp;настройку.   
*Мерцание - примитив в сигнальном состоянии будет скрывать / отображать фон&nbsp;&nbsp; 

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

Отображаемое изображение определяется входным значением сигнала и результатом функции обработки значения:Выбор функции: Text- или LUA зависит от решаемой задачи.

Почти всегда, вам подойдет использование простых [[Text-функция|Text-функций]].

==== Функции обработки входного значения ====

Результатом выполения '''любой '''написанной&nbsp;вами&nbsp;функции&nbsp;должна быть строка&nbsp;следующего вида:
<div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">imagename;&nbsp;[S:soundfile;] [N:название события;] [A:0;]&nbsp;[C:0]</div> 
где,

*параметры, указанный в скобках являются необязательными и могут быть пропущены 
*imagename - имя файла изображения (регистр не важен)&nbsp;из папки '''..\Scada\settings\Images''' 
*S:soundfile - имя звукового файла из папки '''..\Scada\Sounds''', если указано, то файл будет воспроизведен.&nbsp;<br/> Если нет - то будет воспроизведен файл из общих настроек примитива. 
*N:название события&nbsp; - дополнительное название события, которое будет добавлено к основному названию, полученному из свойства Item,&nbsp;в журналах событий<br/> Если название событие начинается с&nbsp;!, например:&nbsp;!Затопление пом.121, то будет использоваться только это название, без анализа свойства Item 
*A:0 - дополнительный флаг 
**0 - значение является нормой 
**1 - значение является сигнальным (аварией)   
*C:0 - команда для записи значения в связанный Item по нажатию на примитив.<br/> Имеет смысл только для примитива, все состояния которого&nbsp;являются нормальным (не сигнальными).<br/> Т.е. для всех вариаций значений в функции&nbsp;указан флаг'''A:0.'''<br/> Это позволяет реализовать&nbsp;с помощью примитива возможность переключения режимов работы устройства (например: Пуск / Останов), или аналог примитива Канал&nbsp;управления. 
*буквы '''S, N, A, C'''&nbsp;- латинские заглавные 

В случае, если соответствующий значению сигнала файл изображения не найден, примитив продолжит работу с изображением по-умолчанию<br/> (то, которое отображается на примитиве при размещении на карте).

Рассмотрим несколько примеров&nbsp; возможных Text-функций.

Рассмотрим поведение примитива, который например связан с Тэгом, название неисправности которого с настройках OPC-сервера указано, как "Насос ИТП".

Отметим также следующий момент, что в Журнал событий SCADA может записываться значение сигнала, если он&nbsp;

*переходит в сигнальное состояние 
*переходит из сигнального в нормальное состояние 

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

'''Пример1 - Краткая запись. Простая функция обработки числового&nbsp;значения'''
<pre>0=norma.jpg
1=alert1.jpg
2=alert2.jpg
</pre>
<div>
Таблица 1 - Поведение примитива

{| border="1" cellpadding="1" cellspacing="1" class="wikitable"
|-
| Значение сигнала
| style="text-align: center;" | Отображаемое изображение
| Состояние&nbsp;
| style="text-align: center;" | Проигрываемый звуковой файл
| style="width: 151px;" | Сообщение в журналы
| style="width: 161px; text-align: center;" | Комментарий
|-
| style="text-align: center;" | 0
| style="text-align: center;" | norma.jpg
| style="text-align: center;" | Норма
| style="text-align: center;" | никакой
| style="text-align: center; width: 151px;" | Норма
| style="width: 161px; text-align: center;" | Для Text-функции значение 0 - всегда по умолчанию = Норма
|-
| style="text-align: center;" | 1
| style="text-align: center;" | alert1.jpg
| style="text-align: center;" | Авария
| style="text-align: center;" | из настройки примитива Звуковой файл
| style="text-align: center; width: 151px;" | Насос ИТП
| style="width: 161px; text-align: center;" | &nbsp;
|-
| style="text-align: center;" | 2
| style="text-align: center;" | alert2.jpg
| style="text-align: center;" | Авария
| style="text-align: center;" | из настройки примитива Звуковой файл
| style="text-align: center; width: 151px;" | Насос ИТП
| style="width: 161px; text-align: center;" | &nbsp;
|-
| style="text-align: center;" | любое другое
| style="text-align: center;" | изображение примитива по умолчанию
| style="text-align: center;" | Авария
| style="text-align: center;" | из настройки примитива Звуковой файл
| style="text-align: center; width: 151px;" | Насос ИТП&nbsp;: Неопределенное значение Х
| style="width: 161px; text-align: center;" | Неопределенное значение расценивается как Авария
|}

'''Пример 2 - Полная запись функции&nbsp;обработки числового&nbsp;значения'''
</div> <pre>0=norma.jpg
1=regim1.jpg; N:Переход в режим1; A:0
2=regim2.jpg; S:_vnimanie.wav; N:Переход в режим2; A:0
3=alert1.jpg; N:Ошибка 1
4=alert2.jpg; S:_sound.wav; N:Ошибка 2
</pre>
<div>Таблица 2 - Поведение примитива</div> <div>
{| border="1" cellpadding="1" cellspacing="1" class="wikitable"
|-
| Значение сигнала
| style="text-align: center;" | Отображаемое изображение
| Состояние&nbsp;
| style="text-align: center;" | Проигрываемый файл
| style="width: 151px; text-align: center;" | Сообщение в журналы
| style="width: 161px; text-align: center;" | Комментарий
|-
| style="text-align: center;" | 0
| style="text-align: center;" | norma.jpg
| style="text-align: center;" | Норма
| style="text-align: center;" | никакой
| style="text-align: center; width: 151px;" | Норма
| style="width: 161px; text-align: center;" | Для Text-функции значение 0 - всегда по умолчанию = Норма
|-
| style="text-align: center;" | 1
| style="text-align: center;" | regim1.jpg
| style="text-align: center;" | Норма
| style="text-align: center;" | никакой
| style="text-align: center; width: 151px;" | 
В оперативном журнале&nbsp;<br/> Норма&nbsp;<br/> Насос ИТП&nbsp;: Переход в режим 1

| style="width: 161px; text-align: center;" | Норма - потому что указан флаг A:0
|-
| style="text-align: center;" | 2
| style="text-align: center;" | regim2.jpg
| style="text-align: center;" | Норма
| style="text-align: center;" | _vnimanie.wav
| style="text-align: center; width: 151px;" | В оперативном журнале&nbsp;<br/> Норма&nbsp;<br/> Насос ИТП&nbsp;: Переход в режим 2
| style="width: 161px; text-align: center;" | Норма - потому что указан флаг A:0
|-
| style="text-align: center;" | 3
| style="text-align: center;" | alert1.jpg
| style="text-align: center;" | Авария
| style="text-align: center;" | из настройки примитива Звуковой файл
| style="text-align: center; width: 151px;" | 
Насос ИТП&nbsp;: Ошибка 1

Журнал событий + Оперативных журнал

| style="width: 161px; text-align: center;" | &nbsp;
|-
| style="text-align: center;" | 4
| style="text-align: center;" | alert2.jpg
| style="text-align: center;" | Авария
| style="text-align: center;" | _sound.wav
| style="text-align: center; width: 151px;" | 
Насос ИТП&nbsp;: Ошибка 2

Журнал событий + Оперативных журнал

| style="width: 161px; text-align: center;" | &nbsp;
|-
| style="text-align: center;" | любое другое
| style="text-align: center;" | изображение примитива по умолчанию
| style="text-align: center;" | Авария
| style="text-align: center;" | из настройки примитива Звуковой файл
| style="text-align: center; width: 151px;" | 
Насос ИТП&nbsp;: Неопределенное значение Х

Журнал событий + Оперативных журнал

| style="width: 161px; text-align: center;" | Неопределенное значение расценивается как Авария
|}

'''Пример 3. Функция отображает два изображения при этом любые состояния входного сигнала являются нормой.&nbsp;'''
<pre>0=norma.jpg
else=regim1.jpg; A:0</pre>

Таблица 3&nbsp;- Поведение примитива

{| border="1" cellpadding="1" cellspacing="1" class="wikitable"
|-
| Значение сигнала
| Отображаемое изображение
| style="text-align: center;" | Состояние&nbsp;
| Проигрываемый файл
| style="width: 151px; text-align: center;" | Сообщение в Оперативный журнал
| style="width: 161px; text-align: center;" | Комментарий
|-
| style="text-align: center;" | 0
| style="text-align: center;" | norma.jpg
| style="text-align: center;" | Норма
| style="text-align: center;" | --
| style="text-align: center; width: 151px;" | --
| style="width: 161px; text-align: center;" | Для Text-функции значение 0 - всегда норма
|-
| style="text-align: center;" | любое другое
| style="text-align: center;" | regim1.jpg
| style="text-align: center;" | Норма
| style="text-align: center;" | --
| style="text-align: center; width: 151px;" | --
| style="width: 161px; text-align: center;" | Норма - потому что указан флаг A:0
|}

'''Пример 4. Функция отображает два изображения при этом любые состояния входного сигнала являются нормой.&nbsp;'''
<pre>0=norma.jpg;N:Состояние 0
else=regim1.jpg;N:Состояние 1; A:0</pre>

Таблица 4&nbsp;- Поведение примитива

{| border="1" cellpadding="1" cellspacing="1" class="wikitable"
|-
| Значение сигнала
| Отображаемое изображение
| style="text-align: center;" | Состояние&nbsp;
| Проигрываемый файл
| style="width: 151px; text-align: center;" | Сообщение в Оперативный журнал
| style="width: 161px; text-align: center;" | Комментарий
|-
| style="text-align: center;" | 0
| style="text-align: center;" | norma.jpg
| style="text-align: center;" | Норма
| style="text-align: center;" | --
| style="text-align: center; width: 151px;" | 
Насос ИТП&nbsp;: Состояние 0

| style="width: 161px; text-align: center;" | Для Text-функции значение 0 - всегда норма
|-
| style="text-align: center;" | любое другое
| style="text-align: center;" | regim1.jpg
| style="text-align: center;" | Норма
| style="text-align: center;" | --
| style="text-align: center; width: 151px;" | Насос ИТП&nbsp;: Состояние 1
| style="width: 161px; text-align: center;" | Норма - потому что указан флаг A:0
|}

LUA-функции имеет смысл использовать, если вам необходимо реализовать логику, например:

*отобразить картинку 1, если значение меньше 15 
*отобразить картинку 2&nbsp; иначе 
</div> 
Пример [[Скрипты|Lua-функции]] выбора картинки из перечня (название функции может быть любым).
<syntaxhighlight lang="php">
function img (x)
 local xi = math.floor(x)
 if (xi < 15)  
  then
    return "norma.jpg; A:0"
  else 
    return "battary.jpg"
 end
end
</syntaxhighlight>

'''Внимание!&nbsp;'''<br/> Для LUA-функция&nbsp;'''для всех нормальных значений '''обязательно '''указывать '''A:0<br/> Функция должна быть сохранена в [[Скрипты|скрипте ]] в папке ..\Scada\scripts\lvm\custom


==== Порядок настройки ====

Перечислим еще раз кратко последовательность по базовой настройке примитива

#Разместить на карте 
#Уточнить цвет фона примитива (что значение - соответствует цвету карты) 
#Если примитив будет больше стандартного размера, то уточнить размеры примитива, указать в качестве тестового изображения одно из изображений, которое будет отображать примитив. 
#Связать с Тегом 
#Выбрать существующую функцию&nbsp;&nbsp;в свойстве&nbsp;Text-функция или создать новую с помощью Помощника 
#По необходимости указать специальную Иконку для облака уведомлений 

См. также примеры:&nbsp;

[https://vk.com/@asud248-universalnye-primitivy-izobrazhenie-nabor-izobrazhenii-chast https://vk.com/@asud248-universalnye-primitivy-izobrazhenie-nabor-izobrazhenii-chast]

[https://vk.com/@asud248-universalnye-primitivy-izobrazhenie-nabor-izobrazhenii-2 https://vk.com/@asud248-universalnye-primitivy-izobrazhenie-nabor-izobrazhenii-2]

==== Помощник Теxt-функций ====

Для удобства создания новой Text-функции (или редактирования существующей)&nbsp;&nbsp;вы можете использовать специальный помощник.

Для его запуска следует выбрать на карте примитив Набор изображений и далее нажать "..." в свойстве Помощник ТФ.

Если с примитивом ранее была связана, какая-то Text-функция, то ее значения будут перечислены в таблице. Если функция связана не была - таблице будет пустой.

[[File:PictPrim TF1.PNG|center|500px|PictPrim TF1.PNG]]Далее вам следует последовательно заполнить поля таблицы, указав все возможные значения входного сигнала.

После этого следует нажать кнопку В Текст - для создания тела функции в правильном формате.

[[File:PictPrim TF2.PNG|center|500px|PictPrim TF2.PNG]]Кнопка:&nbsp;

*В таблицу - снова перенесет значения в таблицу для редактирования 
*В буфер - скопирует тело функции в буфер обмена 

Здесь, вы также, по необходимости, можете добавить комментарий в первой строке после символа '?' или специальную функцию обработки значения после символа '#' (подробнее см.&nbsp;[[Text-функция|Text-функция]])

Далее следует скопировать тело функции в буфер обмена. Закрыть окно и в открывшемся окне Text-функций создать новую функция или отредактировать существующую, вставив тело функции из буфера обмена.

==== Использование примитива&nbsp;с Item типа DiscretChannel&nbsp;(дискретный&nbsp;сигнал) ====

Имеет смысл, если необходимо показывать два разных изображения в состояниях Норма / Сигнал. Иначе проще использовать примитив Изображение.

Теxt-функция обработки значения должа иметь следующий вид
<pre>? Пример1 функции для работы с дискретным сигналом
# BIT(X;1)
0=norma.svg; A:0
1=alert.svg</pre>

где, вместо&nbsp;norma.svg, alert.svg - следует&nbsp;указать свои файлы изображений.

В принципе вы можете использовать и два одинаковых файла, например если это динамическое изображение GIF
<pre>? Пример2 функции для работы с дискретным сигналом
# BIT(X;1)
0=fun.gif; A:0
1=fun.gif</pre>

При значении норма - изображение будет статично, иначе - будет включена динамика.

'''Внимание!'''

*При связке с&nbsp;DiscretChannel функция может выглядеть только так. как указано в примерах 1 и 2. 
*Всегда одно из значений должно быть сигнальным 
*При использовании функции BIT, следует всегда указывать A:0 для всех значений Норма (в том числе, для значения 0). 

==== Использование примитива&nbsp;с Item типа DiscretChannel&nbsp;(дискретный&nbsp;сигнал). Длительное открытие двери ====

Пример отображения с помощью примитива состояния длительного открытого положения двери можно посмотреть [https://vk.com/@asud248-primer-otobrazheniya-dlitelnogo-nezakrytogo-polozheniya-dver здесь].

==== Использование примитива с Item содержащим битовую маску состояний (ошибок) ====

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

Теxt-функция обработки значения должа иметь следующий вид
<pre>? Пример функции для работы с битовой маской
# BIT(X;2)
0=norma.svg; N:Название сигнала; A:0
1=alert.svg; N:Название сигнала</pre>

В описании функции в разделе # BIT(X;2) следует указать номер анализируемого бита (в данном случае анализаируется 2-ой бит).

Также следует конкретизировать название битового сигнала&nbsp;

*N:Название сигнала&nbsp; &nbsp;- тогда в журнал будет писаться "Общее название&nbsp;: Название сигнала", или 
*N:!Название сигнала&nbsp; &nbsp;- тогда в журнал будет писаться "Название сигнала" 

==== Использование примитива с Item типа ControlChannel (канал управления) ====

Настройку "Запись значения" установить в wtFunсtion.

Теxt-функция обработки значения должа иметь следующий вид
<pre>? Пример функции для работы с каналом управления
# BIT(X;16)
0=off.svg; A:0; C:1
1=on.svg; A:0; C:0</pre>

где, вместо on.svg, off.svg - следует указать свои файлы изображений.

Функция может также иметь следующий вид,&nbsp;
<pre>? Пример функции для работы с каналом управления
# BIT(X;1)
0=off.svg; A:0; C:1
1=on.svg; A:0; C:0</pre>

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

Следует иметь введу, что данный примитив не имеет сигнального состояния - все состояния норма. В облаке уведомления ничего не отображается.<br/> <br/> При переходе из состояния включено-выключено, выключено-включено в правом верхнем углу примитива отображается специальное изображение.

[[File:PictPrim Control.PNG|center|200px|PictPrim Control.PNG]]

&nbsp;

==== Использование примитива для переключения режима работы устройства ====

Если необходимо включать/выключать какое-то устройство, но тип&nbsp;Item является простым числовым значением, где:

*0 - выключено, 
*1 - включено, 

то следует использовать функцию следующего вида.
<pre>? Пример функции управления с числовым Item 
0=off.svg; C:1
1=on.svg; A:0; C:0</pre>

где, вместо on.svg, off.svg - следует указать свои файлы изображений.

Настройку "Запись значения" установить в wtFuntion.

'''Внимание!'''<br/> Для всех не нулевых значений Item должен быть указан флаг "А:0"

==== Использование для выбора&nbsp;режима работы устройства ====

Если необходимо реализовать возможность выбора режима работы&nbsp;устройства из нескольких значений, например:

*0 - останов,&nbsp; 
*1 - тихий ход, 
*2 - 50&nbsp;% мощности, 
*3 - полная мощность, 

(значения не обязательно должны идти подряд, допускаются пропуски)

то следует&nbsp;использовать&nbsp; Text-функцию следующего вида.
<pre>? Пример функции выбора нового значения Item
0=0.svg; N:останов; A:0
1=1.svg; N:тихий ход; A:0
2=2.svg; N:50&nbsp;% мощности; A:0
3=3.svg; N:полная мощность; A:0</pre>

где вместо 1.svg, 2.svg - указать свои файлы изображений.

'''Внимание!'''

*Для '''всех '''значений Item должен быть указан флаг "А:0" 
*Не использовать флаг команд "С:". 
*Для каждого значения должен&nbsp;быть указан параметр "N:" - &nbsp;будут отображаться в списке выбора. 
*Настройку "Запись значения" для примитива установить в '''wtWindow'''. 

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

[[File:PictPrim Combo.PNG|center|300px|PictPrim Combo.PNG]]


=== Индикатор ===
<pre>07-06-2022
* поддержка механизма уведомлений
* поддержка граничных значений
</pre>

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

[[File:Prim indicator.PNG|center|350px|Примитив индикатор]]

[[File:Prim indicator2.PNG|center|350px|Примитив индикатор]]

Примитив имеет смысл связывать только с числовыми Item.

Формула вычисления процента (текущего значения):

 Процент выполнения = 100 * (Значение_параметра - Минимум) *  / (Максимум - Минимум).

, где

*Значение параметра - текущее значение Item 
*Максимум - настройка Максимум 
*Минимум - настройка Минимум 

Настройки примитива:

{{:DopPrimBaseSettings}} {{:DopPrimBaseNotification}}

'''Дополнительные настройки:'''

*Минимум - минимальное&nbsp;исходное значение параметра&nbsp; 
*Максимум - максимальное исходное значение параметра 
*Сигнальное (%) - значение верхней или нижней границы в&nbsp;% (0 - не анализировать)<br/> Граничное значение будет отображено на примитиве вертикальной линией (только для типа примитива 0, 1 и 2). 
*Норма меньше&nbsp; - при указании сигнального значения, определяет как относительного него рассматривать нормальные значения<br/> Если Норма меньше границы - то граница на примитиве отображается красным (черным) цветом.<br/> Если Норма больше границы - то граница на примитиве отображается синим (черным) цветом.&nbsp; 
*Динамичное уведомление - отображать ли в облаке уведомлений текущее значение индикатора или только файт перехода в сигнальное состояние 
*Цвет заливки - цвет заполнения индикатора. 
*Цвет фона - цвет заполняемого фона 
*Отображать значение - отображать значение в процентах на примитиве 
*Вид индикатора - один из 5 вариантов отображения Индикатора (по умолчанию 1). 

В случае если при обновлении значения параметра его ОРС_статус <> OPC_Quality_good (потеря связи с устройством), отобразится Синий восклицательный знак.


=== Индикатор&nbsp;времени сигнального состояния ===
<pre>22-10-2025
* первая версия
</pre>

Индикатор времени сигнального состояния - &nbsp;предназначен для оповещения о превышении допустимого времени&nbsp;на устранение неисправности

[[File:Prim indicator time.PNG|center|350px|Примитив индикатор]]

Примитив следует разместить рядом с основным примитивом (дискретным датчиком или лифтовой станцией) и связать его с тэгом основного примитива.

На примитиве будет отображаться время прошедшее с перехода Item в сигнальное состояние.

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

Настройки примитива:

{{:DopPrimBaseSettings}} {{:DopPrimBaseNotification}}

'''Дополнительные настройки:'''

*Цвет заливки - цвет заполнения индикатора. 
*Цвет фона - цвет заполняемого фона 
*Отображать границы - отображать значение срока устаранения на примитиве 
*Срок устранения - количество минут, в течении которых неисправность должна быть устранена. 

В случае если при обновлении значения параметра его ОРС_статус <> OPC_Quality_good (потеря связи с устройством), отобразится Синий восклицательный знак.

=== Индикатор общего времени сигнального состояния ===
<pre>22-10-2025
* первая версия
</pre>

Индикатор времени сигнального состояния - &nbsp;предназначен для оповещения о превышении допустимого времени, нахождения в сигнальном состоянии.

В отличии от примитива Индикатор времени сигнального состояния, отображает накопленное время нахождение сигнала в антивном состоянии.<br/> [[File:Prim indicator timetotal.PNG|center|350px|Примитив индикатор]]Примитив отображает:

*дату сброса счетчиков 
*граничное значение общего числа часов 
*количество включений (переходов сигнала в активное состояние) 
*общее время&nbsp;нахождения в активном (сигнальном) состоянии 

Настройки примитива:

{{:DopPrimBaseSettings}} {{:DopPrimBaseNotification}}

'''Дополнительные настройки:'''

*Цвет заливки - цвет заполнения индикатора. 
*Цвет фона - цвет заполняемого фона 
*Отображать границы - отображать значение допустимого числа часов на примитиве 
*Отображать дату сброса - отображать дату сброса счетчиков на примитиве 
*Отображать счетчик - отображать ли счетчик включений на примитиве 
*Часов включений - максимальное число часов нахождения сигнала в активном состоянии 
*Сбросить счетчик - выполнить сброс счетчиков 
*АвтоСброс - выполнять&nbsp;автосброс счетчиков 
**taNone - никогда 
**taMonth - в начале месяца 
**taYear - в начале года&nbsp;   

В случае если при обновлении значения параметра его ОРС_статус <> OPC_Quality_good (потеря связи с устройством), отобразится Синий восклицательный знак.

=== Индикатор LED ===

 2.7.18
  + расширена поддержка Text-функций
 2.7.15
 &nbsp;+ изменена настройка обработчика значения, 
 &nbsp;  теперь используется выражение, аналогично Переменным
 2.7.10
 &nbsp;+ типы обработки данных 2Bit<>0, 3Bit<>0
 &nbsp;+ изменено входное значение для Text-функции (надписи на примитиве)
 2.7.7
 &nbsp;+ возможность отобразить надпись на примитиве
 2.7.5 update 1 
 &nbsp;существенное обновление функционала примитива
 &nbsp;+ полноценная работа с сигналом в виде битовой маской: 
 &nbsp;   для каждого битового значения Item создается отдельное событие в Журналах событий
 &nbsp;+ возможность конкретизировать аварию для Журналов событий
 &nbsp;+ для вида прямоуголник отображается сплошной прямоугольник
 2.7.2
 &nbsp;+ примитив существенно переработан
 &nbsp;  убраны "лишние" свойства
 2.6.6 
 &nbsp;+ восстановлена работа облака уведомалений (не работало в 2.6.5 - 2.6.4)

[[File:Prim led.PNG|frameless|center|Индикатор LED]]

Индикатор LED позволяет визуализировать числовой или дискретный параметр.

Примитив позволяет выполнить привязку к:&nbsp;

*обычному дискретному сигналу 
**Норма:&nbsp;младший бит значения равен 0 
**Сигнал:&nbsp;иначе   
*числовому сигналу, при этом возможны различные варианты анализа: 
**Анализ битовой маски 
**Сравнение с&nbsp;&nbsp;0 
**Сравнение с min, max 
**и т.д.   

'''Будьте внимательны''' при обновлении с версий ниже 2.6.6, когда в примитиве не было поддержки облаков уведомлений.&nbsp;<br/> После обновления, например: 2.6.2 на новые версии, активные LED-индикаторы отобразятся в облаках уведомлений.<br/> Если отображение в облаке не жалательно, следует после обновления на новую версию, закрыть SCADA и воспользоваться утилитой [[LED_NOTIFICAION.EXE|\ tools-scada \ led_notification.exe]] для отключения уведомлений.

Рассмотрим настройки примитива.

{{:DopPrimBaseSettings}} {{:DopPrimBaseNotification}}

'''Дополнительные настройки:'''

*Цвет вкл. - цвет активного состояния 
*Мерцание - осуществлять ли мерцание в сигнальном состоянии 
*Стиль - Эллипс / Прямоугольник 
*Обработчик -&nbsp;правило анализа контролируемого параметра.<br/> Правило - это выражение, аналогичное используемому в [[Переменные|Переменных]]&nbsp;или [[Text-функция|Text-функция]],<br/> определяющее активное&nbsp;состояние LED-индикатора,&nbsp;где: 
**если выражение Истина, или значение выражения > 0 - LED активен 
**если выражение Ложно, или значение выражения =&nbsp;0 - LED не активен   
*Неисправность - конкретизация названия неисправности для отображаемого сигнала (по умолчанию = пусто)<br/> В&nbsp;журналах событий сигнал будет отображаться, как&nbsp;<br/> ''Название события из настроек ОРС-сервера&nbsp;: Неисправность''<br/> Если указать название неисправности начинается с&nbsp;!, то будет указываться только&nbsp;''Неисправность''<br/> ''Может быть использовано, например: при отображении сигнала битовой маски (подробнее см. далее)'' 
*ОЖ Вкл - сообщение отображаемое в оперативном журнале при активном сигнале (если не указано, отображается Авария). 
*ОЖ Выкл - сообщение отображаемое в оперативном журнале при переходе сигнала в норму (если не указано, отображается Норма). 
*Текст [Да \ Нет] - отображать текст на примитиве (по-умолчанию: название неисправности) 
*[[Text-функция|Text-функция]]&nbsp;- использовать функцию для преобразования число-значение 
*Реальное значение [Да \ Нет] - передавать ли в функцию значение Item, а не только сигнальное состояние (0 / 1). 

Указанный набор настроек позволяет реализовать различные модели поведения примитива.&nbsp;Это может как обычный LED, срабатывающий при замыкании дискретника, так и прямоугольная область, изменяющая цвет при выходе параметра за границы диапазона.

'''Внимание! '''<br/> 1.&nbsp;При связке примитива LED с '''обычными дискретным сигналом''' OPC-сервера будет автоматически выбран&nbsp; тип&nbsp;Обработка&nbsp; BIT (X;1)&nbsp;&nbsp;<br/> 2. Если вы заметили, что в облаке уведомлений отображается пустая картинка вместо LED-индиктатора, следует удалить файлы&nbsp; \ Scada \ Settings \ Images \ led_*.png и перезапустить SCADA

==== Работа с битовыми масками&nbsp; ====

Если числовое значение сигнала Item представляет собой битовую маску, то для отображения&nbsp;&nbsp;состояния каждого требуемого бита следует использовать отдельный LED-примитив.

Обычно сигнал в виде битовой маски встречается при диспетчеризации&nbsp;[[Modbus-устройства|Modbus-устройства]]&nbsp;или других контроллеров сторонних производителей.

Например: пусть значение сигнал представляет собой битовую маску трех состояний:

Бит:

#&nbsp;Пуск насоса 1 
#&nbsp;Пуск насоса 2 
#&nbsp;Пуск насоса 3&nbsp; 

Т.е если значение сигнала = 5, то это значит что запущены насосы 1 и 3 (уставлены 1 и 3 биты).

Название неисправности для данного сигнала в ОРС - сервере указано, как "Насосы ИТП".

Размещаем на карте три LED индикатора (LED1, LED2, LED3), для каждого в настройках указываем

*Обработчик - BIT (X;1) - для первого,&nbsp;BIT (X;2) - для второго, и т.д. 
*Неисправность - "Пуск насоса 1"&nbsp; - для первого индикатора,&nbsp;"Пуск насоса 2" - для второго индикатора&nbsp;&nbsp;и т.д. 

При включении первого насоса у нас будет загораться Led1 и в журналах отображаться событие:&nbsp;"Насосы ИТП&nbsp;:&nbsp;Пуск насоса 1" .

При включении третьего насоса будет загораться Led3&nbsp;и в журналах отображаться событие:&nbsp;"Насосы ИТП&nbsp;:&nbsp;Пуск насоса 3"&nbsp;.

Если в свойстве Неисправность&nbsp;для Led1 указать "!Пуск насоса 1", то при включении насоса 1, в журналах будет отображаться просто&nbsp;&nbsp;&nbsp;"Пуск насоса 1"


==== Дополнительная раскраска примитива&nbsp; ====

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

Однако, с помощью&nbsp;[[Text-функция|Text-функция]]&nbsp;вы можете указывать разные цвета активного состояния индикатора

Пример такой функции приведен ниже&nbsp;
<pre>21=Несанкционированное снятие 1-ой колодки --color:#808080
31=Несанкционированное снятие 2-ой колодки --color:#FF8080
35=Несанкционированное открытие шкафа
</pre>

для изменения цвета следует после описания события добавить --color и код цвета.

[[File:Scada led color.PNG|center|450px]]

=== Стрелочный индикатор ===
<pre> Обновления:
 2.7.20u2
&nbsp;* обновление поведения примитива
 2.6.6
 * восстановлена работа уведомлений (не работало в 2.6.5-2.6.4)
 2.6.3
  * поддержка уведомлений, звуковых файлов 
 24-07-2020
  * исправлена настройка границ Min, Max
</pre>

Позволяет визуализировать любой числовой параметр.

[[File:Prim Analog.PNG|frameless|center|350px|Стрелочный индикатор]]

Настройки:

*Тэг - контролируемый параметр 
*Звуковой файл - воспроизводить звуковой файл при выходе за границы Min, Max 
*Уведомления - отображать ли уведомления в облаке уведомлений 
*Журнал - записывать ли события в оперативный журнал и журнал событий 
*Угол - угол разворота шкалы (от 30 до 90 для стиля Левый, Правый; до 360 для стиля Центр) 
*Шкала - максимальной значение шкалы ('''минимум '''всегда 0) 
*Число отсчетов - число основных отчетов от минимума до максимума шкалы 
*Толщина стрелки - толщина стрелки (от 1 до 5) 
*Надпись 
*Цвет фона 
*Стиль индикатора 
**Левый 
**Правый 
**Центр   
*Рамка - рисовать ли рамку вокруг примитива 
*Максимум - отображать ли границу максимума (если Да, то привитив будет анализировать выход за границы) 
*Цвет max - цвет границы 
*Значение max - значение max 
*Среднее - аналогично Максимум 
*Минимум - аналогично Максимум&nbsp; (если Да, то привитив будет анализировать выход за границы) 

После изменения Стиля индикатора может потребоваться изменить размер примитива.

С версии 2.7.20u2 изменилась логика работы примитива, в зависимости от настроек параметров:

*Отображать максимум, минимум, среднее 

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

<gallery>
Sind no.PNG|
Sind no2.PNG|
</gallery>

Если отображается:

*Максимальное и/или Минимальное 
*Среднее 

<gallery>
Sind_lmnorma.PNG|
Sind_mnorma.PNG|
Sind_lnorma.PNG| 
Sind_mid.PNG| 
</gallery>

Примитив будет работать в режиме анализа граничных значений:

*Ниже нормы 
*Норма 
*Выше 

В оперативном журнале при превышении границы будет отображено сообщение, например: ''Выше нормы Значение&nbsp;: [Диапазон нормальных значений]''

Если отображается:

*Минимальное и Среднее 
*Среднее и Максимальное 

<gallery>
Sind_level12.PNG|
Sind_level12l.PNG|
</gallery>

Примитив будет работать в режиме анализа пороговых&nbsp;значений:

*Норма 
*Порог 1 
*Порог 2 

В оперативном журнале при превышении порога будет отображено сообщение, например: ''Порог1&nbsp;Значение&nbsp;: [Диапазон Порог1]''

=== Часы ===

 Доступен с версии АСУД.SCADA 2.4.1
 В версии 2.6.2 вызывает ошибку на закрытии SCADA (исправлено в версии 2.6.3)

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

[[File:Clock wiki.JPG|center|350px|Clock wiki.JPG]]

'''Настройка примитива'''

Разместите примитив на карте, выберите стиль часов.

=== Часы сегментные ===

 Доступен с версии АСУД.SCADA 2.7.16

Позволяет отобразить на ситуационном плане сегментные часы

.[[File:Segment clock.PNG|center|350px|Clock wiki.JPG]]

=== Источник вызова УПСЛ-М ===

 Доступен с версии АСУД.SCADA 2.6.4

Позволяет отобразить источник вызова [[УПСЛ-М|УПЛС-М]] при подключении выходов Д1, Д2 ПУ-М к концентратору КУН.

Подключение Д1, Д2 имеет смысл&nbsp;только при работе УПСЛ-М с&nbsp;TL-концентраторами&nbsp;&nbsp;<br/> (поскольку передача информации&nbsp; об источнике вызова по RS-485 при таком подключении может занимать значительное время).

[[File:Upslm-prim.PNG|center|Upslm-prim.PNG]]

'''Настройка примитива'''

Разместите примитив на карте, укажите:

*Тег ПГС - тег канала ПГС концентратора КУН, к которому подключен ПУ-М 
*Тег Д1 - тег дискретного входа КУН, к которому подключен выход Д1 ПУ-М 
*Тег Д2 -&nbsp;тег дискретного входа КУН, к которому подключен выход Д2&nbsp;ПУ-М 
*Цвет фона&nbsp; - цвет фона&nbsp; 
*Тext-функция&nbsp; - необязательный параметр, который следует указать, если используется нестандартное название источников вызова. 

Вы можете добавить рядом&nbsp; примитив Надпись, указав текст "Источник вызова".

По умолчанию в примитиве &nbsp;отображается одно из значений:

*0 - Кабина 
*1 - Крыша/Приямок 
*2 - ОПЭ (основной посадочный этаж) 
*3 - Машинное 

Если вам необходимо использовать нестандартные имена, то следует создать текстовую функцию, задав соответствие числам от 0 до 3.

'''Принцип работы примитива'''

Данные об источнике вызова отображаются,&nbsp;только если связанный Тег примитива ПГС находится в состоянии "вызов", иначе отображается "---".




=== Входящие SIP ===
<pre>Доступен с версии АСУД.SCADA 2.7.3</pre>

Примитив позволяет настроить обработку <u>входящих</u> [[SIP_звонки|SIP&nbsp;звонков]] в SCADA.

Данная возможность используется, например при диспетчеризации IP-домофонов&nbsp;[[Comelit|Comelit]], или при необходимости подключения&nbsp;к SCADA любого друго SIP-оборудования.

[[File:Scada sip1.PNG|center|Scada sip1.PNG]]Один примитив следует разместить для&nbsp;каждого&nbsp;удаленного SIP-устройства, с которого необходимо принимать входяшие звонки.

Звонки по умолчанию принимаются на порт '''tcp/udp''' '''5065&nbsp; '''(порт отображаются в настройке&nbsp;Справка, подробнее см. ниже).<br/> Если необходимо изменить номер порта, следует отредактировать поле&nbsp;SIPPort&nbsp; в файле&nbsp; ..\ Scada \ settings \&nbsp; tprim.conf и перезапустить Scada.

'''Базовые настройки:'''

*Справка - (''только чтение'') краткая справка. Нажмите "..."&nbsp; для отображения справки. 

'''Дополнительные настройки:'''

*Скрыть фон - (''по умолчанию Нет'') отображать фон примитива&nbsp; 
*Надпись - (''по умолчанию Нет'') &nbsp;отображать имя Абонента&nbsp;на примитиве 
**В текущей версии надпись корректно отображается для примитивов на одноцветном&nbsp;фоне.<br/> Если фон не одноцветный - используете дополнительно примитив Надпись.   
*Изображение - файл изображения (по-умолчанию изображение домофона) 
**Выберите файл из&nbsp;&nbsp;'''..\Scada\settings\Images&nbsp;'''или любой другой папки (после выбора файл будет автоматически скопирован в&nbsp;'''&nbsp;'''..\Scada\settings\Images)   
*Исходный размер - в случае выбора примитив будет оптимизирован под исходный размер изображения (для svg-изображений никаких действий произведено не будет) 
*Цвет фона - цвет фона определяется автоматически при создании изображения. Для наилучшего отображения картинки&nbsp;'''настройка должна всегда соответствовать'''&nbsp;цвету фона карты. Если вы меняете цвет фона подложки - по необходимости измените цвет фона изображения. 
*&nbsp;Прозрачность -&nbsp;режим прозрачности. Это дополнительная настройка изменять ее почти никогда не следует.&nbsp; 
**sptDefault (''по умолчанию'') - базовый режим&nbsp; 
**sptRectangle - изображение обрабатывается как прямоугольник   
*Прозрачность (цвет) - прозрачный цвет в изображении (в режиме прозрачности&nbsp;sptDefault). 
**Черный (по умолчанию) - почти всегда следует указывать черный.<br/> Если в изображении присутствует "рабочий" черный цвет, измените настройку.   
*Мерцание - при активном вызове фон примитива будет мерцать 
*Адрес - адрес установки SIP-устройства для отображении в журналах 
*Абонент - имя абонента для отображения в журнале ПГС 
*SIP-хост - IP-адрес удаленного SIP-устройства 
*SIP-порт&nbsp; - порт удаленного SIP-устройства 
*Видео-поток - URL-потока, который будет отображен после ответа на звонок&nbsp; 
*DTMF - набор DTMF-сигналов для передачи SIP-устройству во время звонка 
*Нет связи в облаке - отображать ли примитив без связи в облаке уведомлений 
*SIP-монитор&nbsp; - открыть окно [[SIP_звонки|монитора входящих]] SIP-подключений. 

'''Принцип работы примитива'''

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

Принцип обработки входящего SIP звонка в SCADA смотри [[SIP_звонки|здесь]].

Если в настройках примитива указать Видео-поток, то после ответа на звонок, будет открыто окно с видео-данными.

Если указаны DTMF-команды, то после ответа на звонок можно отправить DTMF-сигнал, нажав на примитив правой кнопкой мыши.

&nbsp;Примитив отображается с синим восклицательным знаком если:

*программа перешла в Demo-режим 
*свойство SIP-хост не настроено 
*удаленное&nbsp;SIP-устройство не ответило на ping-запрос<br/> (программа примерно раз в минуту выполняет отправку ping-запросов на указанный SIP-хост). 



=== Состояние таймера ===
<pre>Доступен с версии АСУД.SCADA 2.7.6</pre>

Примитив позволяет отобразить текущее состояние внутрипрограммного [[Tekon_Scada#Таймеры|таймера]]

[[File:Dop timer.PNG|center|Dop timer.PNG]]

'''Базовые настройки:'''

*Справка - (''только чтение'') краткая справка. Нажмите "..."&nbsp; для отображения справки. 

'''Дополнительные настройки:'''

*Скрыть фон - (''по умолчанию Нет'') отображать фон примитива&nbsp; 
*Надпись - (''по умолчанию Да'') &nbsp;отображать имя выбранного Таймера на примитиве 
*Изображение - файл изображения (по-умолчанию изображение Планировщика) 
**Выберите файл из&nbsp;&nbsp;'''..\Scada\settings\Images&nbsp;'''или любой другой папки (после выбора файл будет автоматически скопирован в&nbsp;'''&nbsp;'''..\Scada\settings\Images)   
*Исходный размер - в случае выбора примитив будет оптимизирован под исходный размер изображения (для svg-изображений никаких действий произведено не будет) 
*Цвет фона - цвет фона определяется автоматически при создании изображения. Для наилучшего отображения картинки&nbsp;'''настройка должна всегда соответствовать'''&nbsp;цвету фона карты. Если вы меняете цвет фона подложки - по необходимости измените цвет фона изображения. 
*&nbsp;Прозрачность -&nbsp;режим прозрачности. Это дополнительная настройка изменять ее почти никогда не следует.&nbsp; 
**sptDefault (''по умолчанию'') - базовый режим&nbsp; 
**sptRectangle - изображение обрабатывается как прямоугольник   
*Прозрачность (цвет) - прозрачный цвет в изображении (в режиме прозрачности&nbsp;sptDefault). 
**Черный (по умолчанию) - почти всегда следует указывать черный.<br/> Если в изображении присутствует "рабочий" черный цвет, измените настройку.   
*Мерцание - при активном вызове фон примитива будет мерцать. 
*Таймер - следует выбрать один из настроенных таймеров. 

После настройки примитив будет отображать:

*имя выбранного таймера&nbsp; 
*статус таймера: активирован - ON /деактивирован - OFF 
*последнее значение сработки таймера&nbsp; после запуска Scada<br/> (активное - изображение звоночка / пассивное - нет изображения) 

[[File:Dop timer2.PNG|center|Dop timer2.PNG]]

=== Диспетчеры ===
<pre>Доступен с версии АСУД.SCADA 2.7.14</pre>

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

[[File:Disp scada 1.PNG|center|450px|Disp scada 1.PNG]]Имеет смысл разместить один примитив на главном виде программы.

&nbsp;Настройка примитива:

'''Базовые настройки:'''

*Справка - (''только чтение'') краткая справка. Нажмите "..."&nbsp; для отображения справки. 

'''Дополнительные настройки:'''

*Диспетчеры - (''только чтение''), нажмите "..." для редактирования списка диспетчеров 
*Дежурства&nbsp;- (''только чтение''), нажмите "..." для отображения журнала принятия смен&nbsp; 
*Шрифт - выбор шрифта надписи имени диспетчера 
*Цвет фона - цвет фона определяется автоматически при создании изображения. Для наилучшего отображения картинки&nbsp;'''настройка должна всегда соответствовать'''&nbsp;цвету фона карты. Если вы меняете цвет фона подложки - по необходимости измените цвет фона изображения. 

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

[[File:Disp scada 2.PNG|center|450px|Disp scada 1.PNG]], где:

*Идентификатор - сквозная нумерация диспетчеров 
*ФИО - имя диспетчера 
*Пароль - (скрытое поле)&nbsp; пароль диспетчера 

Пароль должен быть обязательно задан.<br/> Если вы изменяете значение полей Идентификато / ФИО Диспетчера, вы также должны повторно ввести Пароль.

Для просмотра журнала дежурств в режиме настройки нажмите на свойство примитива Держурства / Просмотреть или в рабочем режиме нажмите на примитив.

[[File:Disp scada 3.PNG|center|450px|Disp scada 1.PNG]], где

*Обновить - обновить отчет с учетом выбранных дат 
*>> CSV - сохранить отчет в формате .csv 

В рабочем режиме в примитиве отображается текущий дежурный диспетчер.

[[File:Disp scada 4.PNG|center|350px|Disp scada 1.PNG]]Для смены диспетчера следует выполнить клик на примитиве и в открывшемся окне&nbsp;

[[File:Disp scada 5.PNG|center|350px|Disp scada 1.PNG]]указать имя диспетчера и пароль. Нажать кнопку Взять дежурство.

[[File:Disp scada 6.PNG|center|350px|Disp scada 1.PNG]]Информация о дежурившем диспетчере&nbsp;отображается в журналах событий и ПГС

&nbsp;[[File:Disp scada 7.PNG|center|Disp scada 1.PNG]]







=== Автоподтверждение ===
<pre>До версии 2.7.18 upd2 возможна ошибка
в случае если других доп примитивов на карте нет, и настраивается Тэг обработки значения
Доступен с версии АСУД.SCADA 2.7.16</pre>

Позволяет реализовать автоподтверждение (авто квитирование&nbsp; - переход сигнала в состояние "ознакомлен")&nbsp;для указанного перечня '''дискретных''' сигналов по таймеру.

[[File:Auto confirm.PNG|center|250px|Auto confirm.PNG]]

Примитив может быть удобен при:

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

&nbsp;Настройка примитива:

'''Базовые настройки:'''

*Справка - (''только чтение'') краткая справка. Нажмите "..."&nbsp; для отображения справки. 
*Скрыть фон - отображить фон примитива 
*Надпись - отображать название Таймера, связанного с примитивом 
*Шрифт -&nbsp;выбор шрифта надписи 
*Цвет фона - цвет фона определяется автоматически при создании изображения. Для наилучшего отображения картинки&nbsp;'''настройка должна всегда соответствовать'''&nbsp;цвету фона карты. Если вы меняете цвет фона подложки - по необходимости измените цвет фона изображения. 

'''Дополнительные настройки:'''

*Таймер - имя таймера, связанного с примитивом. Сигналы будут подтверждаться только в период активного состояния таймера.<br/> Если таймер не указан, сигналы будут подтверждаться всегда. 
*Тэги - перечень подтверждаемых тэгов.&nbsp;<br/> Если перечень тэгов пустой, примитив будет автоматически подтверждать любой дискретный сигнал. 

Примеры использования примитива.

Вариант 1. Необходимо автоматически квитировать все дискретные сигналы.

Следует просто разместить примитив на карте.

Вариант 2. Необходимо квитировать все дискретные сигналы в определенное время.

Следует разместить примитив на карте и настроить Таймер.

Вариант 3. Необходимо всегда квитировать определенные сигналы.

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

Вариант 4. Необходимо квитировать определенные сигналы в определенное время.

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

=== Стороннее приложение ===
<pre>Доступен с версии АСУД.SCADA 2.7.16 (в тестовом режиме)</pre>

Позволяет отобразить в окне SCADA окно стороннего "простого" приложения (блокнот, калькулятор, ....) .<br/> (Тяжелые приложения, такие как, например: браузеры - не заработают)

[[File:Soft link.PNG|center|250px|Auto confirm.PNG]]

&nbsp;Настройка примитива:

'''Базовые настройки:'''

*Справка - (''только чтение'') краткая справка. Нажмите "..."&nbsp; для отображения справки. 

'''Дополнительные настройки:'''

*Приложение - имя запускаемой программы (приложения), например: calc.exe&nbsp; 

Внимание.<br/> Окно запущенного приложения будет отображаться&nbsp;только&nbsp; в рабочем режиме.&nbsp;В режиме настройки - окно будет пустым.&nbsp;

== Таблицы ==

=== Простая таблица ===

 Доступен с версии АСУД.SCADA 2.4.0

Позволяет отобразить на виде табличные данные из файла:

*xls (Excel 97, 2000), установка Excel на ПК не требуется 
*csv (текстовые данные, разделенные точкой с запятой) 

[[File:Prim simple table 1.JPG|center|350px|Prim simple table 1.JPG]]

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

Таблицы в формате CSV можно создать в Блокноте, например: файл test.csv

&nbsp;

 &nbsp;

&nbsp;
<nowiki> Заголовок1;Заголовок2 Данные1;Данные2 Данные1;Данные2 Данные1;Данные2 Данные1;Данные2 </nowiki>

'''Настройка примитива'''

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

=== Таблица данных OPC ===
<pre>Доступен с версии 2.5.2</pre>

Позволяет отобразить табличные данные, получаемые с ОРС-сервера.

[[File:Gridopc.PNG|center|Gridopc.PNG]]

Разместите примитив на карте и свяжите со строковым Тегом ОРС-сервера, например: с тегами устройства [[Tekon_OPC-сервер#DBMonitoring|DBMonitoring]]

Примитив позволяет отобразить данные, передаваемые в формате CSV-таблицы.

Пример табличных данных:
<pre>Заголовок1;Заголовок2
Данные1;Данные2</pre>

Дополнительно могут быть указаны Header и Footer
<pre>:Header: Заголовок
:Footer: Комментарий
Заголовок1;Заголовок2
Данные1;Данные2</pre>

&nbsp;

&nbsp;

=== Таблица данных Тегов ===
<pre>Обновления: 
15-05-2020
* в окне выбора тега добавлены оба скрола, иначе мог возникать нежелательный перенос строки при выборе тега
Доступен с версии 2.5.2
</pre>

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

Удобен при отображении набора&nbsp; данных сторонних ОРС-серверов или Modbus-устройств.

[[File:Gridtag.PNG|center|Gridtag.PNG]]Разместите примитив на карте. Укажите в настройках перечень тегов, которые необходимо отобразить в таблице.&nbsp;

Теги выбираеются в окне настройки&nbsp; с помощью контекстного меню, появляющегося при нажатии правой кнопкой мыши.&nbsp;

[[File:Gridtag2.PNG|center|Gridtag2.PNG]]В таблице примитива отображаются:

*№ - сквозная нумерация строк&nbsp; 
*Тег - выбранный тег 
*Название - свойство "название неисправновти" Item&nbsp; (отображаемое в журнале событий) 
*Значение&nbsp; - текущее значение 
*Дата - дата последнего изменения значения&nbsp; 
**Синий цвет - нет связи, неисправность датчика 
**Черный цвет - норма.   

Если в Названии отображается '--' , то Item не передает свойство&nbsp; "название неисправности"

Если в Значении отображается '--', то значение Item не является числом или строкой (отображение значения не поддерживается).

Настройки примитива:

*Теги - окно выбора тегов для отображения в таблице, для каждого тега может быть указана&nbsp;[[Text-функция|Text-функция]]&nbsp;обработки значения 
*Нумерация [Да / Нет] - отобразить столбец с номерами строк 
*Имя тега [Да / Нет ] -&nbsp;отобразить столбец Тег 
*Уровень тега - какое количество элементов тега отобразить (например:&nbsp; 1&nbsp; &nbsp;- Status,&nbsp; 2 - КУН-IP8.Status&nbsp; и т.п.) 
*Центрирование&nbsp;[Да / Нет ] - выполнять ли центрирование данных в столбцах Тег, Название 
*Ширина Значение - если для визуализации данных используется&nbsp;[[Text-функция|Text-функция]]&nbsp;можно указать размер колонки Значение в ручном режиме.

== Управление ==











=== Кнопка ===
<pre>Обновления:
16-09-2024 2.7.17 
* возможность отображения картинки
* ожидание на check 20 с.
* корректировка обработки check при одновременном нажатии нескольких кнопок
* возможность нажатия по таймеру
22-02-2024 2.7.15
* поиск окна запущенного приложения перед выполнением команды
20-09-2023 2.7.14
* прямое выполнение http(s):// запросов
* tlreset
19-07-2022
* исправлена работа функции CHECK
07-06-2022
* запрос пароля на подтверждения действия
15-05-2020
* окне выбора тегов добавлены оба скрола,иначе мог возникать нежелательный перенос строки при&nbsp;длинном имени тега
05-11-2019
* изменена пиктограмма
* добавлена возможность ввода комментария в окне команд, имитация сработы таймера
* факт записи значения в Item OPC-сервера отображается в оперативном журнале
* добавлена возможность требовать подтверждения записи
05-09-2019
* добавлена возможность выбора цвета кнопки 
21-11-2018
</pre>

[[File:Button prim.PNG|thumb|center|До версии 2.6.0]]

[[File:Button prim2.PNG|thumb|center|Начиная с версии 2.6.0]]

Кнопка - предназначена для:

*запуска любой сторонней задачи (приложения) 
*'''или '''выбора элемента главного меню в рабочем режиме 
*'''или '''записи значения в один или несколько Item OPC-сервера и имитации сработки [[Tekon_Scada#Таймеры|Таймера]] 
*'''или '''отображения файлов документации в формате pdf 

Настройки примитива:

*Команда - команда, выполняемая команда при нажатии на кнопку 
*Надпись - надпись на примитиве 
*Цвет фона - цвет кнопки 
*Подтверждение нажатия (Да/Нет) - требовать ли от диспетчера&nbsp; подтверждения&nbsp;выполнения&nbsp;операции (имеет смысл при записи значений Item OPC-сервера и/или имитации сработки Таймера) 
*Сообщение - текст подтверждающего сообщения&nbsp; 
**не указано - будет отображено&nbsp;'Подтвердить нажатие кнопки?' 
**указано - будет отображено&nbsp;'Вы действительно хотите выполнить: Сообщение?'&nbsp;   
*Запрашивать пароль - при нажатии на кнопку будет запрошен пароль. -&nbsp;<br/> Запрос пароля может потребоваться например для изменения каких-либо уставочных параметров подключенных устройств. 
*Задать пароль - задать пароль. Пароль является общим для всех кнопок. 
*Изображение - отобразить картинку на кнопке 
*Позиция&nbsp; - позиция изображения 
**ipLeft - слева от надписи<br/> (для центровки надписи исп. доп пробелы в начале надписи) 
**ipCenter - в центре&nbsp;   
*Таймер - имя таймера, при сработке которого произойдет нажатие кнопки<br/> Кнопка будет нажата при значениях таймера [0, 1]&nbsp;<br/> В случае, если кнопка нажимается по таймеру не будет отображено инфо сообщение и/или запрошен пароль.&nbsp; 

'''Внимание!''' Нажатие на кнопку обрабатывается только в рабочем режиме.

==== Запуск сторонней задачи ====

Примеры одиночных команд:

*cmd.exe /c start ping 192.168.1.1 - выполнить команду ping 
*notepad.exe "settings\заметки.txt" - открыть файл в программе notepad.exe 
*calc.exe - запустить калькулятор 
*cmd /c start [http://www.mail.ru- http://www.mail.ru-] открыть WEB-страницу 
*cmd /c start doc\test.pdf - открыть в Acrobat Reader файл test.pdf из папки ..\Scada\doc (требуется установленный Acrobat Reader) 
*cmd /c start doc\test.jpg - открыть изображение из папки ..\Scada\doc 
*doc\test.pdf - открыть pdf-файл из папки ..\Scada\doc во внутреннем окне просмотра (требуется установленный Acrobat Reader XI или выше). 

При открытии PDF-файла, его расширение в настройке должно быть указано маленькими буквами: pdf&nbsp;

Для команд запускающих сторонние приложения, вы моежете проверить, не было ли запущено это приложение ранее и если это так - просто развернуть его окно. Для этого перед командой запуска добавьте команду: window "часть имени&nbsp;окна", например:

*window&nbsp;"Блокнот" notepad.exe 
*window&nbsp;"HMI a06f" cmd /c start vcnviewer.exe 192.168.1.1 

Вы можете ввести команду вручную, заполнив&nbsp;свойство "Команда", или с помощью контекстного меню, нажав кнопку "...".

С одной кнопкой может быть связана только одна команда.

==== Измение цвета себя или другой кнопки ====

Примеры команды:

*set --color:#FF0000 [--id:"ID"] [--msg:Включено] 
**--color - изменить цвет на указанный&nbsp; 
**--id - необязательный параметр, идентификатор объекта для изменения цвета, если не указан, кнопка изменит свой цвет 
**--msg -&nbsp;необязательный параметр, изменить надпись кнопки на указанную   
*set --color:#FF0000 
**изменить свой цвет на красный   
*set --color:#FF0000 --id:"{180C224C-BF1D-47FE-A437-D917673EB0C2}" 
**изменить на красный цвет объекта с указанным ID   

==== HTTP(S) GET-запрос ====

Примеры команды:

*[http://192.168.1.100/cgi-bin/test.cgi http://192.168.1.100/cgi-bin/test.cgi] - выполнить HTTP(S) GET-запрос, возможные параметры ([ ] - не обязательные параметры): 
**[--u] - UserName 
**[--p] - UserPassword&nbsp;&nbsp; 
**[--show] - отобразить результат выполнения запроса   

С одной кнопкой может быть связана только одна команда.

==== Сброс TL-линии КИО ====

Сброс линии выполняется либо специальной командой, либо путем перезапуска, как в случае КИО-2М.

Сброс линии USB-пультов, работающих в режиме ретрансляции, поддерживается для версий 2.7.16&nbsp;и выше.&nbsp;

Примеры команды:

*tlreset&nbsp; - выполнить сброс TL-линии связи для устройств типа [[КИО|КИО]]&nbsp;(кроме КИО-Windows).<br/> возможные параметры ([ ] - не обязательные параметры): 
**--ip:192.168.1.100 - IP-адрес устройства 
**[--u] - UserName (если отличается от значения по-умолчанию) 
**[--p] - UserPassword&nbsp;&nbsp; (если отличается от значения по-умолчанию) 
**[--show] - отобразить результат выполнения команды   

С одной кнопкой может быть связана только одна команда.

==== Выполнение внутрисистемной команды ====

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

Примеры внутрисистемных команд:

*150 - Включить/Отключить рабочее освещение 
*151 - Включить/Отключить дежурное освещение 
*153 - Включить/Отключить наружное освещение 
*152 - Отключить все 
*1001 - Открыть телефонную книгу 

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

Специальные команды:

*10 - Общий сброс ПГС 
*11 - Конвертирование карты (преобразование надписей на Примитивах в статический текст: свойство Примитива "Из Названия" -> "По умолчанию") 

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

&nbsp;

==== Запись значения в Item OPC-сервера ====

Вы можете выполнить запись одного или нескольких значений Item OPC-сервера.

Для этого следует перейти в режим ввода команд нажав на кнопку "..." в свойстве Команда.
<pre>N=Desc - добавить описание значения N для Оперативного Журнала
DA.{}...ControlChannel=N Msg - вкл (N=1), выкл (N=0) канал управления
DA.{}...TagName=N Msg - записать значение N (N >= 0) в Item
check - дождаться подтверждения записи значения (max 60c), иначе выход из дальнейшей обработки команд
VAR.Name=N Msg - записать значение (N >= 0) в Переменную
TIMER.Name=M - имитация таймера, сигнал M (M =[0,1])
sleep=M - пауза в M (M > 0) с
\\ Комментарий  - любой комментарий
</pre>

где,&nbsp;

*N, M - целое число 
*Msg - необязательный комментарий, отображаемый в Оперативном Журнале 

Например:
<pre> 0=Выключить
1=Включить
DA.[localhost{...}].КУН-IP8 - 0.ControlChannel01=1 
sleep=1 
DA.[localhost{...}].КУН-IP8 - 0.ControlChannel02=1 
sleep=3 
DA.[localhost{...}].КУН-IP8 - 0.ControlChannel02=0 
sleep=1 
DA.[localhost{...}].КУН-IP8 - 0.ControlChannel01=0 
</pre>

Где,

*0=Выключить - описание значения 0, для отображения в Оперативном журнале 
*DA.[localhost{...}]... =1 - включить канал (записать в Item значение 1) 
*DA.[localhost{...}]... =0 - выключить канал&nbsp;(записать в Item значение 0) 
*sleep=1 - подождать 1 секунду 
*sleep=3 - подождать 3 секунды 

Факт действительного выполнения команды (записи)&nbsp;не проверяется (значение просто записывается в ОРС-сервер), если не указана команда '''check'''.

'''check '''- проверяет, значение Item изменилось на указанное при записи (т.е. указали записать 1 и значение Item изменилось на 1, подразумевается что ОРС-сервер меняет значение Item, толкьо после фактической записи запсиси значения в устройство / контроллер).&nbsp;Если этого не происходит в течение 20 секунд, дальнейшая обработка команд прекращается и информация об ошибке отображается в оперативном журнале.<br/> '''Внимание!''' Функция check работает корректно только с версии АСУД.SCADA 2.7.7 (в более ранних версиях использовать не следует)

Факт нажатия на кнопку отображается в Оперативном журнале SCADA.

Вы можете выполнять запись значения в любой Item OPC-сервера (в который разрешена запись) будь-то канал управления или Item Modbus-устройства.

Команды '''вводятся с помощью меню''' (при нажатии правой кнопки мыши).

Пример см. [https://www.youtube.com/watch?v=-4_c-EbsDYo&feature=youtu.be здесь]

==== Имитация сработки Таймера ====

Начиная с версии 2.5.3&nbsp;примитив может быть использован для имитации сработки [[Tekon_Scada#Таймеры|Таймеров]].

Для этого следует перейти в режим ввода команд нажав на кнопку "..." в свойстве Команда. Выбрать контекстное меню "Имитация сработки таймера"
<pre> TIMER.Таймер=1
</pre>

Где,

*TIMER.Таймер=1 - имитировать сработку таймера "Таймер" со значением сигнала 1. 

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

Подробнее о таймерах см. описание [[Tekon_Scada#Таймеры|АСУД.SCADA]]

==== Активация / деактивация&nbsp;Таймера ====

Начиная с версии 2.7.6&nbsp;примитив может быть использован для перевода&nbsp;&nbsp;[[Tekon_Scada#Таймеры|Таймеров]]&nbsp;в ручное управление

Для этого следует перейти в режим ввода команд нажав на кнопку "..." в свойстве Команда. Выбрать контекстное меню "Активировать таймер"
<pre> TIMER.Таймер=1001
</pre>

Где,

*TIMER.Таймер=1001 - активировать таймер "Таймер" - т.е. перевести в рабочее состояние. 
<pre>TIMER.Таймер=1000
</pre>

Где,

*TIMER.Таймер=1000&nbsp;- деактивировать таймер "Таймер" - т.е. перевести в&nbsp;состояние отключен. 

Подробнее о таймерах см. описание [[Tekon_Scada#Таймеры|АСУД.SCADA]]

&nbsp;

=== Агрегатор каналов&nbsp;управления ===
<pre>Обновления:
2.7.15
&nbsp;- примитив существенно доработан
&nbsp;- добавлена возможность указать каналы обратной связи (ОС)
&nbsp;- добавлена поддержка Журнала событий
Доступен с версии 2.6.4</pre>

Описание работы примитива для версий до 2.7.15 смотри [http://wiki.tekon.ru/index.php?title=Дополнительные_примитивы&oldid=9127 здесь]&nbsp;

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

Это может быть полезно, например: при управлении большим числом задвижек&nbsp;(клапанов), подключенных к управляющим концентраторам&nbsp;[[КУП-4RS|КУП-4RS]]&nbsp;и т.п.

&nbsp;[[File:Prim control aggregator.PNG|center|400px|Prim control aggregator.PNG]]Примитив позволяет:

*Настроить связку имя Группы&nbsp;- Набор каналов управления 
*Удобно переключаться между группами 
*Отобразить текущее состояние каналов управления и каналов обратной связи,&nbsp;входящих в выбранную группу 
*Включить / Выключить выбранный канал 
*Включить / Выключить все каналы&nbsp;выбранной&nbsp;группы 
*Включить / Выключить все настроенные каналы управления 
*Отобразить статистику по каналам управления 
**Общее количество каналов 
**Находящихся в состоянии Включен \ Выключен 
**Количество неисправных каналов управления&nbsp; (концентраторы без связи)   
*Отобразить список групп, в которых присутствуют Включенные \ Выключенные каналы 
*Отобразить список групп, в которых присутствуют неисправные каналы&nbsp;(концентраторы без связи) 

Настройки примитива:

*Теги - настройка связки&nbsp; имя Группа - Набор каналов управления и обратной связи 
*Отображать ВЫКЛ - [Да \ Нет] отображать в отдельном окне примитива группы, в которых присутствуют каналы управления в состоянии выключен. Иначе отображать группы с примитивами включен. 
*Подтверждать ВКЛ - требовать дополнительное&nbsp; подтверждение оператора на включение канала 
*Подтверждать ВЫКЛ -&nbsp; - требовать дополнительное&nbsp; подтверждение оператора на выключение канала 

В настройке Теги следует указать привязку каналов управления к группе&nbsp;

[[File:Prim control aggregator tag.PNG|center|400px|Prim control aggregator tag.PNG]]

Общий формат настройки&nbsp;
<pre>#Группа 1
DA.[...].xxx.ControlChannel1=Название канала 1.1
DA.[...].xxx.Sensor1
DA.[...].xxx.ControlChannel2=Название канала 1.2
DA.[...].xxx.Sensor4 
#Группа 2
DA.[...].xxx.ControlChannel1=Название канала 2.1
DA.[...].xxx.ControlChannel2=Название канала 2.2
</pre>

После знака = для каналов управления указывается название, которое будет отображено на первой вкладке примитива при выборе группы&nbsp; для идентификации канала управления.&nbsp;<br/> То что указывается после = для дискретных каналов - нигде не используется.&nbsp;

Sensor&nbsp; - это канал обратной связи (ОС) для предыдущего канала управления.

Если в группе используются каналы ОС, то они должны быть указаны для каждого канала группы. Например: в Группа 1 - присуствуют каналы ОС, а в группе 2 - нет.

Если канал ОС один на несколько каналов управления - он указывается (дублируется) для каждого из этих каналов, например:
<pre>#Название группы 1
DA.[...].xxx.ControlChannel1=Название канала 1.1
DA.[...].xxx.Sensor1
DA.[...].xxx.ControlChannel2=Название канала 1.2
DA.[...].xxx.Sensor1</pre>

Sensor1 - это общий канал обратной связи для каналов&nbsp;ControlChannel1 и&nbsp;ControlChannel2

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

Автоматическая настройка возможна, если наименование каналов управление и каналов обратной связи в ОРС-сервере производилось по-правилу:
<pre>Название группы ; Название канала
</pre>

Т.е., например, окне настройки&nbsp;концентратора&nbsp;[[КУП-4RS|КУП-4RS]]&nbsp; в&nbsp;[[Tekon_OPC-сервер|Tekon OPC-сервер]]&nbsp;для каналов управления вы указывали настройку "Журнал&nbsp; \ Название", как&nbsp;

[[File:Prim control aggregator nastr.PNG|center|Prim control aggregator nastr.PNG]]В этом случае примитив перенесет настройки сервера молниеносно.&nbsp;

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

[[File:Prim control aggregator work.PNG|center|400px|Prim control aggregator work.PNG]]

Текущее состояние канала отображает

*Дату \ Время последнего изменения состояния 
*Подсвечивается 
**Желтым - для каналов в состоянии включен 
**Белым - выключенных 
**Бирюзовым - включаемых / выключаемых в настоящий момент 
**Синим - неисправных   

Если вы настроили в группе каналы ОС, то примитив в рабочем режиме будет выглядеть следующим образом&nbsp;

[[File:Aggregator work1.PNG|center|400px|Prim control aggregator work.PNG]]При этом логика подсчета выключенных / включенных каналов меняется.&nbsp; Канал считается включеным только, если пришло подтвержедение от канала обратной связи.<br/> Например, для канала ГВС&nbsp; - канал включен, но подтверждения от датчика ОС - нет.

Для отображения&nbsp; в рабочем режиме Тега,&nbsp;с которым связан канал, выполните двойной клик на "Названии" канала.&nbsp;

Для отображения архивных значений сигнала следует выполнить Shift-клик по требуемой ячейке в 1 или 2 столбце.&nbsp;

&nbsp;

&nbsp;

[[Category:SCADA]]