Отладка и ошибки
Как посмотреть, что происходит
Заголовок раздела «Как посмотреть, что происходит»На экране оператора выведите значения сообщением. JSON.stringify показывает объект целиком:
HMI.ShowMessage(JSON.stringify({ level: Tags("Tank1.Level").Value, quality: Tags("Tank1.Level").Quality, fill: Item.Actual("Fill"),}, null, 2));Чтобы узнать, как устроен элемент и какие поля у него можно менять:
HMI.ShowMessage(JSON.stringify(Item.Properties(), null, 2)); // свойства из панелиHMI.ShowMessage(JSON.stringify(Item.Config, null, 2)); // полная настройкаНа сервере пишите в журнал. Записи видны в окне среды исполнения на вкладке журнала и в файлах %ProgramData%\Scadora\logs:
Log.Info("Задача " + Trigger.Task + ": " + Trigger.Tag + " = " + Trigger.Value);Перед запуском смотрите панель Проверка проекта в редакторе: там видны синтаксические ошибки скриптов, неизвестные теги в функциях и пустые события.
Частые ошибки
Заголовок раздела «Частые ошибки»Скрипты на экране
Заголовок раздела «Скрипты на экране»| Сообщение | Причина | Что делать |
|---|---|---|
| Тег «…» не найден | В проекте нет тега с таким именем | Проверьте имя; переименованный тег в собранных из частей именах не обновляется |
| …: нельзя записать пустое значение | В Write передан null или undefined |
Проверьте, что значение посчитано, например тег не вернул null |
| …: недостаточно прав для изменения | У роли пользователя нет права на запись этого тега | Дайте роли право или смените защиту тега |
| Введите 1 или 0 | Строка не подходит для тега Bool |
Передавайте true / false |
| Введите целое число | Строка не разбирается как целое для целого тега | Передайте число, а не текст с единицами |
| Допустимо от … до … | Число не помещается в тип тега | Ограничьте значение в скрипте |
| Системная функция «…» не найдена | Опечатка в имени функции HMI.SysFct |
Имена английские: SetValue, ActivateScreen |
| Функция скрипта «…» не найдена | RunScript вызывает функцию, которой нет в модулях |
Проверьте имя и что модуль загрузился без ошибок |
| На экране нет объекта «…» | Screen.Items не нашёл элемент с таким именем |
Проверьте свойство Имя; внутри джинов используйте Children |
| У объекта «…» нет свойства … | Опечатка или у этого типа нет свойства | Смотрите справочник свойств, проверяйте Has |
| …: цвет записывается как #RRGGBB | Цвет указан словом или в другом формате | "#D32F2F", а не "red" |
| …: значение «…» не подходит | Значение не приводится к типу свойства | Для выбора из списка передайте имя варианта |
| …Apply: нет поля … | В Apply передано неизвестное поле |
Посмотрите Item.Config: поля с маленькой буквы |
| Нет события … | Опечатка в Raise |
Имена: Click, DoubleClick, LeftDown и т. д. |
| У объекта «…» нет тега | .Value у элемента без свойства Tag |
Читайте тег через Tags(…) |
| Экран «…» не найден | ActivateScreen с неверным именем |
Имя экрана, а не заголовок |
| Недостаточно прав для управления | RunServerScript без права «Управление» |
Дайте роли право |
| скрипт выполнялся дольше 2 с и остановлен | Долгий цикл или тяжёлые вычисления | Упростите; тяжёлую работу перенесите на сервер |
| скрипт выполнил слишком много операций и остановлен | Скорее всего, вечный цикл | Проверьте условие выхода из цикла |
| слишком глубокая рекурсия | Функция вызывает себя слишком глубоко | Замените рекурсию циклом |
| строка N: … | Синтаксическая ошибка | Номер строки считается от начала скрипта события |
Серверные скрипты
Заголовок раздела «Серверные скрипты»| Сообщение в журнале | Причина | Что делать |
|---|---|---|
| Серверный скрипт …: … | Ошибка при загрузке модуля | Исправьте код верхнего уровня модуля |
| Функция серверного скрипта «…» не найдена | Неверное имя в задаче или в RunServerScript |
Проверьте имя и загрузку модуля |
| Функция «…» работает только на экране оператора | В задаче или в Server.SysFct вызвана функция окна |
На сервере доступны теги, вычисления, квитирование и RunScript |
| База данных «…» не найдена в проекте | Имя в Db.Query не совпадает с узлом Базы данных |
Проверьте имя базы |
| База «…»: … | Ошибка подключения или SQL | Текст после двоеточия — от драйвера базы |
| Файл «…»: … | Нет файла, нет прав, занят | Проверьте путь; относительный путь считается от папки проекта |
| У тега … нет значения | Функция читает тег без достоверного значения | Дождитесь связи или проверяйте .Quality |
| Задача … пропущена: очередь серверных скриптов переполнена | Задачи запускаются чаще, чем успевают выполниться | Реже запускайте или упростите задачи |
Типичные ловушки
Заголовок раздела «Типичные ловушки»Чтение после записи. Записи выполняются после скрипта, поэтому значение, только что переданное в Write, в том же скрипте ещё не прочитать. Держите его в переменной.
Сравнение с null. Пока значения нет, .Value равен null, а null > 5 в JavaScript — false. Проверяйте .Quality === "Good", прежде чем принимать решение.
Числа из RunScript. Аргумент приходит строкой: "2" + 1 даёт "21". Используйте Number(arg).
Скрипт против анимации. Если цвет или видимость управляются анимацией, она перекрывает значение из скрипта при каждом обновлении тега. Сравните Item.Get("Fill") и Item.Actual("Fill").
Вопрос в браузере. После HMI.Confirm скрипт в браузере выполняется заново с начала. Не увеличивайте счётчики до вопроса.
Имена, собранные из частей. Tags("Pump" + n + ".Run") работает, но при переименовании тегов такие имена не обновятся автоматически.
Защитные функции. Скрипты зависят от клиента, сервера и сети. Аварийные защиты должны выполняться в контроллере.