Серверные скрипты
Серверные скрипты выполняются на сервере без оператора: счётчики, расписания, блокировки, последовательности, отчёты, обмен с базами данных. Их запускают задачи, вызов 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
Заголовок раздела «Объект Server»| Член | Описание |
|---|---|
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, по файлу на день. Ошибки скриптов попадают в журнал автоматически вместе с именем задачи.
Функции для экрана
Заголовок раздела «Функции для экрана»Функцию модуля можно вызвать с экрана:
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");