Smart Client язык сценариев и ограничения
Smart Client Сценарии используют ограниченный набор C# внутри XML. Когда XProtect Smart Client При загрузке файла сценария он сверяет файл со списком допустимых функций и действий языка. Если какая-либо часть сценария недействительна, тело сценария и триггеры событий не будут выполняться; однако <Login> Блокировка по-прежнему применяется.
Структура файлов
Сохраните файл с помощью .scs расширение, закодированное как UTF-8. Рекомендуется использовать UTF-8 без спецификации.
Элемент | Обязательно | Описание |
|---|---|---|
| Да | Корневой элемент. |
| Нет | Версия формата файла. Версия по умолчанию и текущая |
| Нет | Сведения о входе в систему. См. раздел Автоматизация входа с помощью сценариев. |
| Нет | Тело сценария. Выполняется один раз при входе в систему. |
| Нет | Активатор события. Файл может иметь одно событие. |
Примечание
Устаревшие элементы, такие как <ScriptExtension> и любые <ScriptLanguage> (кроме C#, отклоняются обработчиком сценариев.)
Специальные символы
Чтение XML <, >, и & в виде разметки. Перенос кода сценария в <![CDATA[ … ]]>, что рекомендуется, или замените каждый символ на его XML-сущность:
Символ | Объект |
|---|---|
|
|
|
|
|
|
Поддерживаемый язык
Переменные | Подробно |
|---|---|
Переменные |
|
Условия |
|
Циклы |
|
Операторы |
|
Строки | Рекомендуется использовать двойные кавычки (обработчик принимает одинарные кавычки, но они генерируют предупреждение и не являются допустимыми для C#). Соединить строки с помощью |
Комментарии |
|
Действия
Тип действия | Синтаксис | Примечания |
|---|---|---|
Встроенные действия |
| Прямые методы, предоставляемые Smart Client обработчик сценариев (например, Доступные группы |
Представления, выводы, события и предварительные настройки PTZ |
| Самая Пример: Эти имена одинаковы для всех языков отображения клиента. Если два элемента в одной группе отличаются только специальными символами (например, Cam-1 и Cam-1), они генерируют один и тот же идентификатор, и доступен только один из них; переименуйте один из элементов, чтобы устранить коллизию. |
Действия подключаемого модуля MIP, по имени |
| Самая |
Действия по идентификатору |
| Независимый от языка уникальный идентификатор. Имена и идентификаторы отображаются в созданном файле сценария, если установлен флажок Включить элементы конфигурации, что позволяет скопировать точный идентификатор непосредственно в сценарий. |
Чтобы просмотреть все действия, доступные в вашей системе, создайте ссылку на сценарий.
Встроенные функции
Функция | Описание |
|---|---|
| Приостанавливает выполнение сценария без зависания XProtect Smart Client. Принимает 0–30 000 мс. |
| Уведомление в области уведомлений. Он не блокирует сценарий или пользовательский интерфейс. |
| Значения даты и времени. Вы можете читать |
| Операции с уникальным идентификатором. |
| Запись в |
| В триггере события возвращает идентификатор окна, в котором произошло событие. Возвращает пустой текст в главном окне, в теле сценария и в Примечание. Эта функция может возвращать идентификатор встроенного окна (например, области просмотра внутри вкладки), который не |
Триггеры событий
Определить <OnEvent> блоки внутри <ScriptEngine> корневой элемент для реагирования на действия пользователя и изменения рабочей области.
Событие | Запуски |
|---|---|
| После каждой завершенной перезагрузки конфигурации, когда представления и вкладки устоятся. Не запускается при первом входе в систему. |
| После выбора другого представления в любом окне. |
| После выбора другого элемента представления в любом окне. |
| После изменения выбранной вкладки или переключения окна между режимами "Наблюдение" и "Воспроизведение". ПримечаниеНекоторые рабочие области, такие как Диспетчер сигналов тревоги и Экспорт, содержат собственные встроенные области просмотра. Каждая встроенная область представления сообщает о своем создании, используя идентификатор, который не относится к плавающему окну. Таким образом, может выполняться переключение на одну из этих вкладок ShownWorkSpaceChanged несколько раз (например, Диспетчер тревог имеет две встроенные области просмотра и Экспорты имеет один, так что переключение на Диспетчер тревог может запустить триггер (до трех раз). Ваш сценарий должен игнорировать нераспознанные идентификаторы окон. |
Триггеры событий проверяются вместе с телом сценария. Неизвестное имя события является ошибкой.
Активаторы событий активируются до запуска тела сценария и остаются активными до выхода из системы.
Активатор события не запускается снова из-за изменения, внесенного его собственными действиями.
В именах событий учитывается регистр.
Каждый тип события может быть объявлен в сценарии не более одного раза.
Изменения вида или вкладки, инициированные телом сценария (
<Script>) также активируют эти события.
Ограничения
Ограничение | Значение |
|---|---|
Операторов на запуск | 100,000 |
Время выполнения на запуск | 30 секунд |
| 30 секунд |
Выполняется по триггеру события | 60 в минуту Любые дополнительные запуски в эту минуту пропускаются. |
Количество итераций в цикле | 10,000 |
Длина строки | 65 536 символов |
Каждый запуск тела сценария или триггера события имеет свои собственные ограничения. Если выполнение достигает лимита или действие завершается ошибкой, остальные операции останавливаются, и событие регистрируется MIPLog.txt, но XProtect Smart Client и любые другие триггеры событий продолжают работать. При выходе из системы или закрытии XProtect Smart Client, он останавливает выполнение любых сценариев.
Не поддерживается | Использовать вместо |
|---|---|
|
|
|
|
| Проверьте сценарий… перед развертыванием сценария |
Условный оператор ( |
|
Приращение префикса | Инкремент постфикса |
Интерполяция строки |
|
Выражения-запятые, объявления нескольких переменных в | Разделить инструкции |
Массивы, литералы коллекции и индексация | Не поддерживается |
| Не поддерживается |
Методы, классы, интерфейсы, пространства имен, | Подключаемый модуль MIP |
| Используйте встроенные действия сценария или подключаемый модуль MIP |
Таймеры, |
|
Доступ к файлам, реестру, сети и процессам, отражение | Подключаемый модуль MIP |