Text-функция: различия между версиями

Материал из TekonWiki
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 1: Строка 1:
[[Category:ДокументацияСКАДА]]
[[Category:ДокументацияСКАДА]]
== Введение ==
Text-функции позволяют выполнить простое преобразование в программе SCADA путем сопоставления:
Text-функции позволяют выполнить простое преобразование в программе SCADA путем сопоставления:
  Число = значение
  Число = значение
Строка 34: Строка 35:
* Имя Text-функции в настройках примитивов указывается без ''.txt'', т.е. func1, а не func1.txt
* Имя Text-функции в настройках примитивов указывается без ''.txt'', т.е. func1, а не func1.txt
* Имя функции не чувствительно в регистру, т.е.  Func1 = func1 = FUNC1
* Имя функции не чувствительно в регистру, т.е.  Func1 = func1 = FUNC1
== Настройка ==
=== До версии 2.4.1 ===
Для добавления/изменения Text-функции необходимо перейти в SCADA в режим настройки, выбрать меню ''Файл \ Рабочая папка'' и перейти в папку scripts \ text или открыть в проводнике папку
...\ASUD Scada \ SCADA \ scripts \ text
Далее создать или отредактировать в этой папке Текстовый файл, имя которого cоответствует Имени Text-функции.
Для вступления изменений в силу (при добавлении нового файла или изменения существующего), необходимо выполнить перезапуск SCADA.
=== С версии 2.4.1 ===
Вы можете добавлять / редактировать Text-функции непосредственно в SCADA (при этом для вступления изменений в силу не требуется перезапуск SCADA), открыв меню ''Дополнительно \ Text-функции'' в режиме Настройки.
[[Файл:Text func1.JPG|200px|центр]]
В открывшемся окне вы можете:
* добавить новую функцию
* изменить существующую функцию
После изменения функции следует нажать ''Сохранить''.
В случае если в теле функции есть ошибки, программа сообщит об этом. При этом, можно вернуться к предыдущей версии, нажав ''Вернуть''.
Причины ошибок:
* Повтор идентификаторов в нескольких строчках
* Лишние пробелы: например, 0 = Останов (правильно: 0=Останов)
* Лишние пустые строки
* Ошибка в выражении (подробнее см. далее)
== Дополнительно ==
Начиная с версии 2.4.1
В Text-функции добавлена поддержка выражений. В случае необходимости вы можете добавить предварительную обработку входного значения 
Выражение задается в первой строке Text-функции начиная с символа #, например:
<nowiki>
# BIT(X;1)
0=Норма
1=Авария
</nowiki>
, где X - это условное обозначение Item-а.
При использовании данной функции будет браться первый бит значения связанного Item-a ОРС-сервера.

Версия от 16:18, 27 декабря 2018

Введение

Text-функции позволяют выполнить простое преобразование в программе SCADA путем сопоставления:

Число = значение

, где:

  • число - это значение Item-a ОРС-сервера, или параметра из БД.
  • значение - некоторая строка.

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

Поддержка Text-функций на данный момент реализована в:

Функции находятся в папке Tekon \ ASUD Scada \ Scada \ scripts \ text

Функция - это обычный текстовый файл (.txt), название которого является названием самой функции.

Пример: функции func1 - файл func1.txt

0=Останов
1=Работа
3=Авария ДТ

Пример функции func2 - файл func2.txt

0=Зима
1=Лето

Замечания:

  • Имя Text-функции в настройках примитивов указывается без .txt, т.е. func1, а не func1.txt
  • Имя функции не чувствительно в регистру, т.е. Func1 = func1 = FUNC1

Настройка

До версии 2.4.1

Для добавления/изменения Text-функции необходимо перейти в SCADA в режим настройки, выбрать меню Файл \ Рабочая папка и перейти в папку scripts \ text или открыть в проводнике папку ...\ASUD Scada \ SCADA \ scripts \ text

Далее создать или отредактировать в этой папке Текстовый файл, имя которого cоответствует Имени Text-функции.

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

С версии 2.4.1

Вы можете добавлять / редактировать Text-функции непосредственно в SCADA (при этом для вступления изменений в силу не требуется перезапуск SCADA), открыв меню Дополнительно \ Text-функции в режиме Настройки.

В открывшемся окне вы можете:

  • добавить новую функцию
  • изменить существующую функцию

После изменения функции следует нажать Сохранить.

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

Причины ошибок:

  • Повтор идентификаторов в нескольких строчках
  • Лишние пробелы: например, 0 = Останов (правильно: 0=Останов)
  • Лишние пустые строки
  • Ошибка в выражении (подробнее см. далее)

Дополнительно

Начиная с версии 2.4.1

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

Выражение задается в первой строке Text-функции начиная с символа #, например:

# BIT(X;1)
0=Норма
1=Авария

, где X - это условное обозначение Item-а.

При использовании данной функции будет браться первый бит значения связанного Item-a ОРС-сервера.