Ошибка скрипта в TRASSIR чаще всего проявляется красным значком на объекте в дереве оборудования, сообщением в логе сервера и прекращением работы сценария автоматизации — при этом остальная система видеонаблюдения продолжает функционировать. Поскольку скрипты в TRASSIR пишутся на языке Python и исполняются внутри сервера, источник проблемы обычно лежит в одной из трёх зон: синтаксис кода, несовместимость с версией ПО или неверные ссылки на объекты системы (камеры, детекторы, зоны).
Ниже разберём, как локализовать сбой, где смотреть диагностическую информацию и какие типовые причины встречаются у пользователей TRASSIR чаще всего. Материал ориентирован на администратора, который имеет доступ к серверу и веб-интерфейсу или клиенту TRASSIR.
Где TRASSIR показывает ошибки скриптов
Первым делом нужно понять, что именно сообщает система. В интерфейсе TRASSIR скрипт с ошибкой помечается визуально, а подробности попадают в журнал событий и лог-файлы сервера. Откройте раздел автоматизации (в разных версиях он может называться «Скрипты» или находиться в настройках объекта) и проверьте статус проблемного сценария.
Текст ошибки обычно содержит номер строки и тип исключения Python — например, SyntaxError, NameError или AttributeError. Это ключевая зацепка: по типу исключения можно сразу сузить круг поиска. Если сообщение обрезано в интерфейсе, полный текст ищите в логах сервера на диске — их расположение зависит от версии TRASSIR и операционной системы, поэтому точный путь стоит уточнить в документации вашей версии.
Типовые причины ошибок скриптов
Практика показывает, что большинство сбоев сводится к ограниченному набору причин. Проверять их удобно от простого к сложному.
- 🔧 Синтаксическая ошибка — лишний или пропущенный отступ, незакрытая скобка, кавычки не того типа. Python чувствителен к отступам, и даже один пробел ломает весь скрипт.
- 📷 Ссылка на несуществующий объект — скрипт обращается к камере или детектору, который был удалён, переименован или отключён.
- 🔄 Несовместимость версий — скрипт написан под другую версию TRASSIR, где изменился программный интерфейс (API) скриптов.
- ⛔ Ошибка времени выполнения — деление на ноль, обращение к пустому значению, недоступный сетевой ресурс внутри логики сценария.
- 💾 Проблемы с правами или ресурсами — серверу не хватает памяти, либо скрипт пытается выполнить действие, недоступное в его окружении.
Отдельный частый случай — скрипт, который «работал раньше, а после обновления перестал». Здесь почти наверняка причина в изменении API: функция или объект, к которым обращается сценарий, в новой версии могли быть переименованы или удалены. Такие изменения описываются в примечаниях к релизу, и сверка с ними — самый быстрый путь к ответу.
Как диагностировать проблему пошагово
Действуйте последовательно, фиксируя результат каждого шага. Это позволит не только найти причину, но и откатиться, если правка ухудшит ситуацию.
- Скопируйте текущий код скрипта в отдельный файл — это ваша резервная копия.
- Прочитайте полный текст ошибки в журнале: тип исключения и номер строки.
- Проверьте указанную строку и несколько строк выше неё на предмет синтаксиса: отступы, скобки, кавычки.
- Убедитесь, что все объекты, к которым обращается скрипт (камеры, зоны, детекторы), существуют и активны в дереве оборудования.
- Сохраните исправленный вариант и перезапустите скрипт, наблюдая за журналом.
☑️ Проверка скрипта TRASSIR перед запуском
⚠️ Внимание: не редактируйте работающий скрипт прямо на производственном сервере без резервной копии. Ошибочная правка может остановить сценарий, который участвует в реакциях системы — например, в отправке тревожных уведомлений.
Чтение типовых сообщений об ошибках
Тип исключения в сообщении — уже половина диагноза. Ниже сведены типовые ошибки Python, которые встречаются при работе со скриптами TRASSIR, и их вероятные причины.
| Тип ошибки | Что означает | Что проверить |
|---|---|---|
SyntaxError | Нарушен синтаксис кода | Отступы, скобки, кавычки в указанной строке |
NameError | Используется необъявленная переменная или функция | Опечатки в именах, порядок объявления |
AttributeError | У объекта нет запрошенного метода или свойства | Совместимость с версией API, тип объекта |
TypeError | Неверный тип аргумента | Что передаётся в функцию — число, строка, объект |
KeyError | Обращение к отсутствующему ключу | Имена объектов и параметров системы |
Обратите внимание: AttributeError и TypeError после обновления TRASSIR почти всегда указывают на изменение программного интерфейса. В этом случае правка кода неизбежна — нужно заменить вызовы на актуальные для вашей версии, сверяясь с официальной документацией по скриптовому API.
Ошибки после обновления TRASSIR
Обновление сервера — самый частый триггер массовых сбоев скриптов. Сценарий, написанный под старую версию, может перестать запускаться, потому что разработчик изменил набор доступных функций, поведение объектов или структуру событий. Это нормальная ситуация для развивающейся платформы, но она требует реакции.
Порядок действий здесь такой: сначала изучите примечания к релизу установленной версии — там перечисляются изменения, затрагивающие скрипты. Затем сопоставьте их с вызовами в вашем коде. Если скрипт получен от интегратора или из открытого источника, проверьте, для какой версии TRASSIR он заявлен. Никогда не обновляйте боевой сервер, не проверив скрипты на тестовом стенде или хотя бы не сохранив полную резервную копию конфигурации.
Как временно отключить проблемный скрипт
Если скрипт мешает работе или сыпет ошибками в журнал, деактивируйте его в разделе автоматизации вместо удаления. Так вы сохраните код для последующего разбора и сможете быстро вернуть сценарий после исправления. Точное расположение переключателя зависит от версии интерфейса.
Когда обращаться к разработчику или интегратору
Не каждую ошибку стоит чинить самостоятельно. Если скрипт написан сторонним интегратором и находится на сопровождении, самостоятельные правки могут нарушить условия поддержки. Аналогично, если сценарий реализует критичную логику — контроль доступа, взаимодействие с тревожными системами, экспорт архива, — ошибочное исправление способно привести к потере функциональности в ответственный момент.
Разумный критерий: синтаксические ошибки и ссылки на переименованные объекты можно исправлять самостоятельно, а изменения логики, связанные с API новых версий, лучше согласовывать с автором скрипта или изучать по официальной документации. Техническая поддержка разработчика TRASSIR также принимает обращения по вопросам скриптового API — для этого подготовьте текст ошибки, версию сервера и сам код.
⚠️ Внимание: скрипты, управляющие реакциями системы безопасности (тревоги, СКУД, оповещение), после любого исправления нужно проверять тестовым срабатыванием. Успешный запуск без ошибок в журнале ещё не гарантирует, что сценарий выполняет нужное действие.
Профилактика сбоев скриптов
Несколько простых привычек заметно снижают число проблем со скриптами в перспективе.
- 🗂️ Ведите версионирование: сохраняйте каждую рабочую редакцию скрипта с датой и комментарием.
- 🧪 Тестируйте новые сценарии и обновления ПО на отдельном сервере или в нерабочее время.
- 📋 После переименования или удаления камер проверяйте, какие скрипты на них ссылаются.
- 📖 Храните ссылку на документацию по скриптовому API именно вашей версии TRASSIR.
Регулярный просмотр журнала сервера — тоже часть профилактики: ошибки, которые не останавливают скрипт полностью, могут накапливаться незаметно и проявиться в самый неподходящий момент.
Часто задаваемые вопросы
Почему скрипт TRASSIR перестал работать после обновления сервера?
Наиболее вероятная причина — изменение скриптового API в новой версии: вызываемые функции или объекты могли быть переименованы либо удалены. Сверьте код с примечаниями к релизу и документацией вашей версии, замените устаревшие вызовы.
Где посмотреть полный текст ошибки скрипта?
Краткое сообщение отображается в интерфейсе рядом со скриптом и в журнале событий. Полный traceback ищите в лог-файлах сервера — их расположение зависит от версии TRASSIR и ОС, уточните путь в документации.
Скрипт запускается без ошибок, но не выполняет нужное действие. Что делать?
Это логическая, а не синтаксическая ошибка: код корректен, но условия срабатывания не наступают или объекты выбраны неверно. Добавьте отладочные сообщения в журнал на каждом этапе сценария и проверьте, какие ветки логики реально выполняются.
Можно ли запускать скрипты, написанные для другой версии TRASSIR?
Можно попробовать, но совместимость не гарантирована. Перед запуском проверьте, что все используемые функции и объекты существуют в вашей версии API, и обязательно протестируйте сценарий в безопасном режиме с наблюдением за журналом.
Что делать, если после правки скрипта появилась новая ошибка?
Верните резервную копию исходного кода, убедитесь, что исходная ошибка воспроизводится, и вносите правки по одной, проверяя результат после каждой. Это позволит точно определить, какое изменение вызвало новую проблему.