Перейти к содержимому

Серверные скрипты

Серверные скрипты выполняются на сервере без оператора: счётчики, расписания, блокировки, последовательности, отчёты, обмен с базами данных. Их запускают задачи, вызов HMI.RunServerScript с экрана и элемент Таблица с источником «функция».

Серверные скрипты

  • Модули serverscripts/*.js загружаются при запуске проекта, по порядку. Их глобальные переменные живут, пока работает среда исполнения. После перезапуска или применения новой версии проекта они начинаются заново.
  • Все задачи и вызовы выполняются по очереди в одном потоке, как цикл контроллера. Два скрипта никогда не работают одновременно, поэтому глобальные переменные не нужно защищать.
  • Записи тегов и системные функции, вызванные из скрипта, выполняются по порядку после него. Если скрипт завершился ошибкой, они отменяются.
  • Очередь вмещает 10 000 запусков. Периодическая задача, которая ещё ждёт выполнения, второй раз в очередь не ставится, поэтому запуски не копятся.
Ограничение Значение
Время одного запуска 5 секунд, включая запросы к базе
Число операций 2 000 000
Глубина рекурсии 256
Память 64 МБ

Доступен стандартный JavaScript. setTimeout, fetch и require не определены. Для повторения используйте задачу «Периодически», для ожидания — задачу «Условие».

Как запущен Когда Trigger.Tag Trigger.Value Trigger.Previous Trigger.User
Задача «При запуске» Один раз при старте проекта null null null Сервер
Задача «Периодически» Каждые N секунд, минимум 0,1 с null null null Сервер
Задача «Ежедневно» В заданное время сервера, по выбранным дням null null null Сервер
Задача «Изменение тега» При каждом новом значении с качеством Good Тег Новое значение Прежнее значение, в первый раз null Сервер
Задача «Условие» Когда условие становится истинным Тег Значение тега null Сервер
HMI.RunServerScript с экрана По действию оператора null null null Имя оператора
Таблица на экране При открытии и по периоду обновления таблицы null null null Сервер

Trigger.Task содержит имя задачи. Во время загрузки модуля Trigger равен null.

Особенности расписаний:

  • «Периодически» впервые срабатывает через один период после запуска. Если сервер был занят или спал, пропущенные запуски не догоняются.
  • «Ежедневно» использует местное время сервера. Время пишется как 08:00 или 08:00:30.
  • «Условие» срабатывает по переходу из «ложно» в «истинно». Если условие истинно уже при запуске, задача тоже сработает. Сравнивать можно с числом, true/false или другим тегом. Во втором случае условие пересчитывается и при изменении этого тега.
  • «Изменение тега» и «Условие» учитывают только значения с качеством Good.
const level = Tags("Tank1.Level");
Член Описание
.Name Имя тега
.Value Значение при качестве Good или Uncertain, иначе null
.Read() То же, что .Value
.Quality Good, Uncertain, Bad, CommFailure, ConfigError, NoData
.Timestamp Время последнего изменения, ISO 8601, UTC: 2026-11-16T09:30:00.0000000+00:00
.Write(value) Запись после скрипта

В отличие от клиента, на сервере .Value при потере связи равен null. Логические значения приходят как true/false, числа — как числа, строки — как строки.

Write принимает число, логическое значение или строку. Строка для нестрокового тега разбирается как ввод оператора. null записать нельзя.

Член Описание
Server.Now Местное время сервера строкой: 2026-11-16T12:30:00
Server.TextList(list, value) Текст из списка текстов
Server.SysFct(name, ...args) Системная функция по имени, после скрипта

На сервере работают функции:

Функция Параметры по порядку
SetBit, ResetBit, InvertBit Tag
SetBitInTag, ResetBitInTag, InvertBitInTag Tag, Bit
SetValue Tag, Value
IncreaseValue, DecreaseValue Tag, Step = 1, Limit?
CopyValue Target, Source
LinearScaling, InvertLinearScaling Target, Source, X1, X2, Y1, Y2
ShiftAndMask Target, Source, Shift = 0, Mask = 65535
AcknowledgeAllAlarms —
AcknowledgeAlarm Alarm
RunScript Function, Argument?

Функции окон и экранов на сервере не работают, вызов приведёт к ошибке «работает только на экране оператора».

Server.SysFct("IncreaseValue", "Counter", 1, 1000);
Server.SysFct("LinearScaling", "Tank1.Percent", "Tank1.Level", 0, 10, 0, 100);
Server.SysFct("AcknowledgeAlarm", "Tank1.HighLevel");

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

Метод Уровень
Log.Info(text), console.log(text) Информация
Log.Warn(text), console.warn(text) Предупреждение
Log.Error(text), console.error(text) Ошибка

Записи видны в окне среды исполнения и в файлах %ProgramData%\Scadora\logs, по файлу на день. Ошибки скриптов попадают в журнал автоматически вместе с именем задачи.

Функцию модуля можно вызвать с экрана:

serverscripts/Main.js
function startSequence(recipe) {
if (Tags("Line.Fault").Value) throw new Error("линия в аварии");
Log.Info(Trigger.User + " запустил рецепт " + recipe);
Tags("Seq.Recipe").Write(Number(recipe));
Tags("Seq.Start").Write(true);
}
// скрипт кнопки на экране
HMI.RunServerScript("startSequence", "3");

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

Элемент Таблица с источником «функция» вызывает функцию без аргументов и показывает результат.

// Массив массивов: первая строка — данные, заголовки задаются в свойствах таблицы.
function pumpsTable() {
return ["Pump1", "Pump2", "Pump3"].map(p => [p, Tags(p + ".Run").Value ? "Работа" : "Стоп", Tags(p + ".Hours").Value]);
}
// Массив объектов: колонки берутся из свойств первой строки.
function ordersTable() {
return Db.Query("Журнал", "SELECT Name AS Заказ, Qty AS Количество FROM Orders ORDER BY Id DESC");
}

Таблице передаётся не больше 1000 строк.

Базы описываются в узле Базы данных редактора: SQLite (файл, драйвер не нужен) или ODBC (SQL Server, PostgreSQL, MySQL, Oracle, Access).

Метод Результат
Db.Query(base, sql, params) Массив объектов: row.Name, row["Имя колонки"]
Db.Execute(base, sql, params) Число изменённых строк
Db.Scalar(base, sql, params) Первое значение первой строки или null

Параметры подставляются вместо ? по порядку. Их можно передать массивом или списком аргументов:

Db.Execute("Журнал", "INSERT INTO Events(Time, Text) VALUES(?, ?)", [Server.Now, "Пуск"]);
Db.Execute("Журнал", "INSERT INTO Events(Time, Text) VALUES(?, ?)", Server.Now, "Пуск");

Всегда передавайте значения параметрами, а не склейкой строк: так не будет ошибок с кавычками и SQL-инъекций.

Тип в базе Значение в скрипте
Число Число
Строка Строка
Логическое true / false
Дата и время Строка ISO: 2026-11-16T12:30:00
Двоичные данные Строка Base64
NULL null

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

Относительный путь считается от папки проекта. Абсолютные пути тоже разрешены.

Функция Действие
File.Exists(path) Есть ли файл
File.ReadText(path) Весь текст файла
File.ReadLines(path) Массив строк
File.ReadCsv(path, sep) Массив строк-массивов; разделитель по умолчанию ;, кавычки понимаются, пустые строки пропускаются
File.WriteText(path, text) Записать файл целиком, создав папки
File.AppendText(path, text) Дописать в конец, создав файл и папки

Записанные файлы в кодировке UTF-8. Перевод строки добавляйте сами: "\r\n" для программ Windows.

File.AppendText("logs/shift.csv", [Server.Now, Tags("Line.Count").Value].join(";") + "\r\n");