WINMAG plus - img.armo.ruimg.armo.ru/files/WINMAG_plus_v2_SIAS_ru.pdf · Данный...

WINMAG plus Описание команд SIAS

P03126-15-0U0-00

2009-02-12 Об изменениях

не сообщается

2 WINMAG plus – Описание команд SIAS

Содержание Введение.....................................................2 Редактор SIAS ............................................3 Синтаксис SIAS ..........................................4 Типы программ ...........................................5 Базы данных ...............................................6 Список команд SIAS...................................7 Команды SIAS ..........................................10 Типы и причины тревог..........................113 Программа тревоги ................................119 Условия запуска .....................................120 Операторы .............................................121 Элементы управления...........................122 Системные переменные .......................124 Ассистент ................................................125 Глоссарий ...............................................135

Введение Данный документ содержит информацию справки редактора SIAS, которая в нем открывается клавишей F1 или в пункте меню "Help / Help Topics“. Программа SIASEDIT является средством создания и изменения SIAS-программ. Пользовательский интерфейс SIASEDIT основан на стандартном текстовом редакторе Microsoft Wordpad, расширенном некоторыми специальными функциями (вставка кнопок SIAS, сервис команд Ассистент, компиляция SIAS-программ). SIAS-программы являются объектно-ориентированными программами, которые работают в среде управляющей системы WINMAG plus. Эти программы запускаются по определенным событиям (напр., при неисправностях, тревогах), по регламенту, вручную из созданного списка или при нажатии на символе пункта сигнализации (привязанная реакция кнопок мыши). WINMAG plus представляет собой управляющую программу для систем безопасности. Программа WINMAG plus предоставляет удобный пользовательский интерфейс для мониторинга и управления подключенными системами с индивидуальными настройками сообщений, тревог и способов их обработки. SIASEDIT оперирует исходными файлами с расширениями .eff и .efm. После компиляции (пункт меню Build / Compile) исполняемые файлы получают расширения соответственно .wxe и .wxm, с которыми непосредственно работает программа WINMAG plus. Типы программ:

• Обычная программа в основном рабочем окне с расширениями .eff / .wxe • Спадающая программа в окне с заданными размерами с расширениями .eff / .wxe • Макрос (фоновая программа без отображения) с расширениями .efm / .wxm

WINMAG plus – Описание команд SIAS 3

Редактор SIAS Редактор SIAS создает для пользователей объектно-ориентированные программы. Общие сведения: Все объектно-ориентированные программы и условия их запуска находятся в папке "WINMAGEX". Исходные тексты программ являются RTF-файлами, с которыми работает редактор SIAS. Файлы содержат команды SIAS, форматированные тексты, графику, специальные объекты, например, звук, кнопки и т. д. Команды SIAS заключаются в тройные угловые скобки'<<<' и '>>>'. При вставке команды с помощью сервиса (пункт или кнопка Insert Command) скобки появляются автоматически. Скобки могут распространяться на несколько команд (как, например, в файле "ausbed.eff"). Программа "ausbed.eff / .wxe" содержит также команды запуска файлов программ тревог по заданным событиям. Создание программ: Программы для WINMAG plus создаются в редакторе SIAS следующими способами: 1. Создание нового файла программы в пункте меню File / New. 2. Изменение имеющихся файлов вручную или с помощью пункта меню или кнопки Insert Command.

Здесь присутствуют все возможные команды, имеющиеся в SIAS. Для сложных команд имеется кнопка Assistent, дающая полную подсказку для программирования команды (например, для команды "call" в диалоге запрашивается имя вызываемой программы).

3. Создание исполняемого файла в пункте меню Built / Compile или по кнопке Compile. Функция Compile проверяет исходный текст, сохраняет исходный файл и создает исполняемый файл. При обнаружении ошибок в исходном файле появляется сообщение об ошибке, исходный файл не сохраняется (не обновляется), и исполняемый файл не создается (не обновляется). При успешной компиляции исходный и исполняемый файлы сохраняются в папке "WINMAGEX". Исходные файлы имеют расширение ".eff", для макросов ".efm" Исполняемые файлы имеют расширение ". wxe ", для макросов ". wxm "


Синтаксис SIAS Команды SIAS являются составной частью исходных файлов программ, которые сохраняются в формате RTF-файлов (расширенный текстовый формат). Команды SIAS отличаются от обычного текста тем, что они заключаются в тройные угловые скобки. <<< Команда SIAS .... >>> Скобки могут включать любое число команд. Перед строками, не являющимися командами SIAS (например, обычный форматированный текст) должны ставиться закрывающие скобки. Пример:

Это строка обычного текста <<< beep

call (Meldername) >>> Это опять строка обычного текста Описание синтаксиса

В следующем ниже описании синтаксиса разделяющие скобки в командах SIAS не указываются в следующих случаях:

В заголовке команды SIAS с параметрами При описании вводимого параметра При описании команды в текстовом виде В примерах правильного синтаксиса с разъяснениями В ссылках на близкие по смыслу команды и понятия

Необязательные опциональные параметры указываются в квадратных скобках ("[" "]"), возможные альтернативные значения разделяются вертикальной чертой ("|"). Например: var Тип_переменной Имя_переменной [= (Значение | Системная переменная | Имя переменной)] Порядок изложения Команды SIAS перечисляются и кратко описываются в алфавитном порядке. Если требуется указывать параметры, то они описываются отдельно. Также указываются ссылки на похожие по смыслу или совместно используемые команды. Для команд с параметрами приводятся примеры. Все команды и системные переменные именуются на английском языке. Элементы управления (Controls) Наряду с текстами и командами SIAS-программа также может содержать другие элементы, которые являются самостоятельными подпрограммами, выполняющими собственные функции и взаимодействующие с основным телом программы.


Типы программ Программы могут работать в следующих режимах: - Обычная программа в основном рабочем окне

Основное рабочее окно WINMAG используется для отображения программы в нескольких разделенных областях с текстом и графикой. Для каждой запущенной программы создается запись в пакете тревог. Выполнение программ производится в соответствии с их очередностью по приоритетам и с возможностью вмешательства вручную. Одновременно могут обрабатываться до 10 программ. - Спадающая программа в отдельном окне Спадающая программа открывается в отдельном окне поверх остальных окон с начальными размерами в пикселях, заданными в программе. Одновременно можно запустить не больше одной спадающей программы. Спадающая программа запускается сразу и не подчиняется пакетному управлению. Вызов новой спадающей программы закрывает окно прежней спадающей программы. - Фоновый макрос без открытия окна Макрос работает без открытия окна и другой визуальной информации. Поэтому никакой прямой ввод данных в такой программе не возможен. Макрос не попадает в пакет тревог и запускается сразу после вызова. Одновременно может быть запущено сколько угодно макросов. Макросы при программировании выделяются в отдельную категорию. Исходные файлы имеют расширение ".efm", исполняемые файлы имеют расширение ".wxm". Специальные программы: ausbed.eff Содержит условия вызова программ и другие определения. Файл программы автоматически запускается из WINMAG и функционирует в цикле как макрос. Программа отслеживает сообщения из сетей и реагирует на них. alarm.eff Стандартная программа тревог, которая запускает типовое приложение по основным причинам тревог. В поставке имеется ее копия с именем alarm_original. manual.eff Программа со списком программ, запускаемых вручную. zeit.eff Программа с временными условиями запуска других программ. toolhandlerХ.efm (Х = 1 – 10) Макросы, которые запускаются кнопками или из меню программы WINMAG. dtmf_menu.eff Содержит структуру меню работы DTMF.


Базы данных WINMAG plus работает с различными файлами баз данных Microsoft Access. Основными из них являются: • Системная база данных с именем WINMAG.MDB. Содержит все системные данные и пользовательские настройки, такие как:

Параметры сетей Параметры объектов Пункты сигнализации Типы пунктов сигнализации Описания символов Структура рисунков Данные пользователей Типы тревог

• Базы данных протоколов с именами WINMAGPRггммдд.MDB. Содержат записи системного протокола. Не является содержимым баз данных:

Состав рабочих программ WINMAG Протоколы работы программ Рисунки Начертания символов


Список команд SIAS (в алфавитном порядке) ack alarm_reason_counter alarm_type_counter and/or autoclose back_color beep bell call call_macro cascade check_notification_ack check_notification_sent cls confirm dec delay delay_ms disable_layer_by_id disable_layer_by_name disable dismanual display display_rtf display_image dtmf_menu email_notification enable_layer_by_id enable_layer_by_name enable exec exec_autoclose exec_default_prog exec_macro exec_popup_prog exit fax_notification


file_append file_delete file_exists file_read file_read_line file_write find finish finish_at_change freeze_controls generate_wav_file get_fkt_nr get_graphic_text get_graphic_xpos get_graphic_ypos get_integer get_mp_nr_from_id get_mp_text_data get_obj_nr_from_id get_parent_picture_id get_playbacktime get_system_property getParameter gettime hardcopy has_popup_alarm_parameter if…then...else...endif inc insert is_message_in_stack is_message_removed is_mp_in_mandant is_mp_in mandant left_substring length lock_tile_off lock_tile_on login logout manual maximize maximizepicture maximizeprog


message minimize mp_exists newpage on_close_exec_macro on_control_exec_macro on_open_exec_macro pager_call parent_var picture picture_id popup_autoclose popup_pin popup_pin_parent popup_pos popup_size print_graphic priority prog_width prot_off prot_on put put_graphic_pos put_graphic_text reload_database remove replace replace_in_page reply report restart_driver right_substring run run_no_window screenshot search search_alarm_reason search_alarm_type seek seek_alarm_reason seek_alarm_type send_prog_to_group send_prog_to_station


send_prog_to_user set_control_text set_title_popup simulate simulate_text simulate_value single_symbol_on/off sms_notification sound speak stack_color substring system_var tile tilepicture top url url_secure use_popup_alarm_parameter var voice_channel voice_notification wait waitforkey while... endwhile word_wrap_off word_wrap_on Комментарий Элементы управления


Команды SIAS

ack

Команда "ack" изменяет статус программы с "В работе" на "Квитировано, В работе". Эти изменения статуса отражаются: • На статусе программы в пакете тревог. • На мигании символов и ссылок на рисунки. В настройках конфигурации WINMAGplus указывается, продолжают ли мигать последующие символы и ссылки на рисунки. Пример:

<<< ack >>>

alarm_reason_counter(Номер причины тревоги)

Запрос счетчика внутренних причин тревог. Возвращает числовое значение. Параметры:

• Номер причины тревоги = номер запрашиваемой причины тревоги. Посчитывает имеющиеся тревоги с запрашиваемой причиной тревоги. Учитывает только инициализированные пункты сигнализации. Примеры:

<<< var integer Датчики_в_сработке >>> <<< var integer Тревоги_пожара >>> <<< Датчики_в_сработке = alarm_reason_counter(23) >>> <<< Тревоги_пожара = alarm_reason_counter(10)+ alarm_reason_counter(11)+ alarm_reason_counter(100)+alarm_reason_counter(101)+ alarm_reason_counter(102)+ alarm_reason_counter(103)>>> 1. Переменная "Датчики_в_сработке" связана с содержимым счетчика с причиной тревоги 23 (Сработка). 2. Переменная "Тревоги_пожара" связана с суммой разных причин тревоги. Ссылки:

Причины тревог


alarm_type_counter(Номер типа тревоги)

Запрос счетчика внутренних типов тревог. Возвращает числовое значение. Параметры:

• Номер типа тревоги = номер запрашиваемого типа тревоги. Посчитывает имеющиеся тревоги с причинами тревоги запрашиваемого типа. Учитывает только инициализированные пункты сигнализации. Примеры:

<<< var integer Тип_Пожар >>> <<< var integer Тип_Вторжение >>> <<< Тип_Пожар = alarm_type_counter(1) >>> <<< Тип_Вторжение = alarm_type_counter(2) >>> 1. Переменная "Тип_Пожар" связана с содержимым счетчика с типом тревоги 1. 2. Переменная "Тип_Вторжение" связана с содержимым счетчика с типом тревоги 2. Ссылки:

alarm_reason_counter

Причины тревог

and / or

"and" и "or" – это логические связи, которые используются в • условиях запуска • других программных конструкциях. Этими связями могут объединяться различные условия. Рекомендации: - Используйте обозримые связи - Ставьте больше скобок для лучшего восприятия - Комментируйте написанные условия Примеры:

Условия запуска:

<<< { Проверка состояний "Сработка" и "Отсутствует" для Группы 1 централи MB100 } if ((obj_name = "MB100") and

(mp_nr = 101) and (state_nr = 0) and ((fkt_nr = 1) or (fkt_nr = 2))) then....>>> Проверка в программе:

<<< if time > 12:00 and time < 13:00 then....>>>


autoclose

Сразу завершает программу пакета тревог, которая находится непосредственно в обработке. Для завершения программы при возврате условия вызова программы к этому моменту команда запуска программы должна быть вновь выполнена. Параметры: нет

Примеры: ... <<< autoclose >>> ... <<< waitforkey >>>

Программа завершается до следующего выполнения условия вызова программы. Ссылки:

exec autoclose alarm_reason_counter back_color(R,G,B)

Устанавливает цвет фона окна программы (текстовой области) в формате RGB: Параметры:

• R (значение красного), G (значение зеленого), B (значение синего) в диапазонах 0 – 255 Пример:

<<< back_color(255,0,0) >>> устанавливает красный фон окна. Ссылки:

stack_color(R,G,B) beep

Выдает длительный звуковой сигнал. Сигнал может быть остановлен: - Нажатием кнопки остановки звука в панели инструментов - Нажатием кнопки завершения программы (или в аналогичных пунктах обработки программы). Должна быть установлена звуковая карта, на встроенном динамике качество звука неудовлетворительно. Пример:

<<< beep >>> Ссылки:

bell sound bell Выдает кратковременный звуковой сигнал (примерно 1 с). Должна быть установлена звуковая карта. Пример:

<<< bell >>> Ссылки:

be ep sound


call(Программа / Переменная)

Вызов подпрограммы. Параметры (альтернативно):

• Программа = Имя SIAS-программы без расширения • Переменная = Имя строчной переменной или SIAS-переменной Из SIAS-программы можно вызвать любое число любых SIAS-программ. Командой "call" запускается вызываемая SIAS-программа в составе вызывающей программы. Вызываемая программа не попадает в пакет тревог и не записывается в протокол. В качестве параметра может использоваться: - Конкретное имя SIAS-программы - SIAS-переменная, например, mp_name, state_name, state_nr ... - самостоятельно определенная строчная переменная. Если вызываемая программа не найдена, ее выполнение игнорируется без всякого сообщения. Примеры:

<<< call (melderna)>>> Вызывает SIAS-программу с именем "melderna.wxe" <<< call (mp_name)>>> Вызывает SIAS-программу с именем, которое содержится в значении переменной mp_name, например, "Group1.wxe" Ссылки:

exec

run

call_macro(macro)

Вызывает макрос как подпрограмму. Параметр:

• macro = Имя SIAS-макроса без расширения. Из SIAS-программы можно вызвать любой SIAS-макрос. Командой "call_macro " запускается вызываемый SIAS-макрос в составе вызывающей программы. Вызываемый макрос не попадает в пакет тревог и не записывается в протокол. Если вызываемый макрос не найден, его выполнение игнорируется без всякого сообщения. Пример:

<<< call_macro (ausbed_macro)>>> Вызывает SIAS-макрос с именем " ausbed_macro.wxm". Файл макроса должен находиться в папке WINMAEX. Ссылки:

exec

run


cascade

Команда настройки размещения окон экрана. Открытые окна WINMAG plus упорядочиваются каскадом, так что видны их заголовки с правыми частями. Кнопкой с нижним подчеркиванием данное окно можно свернуть, а затем вновь раскрыть для просмотра. Параметры: нет Пример:

<<< cascade >>> Ссылки:

maximize maximizeprog maximizepicture minimize tile tilepicture

check_notification_ack(id)

Возвращает значение "true", если уведомление с указанным идентификатором было квитировано. Квитирование может производиться посредством Esafetynet, DTMF-сигнала или по команде SIAS ack_notification (id). Параметры:

• id = идентификатор уведомления Пример:

<<< var integer notification_id >>> <<< system_var string Адрес >>> <<< notification_id = sms_notification (Адрес,alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>> <<< delay (50)>>> <<< if check_notification_ack (notification_id) then >>> ... <<< endif >>> Посылает уведомление с заданными событиями на телефонный номер, указанный в переменной "Адрес". По истечении 50 с проверяется, квитировано сообщение или нет. Ссылки:

check_notification_sent

fax_notification

sms_notification

voice_notification


check_notification_sent(id)

Возвращает значение "true", если уведомление с указанным идентификатором было отправлено. Параметры:

• id = идентификатор уведомления Пример:

<<< var integer notification_id >>> <<< system_var string Адрес >>> <<< notification_id = sms_notification (Адрес,alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>> <<< delay (5)>>> <<< if check_notification_sent (notification_id) then >>> … <<< endif >>> Посылает уведомление с заданными событиями на телефонный номер, указанный в переменной "Адрес". По истечении 5 с проверяется, отправлено ли сообщение или нет. Ссылки:

check_notification_ack

fax_notification

sms_notification

voice_notification

cls

Начинает новую страницу в текстовом окне. Возврат к предыдущей странице в программе производится кнопкой со стрелкой назад. Параметры: нет Пример:

<<< cls >>> Ссылки:

newpage

confirm "Текст"

Открывает диалоговое окно запроса с кнопками Да и Нет. Параметры:

• "Текст" = заданный текст, который появляется в окне запроса. В примерах заданы тексты "Все в норме ?" и "Сбросить тревогу ?". Оператор может продолжить диалог кнопками Да или Нет. Ответ переводит к условному оператору "if …". Тексты запроса и ответа протоколируются.


Примеры:

<<< confirm "Все в норме ?" >>> <<< if (confirm "Сбросить тревогу ?") then ...>>> Ссылки: if…then...else...endif

waitforkey

dec Переменная [(Значение)]

Уменьшает целую переменную "Переменная" на величину "Значение". Параметры:

• Переменная = Имя переменной, заданной в программе • Значение = Числовое значение [опционально] Команда применима только к целым переменным. Если величина "Значение" не задана, то по умолчанию используется "1". Пример:

<<< var integer counter >>> Устанавливает переменную counter с начальным значением 0. <<< dec counter Уменьшает переменную counter на 1, после этого counter равно -1. <<< dec counter (5) >>> Уменьшает переменную counter на 5, после этого counter равно -6. Ссылки: inc

var

Переменные


delay(Секунды)

Прерывает выполнение программы на время "Секунды" секунд. Параметры:

• Секунды = величина задержки в секундах.

Допустимый диапазон: 1 – 1000 с. Команда прерывает программу на заданное время. При нажатии кнопок "Далее" или клавиши Enter время задержки сбрасывается и программа продолжается принудительно. В течение времени задержки программа остается на экране. Пример:

<<<delay(2)>>> Останавливает программу на 2 секунды. Ссылки:

delay_ms

wait(min)

waitforkey

delay_ms(Миллисекунды)

Прерывает выполнение программы на время "Миллисекунды" миллисекунд. Параметры:

• Миллисекунды = величина задержки в миллисекундах.

Допустимый диапазон: 1 – 100 000 мс. Команда прерывает программу на заданное время. При нажатии кнопок "Далее" или клавиши Enter время задержки сбрасывается и программа продолжается принудительно. В течение времени задержки программа остается на экране. Пример: <<<delay_ms(500)>>> Останавливает программу на 500 мс (1/2 секунды). Ссылки:

delay

wait

waitforkey


disable "net"::"obj_name":"mp_name"."state_name"

Отключает передачу состояния от конечного устройства сети. Параметры:

• net = Имя сети • obj_name = Имя объекта • mp_name = Имя пункта сигнализации • state_name = Имя состояния Передача данных зависит от фильтра. При инициализации определяется, какие данные от устройства должны передаваться до уровня его состояния. Команда "disable" ограничивает поступающий трафик, включая фильтр. Это влияет на количество поступающих сообщений. Пример:

<<< disable "IGIS Netz 1"::";MB 100":"Главный вход–ИК-датчик"."Состояние" >>> Деактивирует передачу физического состояния группы "Главный вход–ИК-датчик". Тревоги группы продолжают передаваться. Ссылки:

enable

disable_layer_by_id(ID)

Отключает графический уровень, задаваемый его идентификатором, во время выполнения SIAS-программы. Параметры:

• ID – идентификатор уровня Действующий графический уровень отключается на определенное время или на все время работы SIAS-программы. Пример:

<<< disable_layer_by_id (Id) >>> Ссылки:

disable_layer_by_name

enable_layer_by_id

enable_layer_by_name


disable_layer_by_name(Имя) Отключает графический уровень, задаваемый его именем, во время выполнения SIAS-программы. Параметры:

• Имя – имя уровня Действующий графический уровень отключается на определенное время или на все время работы SIAS-программы. Пример:

<<< disable_layer_by_name ("Name") >>> Ссылки:

disable_layer_by_id

enable_layer_by_id

enable_layer_by_name

dismanual (“Текст”)

Отменяет заданную программу из списка программ, запускаемых вручную. Параметры:

• "Текст" = Текст с описанием программы, запускаемой вручную. Пример:

<<< dismanual("Сброс_пожарной_централи_664") >>>

Отменяет в списке программ, запускаемых вручную, программу "Сброс_пожарной_централи_664". Ссылки:

manual


display “Текст”, Переменная, Файл.txt

Вывод на экран текста, значения переменной или текстового файла в данной программе. Команда может иметь много параметров, разделяемых запятыми:

• Текст, заключенный в кавычки (Например, "Тревога !"). Текст для вывода на экран может быть также написан в программе вне блока команд (скобок <<<,>>>).

• Переменные: - Любые системные SIAS-переменные, например, mp_name, time,... - Переменные, определенные в программе (например, var integer Тревога) - Пункты сигнализации в формате "Сеть"::"Объект":"Пункт_сигнализации"."Состояние" или в специальной форме с подстановкой параметров mp_name."Состояние".

• Текстовые файлы в папке "WINMAG/TEXT". Текстовый файл должен иметь расширение ".txt". Кавычки и имя папки не указываются.

В пределах команды форматирование текста невозможно. Формат текста зависит от формата предшествующей команды. Формат шрифта текста определяет: - Тип (например, Arial) - Размер (например, 12) - Стиль (B – полужирный, I – курсив, U – подчеркивание) - Цвет (например, красный). Примеры:

Текст: <<< display "Привет всем !" >>> Переменная: <<< display "Время события:",arrival>>> <<< display "Сообщение: "net," ",,obj_name," ",mp_name," ",state_name," ",fkt_name>>> <<< display "Igis 1"::"MB100":"Блиц-лампа"."Саботаж" >>> <<< display mp_name."Состояние" Текстовый файл: <<< display text.txt>>> Ссылки:

display_image find insert length remove replace substring get_mp_text_data Ассистент Переменные


display_image (Имя файла рисунка(Увеличение))

Отображение файла рисунка на экране SIAS-программы с заданным увеличением. Параметры:

• Имя файла рисунка = Имя файла с расширением и указанием пути. Поддерживаемые форматы: .bmp, .jpg, .png, .ico, .wmf • Увеличение = опционально задаваемый в процентах масштаб от 1% до 300%. 100 = 1:1 Пример:

<<< display_image (комната.jpg(50)) >>> Показывает рисунок с масштабом 50%. Ссылки:

display display_rtf find insert length remove replace substring get_mp_text_data Ассистент Переменные

display_rtf(Имя файла) Отображает rtf-филе в SIAS-программе. Параметры:

• Имя файла = Имя RTF-файла. Пример:

<<< display_rtf(Text.rtf)

В SIAS-программе отображается RTF-файл "Text.rtf". Ссылки:

display display_image find insert length remove replace substring get_mp_text_data Ассистент Переменные


dtmf_menu(Имя,on_key_x(menu/macro,m_name),"Справка")

Создает одно управляемое меню на каждый DTMF-сигнал. Меню может вызывать подменю или макрос для последующего управления. Первое меню должно иметь имя "start". Для работы команды в WINMAG plus должна быть лицензирована опция "Возможность управления DTMF", установлена и настроена функция оповещения. Параметры:

• Имя = Имя записи меню. Головное меню должно иметь имя "start". • on_key_x = Привязка телефонных кнопок от 1 до 9, например, on_key_1 для кнопки 1. Можно определить насколько кнопок для команд меню. • menu,m_name = Имя подменю, вызываемого нажатием кнопки, или

macro,m_name = Имя SIAS-макроса, вызываемого нажатием кнопки. • Справка = Текст, запрашиваемый для прослушивания после нажатия кнопки "*" на телефоне. Текст может описывать функции меню, например, привязку функций к кнопкам телефона.

При вызове команды на компьютере запрашивается код полномочий, установленный в свойствах пользователя WINMAG plus (Код DTMF). После ввода кода и нажатия кнопки "*" можно выбрать конкретные меню. Можно сразу задать последовательность цифр, например, "123" означает в первом меню кнопку "1", в следующем меню кнопку "2" и в следующем меню кнопку "3". После нажатия кнопки "*" текст справки выдается на соответствующий уровень меню. Примеры:

<<< dtmf_menu (start,on_key_1(menu,Управление),on_key_2(menu,Информация),"1 Управление, 2 Информация")>>>

Создает одно меню с 2 пунктами выбора. Можно вызвать 2 подменю "Управление" или "Информация", создаваемые другими командами dtmf_menu, как показано далее. В качестве справки, выдаваемой по кнопке "*", задан текст в кавычках. <<< dtmf_menu (Информация,on_key_1(macro,voice_alarm),on_key_2(macro,voice_scharf), on_key_3(macro,voice_unscharf),"Выбор: 1 Тревога, 2 Зона без охраны, 3 Зона на охране")>>> Подменю "Информация" вызывает разные макросы, которые по командам voice_channel передают голосовую информацию на телефон. Ссылки:

voice_channel


email_notification ("Кому","Причина","Сообщение"[,web])

Передает письмо e-mail на заданный адрес через функцию WINMAG plus "Оповещение". Текст письма может быть составлен из переменных и констант. Параметры:

• Кому = Адрес получателя как текст или переменная • Причина = Причина передачи письма • Сообщение = Текст письма, состоящий из

фиксированного текста в кавычках или переменных – системных, строчных или числовых.

Длина сообщения не должна превышать 255 символов. • web = Необязательный параметр, если письмо передается через портал esafetynet. Пример:

<<< var integer notification_id >>> <<< notification_id = email_notification ("[email protected],alarm_reason_name,arrival+" "+obj_name+" "+mp_name+" "+mp_text)>>> <<< delay(5)>>> <<< if check_notification_sent (notification_id) then >>> ... <<< endif >>>

Передает совокупность значений системных переменных пункта сигнализации по причине, указанной в системной переменной alarm_reason_name, на указанный адрес e-mail. По истечении 5 с проверяется факт передачи. Ссылки:



fax_notification

sms_notification

voice_notification


enable "net"::"obj_name":"mp_name"."state_name"

Включает передачу состояния от конечного устройства сети. Параметры:

• net = Имя сети • obj_name = Имя объекта • mp_name = Имя пункта сигнализации • state_name = Имя состояния

Передача данных зависит от фильтра. При инициализации определяется, какие данные от устройства должны передаваться до уровня его состояния. Команда "enable" восстанавливает ранее неактивный трафик, отключая фильтр. Это влияет на количество поступающих сообщений. Пример:

<<< enable "IGIS 1"::";MB 100":" Главный вход–ИК-датчик "."Состояние" >>>

Активирует передачу физического состояния группы "Главный вход–ИК-датчик". Ссылки:

disable

enable_layer_by_id(ID) Включает графический уровень, задаваемый его идентификатором, во время выполнения SIAS-программы.

Параметры:

• ID – идентификатор уровня Действующий графический уровень включается на определенное время или на все время работы SIAS-программы. Пример:

<<< enable_layer_by_id (Id) >>> Ссылки:

disable_layer_by_id disable_layer_by_name enable_layer_by_name

enable_layer_by_name(Имя) Включает графический уровень, задаваемый его именем, во время выполнения SIAS-программы.

Параметры:

• Имя – имя уровня Действующий графический уровень включается на определенное время или на все время работы SIAS-программы. Пример:

<<< enable_layer_by_name ("Name") >>> Ссылки:

disable_layer_by_id disable_layer_by_name enable_layer_by_id


exec(Программа,Приоритет[,Тип,R,G,B])

Вызов самостоятельной SIAS-программы. Параметры:

• Программа = Имя SIAS-программы без расширения • Приоритет = Числовое значение приоритета вызываемой программы от 1 до 30000. • Тип (необязательный параметр) = тип тревоги (категория), который присваивается программе. Если тип не указывается, то используется тип сообщения. В определении пункта сигнализации каждому функциональному значению может присваиваться причина тревоги, которая в свою очередь принадлежит типу тревоги. • R, G, B (необязательные параметры) = принудительное определение цвета текста пакета тревог.

При задании RGB-параметров необходимо также задать параметр Тип.

SIAS-программа может вызывать любые другие SIAS-программы. SIAS-программы, вызываемые командой "exec", запускаются независимо от вызывающей программы. Программа записывается в пакет тревог в соответствии с ее приоритетом и автоматически запускается согласно алгоритму управления пакетом. В основном команды "exec" используются в программе "ausbed.wxe". Условия их вызова определяют алгоритм работы системы WINMAG plus. Примеры:

<<< exec(alarm,6000)>>>

Вызывает SIAS-программу "alarm.wxe" с приоритетом 6000. Тип явно не задан и определяется связанным сообщением. <<< exec(alarm,6000,2,0,0,255)>>>

Вызывает SIAS-программу "alarm.wxe" с приоритетом 6000. Тип программы определен как "2" – Вторжение. Цвет текста пакета тревог имеет значение 0,0,255 = синий. Ссылки:

back_color

call

exec_autoclose

exec_macro

exec_popup_prog

finish_at_change

manual

priority

run

stack_color

top


exec_autoclose(Программа,Приоритет[,Тип,R,G,B])

Вызов самостоятельной SIAS-программы. В отличие от команды "exec" вызванная программа будет автоматически завершена, если условие запуска перестает действовать. Параметры:

• Программа = Имя SIAS-программы без расширения • Приоритет = Числовое значение приоритета вызываемой программы от 1 до 30000. • Тип (необязательный параметр) = тип тревоги (категория), который присваивается программе. Если тип не указывается, то используется тип сообщения. В определении пункта сигнализации каждому функциональному значению может присваиваться причина тревоги, которая в свою очередь принадлежит типу тревоги. • R, G, B (необязательные параметры) = принудительное определение цвета текста пакета тревог.

При задании RGB-параметров необходимо также задать параметр Тип.

SIAS-программа может вызывать любые другие SIAS-программы. SIAS-программы, вызываемые командой "exec", запускаются независимо от вызывающей программы. Программа записывается в пакет тревог в соответствии с ее приоритетом и автоматически запускается согласно алгоритму управления пакетом.

В основном команды "exec_autoclose" используются в программе "ausbed.wxe". Условия их вызова определяют алгоритм работы системы WINMAG plus. Примеры:

<<< exec_autoclose (alarm,6000)>>>

Вызывает SIAS-программу "alarm.wxe" с приоритетом 6000. Тип явно не задан и определяется связанным сообщением. <<< exec_autoclose (alarm,6000,2,0,0,255)>>>

Вызывает SIAS-программу "alarm.wxe" с приоритетом 6000. Тип программы определен как "2" – Вторжение. Цвет текста пакета тревог имеет значение 0,0,255 = синий. Ссылки:

autoclose

exec


exec_default_prog

Вызов самостоятельной SIAS-программы, которая попадает в пакет тревог по привязанной по умолчанию причине тревоги. Параметры: нет

Команда должна находиться в цикле проверки условий запуска (программа "ausbed.exe"), в котором проверяется наступление причины тревоги, напрямую привязанной к стандартной SIAS-программе. Эта привязка производится в меню конфигурации системы "Обработка причины тревоги": - Активизировать флажок "Использовать SIAS-программу" - Ввести поле "Приоритет" - Привязать конкретную программу кнопкой "…". Пример: ... <<< while (1) >>> <<< getparameter >>> ... <<< exec_default_prog>>> ... <<< endwhile >>> Ссылки:

call

exec


exec_macro (Имя макроса[,0/1])

Вызов SIAS-макроса. Параметры:

• Имя макроса = Имя вызываемого макроса без расширения Макрос всегда имеет расширение ".efm"

• Необходимость протоколирования 0 = Нет протоколирования запуска и завершения макроса в базе данных системного протокола 1 = Есть протоколирование запуска и завершения макроса в базе данных системного протокола

По умолчанию без этого параметра протоколирование имеется.

SIAS-макрос не дает никакого отображения в окнах, но из него можно вызывать любые другие программы. Команда "exec_macro" сразу запускает независимый от вызывающей SIAS -программы макрос, который не попадает в пакет тревог и не подчиняется пакетному управлению.

Макрос также может быть вызван как действие кнопками мыши на любом символе.

Команды "exec_macro" часто используются в программе "ausbed.wxe". Условия их вызова определяют алгоритм работы системы WINMAG plus. Примеры:

<<< exec_macro(testalarm)>>>

Вызывает SIAS-макрос с именем "testalarm.wxm". <<< exec_macro(counter_aktualisieren,0)>>>

Вызывает SIAS-макрос с именем "counter_aktualisieren.wxm". Запуск и завершение макроса не протоколируются в системном протоколе. Ссылки:

exec


exec_popup_prog(Программа[,"Источник"])

Вызов SIAS-программы в спадающем окне поверх остальных окон. Параметры:

• Программа = Имя вызываемой SIAS-программы без расширения • Источник = Имя пункта сигнализации в формате

"Сеть"::"Объект":"Пункт сигнализации"."Состояние"="Функциональное значение" Вызываемая SIAS-программа работает в отдельном спадающем окне поверх текущего фона. Из нее можно вызывать любые другие SIAS-программы. Команда "exec_popup_prog" сразу запускает независимую от вызывающей SIAS -программу, которая не попадает в пакет тревог и не подчиняется пакетному управлению. Спадающая программа также может быть вызвана как действие кнопками мыши на любом символе. Без параметра "Источник" текущие данные вызывающей программы передаются в спадающую программу. Если требуются другие данные, необходимо задать параметр "Источник". Команды " exec_popup_prog " часто используются в программе "ausbed.wxe". Условия их вызова определяют алгоритм работы системы WINMAG plus. Примеры:

<<< exec_popup_prog(melderna_wait)>>>

Вызывает спадающую SIAS-программу с именем "melderna_wait.wxe". <<< exec_popup_prog (pop_zk_liste,"Контроль доступа и учета времени"::"Контроль доступа":"Зона Здание"."Количество лиц - десятки"="0") >>>

Вызывает спадающую SIAS-программу с именем "zk_liste.wxe". Независимо от текущих значений пункта сигнализации принимаются параметры системы контроля доступа. Ссылки:

back_color

exec

exec_macro

popup_autoclose

popup_pin

popup_pin_parent

popup_size


exit

По этой команде данная программа завершается. Параметры: нет Команда не завершает программы более высокой иерархии вложения. Если программа вызвана из другой программы командой "call", то вышестоящая программа не завершается. Отличать от команды "finish" ! Пример:

В программе "Alarm" ... call (Конец) ... В программе "Конец" <<< if confirm "Завершить программу "Конец" ? " then >>> <<< exit >>> <<< endif >>> Завершается только программа "Конец" ! Программа "Alarm" не завершается ! Ссылки:

finish


fax_notification(Телефон,"Текст"/Переменная[+"Текст"/Переменная][,web])

Передает факс на заданный номер телефона через функцию WINMAG plus "Оповещение". Текст факса может быть составлен из переменных и констант. Параметры:

• Телефон = Номер телефона получателя как текст или переменная • Текст = Текст факса, состоящий из

фиксированного текста в кавычках или переменной – системной, строчной или числовой.

• + = Добавление фиксированного текста в кавычках или переменной – системной, строчной или числовой. Длина сообщения не должна превышать 255 символов.

• web = Необязательный параметр, если факс передается через портал esafetynet.

Передача факса выполняется как функция, поэтому его отправка и квитирование могут быть проконтролированы. Пример:

<<< var integer notification_id >>> <<< system_var string Номер >>> <<< notification_id = fax_notification (Номер,alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>> <<< delay(5)>>> <<< if check_notification_sent (notification_id) then >>> ... <<< endif >>> Передает совокупность значений системных переменных пункта сигнализации по указанному телефонному номеру. По истечении 5 с проверяется факт передачи. Ссылки:



email_notification

sms_notification

voice_notification


file_append("Файл","Текст"[+Переменная])

Добавляет в существующий файл с именем "Файл" указанный после запятой текст как новую строку. Текст может быть составлен из нескольких параметров. Если указанный файл с указанным именем не существует, то он создается. Параметры:

• Файл = Имя файла с путем. Параметр должен содержать полный путь к изменяемому файлу ! • Текст = Текст, добавляемый в файл. Пример:

<<< file_append("C:\temp\musterdatei.txt","Тревога "+"mp_name+" / "+arrival>>>

Добавляет в файл "C:\temp\musterdatei.txt" текст, зависимый от события, например, "Тревога Группа 12 / 24.12.2003 14:27:32" (новая строка). Ссылки:

file_write

file_read

file_delete("Файл")

Удаляет файл с именем "Файл". Имя файла должно быть с указанием пути, иначе файл должен находиться в папке "Text". Параметры:

• Файл = Имя файла в папке "Text" или с путем. Пример:

<<< if file_exists ("test.txt") then>>> <<< file_delete ("test.txt")>>> <<< endif >>> Проверяет, существует ли файл "…Text\testdatei.txt" и, если существует, то удаляет его. Ссылки:

file_exists

file_read

file_write


file_exists("Файл")

Проверяет, существует ли файл с именем "Файл". Эта проверка существенно быстрее тестового чтения файла. Имя файла должно быть с указанием пути, иначе файл должен находиться в папке "Text". Конструкция "file_exists" как функция возвращает булево значение существования файла (0 или 1). Параметры:

• Файл = Имя файла в папке "Text" или с путем. Примеры:

<<< var integer Ответ>>> <<< Ответ = file_exists ("testdatei.txt") >>>

Проверяет, существует ли файл с именем "…Text\testdatei.txt". Если файл существует, то переменная "Ответ" получает значение 1. Если файл не существует, то переменная "Ответ" получает значение 0. <<< var string Файл>>> <<< if file_exists ("testdatei.txt") then>>> <<< file_read ("testdatei.txt", Файл)>>> <<< endif >>>

Проверяет, существует ли файл с именем "…Text\testdatei.txt" и, если существует, то его содержимое записывается в переменную "Файл". Ссылки:

file_append file_delete file_read file_write

file_read("Файл",Переменная)

Читает файл с именем "Файл" и записывает его содержимое в строчную переменную. Длина переменной не должна превышать 65535 символов. Считывание файла ограничено 50 строками, каждая не более 256 символов. Имя файла должно быть с указанием полного пути. Параметры:

• Файл = Имя файла с полным путем. • Переменная = Имя строчной переменной, в которую переписывается содержимое файла. Пример:

<<< var string Строка var integer Число>>> <<< file_read ("c:\temp\testdatei.txt", Строка) >>> <<< Число = get_integer Строка {Преобразует строку в число}>>> Ссылки:

file_append file_write


file_read_line("Файл",Переменная,Строка)

Читает файл с именем "Файл" и записывает содержимое его заданной строки в строчную переменную. Длина переменной не должна превышать 64 Кбайт. Имя файла должно быть с указанием полного пути. Параметры:

• Файл = Имя файла с указанием полного пути. • Переменная = Имя строчной переменной, в которую переписывается содержимое файла. • Строка = Номер строки, которая должна быть переписана в переменную. Пример:

<<< file_read_line ("c:\temp\ testfile.txt", Строка, 7)

Переписывает 7-ю строку файла "c:\temp\ testfile.txt", в переменную Строка. Ссылки:

file_append file_read file_write file_write("Файл","Текст"[+Переменная])

Записывает заданный текст в файл с именем "Файл". Текст может быть составным. Если файл уже существует, то его содержимое переписывается. Параметры:

• Файл = Имя файла с указанием полного пути.

• Текст = Текст для записи в файл Пример:

<<< file_write("C:\temp\musterdatei.txt","Тревога "+"mp_name+" "+arrival>>> Создает файл "C:\temp\musterdatei.txt" с заданным текстом, например, "Тревога Группа 12 24.12.2008 14:27:32". Ссылки:

file_append

file_read


find("Строка", "Значение"[, Начало, Длина])

Поиск фрагмента в тексте или в строчной переменной. Можно задать начальную позицию и число искомых символов. Команда действует как функция, которая возвращает номер позиции начала искомых символов. Счет начинается с нуля для первой позиции. Если искомые символы не найдены, возвращается значение "-1". Параметры:

• Строка = Строка символов или переменная, в которых должен производиться поиск. • Значение = Фрагмент или переменная, которые должны искаться. • Начало = Начальная позиция строки, с которой должен вестись поиск.

Диапазон значений от 0 до (Длина строки –1), первая позиция строки имеет значение 0. Параметр является необязательным, без него производится поиск во всей строке. • Длина = Число символов поисковой строки, в диапазоне которых производится поиск.

Диапазон значений от 1 до (Длина строки –1). Параметр является необязательным, без него производится поиск во всей строке. Этот параметр должен быть задан, если задан параметр "Начало". Примеры:

<<< var integer Позиция >>> <<< Позиция = find ("12345ZIEL","ZIEL",3)>>> Переменная "Позиция" содержит 5 символов ("ZIEL" будет найдена после 5-й позиции). Начало поиска после позиции 3. <<< position = find ("12345ZIEL","ZIEL",6)>>> Переменная "Позиция" содержит на 1 меньше символов ("ZIEL" не будет найдена после 6-й позиции). Начало поиска после позиции 6. <<< position = find ("12345ZIEL","VIEL")>>> Переменная "Позиция" содержит на 1 меньше символов ("ZIEL" не будет найдена во всей строке). Начало поиска с начала строки. Ссылки:

insert

left_substring

length

remove

replace

right_substring

substring



finish

По этой команде данная программа завершается. Параметры: нет Если программа вызвана из другой программы командой "call", то все вышестоящие программы также завершаются. Отличать от команды " exit " ! Пример:

В программе "Alarm" ... call (Конец) ... В программе " Конец "

<<< if confirm "Завершить программу "Конец" ? " then >>> <<< exit >>> <<< endif >>> Завершается также программа "Alarm", как только завершается программа "Конец" ! Ссылки:

exit


finish_at_change(Приоритет)

Удерживает программу до указанного приоритета в пакете тревог, пока выполняется условие запуска. Статус программы остается "В работе". После команды "finish_at_change" прежние команды больше не запускаются. Параметры:

• Приоритет = Приоритет программы (от 1 до 30000), до которого программа остается в пакете тревог.

Пример:

<<< finish_at_change(60)>>>

Удерживает в пакете тревог SIAS-программы с приоритетом 60, пока выполняется условие запуска. Ссылки:

exec

priority

freeze_controls

После этой команды в процессе работы программы все предыдущие элементы управления сохраняют текущее состояние. Никакие действия с ранее установленными элементами управления в программе невозможны. Пример:

<<< freeze_controls >>> Ссылки:

Элементы управления


generate_wav_file ("Файл","Текст")

Команда создает звуковой wav-файл с заданным текстом. Необходимые условия: - Опция "Оповещение" должна быть лицензирована - В компьютере должна быть установлена звуковая карта - Качество речи зависит от установки и настроек голосового синтезатора Созданный звуковой файл можно воспроизвести командой "sound". Параметры:

• Файл = Имя создаваемого звукового файла. • Текст = Текст для озвучивания в создаваемом файле (строка и / или переменная). Пример:

<<< generate_wav_file ("c:\sprachmeldung1.wav", "Тревога датчика "+mp_name)>>>

Создает звуковой wav-файл "sprachmeldung1.wav" на диске C: с текстом, зависящим от события. Ссылки:

sound

speak

get_fkt_nr Состояние ПС

Преобразование имени функционального значения в числовое значение. Параметры:

• Состояние ПС = Состояние пункта сигнализации в формате Сеть::Объект:Пункт сигнализации:Состояние или в формате mp_nr:Имя состояния

Примеры:

<<< var integer Счетчик1 >>> <<< var integer Счетчик2 >>> ... <<< Счетчик1 = get_fkt_nr mp_nr.Состояние >>> <<< Счетчик12= get_fkt_nr "IGIS-карта"::"MB100":"Группа 1":"Главная зона" >>> <<< put (net_nr::obj_nr:(35+ Счетчик2)."Управление")="Сбросить">>>

Счетчик1 = 200, Счетчик2 = 123 Переменным в пункте сигнализации можно присвоить значения в обратном порядке. Восьми состояниям соответствуют десятичные разряды 1 – 8, например:

<<< put "System"::"Переменные":"Счетчик" = 123 >>> дает Значение 1 = 3

Значение 2 = 2 Значение 3 = 1 Ссылки:

get_integer wert


get_graphic_text(Сеть::Объект:ПС)

Функция определяет графический текст, присвоенный пункту сигнализации, который может быть просмотрены в стандартной спадающей программы на символе – пункт меню "Инфо" табличного вида символа / строка "Графический_текст:" открывающейся спадающей программы. Параметры:

• Сеть = Имя сети / Номер сети • Объект = Имя объекта / Номер объекта • ПС = Имя пункта сигнализации / Номер пункта сигнализации Присвоенный графический текст сохраняется в компьютере и должен обновляться после нового запуска программы WINMAG plus. Каждому пункту сигнализации можно присвоить графический текст командой "put_graphic_text". Если графический текст отсутствует, функция возвращает пустую строку. Запрашиваемый пункт сигнализации должен присутствовать, иначе при вызове команды появляется сообщение об ошибке. Пример:

<<< var string Строка >>> <<< put_graphic_text(((0)::(3):(501)) = "Тест:"+time) >>> <<< Строка = get_graphic_text(((0)::(3):(501))) >>> <<< display"Содержимое",Строка>>>

Присваивает заданный текст пункту сигнализации Сеть 0 (Система) Объект 3 (Переменные) ПС 501 и затем текст заправшивает. Ссылки:

put_graphic_text


get_graphic_xpos(Строка GPS,Тип)

Из GPS-строки определяет географическую долготу и возвращает целочисленное значение. Параметры:

• Строка GPS = Переменная со строкой GPS, содержит координаты x, y и другие значения. • Тип = Тип строки GPS, в настоящее время поддерживается только значение 1 Сообщение GPS должно определять географическую долготу позиционирования в градусах с двумя знаками до запятой и произвольным числом знаков после запятой. Это значение умножается на 1000 и представляется как целочисленное значение. Точность позиционирования вблизи экватора составляет примерно 1 м. Пример: 48,3478563° = 4834.78563 * 1000 = 4834786 Команда используется как функция. Примеры:

<<< put_graphic_pos((net::obj_nr:mp_nr),get_graphic_xpos(mp_text1,1) , get_graphic_ypos(mp_text1,1)) >>>

Определяет координаты позиционирования x / y из сообщения GPS и непосредственно привязывает их к символу. <<< var integer x >>> <<< var integer y >>> <<< popup_size (500, 200) >>> <<< set_title_popup ("Позиция GPS "+mp_name) >>> <<< display " x =", get_graphic_xpos(mp_text1,1) >>> <<< display " y =", get_graphic_ypos(mp_text1,1) >>>

Показывает принятые координаты в спадающей программе. Ссылки:

get_graphic_ypos

put_graphic_pos


get_graphic_ypos(Строка GPS,Тип)

Из GPS-строки определяет географическую долготу и возвращает целочисленное значение. Параметры:

• Строка GPS = Переменная со строкой GPS, содержит координаты x, y и другие значения. • Тип = Тип строки GPS, в настоящее время поддерживается только значение 1 Сообщение GPS должно определять географическую долготу позиционирования в градусах с двумя знаками до запятой и произвольным числом знаков после запятой. Это значение умножается на 1000 и представляется как целочисленное значение. Точность позиционирования вблизи экватора составляет примерно 1 м. Пример: 48,3478563° = 4834.78563 * 1000 = 4834786 Команда используется как функция. Примеры:

<<< put_graphic_pos((net::obj_nr:mp_nr),get_graphic_xpos(mp_text1,1) , get_graphic_ypos(mp_text1,1)) >>>

Определяет координаты позиционирования x / y из сообщения GPS и непосредственно привязывает их к символу. <<< var integer x >>> <<< var integer y >>> <<< popup_size (500, 200) >>> <<< set_title_popup ("Позиция GPS "+mp_name) >>> <<< display " x =", get_graphic_xpos(mp_text1,1) >>> <<< display " y =", get_graphic_ypos(mp_text1,1) >>>

Показывает принятые координаты в спадающей программе. Ссылки:

get_graphic_xpos

put_graphic_pos


get_integer Значение

Преобразует значение строчной переменной в целую величину. Параметры:

• Значение = Переменная или строка Пример:

<<< var integer Целое 1 >>> <<< var integer Целое 2 >>> <<< var string Строка 1 = "123" >>> ... <<< Целое 1 = get_integer "200Состояние" >>> <<< Целое 2 = get_integer Строка 1 >>> Целое1 равно 200, Целое2 равно 123. Ссылки:

get_fkt_nr

get_mp_nr_from_id(Сеть:Объект,id1,id2)

Определяет номер пункта сигнализации по его параметрам ID1 и ID2. Возвращает найденный номер пункта сигнализации или значение -1. Параметры:

• Сеть = Имя сети или ее номер, в которой ищется пункт сигнализации. • Объект = Имя объекта или его номер, в котором ищется пункт сигнализации.

Номер объекта можно получить функцией "get_obj_nr_from_id". • id1 = Значение параметра ID1 пункта сигнализации. • id2 = Значение параметра ID2 пункта сигнализации. Функция определяет номер пункта сигнализации по его специальным параметрам, например, по номеру группы и номеру датчика в группе. По определенному номеру пункта сигнализации дальше могут запускаться команды управления. Для надежного нахождения пункта сигнализации он должен иметь однозначную комбинацию ID1 и ID2 в пределах объекта. Обычно это требуется для пунктов сигнализации централей Esser. Если пункт сигнализации не найден, возвращается значение "-1". Пример:

<<< var integer Номер_ПС >>> <<< Номер_ПС = get_mp_nr_from_id("Сеть1"::"Централь1",2,3) >>> <<< if Номер_ПС > 0 { датчик найден } then >>> <<< put ("Сеть1"::" Централь1":( Номер_ПС)."Управление")="Выключить" >>> <<< endif >>>

По заданным номерам группы и датчика (например, можно задать по маске) определяет номер пункта сигнализации и передает на него команду управления (выключение датчика). Ссылки:

get_obj_nr_from_id


get_mp_text_data(Объект,Номер ПС,Тип)

Находит тексты из базы данных WINMAG plus. Через привязку пункта сигнализации к объекту могут определяться все тексты пункта сигнализации путем задания параметра "Тип" (= номер записи). Параметры:

• Объект = Имя объекта • Номер ПС = Номер пункта сигнализации • Тип = требуемый тип данных Тип Содержимое 1 Имя пункта сигнализации 2 Дополнительный текст пункта сигнализации 3 Параметр ID1 пункта сигнализации 4 Параметр ID2 пункта сигнализации 10–17 Тексты состояний входов 0–7 20–27 Тексты состояний выходов 0–7 с 1000 Тексты функциональных значений Найденные значения могут использоваться в командах отображения на экран или в запросах состояния пунктов сигнализации. Использование найденных значений зависит от версии языка и конкретных объектовых настроек. Примеры:

<<< display get_mp_text_data(obj_nr,mp_nr,1) {Имя ПС} >>> <<< display get_mp_text_data(obj_nr,mp_nr,2) {Дополнительный текст ПС} >>> <<< display get_mp_text_data(obj_nr,mp_nr,3) {ID1 ПС} >>> <<< display get_mp_text_data(obj_nr,mp_nr,10) {Состояние 0 вход} >>> <<< display get_mp_text_data(obj_nr,mp_nr,20) {Состояние 0 выход } >>> <<< display get_mp_text_data(obj_nr,mp_nr,1000) {Состояние 0 вход функц. значение 0} >>> <<< display get_mp_text_data(obj_nr,mp_nr,1204) { Состояние 2 вход функц. значение 4} >>> <<< display get_mp_text_data(obj_nr,mp_nr,2000) { Состояние 0 выход функц. значение 0}>>> <<< if ((net)::obj_nr:(mp_nr).(4)) <> get_mp_text_data(net::obj_nr,mp_nr,1400) then>>> <<<endif >>>

Запрашивает состояния текущего пункта сигнализации, и если значение 4-го состояния не равно первому функциональному значению, то далее выполняются действия по команде "then". Ссылки:

display

get_mp_nr_from_id

if…then...else...endif



get_obj_nr_from_id(Сеть,id1,id2)

Определяет номер объекта по его параметрам ID1 и ID2. Возвращает найденный номер пункта сигнализации или значение "-1". Параметры:

• Сеть = Имя сети или ее номер, в которой ищется объект. • id1 = Значение параметра ID1 объекта. • id2 = Значение параметра ID2 объекта. Функция определяет номер объекта по его специальным параметрам. Для надежного нахождения объекта он должен иметь однозначную комбинацию ID1 и ID2 в пределах сети. Обычно это требуется для пунктов сигнализации централей Esser. Если объект не найден, возвращается значение "-1". Пример:

<<< var integer Централь >>> <<< var integer Номер_ПС >>> <<< Централь = get_obj_nr_from_id("Сеть1",2,3) >>> <<< Номер_ПС = get_mp_nr_from_id("Сеть1"::( Централь),2,3) >>> <<< if Номер_ПС > 0 { датчик найден } then >>> <<< put ("Сеть1"::( Централь):( Номер_ПС)."Управление")="Выключить" >>> <<< endif >>>

По заданным ID1 и ID2 определяет объект и передает на него команду управления (выключение датчика). Ссылки:

get_mp_nr_from_id


get_parent_picture_id(ID / Имя рисунка)

Для заданного рисунка головной рисунок. Таким образом, определяется вышестоящий уровень структуры графики, и в SIAS-программе можно к нему перейти. Параметры:

• ID = ID исходного рисунка, можно определить из команды "picture" или из переменной "picture_id". • Имя рисунка = Имя файла рисунка.

Это определение неоднозначно, так как один и тот же рисунок может неоднократно входить в структуру графики. В этом случае находится первая запись головного рисунка в базе данных.

Найденное значение может использоваться в команде "picture" для подстановки соответствующего головного рисунка. Пример:

<<< var integer Рисунок >>> <<< var integer Головной_рисунок >>> <<< picture (1) { Рисунок определяется в порядке записи символа }>>> <<< Рисунок = picture_id >>> <<< Головной_рисунок = get_parent_picture_id(Рисунок) >>> <<< display "1-й рисунок = ",Рисунок ",picture_name1," , Головной рисунок = ", Головной_рисунок >>> <<< picture (2, Головной_рисунок) >>>

Показывает ID рисунка и головной рисунок во втором окне программы. Ссылки:

picture


get_playbacktime(Время, Формат)

Определяет время обращения к записи цифрового видеомагнитофона. Параметры:

• Время = Время обращения к записи в секундах. Возможны положительные и отрицательные значения.

• Формат = Формат строки времени. 0 = время события в формате Visioprime.

Установленное значение может передаваться в цифровой видеомагнитофон как дополнительный текст. Этим достигается, например, что воспроизведение записи начинается за 30 с до тревоги. Пример:

<<< url ("Видео:107731476/1/3/"+get_playbacktime(-10,0))>>> Начинает показ видеозаписи для "Сеть 107731476", "Объект 1", "Камера 3" за 10 с до времени тревоги. Формат времени – "ггггммддччммсс". Ссылки:

url


get_system_property(Свойство)

Функция определяет системные параметры среды функционирования WINMAG plus, например, папку, файлы протоколов, папки метаданных. Данные возвращаются в виде строки. Параметры:

• Свойство = Имя системной информации: winmag@path winmag@master_path message/mp@metafilepath message/mp@master_metafilepath message/mp@graphic_ids mp/addr/"+id+"@name graphic/id/1@metafilepath sias@seek_count sias@seek_result sias@tmpfilename

Полученная информация может показываться на экране командой "display" или использоваться в запросах. Если данные не найдены или содержат ошибку возвращается пустая строка. Использование найденных значений зависит от версии языка и конкретных объектовых настроек. Данные разделяются по следующим рубрикам:

• WINMAG Параметры работы WINMAG (папка программы, сети) • SIAS Параметры работы приложений SIAS, например, результаты поиска • СООБЩЕНИЯ Контекстная информация пункта сигнализации, связи пункта сигнализации с

вызываемыми программами, реакции кнопок мыши на символе • ПС Параметры пункта сигнализации, такие как имя, тип, объект, ID • ГРАФИКА Параметры графики, такие как имя рисунка, ID, тип, уровень в структуре

графики, головные и подчиненные рисунки Файл sias@tmpfilename обладает следующей особенностью: он автоматически удаляется после завершения программы тревоги, то есть файл содержит данные, зависимые от конкретной тревоги. Примеры:

Запись данных в переменную, в данном случае с имени папки WINMAG: <<< a = get_system_property ("winmag@path") >>> Имя временного файла с текущими данными SIAS-программы: <<< display get_system_property ("sias@tmpfilename") >>>

WINMAG: <<< display "WINMAG@path ",(get_system_property("winmag@path")) >>> <<< display "WINMAG@master_path ",(get_system_property("winmag@master_path")) >>> <<< display "WINMAG@net_ids ",(get_system_property("winmag@net_ids")) >>> SIAS: Имя файла текущей запущенной программы или подпрограммы указывается с относительным (prog_name) или полным (full_prog_name) путем. <<< display "sias@prog_name ", (get_system_property("sias@prog_name")) >>> <<< display "sias@full_prog_name ", (get_system_property("sias@full_prog_name")) >>> Поиск всех зон без охраны командой "seek", вставка результатов поиска "seek_result" в переменную и отображение количества найденных записей "seek_count". Эта информация временная, и ее содержание обновляется следующей командой "seek". <<< seek_alarm_reason(91) >>> <<< result = (get_system_property("sias@seek_result")) >>> <<< display get_system_property("sias@seek_count") >>>


СООБЩЕНИЯ: <<< display "net properties">>> <<< display "message/net@nettype_id ",(get_system_property("message/net@nettype_id")) >>> <<< display "message/net@no_pc ",(get_system_property("message/net@no_pc")) >>> <<< display "message/net@name: ",(get_system_property("message/net@name")) >>> <<< display "message/net@vaddr: ",(get_system_property("message/net@vaddr")) >>> <<< display "message/net@vaddr-bridge: ",(get_system_property("message/net@vaddr_bridge")) >>> <<< display "message/net@mp: ",(get_system_property("message/net@mp")) >>> <<< display "Object properties">>> <<< display "message/object@devicetype_id ",(get_system_property("message/object@devicetype_id")) >>> <<< display "message/object@devicetype_name ",(get_system_property ("message/object@ devicetype_name")) >>> <<< display "message/object@name: ",(get_system_property("message/object@name")) >>> <<< display "message/object@addr: ",(get_system_property("message/object@addr")) >>> <<< display "message/object@id: ",(get_system_property("message/object@id")) >>> <<< display "message/object@no: ",(get_system_property("message/object@no")) >>> <<< display "mp properties">>> <<< display "message/mp@id ",(get_system_property("message/mp@id")) >>> <<< display "message/mp@name ",(get_system_property("message/mp@name")) >>> <<< display "message/mp@no ",(get_system_property("message/mp@no")) >>> <<< display "message/mp@type: ",(get_system_property("message/mp@type")) >>> <<< display "message/mp@types: ",(get_system_property("message/mp@types")) >>> <<< display "message/mp@id_1: ",(get_system_property("message/mp@id_1")) >>> <<< display "message/mp@id_2: ",(get_system_property("message/mp@id_2")) >>> <<< display "message/mp@has_value: ",(get_system_property("message/mp@has_value")) >>> <<< display (get_system_property("message/mp@graphic_ids")) >>> <<< display (get_system_property("message/mp@metafilepath")) >>> <<< display (get_system_property("message/mp@master_metafilepath")) >>> <<< display (get_system_property("message/mp/object/net@name")) >>> ПС: Пункт сигнализации задается адресом (например, addr/0::3:1) или ID (например, id/110040001). <<< display "mp/addr/0::3:1@id ", (get_system_property("mp/addr/0::3:1@id")) >>> <<< display "mp/id/110040001@id ",(get_system_property("mp/id/110040001@id")) >>> <<< display "mp/addr/0::3:1@name ",(get_system_property("mp/addr/0::3:1@name")) >>> <<< display "mp/addr/0::3:1/object@name ",(get_system_property("mp/addr/0::3:1/object@name")) >>> <<< display "mp/addr/0::3:1/object/net@name ",(get_system_property("mp/addr/0::3:1/object/net@name")) >>> <<< display "mp/addr/0::3@metafilepath: ",(get_system_property("mp/addr/0::3@metafilepath")) >>> ... и т.д. как в сообщении. ГРАФИКА: Данные относятся к определенной графике, которая должна определяться своим параметром ID. <<< display get_system_property("graphic/id/84428627@metafilepath") >>> <<< display get_system_property("graphic/id/84428627@master_metafilepath") >>> <<< display "graphic/id/1@id ",(get_system_property("graphic/id/1@id")) >>> <<< display "graphic/id/1@name ",(get_system_property("graphic/id/1@name")) >>> <<< display "graphic/id/1@full_name ",(get_system_property("graphic/id/1@full_name")) >>> <<< display "graphic/id/1@url ",(get_system_property("graphic/id/1@url")) >>> <<< display "graphic/id/1@level ",(get_system_property("graphic/id/1@level")) >>> <<< display "graphic/id/1@is_webpage ",(get_system_property("graphic/id/1@is_webpage")) >>> <<< display "graphic/id/1@is_overlaygraphic ",(get_system_property("graphic/id/1@is_overlaygraphic")) >>> <<< display "graphic/id/1@is_zoomcutout ",(get_system_property("graphic/id/1@is_zoomcutout")) >>> <<< display "graphic/id/1@zoomable ",(get_system_property("graphic/id/1@zoomable")) >>> <<< display "graphic/id/1@is_video ",(get_system_property("graphic/id/1@is_video")) >>> <<< display "graphic/id/2@parent_graphic_id ",(get_system_property("graphic/id/2@parent_graphic_id")) >>> <<< display "graphic/id/2/parent_graphic@name",(get_system_property("graphic/id/2/parent_graphic@name")) >>> <<< display "graphic/id/1@child_graphic_ids ",(get_system_property("graphic/id/1@child_graphic_ids")) >>>


parent->parent->name: <<< display (get_system_property("graphic/id/2653275/parent_graphic/parent_graphic@name")) >>> parent->parent->level: <<< display (get_system_property("graphic/id/2653275/parent_graphic/parent_graphic@level")) >>> Ссылки:

get_mp_nr_from_id

get_mp_text_data

getParameter

Опрашивает сообщения из входного буфера. Эта команда должна входить в главный цикл опроса условий запуска, иначе буфер будет переполнен. Параметры: нет Пример:

Программа ausbed.eff: <<< while (1) >>> <<< getParameter>>> <<< if alarm_reason_nr = 21 then... >>> ... Обрабатывает поступающие сообщения в главном цикле опроса. Ссылки:

exec while... endwhile


gettime"Текст"

Прерывает выполнение программы и открывает диалоговое окно для ввода времени. Параметры:

• Текст = Текст, вводимый в диалоге В полях времени по умолчанию отображается текущее время компьютера.

Запрашивается время в часах, минутах, секундах. Веденное время сохраняется в системной переменной "response" далее может быть проверено и обработано. Примеры:

<<< gettime "Завершить приложение в: >>>

Показывает окно с этим текстом. <<< display " Приложение в ",response," завершено" >>>

Показывает текст с сохраненным в переменной "response" временем. Ссылки:

reply

report


hardcopy(Окно, Принтер)

Печать окна на графическом принтере. В WINMAG plus можно определить до 10 графических принтеров. На эти принтеры можно задать печать текстового или графических окон программы. Производится печать только содержимого соответствующего окна. Параметры:

• Окно = Номер окна программы для печати (от 0 до 3): 0 = Текстовое окно 1 – 3 = Графические окна программы по часовой стрелке

Вместо числовых значений можно также использовать переменные "text","graphic_1", "graphic_2", "graphic3".

• Принтер = Номер принтера в соответствии с конфигурации принтеров (1 – 10). Вместо числовых значений можно также использовать переменные graphicprinter_1, graphicprinter_2, graphicprinter_3, graphicprinter_4, graphicprinter_5,...

Нумерация окон в окне тревоги:

0 = Текстовое окно слева (или слева вверху) 1 = Графическое окно справа вверху 2 = Графическое окно справа внизу 3 = Графическое окно слева внизу

Графические окна открываются командой "picture (Номер [,Имя]) ". Для печати графики без названия используется команда "print_graphic". Примеры:

<<< hardcopy (text,graphicprinter_1) { Печать текстового окна 1 на графическом принтере 1}>>> <<< hardcopy (1,2) { Печать графического окна 1 на графическом принтере 2} >>> Ссылки:

picture

print_graphic

screenshot

Ассистент


has_popup_alarm_parameter

Проверяет, доступны ли текущие параметры тревоги из программы тревоги. Возвращает истинное значение, если спадающая программа, запускается, например, из графики, показываемой в программе тревоги. Параметры: нет

Возвращаемые 0: параметры тревоги не найдены значения: 1: параметры тревоги найдены Примеры:

<<< var integer Ответ >>> ... <<< Ответ = has_popup_alarm_parameter >>> <<< if has_popup_alarm_parameter then >>> <<< display"Возвращаемое значение: ", Ответ >>> <<< use_popup_alarm_parameter >>> <<< call (melderna) { Параметры программы тревоги }>>> <<< endif >>> <<< if has_popup_alarm_parameter then >>> <<< use_popup_alarm_parameter >>> <<< call (melderna) { Параметры программы тревоги }>>> <<< endif >>> Ссылки:

exec_popup_prog

use_popup_alarm_parameter


if (Условие) then ... [else ...] endif

Проверка и обработка условий. Параметры:

• Условие: - Проверка состояния переменных - Результат запроса оператора (confirm, reply) - Проверка состояния пунктов сигнализации - Проверка системных параметров, например, времени, состояние ключа защиты и т.д.

Условный оператор "If" проверяет условия, которые могут быть связаны логическими связями. В зависимости от результата общей проверки выполняются действия по ключевому слову "then" или по ключевому слову "else" (выполнение по "else" является необязательным). Условный оператор "If" всегда должен заканчиваться ключевым словом "endif". Ключевое слово "else" заканчивает ветвь "then". Условные операторы "If" могут включать другие операторы "If". Условные операторы "If" образуют ядро условий запуска в программе "ausbed.eff". Примеры:

<<< if (alarm_reason_nr = 63) then exec (Alarm,7000) endif >>> <<< if (confirm"Сбросить тревогу ?" then....>>> Ссылки:

Операторы Условия запуска


inc Переменная [(Значение)]

Увеличивает целую переменную "Переменная" на величину "Значение". Параметры:

• Переменная = Имя переменной, заданной в программе • Значение = Числовое значение [опционально]

Команда применима только к целым переменным. Если величина "Значение" не задана, то по умолчанию используется "1". Пример:

<<< var integer counter >>> Устанавливает переменную counter с начальным значением 0. <<< inc counter Увеличивает переменную counter на 1, после этого counter равно 1. <<< inc counter (5) >>> Увеличивает переменную counter на 5, после этого counter равно 6. Ссылки:

dec

var



insert("Строка", "Значение", Начало)

Вставка текста или символов в текст или текстовую переменную. Должна быть задана начальная позиция вставки. Результат команды – расширенная строка. Параметры:

• Строка = Строка или переменная, в которую должен вставляться текстовый фрагмент. • Значение = Текстовый фрагмент или переменная, которые должны вставляться. • Начало = Начальная позиция, с которой должна производиться вставка.

Минимальное значение 0 = начало строки. Если значение больше длины строки, то вставка производится после конца строки.

Примеры:

<<< var string Новая >>> <<< Новая = insert ("123456789","НОВ",3)>>>

Переменная Новая = "123НОВ456789", вставка после позиции 3. <<< Новая = insert ("123456789","НОВ",0)>>>

Переменная Новая = "НОВ123456789", вставка с начала строки (после позиции 0). <<< Новая = insert ("123456789","НОВ",15)>>>

Переменная Новая = "123456789НОВ ", вставка после конца строки. Ссылки:

find

length

remove

replace

substring



is_message_in_stack(Сеть::Объект:ПС.Состояние=ФЗ)

Команда проверяет, находится ли сообщение с заданными состоянием и функциональным значением пункта сигнализации в пакете тревог. Параметры:

• Сеть = Имя / Номер сети в сообщении • Объект = Имя / Номер объекта в сообщении • ПС = Имя / Номер пункта сигнализации в сообщении • Состояние = Состояние пункта сигнализации в сообщении • ФЗ = Функциональное значение состояния в сообщении Проверка препятствует повторным запускам программы. Как функция возвращает следующие значения:

1, если сообщение находится в пакете тревог 0, во всех остальных случаях

Пример:

<<< if is_message_in_stack("IGISLoop 0 Узел 68"::"EMZ 561-MB100.10":"ИК-датчик жилая комната"."Тревога" = "Вкл.") then>>> <<< display "В пакете тревог">>> <<< else >>> <<< display "Нет в пакете тревог или удалена">>> <<< endif >>> Ссылки:

is_message_removed


is_message_removed (Сеть::Объект:ПС.Состояние=ФЗ)

Команда проверяет, удалено ли автоматически сообщение с заданными состоянием и функциональным значением пункта сигнализации из пакета тревог (сетевое управление, переполнение пакета тревог, …). Параметры:

• Сеть = Имя / Номер сети в сообщении • Объект = Имя / Номер объекта в сообщении • ПС = Имя / Номер пункта сигнализации в сообщении • Состояние = Состояние пункта сигнализации в сообщении • ФЗ = Функциональное значение состояния в сообщении Проверка препятствует повторным запускам программы. Как функция возвращает следующие значения:

1, если сообщение автоматически удалено из пакета тревог 0, во всех остальных случаях

Пример:

<<< if is_message_removed("IGISLoop 0 Узел 68"::"EMZ 561-MB100.10":" ИК-датчик жилая комната"."Тревога" = "Вкл.") then>>> <<< display "Автоматически удалено из пакета тревог">>> <<< else >>> <<< display "В пакете тревог">>> <<< endif >>> Ссылки:

is_message_in_stack

is_mp_in_mandant("Сеть"::"Объект":"ПС", "Имя") Проверяет, доступен ли указанный пункт сигнализации данному пользователю (опция Полномочия).

Параметры: • Сеть = Имя сети • Объект = Имя объекта • ПС = Имя пункта сигнализации • Имя = Имя пользователя

Пример: <<< is_mp_in_mandant("Network"::"Object":"I/O device", "Name") >>>


left_substring(Строка,Разделитель)

Поиск фрагмента текста слева от указанного разделителя в полном тексте переменной. Команда действует как функция, которая возвращает искомый фрагмент из текста переменной. Если фрагмент текста не находится, возвращается пустая строка. Параметры:

• Строка = Текст или переменная, в которой должен производиться поиск. • Разделитель = Символ, после появления которого первый раз определяется левый фрагмент

текста.

Специальные символы: CRLF = Carriage return + line feed = Возврат каретки, переход на новую строку. Примеры:

<<< Результат = left_substring("12.34", ".") >>>

Поиск фиксированного фрагмента строки символов, возвращает Результат = "12". <<< seek_alarm_reason( 91 ) >>> <<< Результат = (get_system_property("sias@seek_result")) >>> <<< while (length(Результат) > 0) >>> <<< Тест = left_substring(Результат, CRLF) >>> <<< display Get_System_Property("mp/addr/"+ Тест +"@name") >>> <<< Результат = right_substring(Результат, CRLF) >>> <<< endwhile >>>

Просмотр событий с зонами без охраны и передачи отдельных записей в переменную "Тест". Ссылки:

right_substring

substring

length ("Строка")

Определяет длину строки или строчной переменной. Возвращает целое значение длины строки, для пустой строки возвращает значение 0. Параметры:

• Строка = Строка или строчная переменная Примеры:

<<< var integer Длина >>> <<< Длина = length("12345")>>>

Переменная Длина = 5 <<< Длина = length("")>>>

Переменная Длина = 0 Ссылки:

find insert remove replace substring Переменные


lock_tile_off

Отключает блокировку команды деления экрана на окна текста и графики. Разделительная линия между окнами опять может перемещаться (это стандартное поведение без применения команды lock_tile_on). Данная команда может отменяться командой lock_tile_on. Параметры: нет Пример:

<<< lock_tile_off >>> Ссылки:

lock_tile_on

word_wrap_off

word_wrap_on

lock_tile_on

Включает блокировку команды деления экрана на окна текста и графики. Разделительная линия между окнами не может перемещаться. Данная команда может отменяться командой lock_tile_off. Параметры: нет Пример:

<<< lock_tile_on >>> Ссылки:

lock_tile_off

word_wrap_off

word_wrap_on


login ("Пользователь" / Переменная)

Заявляет пользователя WINMAG plus с указанным именем (вход нового пользователя).. Имя пользователя задается как строка символов в кавычках или как переменная. Если имя пользователя отсутствует в списке пользователей, то ничего не происходит. Если имеется несколько одинаковых имен пользователей, то заявляется первый найденный. Параметры: • Имя пользователя как строка или строчная переменная Примеры:

<<< login ("Администратор") >>>

Заявляется пользователь с именем "Администратор". <<< login (Пользователь) >>>

Заявляется пользователь с именем, содержащимся в переменной "Пользователь". Ссылки:

logout

logout

Отключает текущего пользователя WINMAG plus. Если в установках WINMAG plus задан вход пользователя по умолчанию, то заявляется пользователь по умолчанию. Параметры: нет Пример:

<<< logout >>> Ссылки:

login


manual(Программа,Приоритет,Тип,”Текст”[,”Сообщение”])

Определяет SIAS-программы ручного запуска. Параметры:

• Программа = Имя SIAS-программы без расширения (например, bmc664stop)- • Приоритет = Приоритет запуска программы как целое число от 1 до 30000.

Для ручного запуска программы пользователь должен иметь параметр "Приоритет программ" не меньший, чем приоритет данной программы. Иначе данная программа для текущего пользователя не появится в списке доступных программ ручного запуска.

• Тип = Номер типа программы тревоги, который устанавливается для данной программы (например, 6 для программ ручного запуска).

• "Текст" = Текстовый комментарий к программе, который показывается в списке для вызова программ ручного запуска.

• "Сообщение" = Необязательный параметр в формате: "Имя сети"::"Имя объекта":"Имя пункта сигнализации"."Состояние"="Функциональное значение". Этот параметр рассматривается как привязанное входное сообщение, то есть могут использоваться символы и переменные.

Список программ ручного запуска открывается: - Кнопкой "Программы ручного запуска" - Одноименным пунктом в меню "Окно" - Из спадающего меню по правой кнопке мыши на пакете тревог. Список программ изначально сортирован по приоритетам, но может быть также сортирован вручную по любому столбцу таблицы (щелчок мышью на заголовке). Для указанных типов тревоги показываются соответствующие символы. Каждый пользователь видит только те программы, которые ему доступны для запуска. Определение ручных программ может меняться в динамике и производиться в любой программе. Чтобы список программ был виден всегда, определение программ командой "manual" должно быть вставлено в программе "ausbed" перед циклом опроса. Команда "dismanual" отменяет определение конкретной программы ручного запуска. Примеры:

<<< manual (bmc664stop,2000,1,"Сброс централи 664","IGIS-карта"::"BMC 664":"Обслуживание BМС 664"."Тревога" = "Имеется") >>>

Определяет программу ручного запуска "bmc664stop" с приоритетом 2000 как программу пожарной тревоги с текстовым комментарием "Сброс централи 664". Как параметр задана сеть, объект, пункт сигнализации, состояние и функциональное значение (параметр не обязателен). Ссылки:

call

dismanual

exec

run


maximize

Команда настройки окон экрана. Активные окна WINMAG plus раскрываются, главное окно WINMAG plus занимается одним окном. Если активны несколько окон, то их смена в главном окне производится в меню "Окно". Параметры: нет. Пример:

<<< maximize >>> Ссылки:

cascade

maximizeprog

maximizepicture

minimize

tile

tilepicture

maximizepicture (Номер)

Команда настройки окон экрана. В окне тревоги раскрывается рисунок заданной графической области. Предварительно должна быть определена привязка рисунка к графической области командой "picture". Кнопкой "Текст, графика или совмещенный виды" содержимое окна тревоги может последовательно меняться. Параметры:

• Номер = Номер графической области (1, 2 или 3) Пример:

<<< maximizepicture (1) >>> Ссылки:

cascade

maximize

maximizeprog

minimize

picture

tile

tilepicture


maximizeprog

Команда настройки окон экрана. В окне тревоги раскрывается текстовая область. Возможные открытые графические области скрываются. Если предшествующей командой "picture" были определены рисунки в графических областях, то кнопкой "Текст, графика или совмещенный виды" содержимое окна тревоги может последовательно меняться. Параметры: нет Пример:

<<< maximizeprog >>> Ссылки:

cascade

maximize

maximizepicture

minimize

tile

tilepicture


message ("Текст" / Переменная[+"Текст"/Переменная],Номер)

Запись текста и / или значений переменных в сообщение протоколирования с заданным номером. Параметры:

• Текст = Текст, вносимый в сообщение. • Переменная = Переменная или SIAS-переменная, вносимые в сообщение. Числовые переменные

преобразуются в формат строки. • Номер = Системный номер сообщения = Тип сообщения.

Тексты сообщений определены в базе данных, но могут быть изменены индивидуально. Диапазон номеров от 1 до 10.

Тексты и сообщения могут объединяться с помощью знака '+'. Тексты сообщений в базе данных (пункт меню конфигурации "Обработка типов протоколов":

500 Пользовательское сообщение 1: %1!s! 501 Пользовательское сообщение 2: %1!s! ... 509 Пользовательское сообщение 10: %1!s! Для каждого сообщения можно определить направление вывода (возможны любые комбинации):

• Экран с параметром "Длительность вывода на экран, мс") • База данных • Принтеры протоколов (если заданы и работают) При просмотре системного протокола могут выбираться отдельные записи по их типам и содержащимся символам. Примеры:

<<< message ("Пожарная тревога",1) >>>

Текст "Пожарная тревога" попадет в пользовательское сообщение 1. <<< message ("Пожарная тревога от "+mp_name,1) >>> Сообщение от датчика с mp_name = "Ручной датчик"

Текст "Пожарная тревога от Ручной датчик" попадет в пользовательское сообщение 1. <<< message (mp_name,1) >>>

Содержимое SIAS-переменной "mp_name" оформляется как пользовательское сообщение 1, например, как "Группа 1". <<< var string Выдача = "Тест">>> <<< message (Выдача,1) >>>

Содержимое переменной "Выдача" оформляется как пользовательское сообщение 1, в данном случае, как "Тест". Ссылки:

var


minimize

Команда настройки окон экрана. Окно тревоги WINMAG plus свертывается в левый нижний угол окна WINMAG plus с именем и управляющими кнопками окна. С помощью управляющих кнопок и пунктов меню окно можно развернуть полностью или до нужных размеров или закрыть совсем. Параметры: нет. Пример:

<<< minimize >>> Ссылки:

cascade

maximize

maximizeprog

maximizepicture

tile

tilepicture


mp_exists ("Сеть"::"Объект":"ПС")

Функция проверяет, существует ли указанный пункт сигнализации. При ошибке возвращается значение 0, иначе возвращается значение > 0. Параметры:

• Сеть = Имя сети • Объект = Имя объекта • ПС = Имя пункта сигнализации

Параметры могут содержать символы, числовые значения и переменные. Применение: если в конкретном объекте заданы индивидуальные параметры, которые должны запускать управление, например, по номеру группы, то эта команда проверяет, имеется ли пункт сигнализации для указанного номера группы. Без такой проверки SIAS-программа может завершиться с синтаксической ошибкой. Пример:

<<< var Группа >>> ... <<< if mp_exists((("IGISLoop 0 Узел 68")::0: Группа)) then >>> <<< put ("IGISLoop 0 Узел 68"::(0):(Группа).(0) = (1) >>> <<< endif >>>

Проверяет, существует ли пункт сигнализации с именем, заданным в переменной "Группа", и если существует (возвращается значение <> 0), то передается управляющая команда. Ссылки:

get_mp_text_data

is_mp_in_mandant

newpage

Прерывает выполнение программы до нажатия клавиши ENTER или кнопки с зеленой стрелкой вправо (Далее). После этого начинается новая страница текстовой области. Возврат на предыдущую страницу возможен по кнопке с красной стрелкой влево (Назад). Команда "newpage" является комбинацией команд "waitforkey" и "cls". Параметры: нет Пример:

<<< newpage >>> Ссылки:

cls

waitforkey


on_close_exec_macro(Макрос)

При завершении SIAS-программы запускает заданный макрос. Макрос также запускается, если SIAS-программа перемещается в пакет тревог. Макросом могут выполняться повторяющиеся заключительные установки. Команда должна находиться в начале SIAS-программы. Параметры

• Макрос = Имя макроса, запускаемого по завершении программы. Пример:

<<< on_close_exec_macro (Конец) >>>

При каждом завершении программы запускается макрос с именем "Конец". Он может производить установку значений переменных, исполнять управляющие команды и т.д. Ссылки:

on_control_exec_macro

on_open_exec_macro

on_control_exec_macro(Переменная,Макрос)

Отслеживает значение переменной и при ее изменении запускает заданный макрос. Параметры:

• Переменная = Имя переменной, при изменении которой запускается макрос. • Макрос = Имя запускаемого макроса. Пример:

<<< var string Стоп >>>

<<<{ Кнопка программируется как связанная с переменной "Стоп" }>>> <<< on_control_exec_macro (Стор,cam_stop) >>> <<< waitforkey >>>

При действии на кнопку связанная переменная изменяется, если даже она не меняется по команде явно. После этого запускается макрос "cam_stop". Ссылки:

on_close_exec_macro

on_open_exec_macro


on_open_exec_macro(Макрос)

При запуске SIAS-программы с этой командой также выполняется заданный макрос. Макрос также запускается, если SIAS-программа возвращается на обработку из пакета тревог. Макросом могут выполняться повторяющиеся начальные установки. Команда должна находиться в начале SIAS-программы. Параметры:

• Макрос = Имя запускаемого макроса Пример:

<<< on_open_exec_macro (a_graphic1) >>>

Содержимое макроса: <<< picture(graphicwindow_1) >>> При запуске программы в 2-экранной конфигурации макросом показывается тревога на графическом экране. Без вызова макроса графика с тревогой возникает только при первом вызове программы, а при перемещении в пакет тревог и последующем возвращении на обработку переключение на графику тревоги не производится. Ссылки:

on_close_exec_macro

on_control_exec_macro

pager_call (Сообщение,Адрес,Код)

Команда передает сообщение на модуль Ackermann PSA. Параметры:

• Сообщение = Текст сообщения • Адрес = Действующий адрес системы PSA. • Код = Значение от 1 до 10, задаваемое в соответствии с установкой типа PSA.


parent_var Тип Переменная [=Значение]

Декларирует переменную с именем "Переменная" и типом "Тип", которая в вышестоящей вызывающей программе объявляется командой "var" и совместно используется вышестоящим и текущим процессами. Таким образом, переменная может использоваться для обмена данными между программами. Значение переменной сохраняется на все время сеанса работы с WINMAG plus. Параметры:

• Тип = Тип переменной • Переменная = Имя переменной • Значение = Начальное значение переменной [необязательный параметр] Пример:

*** Вышестоящая вызывающая программа *** <<< var integer Счетчик >>> ... <<< call (Модуль1)>>> ... <<< display Счетчик >>> ... *** Программа Модуль1 *** <<< parent_var integer Счетчик >>> ... <<< inc Счетчик >>>

Программа Модуль1 использует переменную "Счетчик", которая в вызывающей программе определяется командой "var" и в ней тоже может использоваться. Ссылки:

system_var

var


picture (Номер [,ID / ”Имя”])

Выводит графический файл на экран. Параметры:

• Номер = Номер графического окна 1 = Графическое окно вверху справа 2 = Графическое окно внизу справа 3 = Графическое окно внизу слева

WINMAG plus автоматически совместно сдвигает нумерацию окон. Если, например, указывается номер 2 без указания окна 1, то графика 2 автоматически показывается в окне 1. Ввод окон в стандартном виде: graphicwindow_1 .. 48

• Необязательные параметры графики - ID = Номер в базе данных (всегда однозначный). - Имя = Имя графического файла с указанием пути (может использоваться неоднократно).

Если отсутствует указание конкретной графики, то WINMAG автоматически перебирает рисунки, на которых имеются символы пунктов сигнализации, относящихся к сообщению (находящихся в тревоге). Если WINMAG не находит рисунки с символами в тревоге, то показывается головной рисунок. Если графика задается через входящие в нее символы, то можно опросить функцией "picture_id" зарегистрированную в базе данных графику и дальше вывести рисунки, связанные с имеющимся на них символом пункта сигнализации. Например, picture_id дает ID первой записи базы данных. Если запись не найдена, то функция возвращает значение "-1". Если не указываются другие команды SIAS, то окно тревоги имеет следующую структуру: - Слева показывается текст - При одном рисунке он занимает всю правую половину окна тревоги - При двух рисунках первый показывается справа верху, второй – справа внизу - При трех рисунках третий добавляется слева внизу. Содержимое окон может изменяться в процессе работы программы кнопкой "Текст, графика или совмещенный виды".

• Другие команды SIAS управления окном тревоги - maximizeprog – раскрывает текстовую область до полного окна тревоги - maximizepicture(№) – раскрывает графическую область № до полного окна тревоги - tilepicture – разделенное окно тревоги

Примеры:

<<<picture(1)>>> Автоматически показывает в 1-й графической области рисунок с тревожным символом. <<<picture(2,1)>>> Показывает во 2-й графической области рисунок с ID = 1 (головной рисунок) <<<picture(3,"c:\bilder\bild1.bmp")>>> Показывает в 3-й графической области рисунок с именем файла "bild1.bmp". Ссылки:

get_parent_picture_id

hardcopy

picture_id Ассистент

Окно тревоги


picture_id[(Сеть::Объект:ПС,Запись)]

Определяет ID записи базы данных рисунка, связанного с символом пункта сигнализации. Возвращает найденный ID или значение "-1" (запись не найдена). Параметры: нет или следующие:

• Сеть = Имя или номер сети с пунктом сигнализации с символом на данном рисунке. • Объект = Имя или номер объекта с пунктом сигнализации с символом на данном рисунке. • ПС = Имя или номер пункта сигнализации с символом на данном рисунке. • Запись = Номер записи.

ID записи базы данных рисунка автоматически генерируется как случайное число при вставке рисунка в структуру графики. Если графика задается через входящие в нее символы, то функцией "picture_id" можно опросить зарегистрированную в базе данных графику и дальше вывести рисунки, связанные с имеющимся на них символом пункта сигнализации.

picture_id = ID 1-ой записи графики в базе данных picture_id(1) = ID 2-ой записи графики в базе данных picture_id(2) = ID 3-ей записи графики в базе данных picture_id(3) = ID 4-ой записи графики в базе данных

Если запись не найдена, то функция возвращает значение "-1". Более того, функцией "picture_id" можно найти рисунки, привязанные к конкретным пунктам сигнализации через их символы.

picture_id ((Сеть::Оbjekt:ПС), 1) определяет 1-ю запись в базе данных picture_id ((Сеть::Оbjekt:ПС), 2) определяет 2-ю запись в базе данных

и т.д. до 10 записей. Примеры:

<<< p_id = picture_id((Сеть::Централь:mp_nr), 1)>>> <<< if p_id >=0 then >>> <<< picture(1,p_id)>>> <<< display "Графика: ",picture_name1>>> <<< endif >>>

Проверяет, имеются ли записи графики для заданного пункта сигнализации в базе данных, и показывает рисунок. <<< display picture_id>>>

Показывает первую найденную запись графики для базы данных. Ссылки:

get_parent_picture_id

picture


popup_autoclose

Возвращает вид закрепленного окна спадающей программы на "autoclose" (= значение по умолчанию). Параметры: нет Пример:

<<< popup_pin_parent { Спадающая программа остается на экране до закрытия вышестоящей программы или до закрытия спадающей программы вручную } >>> ... <<< popup_autoclose { Стандартное поведение: спадающая программа закрывается при запуске другой спадающей программы или при щелчке мышью на экране вне текущего спадающего окна } >>> ... Ссылки:

exec_popup_prog

popup_pin

popup_pin_parent

popup_pin

Устанавливает вид окна спадающей программы на "закреплено" до закрытия WINMAG plus или до закрытия спадающей программы вручную. Тогда можно открыть одновременно несколько спадающих программ. При достижении максимального число одновременно открытых спадающих программ, самое старое окно программы автоматически закрывается при открытии окна новой спадающей программы С версии WINMAG v.10 одновременно можно открыть до 10 спадающих программ. Без этой команды окно спадающей программы закрывается сразу, если открывается новая спадающая программа или при щелчке мышью на экране вне текущего спадающего окна. Параметры: нет Пример:

<<< popup_pin >>> Ссылки:

exec_popup_prog

popup_autoclose

popup_pin_parent


popup_pin_parent

Устанавливает вид окна спадающей программы на "закреплено" до закрытия вышестоящей программы или до закрытия спадающей программы вручную. Тогда можно открыть одновременно несколько спадающих программ. При достижении максимального число одновременно открытых спадающих программ, самое старое окно программы автоматически закрывается при открытии окна новой спадающей программы С версии WINMAG v.10 одновременно можно открыть до 10 спадающих программ. Без этой команды окно спадающей программы закрывается сразу, если открывается новая спадающая программа или при щелчке мышью на экране вне текущего спадающего окна. Параметры: нет Пример:

<<< popup_pin_parent >>> Ссылки:

exec_popup_prog

popup_autoclose

popup_pin

popup_pos (x, y)

Задает координаты левого верхнего угла окна спадающей программы. Параметры:

• x = Координата левого края окна в пикселях. • у = Координата верхнего края окна в пикселях. Примеры:

<<< popup_pos(200,100)>>>

Задает координаты левого верхнего угла программы на экране x = 200 и y = 100. Ссылки:

back_color

exec_popup_prog

popup_size


popup_size (x, y)

Задает размеры окна спадающей программы. Без этой команды после вызова спадающей программы ее окно имеет минимальные размеры, так что содержимое окна может не просматриваться. Параметры:

• x = Горизонтальный размер окна в пикселях. • у = Вертикальный размер окна в пикселях. Пример:

<<< popup_size(200,100)>>> Задает окно спадающей программы шириной 200 пикселей и высотой 100 пикселей. Ссылки:

back_color

exec_popup_prog

print_graphic(ID,Принтер)

Печать страницы графики на принтерах графики. В WINMAG plus могут быть определены до 10 принтеров графики. Они постранично печатают открытые окна. Команда "print_graphic" может производить вывод на печать без отображения, например, можно печатать только содержимое окна программы. Параметры:

• ID = ID рисунка для вывода на печать. ID рисунка может быть получен, например, вызовом системных параметров командой get_System_Property ("message/mp@graphic_ids "). • Принтер = Номер принтера в соответствии с конфигурацией принтеров от 1 до 10.

Вместо численных значений можно использовать параметры graphicprinter_1, graphicprinter_2, graphicprinter_3, ...

Примеры:

<<< print_graphic (2, 2) >>>

Печать рисунка с ID = 2 на принтере графики 2. <<< print_graphic (Get_System_Property("message/mp@graphic_ids"), graphicprinter_2) >>>

Печать всех рисунков текущего пункта сигнализации. ID рисунков определяются через системные параметры. Ссылки:

hardcopy

screenshot


priority(Значение)

Изменение приоритета программы во время ее работы. Параметры:

• Значение = Целое значение нового приоритета. Приоритет может быть увеличен или уменьшен. В соответствии с приоритетом производится управление программы в пакете тревог. Изменение приоритета может привести к следующему: - Другие программы с бывшим более низким или тем же приоритетом теперь попадут в обработку. - Другие программы с бывшим более высоким приоритетом не смогут прервать текущую программу. Наивысший возможный приоритет – 32000. Если задано большее значение, то приоритет устанавливается 32000. Примеры:

<<< priority (10000) >>>

Устанавливает приоритет 10000. <<< priority (priority -100)>>>

Уменьшает текущий приоритет на 100. Ссылки:

exec

prog_width (Значение)

Задает ширину текстовой области программы. Без этой установки ширина окна делится пополам между текстовой и графическими областями. Параметры:

• Ширина = Ширина текстовой области в пикселях. Пример:

<<< prog_width (400)>>>

Задает ширину текстовой области 400 пикселей. Остальная часть окна может использоваться графикой. Ссылки:

maximizeprog

picture

popup_size

tilepicture


prot_off

Отключает протоколирование запросов и команд в SIAS-программе. Например, команда "put" не показывается на экране и не попадает в протокол. Пример:

<<< prot_off>>> Ссылки:

prot_on

prot_on

Включает протоколирование запросов и команд SIAS в протоколе программы. Например, команда "put" показывается на экране и попадает в протокол. Пример:

<<< prot_on>>> Ссылки:

prot_off


put_graphic_pos(Сеть::Объект:ПС,x,y)

Задает координаты центра символа на графике. Параметры:

• Сеть = Имя или номер сети пункта сигнализации. • Объект = Имя или номер объекта пункта сигнализации • ПС = Имя или номер пункта сигнализации • x = Значение координаты x (горизонтальной) • y = Значение координаты y (вертикальной) Система координат рисунка определяется для каждого рисунка индивидуально двумя противолежащими точками прямоугольника. Это могут быть, например, координаты GPS, так что можно перемещать символ в зависимости от принятых данных GPS на фоне графики. Значения x и y должны быть целыми числами, которые также могут быть отрицательными. Перемещаемый символ должен иметь в свойствах признак "Перемещаемый" (меню "Обработка графики", правая кнопка мыши на выделенном символе, пункт "Изменение размеров / действие мыши". Значения x / y = 0 / 0 устанавливают символ в позицию, заданную при вводе. Примеры:

<<< put_graphic_pos(((net)::(obj_nr):(mp_nr)),435010,275680) >>>

Устанавливает символ текущего пункта сигнализации в позицию с координатами x = 435010, y = 275680 (например, 43,5010° восточной долготы, 27,5680° северной широты). <<< put_graphic_pos("Система"::"Переменные":"Авто 1",435010,275680) >>>

Устанавливает символ заданного пункта сигнализации (здесь символ для "Авто 1") в позицию с координатами x = 435010, y = 275680 (например, 43,5010° восточной долготы, 27,5680° северной широты). Ссылки:

get_graphic xpos

get_graphic ypos

put_graphic_text


put_graphic_text(Сеть::Объект:ПС="Текст")

Присваивает пункту сигнализации графический текст, который показывается текстовым символом. Параметры:

• Сеть = Имя или номер сети пункта сигнализации. • Объект = Имя или номер объекта пункта сигнализации. • ПС = Имя или номер пункта сигнализации. • Текст = Текст или строчная переменная. Графический текст записывается в память компьютера и показывается только после перезапуска программы WINMAG plus. Вывод на экран производится текстовыми символами, которые индивидуально могут настраиваться по типу шрифта, цвету, степени прозрачности и фону. Если высота текстового символа больше его ширины, то строка текста символа поворачивается на 90°. Примеры:

<<< put_graphic_text (((Сеть)::(Централь):(ПС)) = Группа+"/"+Номер) >>>

Вставляет в текстовый символ номер группы и номер пункта сигнализации ("Группа" и "Номер" суть соответствующие переменные), например, 12/4 для группы 12 и пункта сигнализации 4. Ссылки:

put_graphic_pos


put Параметр

Передает управляющие команды на подключенные устройства и в компьютер. Параметры:

put "net"::"obj_name":"mp_name"."state_name" = "fkt_name" put mp_name."state_name" = "fkt_name" put (net::obj_nr:mp.(0)) = (1) put Переменная = Значение

• net = Имя сети. • obj_name = Имя объекта. • mp_name = Имя пункта сигнализации. • state_name = Имя состояния. • fkt_name = Имя функционального значения. • Переменная = Имя переменной, декларированное ранее командой "var". • Значение = Присваиваемое значение переменной. Для управления должно быть задано оконечное устройство с указанием:

сети, объекта, пункта сигнализации, состояния и управления - функционального значения, или в краткой форме

путем указания имени системной переменной "mp_name" с состоянием и функциональным значением.

В краткой форме команда должна получить соответствующие параметры пункта сигнализации, состояния и функционального значения, иначе команда управления не будет сформирована и передана на устройство. Для каждого параметра могут быть заданы соответствующие переменные, которые должны заключаться в скобки. Параметры отделяются установленными разделителями. Так как в WINMAG plus системные параметры, такие как, календарь, переменные и т.д., представляются в виде пунктов сигнализации, то к ним тоже применима команда "put". Примеры:

<<< put "IGIS-карта 1"::"MB100":"Группа 10"."Частичная блокировка" = "Выкл." >>> <<< put "Система"::"Переменные":"Переменная 1"."Значение 1" = "1" >>> Управление со всеми параметрами <<< put (net::obj_nr:mp.(0)) = (1) >>> Использование переменных и констант. Передает для состояния 0 функциональное значение 1. <<< put mp_nr."Управление"="Сбросить" >>> Краткая форма с использованием переменной пункта сигнализации. Сбрасывает тревогу группы MB100 (требуется соответствующая версия централи). <<< put (net_nr::obj_nr:(21700)."Тревога")="Сброс" >>> Сеть и объект заданы переменными из сообщения, пункт сигнализации – номером, состояние и управление – прямым текстом. Управление по номерам группы и пункта сигнализации: <<< panel_nr = GET_OBJ_NR_FROM_ID (netz,i_Gruppe, i_nr) >>> <<< if panel_nr > 0 then >>> <<< meldepunkt = GET_MP_NR_FROM_ID (netz::panel_nr ,i_Gruppe, i_nr) >>> <<< if meldepunkt > 0 then >>> <<< put (netz::(panel_nr):(meldepunkt).(0))=(0)>>> <<< else >>> <<< display i_Gruppe,"/",i_nr," ПС:",meldepunkt," не найден">>> <<< endif>>> <<< endif >>> put Счетчик = 10 Присваивает значение заданной переменной.


Ссылки:

get_mp_nr_from_id

get_obj_nr_from_id

simulate


reload_database Выполняет перезагрузку базы данных WINMAG plus. Пример:

<<< reload_database >>>


remove("Текст", Начало, Количество)

Удаляет текстовые символы из исходных текста или переменной. Должны указываться начальная позиция удаления и число удаляемых символов. Команда действует как функция, возвращая сокращенную строку символов. Параметры:

• Текст = Исходные текст или переменная, из которых надо удалить символы. • Начало = Позиция, после которой должно начинаться удаление.

Минимальное значение 0 – с начала строки. Если значение больше длины строки, то ничего не удаляется и возвращается исходная строка.

• Количество = Число удаляемых символов. Диапазон значений от 1 до (Длина строки –1).

Примеры:

<<< var string Новая_строка >>> <<< Новая_строка = remove ("123456789",3,3)>>>

Переменная " Новая_строка " содержит "123789". Удалены 3 символа после 3-й позиции. <<< Новая_строка = remove ("123456789",8,3)>>>

Переменная " Новая_строка " содержит "12345678". Удалены все символы после 8-й позиции. Ссылки:

find

insert

length

replace

substring



replace("Текст", "Старый", "Новый")

Заменяет фрагменты текста в исходных тексте или переменной. Заменяет все найденные фрагменты. Команда действует как функция, возвращая измененную строку символов. Параметры:

• Текст = Исходные текст или переменная, в которых надо заменить фрагменты. • Старый = Фрагмент текста или переменной, который надо заменить. • Новый = Фрагмент текста или переменной, которым надо заменить старые фрагменты. Примеры:

<<< var string Новая_строка >>> <<< Новая_строка = replace ("123456789","3","4")>>>

Переменная "Новая_строка" содержит "124456789". Заменен символ "3" на символ "4". <<< Новая_строка = replace ("123456789","a","b")>>>

Переменная "Новая_строка" содержит "123456789". Фрагментов для замены не найдено. Возвращается исходная строка. <<< Новая_строка = replace ("11111xx",1,2)>>>

Переменная "Новая_строка" содержит "22222xx ". Все символы "1" заменены на символы "2". Ссылки:

find

insert

length

remove

substring

replace_in_page(Старый, Новый)

Заменяет текст "Старый" текстом "Новый" на текущей странице. Параметры:

• Старый = Текст, который будет заменен • Новый = Текст, который будет вставлен Пример:

<<< replace_in_page(Старый, Новый) >>>


reply "Текст"

Прерывает выполнение программы и выводит на экран запрос для ввода информации пользователем. Параметры:

• Текст = Текст, который должен быть в запросе.

Ответ пользователя передается в системную переменную "answer" и может быть потом просмотрен. Пример:

<<< reply "Как дела ? >>>

Показывает диалоговое окно с этим текстом. <<< display "Был ответ ",answer >>>

Показывает текст с ответом. Ссылки:

gettime

report

report

Прерывает выполнение программы и выводит на экран запрос для ввода информации пользователем. Параметры: нет

Можно ввести более длинный текст, чем показывает текстовое окно. В текстовом окне показываются текущие строки текста. После нажатия клавиши "OK" введенный текст записывается в протокол. Пример:

<<< report >>> Ссылки:

gettime

reply


restart_driver(Сеть)

Перезапускает драйвер указанной сети. Параметры:

• Сеть = Имя или идентификатор (ID) сети Пример:

<<< restart_driver(103515222) {Fusion}>>>

Перезапуск драйвера сети с ID = 103515222. <<< restart_driver("IGIS_Loop1")>>>

Перезапуск драйвера сети "IGIS_Loop1". Ссылки:

run

right_substring(Строка,Разделитель)

Поиск фрагмента текста справа от указанного разделителя в полном тексте переменной. Команда действует как функция, которая возвращает искомый фрагмент из текста переменной. Если фрагмент текста не находится, возвращается пустая строка. Параметры:

• Строка = Текст или переменная, в которой должен производиться поиск. • Разделитель = Символы, которые появляются первый раз для определения правого фрагмента

текста. Специальные символы: CRLF = Carriage return + line feed = Возврат каретки, переход на новую строку. Примеры:

<<< Результат = right _substring("12.34", ".") >>>

Поиск фиксированного фрагмента строки символов, возвращает Результат = "34". <<< seek_alarm_reason( 91 ) >>> <<< Результат = (get_system_property("sias@seek_result")) >>> <<< while (length(Результат) > 0) >>> <<< Тест = right_substring(Результат, CRLF) >>> <<< display Get_System_Property("mp/addr/"+ Тест +"@name") >>> <<< Результат = right_substring(Результат, CRLF) >>> <<< endwhile >>>

Просмотр событий с зонами без охраны и передачи отдельных записей в переменную "Тест". Ссылки:

left_substring

substring


run("Программа"[,"Параметр"][,Переменная])

Запускает внешнюю программу. Параметры:

• Программа = Имя запускаемой программы, например, wordpad.exe. • Параметр = Параметр запуска программы, например, имя открываемого файла. • Переменная = SIAS-переменная или декларируемая переменная. Из WINMAG plus могут запускаться другие (внешние) программы. Возможные применения: - Вызов пэйджера - Включение видео внешней программой - Табличное оформление тревог -. .. Могут запускаться программы Windows и DOS. При запуске программы с параметрами они указываются как строки символов или как переменные. Примеры:

<<< run (“\windows\mplayer.exe”, “/play /close \winmag\avi\test.avi”) >>>

Запускает проигрыватель Windows, открывает и воспроизводит (/play) файл "winmag\avi\test.avi" и по окончании записи закрывает проигрыватель (/close). <<<run ("notepad",mp_name,".abc")>>>

Запускает текстовый редактор "Блокнот", производит поиск файла с именем текущего пункта сигнализации и расширением ".abc" и открывает его. <<<run ("c:\winmagplus\tools\extprot.exe ","-Pwd=Supervisor -Usr=Supervisor -Prot=Systemkonfiguration")>>> Ссылки:

call

exec

run_no_window


run_no_window("Программа"[,"Параметр"][,Переменная])

Запускает внешнюю программу без открытого окна как командный файл. Параметры:

• Программа = Имя запускаемой фоновой программы, например, bat-файл. • Параметр = Параметр запуска программы, например, имя открываемого файла. • Переменная = SIAS-переменная или декларируемая переменная. Из WINMAG plus могут запускаться внешние фоновые программы. Возможные применения: - Вызов командных файлов, например, для копирования файлов -. .. При запуске программы с параметрами они указываются как строки символов или как переменные. Примеры:

<<<run_no_window("c:\winmagplus\test\test.bat")>>>

Запускает командный файл "test.bat", фоновый, то есть без открытого окна. Ссылки:

calll

exec

run


screenshot

Печать на принтере графики окна программы WINMAG plus (печать экрана). Содержимое печати включает все рабочее окно со всеми ее частями, то есть с областями текста и графики. Печать экрана может также выполняться в пункте меню "Файл / Печать экрана" или одноименной кнопкой панели инструментов. Конфигурирование соответствующего принтера производится в меню "Обработка конфигурации системы / Настройка принтеров / Принтер экрана". Эта команда отличается от команды "hardcopy", которая печатает каждое окно на отдельной странице. Пример:

<<< screenshot >>>

Печать текущего содержимого окна тревоги. Ссылки:

hardcopy

picture


search Параметр[,Параметр][and"state_name"="fkt_name"]

Поиск пунктов сигнализации по условиям, заданным в следующем формате: search "Сеть","Объект","Тип ПС","Состояние"="Функциональное значение". Результаты поиска показываются в виде структуры с указанием входа в систему (Сеть / Объект / Пункт сигнализации), например:

Параметры:

Все параметры могут содержать символ произвольной замены " * ". С этим символом соответствующий параметр не проверяется.

• Сеть = Имя сети • Объект = Имя объекта • Тип ПС = Имя типа пункта сигнализации • Состояние = Имя состояния • Функциональное значение = Имя функционального значения

В параметрах поиска должен присутствовать тип пункта сигнализации. Просматриваются только те пункты сигнализации, которые относятся к заданному типу. Несколько поисковых критериев могут быть связаны логическими условиями:

• Условие "and" запрашивает следующий аргумент в типе пункта сигнализации. Здесь нужно указывать свои состояние и функциональное значение.

• Символ "," (запятая) работает как логическое ИЛИ. Примеры:

Простое условие: <<<search "IGIS-карта"::"561-MB100.10":"Группа вторжения MB100/16/8"."Состояние" = "В норме">>> Связь с "and": <<<search "IGIS-карта"::"561-MB100.10":"Группа вторжения MB100/16/8"."Состояние" = "Сработка" and "Главная зона" = "ГЗ 1">>> Несколько поисковых критериев: <<<search "IGIS-карта"::"561-MB100.10":"Группа вторжения MB100/16/8"."Состояние" = "Сработка","IGIS-карта"::"561-MB100.10":" Группа вторжения MB100/16/8"."Состояние" = "Отсутствует">>> Произвольная замена: <<<search *::*:"Группа вторжения MB100/16/8"."Состояние" ="Сработка">>> Ссылки:

seek

search_alarm_reason

search_alarm_type


search_alarm_reason(Номер[,Номер])

Поиск пунктов сигнализации по заданным номерам причин тревог. Номера причин тревоги связаны с функциональными значениями. Параметры:

• Номер = Номер причины тревоги как константа или числовая переменная. Примеры:

<<< search_alarm_reason(23)>>>

Поиск датчиков с причиной тревоги 23 (= Сработка). <<< search_alarm_reason(100,102)>>>

Поиск датчиков с причинами тревоги 100 или 102 (= Пожарная тревога). <<< search_alarm_reason(alarm_reason_nr)>>>

Поиск датчиков с такой же причиной тревоги, что и у обрабатываемого сообщения. Ссылки:

search

search_alarm_type

search_alarm_type(Номер[,Номер])

Поиск пунктов сигнализации по заданным номерам типов тревог. Номера типов тревоги связаны с функциональными значениями через причины тревоги. Параметры:

• Номер = Номер типа тревоги как константа или числовая переменная. Примеры:

<<< search_alarm_type(1)>>>

Поиск датчиков с типом тревоги 1 (Все пожарные тревоги). Ссылки:

search

search_alarm_reason


seek [,Параметр][and "state_name"="fkt_name"]

Поиск пунктов сигнализации по условиям, заданным в следующем формате: seek "Сеть","Объект","Тип ПС","Состояние"="Функциональное значение". Результаты поиска показываются на экране и передаются в протокол в виде строчного списка.

Запись в протоколе:

Параметры:

Все параметры могут содержать символ произвольной замены " * ". С этим символом соответствующий параметр не проверяется.

• Сеть = Имя сети • Объект = Имя объекта • Тип ПС = Имя типа пункта сигнализации • Состояние = Имя состояния • Функциональное значение = Имя функционального значения

В параметрах поиска должен присутствовать тип пункта сигнализации. Просматриваются только те пункты сигнализации, которые относятся к заданному типу. Несколько поисковых критериев могут быть связаны логическими условиями:

• Условие "and" запрашивает следующий аргумент в типе пункта сигнализации. Здесь нужно указывать свои состояние и функциональное значение.

• Символ "," (запятая) работает как логическое ИЛИ. Примеры:

Простое условие: <<<seek "IGIS-карта"::"561-MB100.10":"Группа вторжения MB100/16/8"."Состояние" = "В норме">>> Связь с "and": <<< seek "IGIS-карта"::"561-MB100.10":"Группа вторжения MB100/16/8"."Состояние" = "Сработка" and "Главная зона" = "ГЗ 1">>> Несколько поисковых критериев: <<< seek "IGIS-карта"::"561-MB100.10":"Группа вторжения MB100/16/8"."Состояние" = "Сработка","IGIS-карта"::"561-MB100.10":" Группа вторжения MB100/16/8"."Состояние" = "Отсутствует">>> Произвольная замена: <<< seek *::*:"Группа вторжения MB100/16/8"."Состояние" ="Сработка">>> Ссылки:

search

seek "IGIS-карта"::"561-MB100.10":"Группа вторжения MB100/16/8"."Состояние"="В норме" Найденные пункты сигнализации : Имя пункта сигнализации: ИК 9 (Группа 1) Имя пункта сигнализации: МК 9 (Группа 2) Имя пункта сигнализации: МК 9 окно Группа 3) Имя пункта сигнализации: РК 9 (Группа 4) Имя пункта сигнализации: ИК лестница 1 (Группа 5) Имя пункта сигнализации: МК дверь секретариата (Группа 7) Имя пункта сигнализации: Группа 9


seek_alarm_reason(Номер[,Номер])

Поиск пунктов сигнализации по заданным номерам причин тревог. Параметры:

• Номер = Номер причины тревоги как константа или числовая переменная. Примеры:

<<< seek_alarm_reason(23)>>>

Поиск датчиков с причиной тревоги 23 (= Сработка). <<< seek_alarm_reason(100,102)>>>

Поиск датчиков с причинами тревоги 100 или 102 (= Пожарная тревога). <<< seek_alarm_reason(alarm_reason_nr)>>>

Поиск датчиков с такой же причиной тревоги, что и у обрабатываемого сообщения. Ссылки:

seek_alarm_type seek_alarm_type(Номер[,Номер])

Поиск пунктов сигнализации по заданным номерам типов тревог. Параметры:

• Номер = Номер типа тревоги как константа или числовая переменная. Примеры:

<<< seek_alarm_type(1)>>>

Поиск датчиков с типом тревоги 1 (Все пожарные тревоги). Ссылки:

seek_alarm_reason


send_prog_to_group("Группа") Передает данную SIAS-программу указанной группе пользователей. Параметры: • Группа – Имя группы пользователей Пример: <<< send_prog_to_group ("Groupname") >>> Ссылки: send_prog_to_station

send_prog_to_user

send_prog_to_station("Станция") Передает данную SIAS-программу на указанную станцию. Параметры: • Станция – Имя станции Пример: <<< send_prog_to_station ("Stationname") >>> Ссылки: send_prog_to_group

send_prog_to_user

send_prog_to_user("Пользователь") Передает данную SIAS-программу указанному пользователю. Параметры: • Пользователь – Имя пользователя

Пример: <<< send_prog_to_user ("Username") >>> Ссылки: send_prog_to_group

send_prog_to_ station


set_control_text("Текст"/Переменная)

Присваивает заданный текст последнему перед этим определенному элементу управления SIAS. Параметры:

• Текст = Произвольный текст в кавычках. • Переменная = Строчная переменная. Команда меняет предустановленную настройку элемента управления. Например, кнопка в зависимости от текущих условий может называться по-разному, или текстовое поле может принимать последнее введенное значение. Пример:

<<<set_control_text(user)>>>

В текстовое поле записывает имя текущего пользователя. Ссылки:


set_title_popup("Текст"/Переменная[+"Текст"/Переменная])

Задает текст заголовка окна спадающей программы. Текст может состоять из фиксированных текстов и переменных, связываемых знаком "+". Параметры:

• Текст = Текст в кавычках. • Переменная = Имя переменной без кавычек. Примеры:

<<< set_title_popup "Справка")>>>

Задает фиксированный заголовок программы. <<< set _title_popup (obj_name+" "+mp_name)>>>

Задает заголовок программы как имя текущего пункта сигнализации. Ссылки:

popup_pin .......................................................................... popup_pos ......................................................................... popup_size.........................................................................


simulate Сеть::Объект:ПС.Состояние=Функциональное значение

Имитирует на компьютере любые функциональные значения состояний пункта сигнализации. Синтаксис команды аналогичен синтаксису команды "put" со следующими отличиями:

• Задается не управление, а состояние. • Задается не команда управления, а функциональное значение. Для имитации текстовых состояний должна использоваться команда "simulate_text". Примеры:

<<< simulate "IGIS 1"::"MB100":"Зона 1"."Состояние охраны" = "Полная охрана" >>>

Имитирует состояние полной охраны Зоны 1 централи МВ100. <<< simulate mp_nr.(0) = (1) >>>

Имитирует функциональное значение 1 состояния 0 текущего пункта сигнализации. <<< simulate (net::obj_nr:(1101).(1)) = 1>>>

Имитирует функциональное значение 1 состояния 1 пункта сигнализации 1101 текущей сети и текущего объекта (например, тревогу вторжения для группы 1 централи МВ100). Ссылки:

put

simulate_text


simulate_text (Сеть::Объект:ПС.Состояние=ФЗ,text1-text5)

Имитирует текстовые записи пункта сигнализации. Текстовые записи могут иметь суммарную длину до 200 символов и разделяться на 5 частей. Синтаксис команды аналогичен синтаксису команды "simulate" со следующими отличиями:

• Текстовые записи разделяются запятыми (1-5) • Вводимые тексты должны заключаться в кавычки. Пример:

<<< simulate_text ("IGISLoop узел 1/3"::"EMZ 561-MB256":"Карта на УВ 1"."Последнее действие" = "На охране","Максимально","12345678") >>>

Имитируются 2 текстовые записи mp_text1, mp_text2, которые далее используются в SIAS-программе. Ссылки:

put t

simulate


simulate_value (Сеть::Объект:ПС.Состояние,Значение)

Присваивает пункту сигнализации заданное значение. В сетевой конфигурации происходит обмен этим значением между рабочими станциями. Пункт сигнализации задается указанием сети, объекта и самого пункта сигнализации. Запрос пункта сигнализации может быть произведен через свойства системы. Изменение значения вызывает сообщение с причиной тревоги 700, что может использоваться при обработке в SIAS-программе. Пример:

<<< simulate_value(((0)::(3):(1)), "Пример текста") >>> <<< delay(5) >>> <<< display "Значение:", get_system_property ("mp/addr/0::3:1@value") >>>

Имитирует текст "Пример текста" для пункта сигнализации 1 объекта "Переменные" сети "Система". Запрос производится командой get_system_property. Ссылки:

simulate

put_graphic_text

single_symbol_off / single_symbol_on

Изменяют индикацию символов на графике: • По команде "single_symbol_on" показываются только те символы и ссылки на рисунки, которые

участвуют (мигают) в сообщении (тревоге). • По команде "single_symbol_off" показываются все символы и ссылки (стандартная индикация).

Изменение индикации производится также соответствующей кнопкой панели инструментов.


sms_notification(Номер,"Текст"/Переменная[+"Текст"/Переменная][,web])

Передает SMS-сообщение через опцию "Оповещение" WINMAG plus на заданный номер телефона. Сообщение может составляться из переменных и фиксированного текста. Параметры:

• Номер = Номер телефона как текст или переменная. • Текст = Фиксированный текст в кавычках

или Переменная – строчная или числовая

• Знак "+" объединяет составные части из текста и переменных. • web = Необязательный параметр, если письмо передается через портал esafetynet. Передача сообщения выполняется как функция, поэтому его отправка и квитирование могут быть проконтролированы. Максимальная длина одного SMS-сообщения – 160 символов. Пример:

<<< var integer notification_id >>> <<< system_var string Номер >>> <<< notification_id = sms_notification (Номер,alarm_reason_name+" "+obj_name+" "+mp_name+ " "+mp_text)>>> <<< delay(5) >>> <<< if check_notification_sent (notification_id) then >>> ... <<< endif >>>

Передает совокупность значений системных переменных пункта сигнализации на указанный номер телефона. По истечении 5 с проверяется факт передачи. Ссылки:



email_notification

fax_notification

voice_channel

voice_notification


sound(Файл.wav[,loop,norestart])

Воспроизводит звуковой файл через звуковую карту. Параметры:

• Файл.wav = Звуковой файл в wav-формате с указанием абсолютного или относительного пути. Относительный путь начинается с имени папки "sounds".

• loop = Непрерывное воспроизведение файла с повторами до закрытия программы или нажатия кнопки "Выключение звука" на панели инструментов.

• norestart = При продолжении прерванной программы тревоги звуковой файл больше не воспроизводится. Этот параметр должен указываться всегда последним !

Без указания параметра "loop" звуковой файл воспроизводится однократно. С параметром "loop" файл проигрывается непрерывно с повторами до тех пор пока: - Не нажата кнопка "Выключение звука" на панели инструментов - Не завершена программа тревоги Если звук запущен непрерывно с параметром "loop", и программа помещается в пакет тревог и вновь возвращается на обработку, то воспроизведение будет продолжено. Звук после продолжения программы из пакета тревог можно отменить параметром "norestart". Примеры:

<<< sound ("sounds\siren.wav") >>>

Однократное воспроизведение файла siren.wav <<< sound ("sounds\siren.wav",loop)>>>

Повторяющееся воспроизведение файла siren.wav <<< sound ("sounds\siren.wav",loop,norestart)>>>

Повторяющееся воспроизведение файла siren.wav, но после возврата программы в обработку звук не продолжается. ОШИБКА: <<< sound ("sounds\siren.wav",norestart, loop)>>> Ссылки:

beep

bell

generate_wav_file

speak


speak ("Текст")

Воспроизводит заданный текст голосом на компьютере. Необходимые условия: - Должна быть лицензирована опция "Оповещение". - Компьютер должен иметь звуковую карту. - В компьютере должен быть установлен синтезатор речи. Параметры:

• Текст = Текст сообщения, который должен воспроизводиться голосом. Примеры:

<<< speak ("Внимание, вызывайте аварийную службу по телефону 123 !") >>>

Озвучивает фиксированный текст. <<< speak (alarm_reason_name+" "+mp_name+" "+state_name+" "+fkt_name) >>>

Озвучивает сообщение через переменные, например "Пожарная тревога Дымовой датчик 41/1 в комнате 107 Тревога автоматического датчика". Ссылки:

generate_wav_file

sound

stack_color(R,G,B)

Задает цвет текста записей пакета тревог. Параметры:

• R (красный) от 0 до 255 • G (зеленый) от 0 до 255 • B (синий) от 0 до 255 Пример:

<<< stack_color(0,0,255) >>>

Записи пакета тревог синего цвета. Ссылки:

back_color

exec


substring("Текст", Начало, Количество)

Создает новую строку из текста или из строчной переменной, являющуюся фрагментом исходной. Должны указываться начальная позиция и число символов исходной строки. Команда действует как функция, возвращая выбранный фрагмент. Параметры:

• Текст = Исходные текст или переменная, из которых надо выбрать фрагмент. • Начало = Позиция, после которой должен начинаться выбор.

Минимальное значение 0 – с начала строки. Если значение больше длины строки, то возвращается пустая строка.

• Количество = Число выбираемых символов. Диапазон значений от 1 до (Длина строки –1).

Примеры:

<<< var string Новая >>> <<< Новая = substring ("123456789",3,3)>>>

Переменная "Новая" содержит "456", выборка начинается после позиции 3, ее длина – 3 символа. <<< newstring = substring ("123456789",10,3)>>>

Переменная "Новая" содержит пустую строку. После позиции 10 ничего не найдено. <<< newstring = substring ("123456789",8,3)>>>

Переменная "Новая" содержит "9", выборка начинается после позиции 8, для выборки остается 1 символ. Ссылки:

find

insert

length

remove

replace



system_var Тип Переменная [=Значение]

Декларирует переменную с именем "Переменная" и типом "Тип", которая действует во всей системе и может совместно использоваться всеми программами с определением "system_var". Таким образом, переменная определяется как глобальная. Значение переменной сохраняется на все время сеанса работы с WINMAG plus. Параметры:

• Тип = Тип переменной • Переменная = Имя переменной • Значение = Начальное значение переменной [необязательный параметр] Пример:

<<< system_var integer Счетчик >>>

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

parent_var

var


tile

Команда настройки размещения окон экрана. Открытые окна WINMAG plus упорядочиваются мозаикой. Размеры каждого окна зависят от количества окон и размеров основного окна WINMAG plus. Параметры: нет Пример:

<<< tile >>> Ссылки:

cascade

maximize

maximizeprog

maximizepicture

minimize

tilepicture

tilepicture

Команда настройки размещения окон экрана. В окна тревоги показываются мозаикой текстовая и все графические области. Параметры: нет Пример:

<<< tilepicture >>> Ссылки:

cascade

maximize

maximizeprog

maximizepicture

picture

tile


top

Устанавливает текстовую область окна программы на верхнюю строку. Если строк текст больше размера области, то появляется линейка прокрутки, с помощью которой можно просмотреть нижние строки. Команда используется, если в программе надо автоматически перейти на верхнюю строку. Параметры: нет

url(Адрес)

Вызывает программу Internet-Explorers и открывает сайт с заданным адресом. Должен быть установлен Intenet-Explorer не ниже версии 4.01. Параметры:

• Адрес = URL Команда URL открывает окно сайта с заданным адресом. Сайт, открытый другой SIAS-программой, закрывается, и открывается новый. В протокол записывается адрес вызываемого сайта, но не его содержание. Примеры:

<<<url ("http://www.esser-security.com")>>>

Вызывает сайт компании esser. <<< popup_size (492, 412) >>> <<< set_title_popup ("Видео-сервер / Web-камера")>>> <<< url ("http://10.10.1.3") >>> <<< waitforkey >>>

Показ видео с видео-сервера. Адрес видео-сервера задается в команде "url". Ссылки:

get_playbacktime

url_secure


url_secure [(Пункт сигнализации/ID)][+"&TYPE=1"]

Вызывает программу Internet-Explorers и открывает сайт программы MultiAccess for Windows (IQ MultiAccess). Должен быть установлен Intenet-Explorer не ниже версии 4.01. Параметры:

• Пункт сигнализации = Номер пункта сигнализации [необязательный параметр]. • ID = Номер карты • +"&TYPE=1" = Признак запроса информации о фото пропуска. Конечный адрес и пароль должны быть указаны в конфигурации программ WINMAG plus (настройки сети контроля доступа) и (IQ) MultiAccess (настройки сети контроля доступа). При вызове команды "url_secure" без параметров, в MultiAccess запрашивается и показывается информация текущего пункта сигнализации (связанного с программой или с символом). Для номеров пунктов сигнализации от 1 до 1000: - Последнее действие на пункте сигнализации. Для номеров пунктов сигнализации от 3001 до 3256: - Лица в соответствующей зоне. В протокол записывается адрес вызываемого сайта, но не его содержание. При наличии параметра +"&TYPE=1" запрашивается информация о фото соответствующего пропуска в (IQ) MultiAccess. Должен использоваться MultiAccess не ниже версии 6, и пропуск должен иметь фото в базе данных. Параметр ID является номером карты. Примеры:

<<<url_secure>>>

Запрашивает информацию текущего пункта сигнализации. <<< url_secure (1) >>>

Запрашивает информацию двери 1. <<< url_secure(ausweisnr+"&TYPE=1") { с фото номера пропуска = mp_text3}>>>

Запрашивает информацию о фото заданного номера пропуска. Если фото имеется, то информация передается в WINMAG plus и может быть просмотрена. Ссылки:

url


use_popup_alarm_parameter

Команда заменяет текущие параметры тревоги на ранее сохраненные. Параметры: нет Примеры:

<<< var integer Ответ >>> ... <<< Ответ = has_popup_alarm_parameter >>> <<< if has_popup_alarm_parameter then >>> <<< display"Возвращаемое значение: ", Ответ >>> <<< use_popup_alarm_parameter >>> <<< call (melderna) { Параметры программы тревоги }>>> <<< endif >>> <<< if has_popup_alarm_parameter then >>> <<< use_popup_alarm_parameter >>> <<< call (melderna) { Параметры программы тревоги }>>> <<< endif >>> Ссылки:

exec_popup_prog

has_popup_alarm_parameter


var Тип Переменная [=Значение]

Декларирует локальную переменную с именем "Переменная" и типом "Тип". Параметры:

• Тип = Тип переменной • Переменная = Имя переменной • Значение = Начальное значение переменной [необязательный параметр] Примеры:

<<< var integer Счетчик >>>

Декларирует целую переменную с начальным значением 0. <<< var integer Счетчик = 10 >>>

Декларирует целую переменную с начальным значением 10. Ссылки:

parent_var

system_var

voice_channel("Текст"/Переменная[+"Текст"/ Переменная])

Передает голосовое сообщение по телефону с установленным соединением. Сообщение может составляться из переменных и фиксированного текста. Параметры:

• Текст = Фиксированный текст в кавычках или Переменная – строчная или числовая

• Знак "+" объединяет составные части из текста и переменных. Примеры:

<<< voice_channel (" Тревога вторжения :"+EMA_alarm) >>> <<< voice_channel (" Тревоги вторжения отсутствуют ") >>> Ссылки:

dtmf_menu

sms_notification


voice_notification (Номер,"Текст"/Переменная[+"Текст"/Переменная][,web])

Передает голосовое сообщение через опцию "Оповещение" WINMAG plus на заданный номер телефона. Сообщение может составляться из переменных и фиксированного текста. Параметры:

• Номер = Номер телефона как текст или переменная. • Текст = Фиксированный текст в кавычках

или Переменная – строчная или числовая

• Знак "+" объединяет составные части из текста и переменных. • web = Необязательный параметр, если письмо передается через портал esafetynet. Передача сообщения выполняется как функция, поэтому его отправка и квитирование могут быть проконтролированы. Пример:

<<< var integer Квитирование >>> <<< system_var string Номер >>> <<< Квитирование = voice_notification (Номер,alarm_reason_name+" "+obj_name+" "+mp_name+" "+mp_text)>>>

Передает голосом совокупность значений системных переменных пункта сигнализации на указанный номер телефона. Ссылки:



email_notification

fax_notification

sms_notification

voice_channel


wait(Минуты)

Передает текущую программу на ожидание в пакет тревог на заданное время. Параметры:

• Минуты = Время ожидания в пакете тревог в минутах. Диапазон значений 1 – 1000 минут.

Команда "wait" прерывает работу программы на заданное количество минут. На время ожидания программа перемещается в пакет тревог и на экране больше не показывается. В записи пакета тревог в столбце "Статус" показывается, сколько минут программа еще будет ожидать в пакете тревог. По истечении времени ожидания программа автоматически возвращается в обработку, если позволяет ее приоритет. Если пользователю доступно соответствующее управление, то программа в любое время может быть перемещена в пакет тревог и возвращена вновь в обработку на экран. Пример:

<<< wait (10)>>>

С момента выполнения команды программа перемещается в пакет тревог на 10 минут. Ссылки:

delay

waitforkey


waitforkey

В месте команды работа программа прерывается и ожидает нажатия клавиши ENTER или кнопки с зеленой стрелкой "Далее". Параметры: нет С помощью этой команды ожидания пользователь может подробно просмотреть текущий экран до тех пор, пока он не нажмет соответствующую клавишу. Команда активизирует зеленую кнопку "Далее" для продолжения программы. Если в программе имеются элементы управления, то по крайней мере, после последнего из них должна быть команда "waitforkey", чтобы им можно было воспользоваться до завершения программы. Пример:

<<< waitforkey >>> Ссылки:

confirm

delay

gettime

newpage

report

reply

wait



while (Условие) endwhile

Организация цикла, который работает, пока выполняется заданное условие. Параметры:

• Условие = Логическое условие, которое может состоять из нескольких связанных операторами критериев (аналогично команде "if").

Условиями работы цикла могут быть:

- Счетчик шагов цикла - Проверка условия - Отсутствие конца цикла (бесконечный цикл). Важным применением команды является бесконечный цикл опроса в программу "ausbed.wxe", в котором проверяются входные сообщения. ВНИМАНИЕ ! Во избежание зацикливания следует предусматривать соответствующие проверки ! Примеры:

<<< while (1) getParameter if... then... endif ... endwhile >>>

Бесконечный цикл в программе "ausbed.wxe". <<< var integer Счетчик >>> <<< while (Счетчик < 10) inc Счетчик ... endwhile >>>

Конечный цикл. <<< while ("IGIS1"::"MB100":"Главная зона 1"."Состояние охраны" = "Без охраны") >>> <<< put "IGIS1"::"MB100":"Главная зона 1"."Управление" = "Сразу частичная охрана" >>> <<< endwhile >>>

Цикл с проверкой состояния централи. Ссылки:

if…then…endif

Условия запуска


word_wrap_off

Команда отключает специальные символы конца строк в текстовой области. Тогда текст может быть просмотрен с помощью горизонтальной линейки прокрутки. По умолчанию тексты содержат символы конца строки. Команда "word_wrap_off" является обратной команде "word_wrap_on". Параметры: нет Пример:

<<< word_wrap_off >>> Ссылки:

lock_tile_off

lock_tile_on

word_wrap_on

word_wrap_on

Команда включает специальные символы конца строк в текстовой области. По умолчанию тексты содержат символы конца строки. Команда "word_wrap_on " является обратной команде "word_wrap_off ". Параметры: нет Пример:

<<< word_wrap_on >>> Ссылки:

lock_tile_off

lock_tile_on

word_wrap_off


Комментарий <<<{ ... }>>>

Комментарий является частью исходного файла (.eff, .efm) SIAS-программы, но не используется в качестве команды или для вывода текста на экран. Комментарий заключается в фигурные скобки <<<{ Комментарий }>>> Комментарий может занимать несколько строк программы. Комментарии не могут быть вложенными (комментарий в комментарии). Комментарий может находиться только внутри блока SIAS ( <<< до >>> ).

Примеры: <<< if alarm_type_nr = 2 then {2 = Тревога вторжения} >>> <<<{Тип программы: Спадающая Назначение: Эта программа используется для управления зоной датчиков вторжения с учетом

текущего состояния и полномочий пользователей. Параметры: Сеть и объект определяются соответствующими символами Дата выпуска: 12.07.2007 Автор: Max Mustermann}>>>


Типы и причины тревог

Система работает с разными видами тревог. Различают тип тревоги и причину тревоги. Причина тревоги автоматически входит в каждое сообщение (по типу пункта сигнализации). Каждая причина тревоги связана с типом тревоги. В программе тревоги тип тревоги представляется мигающим символом в верхнем левом углу окна. Тип тревоги и причина тревоги могут быть запрошены в программе. Условия запуска непосредственно определяются типом тревоги или причиной тревоги по типу пункта сигнализации. Связанный текст и вид символа можно индивидуально настроить в базе данных. В зависимости от типа тревоги формируются таблицы системы, такие как список программ пакета тревог, список программ ручного запуска, протокол запуска программ и т.д. У записей таблиц показывается также соответствующий символ типа тревоги. Можно просмотреть общие списки или фильтровать их по типам тревоги. К имеющимся именам типов и причин тревоги могут быть добавлены пользовательские тексты. При их наличии они также показываются в программах.

Имеющиеся типы и причины тревог (см. также Руководство по программированию, Р03126-05)

№ типа тревоги

Имя типа тревоги № причины тревоги Имя причины тревоги

0 Общий 0 - 0 Общий 127 Тревога завершена 0 Общий 128 Неисправность завершена 0 Общий 129 Активация завершена 1 Пожар 1 Пожарная тревога 1 Пожар 10 Пожарная тревога датчика 1 Пожар 11 Пожарная тревога группы 1 Пожар 12 Предвар. пожарная тревога датчика 1 Пожар 13 Предвар. пожарная тревога группы 1 Пожар 15 Передача данных Пожар 1 Пожар 16 Ящик с пожарными ключами 1 Пожар 17 Отсчёт времени 1 Пожар 18 Система дымоудаления 1 Пожар 19 Линейный пожарный датчик 1 Пожар 27 Пожарная тревога 1 Пожар 100 Тревога автоматического датчика 1 Пожар 101 Тревога группы автоматических датчиков 1 Пожар 102 Тревога ручного датчика 1 Пожар 103 Тревога группы ручных датчиков 1 Пожар 104 Отсутствует 1 Пожар 105 Выкл 1 Пожар 107 Стадия включения 1 Пожар 108 Замена датчика 2 Вторжение 2 Тревога вторжения 2 Вторжение 3 Тревога нападения 2 Вторжение 20 Тревога вторжения датчика 2 Вторжение 21 Тревога вторжения группы 2 Вторжение 23 Сработка 2 Вторжение 25 Тревога датчика корпуса 2 Вторжение 26 Контакт открытия 2 Вторжение 28 Контакт включения замка 2 Вторжение 29 Предварительная тревога 3 Неисправность 5 Техническое сообщение




3 Неисправность 6 Неисправность 3 Неисправность 9 Неисправность сети 3 Неисправность 14 Неисправность Пожар 3 Неисправность 68 Неисправность радиосистемы 3 Неисправность 190 Сетевое сообщение LAN-Loop 3 Неисправность 191 Обрыв LAN-Loop 3 Неисправность 192 Сообщение LAN-Loop 3 Неисправность 450 Нет бумаги 3 Неисправность 451 Загрязнение 3 Неисправность 452 Неисправность заземления 3 Неисправность 453 Легкая неисправность 3 Неисправность 454 Неисправность 4 Контроль доступа 4 Сообщение контроля доступа 4 Контроль доступа 37 Карта блокирована 4 Контроль доступа 38 Число сотрудников изменилось 4 Контроль доступа 39 Специальный код 4 Контроль доступа 40 Сообщение 4 Контроль доступа 41 Дверь открыта 4 Контроль доступа 42 Сообщение об ошибке 4 Контроль доступа 43 Тревога контроля доступа 4 Контроль доступа 44 Зона пуста 4 Контроль доступа 45 Присутствие 4 Контроль доступа 46 Доступ разрешён 4 Контроль доступа 47 Блокировка 4 Контроль доступа 48 Разблокировка 4 Контроль доступа 49 Ошибочный ключ 5 Система 7 Системное сообщение 5 Система 8 Сообщение программы 5 Система 180 Инициализация завершена 5 Система 181 Инициализация неуспешна 5 Система 195 Смена пользователя 6 Ручная программа 99 Запущена вручную 7 Саботаж 22 Саботаж 7 Саботаж 62 Сообщение о саботаже 8 Нападение 60 Нападение с угрозой 8 Нападение 61 Похищение 8 Нападение 63 Сообщение о нападении 9 Переключение 64 TBS-тревога 9 Переключение 66 Техническое помещение 9 Переключение 90 ИдентКей 9 Переключение 91 Без охраны 9 Переключение 92 На охране 9 Переключение 93 Полная охрана 9 Переключение 94 Изменение 9 Переключение 95 Блокировка 9 Переключение 96 Выкл 9 Переключение 97 День 10 Вахта 65 Сообщение на вахту 10 Вахта 67 Вахта-неисправность 11 Временная программа 50 Время 11 Временная программа 51 Временная зона A 11 Временная программа 52 Временная зона B 12 Управление ключами 70 Управление ключом 12 Управление ключами 71 Тревога 12 Управление ключами 72 Ошибочный код




13 Видео 130 Неисправность видео 13 Видео 131 Тревога видео 13 Видео 132 Выкл 13 Видео 133 Вкл 13 Видео 134 Событие 13 Видео 135 Саботаж 14 Аварийные выходы 140 Неисправность аварийного выхода 14 Аварийные выходы 141 Тревога аварийного выхода 14 Аварийные выходы 142 Нет связи с аварийными выходами 14 Аварийные выходы 143 Саботаж 14 Аварийные выходы 144 Аварийный вызов 14 Аварийные выходы 145 Дверь открыта 15 Инженерные системы 150 Неисправность управляющего блока 15 Инженерные системы 151 Тревога 15 Инженерные системы 152 Предварительная тревога 15 Инженерные системы 153 Сообщение 15 Инженерные системы 154 предупреждение 15 Инженерные системы 155 Отключение 15 Инженерные системы 156 Ревизия 16 Техника 159 Внутренний аварийный вызов 16 Техника 160 Техническая тревога 16 Техника 161 Техническая неисправность 16 Техника 162 Техническое сообщение 16 Техника 163 Неисправность датчика воды 16 Техника 164 Сообщение о неисправности 16 Техника 165 Тепловой датчик 16 Техника 166 Тревога теплового датчика 16 Техника 167 Датчик газа 16 Техника 168 Тревога датчика газа 16 Техника 169 Неисправность системы 16 Техника 170 Функциональная неисправность 17 Тест/ревизия 30 Сообщение об ошибке 17 Тест/ревизия 31 Вход системы пожарной сигнализации 17 Тест/ревизия 32 Вход системы пожаротушения 17 Тест/ревизия 33 Вход управления с компьютера 17 Тест/ревизия 34 Выход системы пожарной сигнализации 17 Тест/ревизия 110 Идет ревизия 17 Тест/ревизия 111 Идет ревизия группы 17 Тест/ревизия 112 Ревизия группы выключена 17 Тест/ревизия 113 Ревизия абонента 17 Тест/ревизия 114 Тревога ревизии 17 Тест/ревизия 115 Диагностика 17 Тест/ревизия 116 Удаленное обслуживание 17 Тест/ревизия 117 Тест состояния 17 Тест/ревизия 118 Тест функционирования 17 Тест/ревизия 119 Тест тревоги 18 Отключение 106 Отключение 18 Отключение 126 Завершено 18 Отключение 1060 Детектор в группе 18 Отключение 1061 Группа 19 Управление 109 Управление 20 Пользовательское 20 200 Пользовательское 200 20 Пользовательское 20 201 Пользовательское 201 20 Пользовательское 20 202 Пользовательское 202 20 Пользовательское 20 203 Пользовательское 203




… … … … 29 Пользовательское 29 296 Пользовательское 296 29 Пользовательское 29 297 Пользовательское 297 29 Пользовательское 29 298 Пользовательское 298 29 Пользовательское 29 299 Пользовательское 299 30 Предупреждение 120 Предупреждение 31 Общее отключение 121 Отключение 32 Ошибка 122 Ошибка-условие 33 Выход 123 Выход активизирован 34 Информация 124 Информация 34 Информация 125 Важная информация 34 Информация 400 GPS-сообщение 34 Информация 410 Переключение 34 Информация 411 Вызов пожарной команды 35 Патрулирование 171 Тревога 35 Патрулирование 172 Неисправность 35 Патрулирование 173 Входящий вызов 35 Патрулирование 174 Отмена PNG 35 Патрулирование 175 Тревога зоны 35 Патрулирование 176 Тест 35 Патрулирование 177 Режим молчания 36 OPC 350 Сообщение 36 OPC 351 Тревога 37 Модем 370 Сообщение 37 Модем 371 Неисправность 37 Модем 372 Сбой линии 37 Модем 373 Тревога 37 Модем 375 Запрос 38 Clino 380 Присутствие 38 Clino 381 Вызов 38 Clino 382 Приоритетный вызов 38 Clino 383 Аварийный вызов 38 Clino 384 Неисправность 39 Тревога 600 Предварительная тревога 39 Тревога 601 Внутренняя тревога 39 Тревога 602 Внешняя тревога 39 Тревога 603 Тревога 40 Сообщение 500 Тишина 40 Сообщение 501 Ответное сообщение 40 Сообщение 502 Сработка 40 Сообщение 503 Критерий

1000 Не привязано 1000 Не привязано


Имеющиеся типы тревог (см. также Руководство по программированию, Р03126-05) ID Имя ID символа 0 Всего 233 1 Пожар 159 2 Вторжение 160 3 Неисправность 169 4 Контроль доступа 218 5 Система 166 6 Ручная программа 251 7 Саботаж 249 8 Нападение 250 9 Переключение 229 10 Вахта 229 11 Временная программа 220 12 Управление ключами 218 13 Видео 163 14 Аварийные выходы 336 15 Инженерные системы 228 16 Техника 228 17 Тест/ревизия 166 18 Отключение 233 19 Управление 233 20 Пользовательское 20 169 21 Пользовательское 21 169 22 Пользовательское 22 169 23 Пользовательское 23 169 24 Пользовательское 24 169 25 Пользовательское 25 169 26 Пользовательское 26 169 27 Пользовательское 27 169 28 Пользовательское 28 169 29 Пользовательское 29 169 30 Предупреждение 169 31 Общее отключение 169 32 Ошибка 169 33 Выход 169 34 Информация 169 35 Патрулирование 250 36 OPC 228 37 Модем 228 38 Clino 228 39 Тревога 169 40 Сообщение 169 10000 Не привязано 0


Программа тревоги Программа тревоги работает в отдельном собственном окне. Структуру окна программы можно задать в программе. В окне могут показываться графика, текст, комбинация графики и текста. Окно тревоги

Работа программы зависит от ее программирования на языке SIAS. Управление программой производится специальными кнопками панели управления программы. Структура окна тревоги:

• Заголовок с заданным текстом. • Мигающий символ типа тревоги данной программы. • Панель инструментов с кнопками управления программой:

- "Назад" - "Далее" - "В пакет тревог" - "Удаление" - "Текст, графика или совмещенный виды" - "Высвечивание символов и ссылок".

• Мигающий текст сообщения, вызвавшего программу с именами объекта и пункта сигнализации. • Текст и графика в сменяемых областях окна.

Максимально может быть одновременно 1 текстовая и 3 графических области. • Пакет тревог с записями программ, упорядоченными по приоритетам.


Условия запуска Условия запуска определяют, когда должна запускаться программа. В WINMAG / WINMAG plus условия запуска задаются в файле "winmagex\ausbed.eff". В WINMAG plus отдельные типы тревоги при конфигурировании могут быть связаны непосредственно с выполняемыми программами, что уменьшает объем файла "winmagex\ausbed.eff".

Условия запуска включаются в непрерывный цикл опроса входных сообщений. Поэтому программа также функционирует постоянно, пока WINMAG plus не будет переключен в режим конфигурирования. В цикле выполняются следующие действия: - SIAS-команда "getParameter" читает входные сообщения из подключенных сетей. - Все входящие сообщения сравниваются с условиями запуска. - Если условие запуска для сообщения выполняется, то запускается некоторая программа (например, по команде "exec". Программа "ausbed.wxe" продолжает непрерывную работу, если даже в данное время запущены другие программы (например, программа тревоги).

<<< while (1) getParameter { Тревога вторжения } if {(alarm_reason_nr = 2) or }(alarm_reason_nr = 20) or (alarm_reason_nr = 21) then exec (Alarm,5000) endif { Тревога саботажа } if (alarm_reason_nr = 62) or (alarm_reason_nr = 22) then exec (Alarm,7000) endif { Тревога нападения } if (alarm_reason_nr = 63) then exec (Alarm,8000) endif { Неисправности } if (alarm_reason_nr = 5) or (alarm_reason_nr = 6) then exec (Stoerung,2000) endif { Пожарная тревога } if {(alarm_reason_nr = 1) or }(alarm_reason_nr = 10) or (alarm_reason_nr = 11) then exec (Alarm,10000) endif { Временная программа Перерыв---------------------------------} if ((mp_name = "09:00")or (mp_name = "12:00")) and (state_nr = 0) and (fkt_nr = 1) then exec (pause,20000) endif { Молчание оператора -------------------------------------------} if (mp_name = "Totmann") and (fkt_name = "Alarm") then exec (totmann,31000,5) endif { Инициализация -----------------------------------------} { Сетевые сообщения } if (alarm_reason_nr = 9) then exec (fail,30000,5) endif endwhile >>>


Операторы В условиях запуска и командах сравнения используются следующие операторы: and логическое И

or логическое ИЛИ

from ... to в диапазоне

( ) скобки

< меньше

> больше

= равно

<= меньше или равно

>= больше или равно

<> не равно



Наряду с текстами и SIAS-командами файл программы также может содержать элементы, которые поддерживаются отдельными подпрограммами, выполняют собственные функции и обмениваются с SIAS-приложениями. Они являются аналогами элементов Controls в Visual-языках программирования.

Эти элементы управления могут проявляться в программе как кнопки, текстовые поля и т.д. и встроены непосредственно в тело программы, в отличие от диалоговых окон, вызываемых, например, командой "confirm", которые открываются поверх окна программы. С помощью элементов управления можно более наглядно оформлять программы.

Для элементов управления можно определить следующие свойства: - Цвета шрифта и элемента - Размер шрифта и элемента - Тип шрифта - Текстовое содержимое - Связанные переменные - Способ работы (однократно или многократно) - Необходимость ввода данных - Автоматическое продолжение работы после нажатия кнопки или другого действия на элемент

Работа программы управляется SIAS-командами. Поэтому после одной или нескольких Control-команд (элементов управления) всегда должна следовать команда ожидания (например, команда "waitforkey"), чтобы оператор мог бы работать с элементами управления.

Элемент управления SIASButtonControl. При нажатии кнопки ее надпись передается в связанную переменную. В изображение кнопки можно поместить произвольный рисунок. Элемент управления SIASCheckBoxControl. Элемент CheckBox после выделения показывает "галочку" и может выводить справа или слева от поля дату и время действия. При нажатии на поле соответствующее целое значение (0 или 1) передается в заданную переменную.

Элемент управления SIASComboBoxControl. Элемент ComboBox позволяет выбрать запись из заданного списка. Выбранная запись передается в переменную.

Элемент управления SIASEditControl. В элементе Edit можно ввести произвольный текст в пределах поля. Текст (не более 255 символов) передается в заданную переменную. Элемент управления SIASEditMultilineControl. В EditMultiline можно ввести произвольный текст без ограничения длины, при превышении длины строки текст переносится на следующие строки. Элемент управления SIASListBoxControl. Элемент ListBox позволяет выбрать запись из заданного списка. Выбранная запись передается в переменную.

Элемент управления SIASPwdEditControl. Элемент PwdEdit позволяет задать пароль в "слепом" виде. Элемент управления SIASYesNoControl. Элемент YesNo позволяет сделать выбор альтернатив. Текст каждой нажатой кнопки передается в переменную.


SIAS-командой "freeze_controls" можно отключить работу предыдущих элементов управления, то есть все ранее вставленные элементы после этой команды не будут работать. SIAS-командой "set_control_text" можно изменить текст последнего вставленного элемента управления. Можно передать несколько строк текста. Примеры:

<<< var string Вызов>>>

Вызвать охрану ?

<<< waitforkey >>> <<< freeze_controls>>> <<< if (Вызов = "Да") then .... endif >>> Вначале декларируется строчная переменная "Вызов". Она также определяется как переменная в свойствах элемента управления SIASYesNoControl. Элемент управления является составной частью текста (не составной частью SIAS-команды) и может быть окружен любым текстом. Команда "waitforkey" ждет продолжения программы после действия на элемент управления.

В зависимости от свойств элемента, действие на него сразу продолжит программу или нужно будет нажать клавишу с зеленой стрелкой "Далее" (продолжение программы, переход на новую страницу).

Если оператор может неоднократно действовать на элемент управления, то следует отключить опцию "single action". Команда "freeze_controls" отключает возможность следующих действий со всеми ранее установленными элементами управления.

Текст нажатой клавиши передается в переменную "Вызов" и далее может опрашиваться и обрабатываться. <<<set_control_text(user)>>>

В текстовое поле записывает имя текущего пользователя. Ссылки:

freeze_controls

set_control_text

waitforkey


Системные переменные (см. также Руководство по программированию, Р03126-05) alarm_reason_name Имя причины тревоги alarm_reason_nr Номер причины тревоги alarm_type_name Имя типа тревоги alarm_type_nr Номер типа тревоги answer Ответ на запрос "reply" arrival Дата и время сообщения day Текущая дата в формате "дд.мм.гггг" fkt_name Имя функционального значения пункта сигнализации (сообщения) fkt_nr Номер функционального значения пункта сигнализации (сообщения) found Количество найденных записей в командах "search / seek" hour Текущее время в часах in_mandant Пункт сигнализации привязан текущему пользователю через полномочия lite Признак работы WINMAG в опции "lite" minute Текущее время в минутах mp_family_type_name Имя семейства пункта сигнализации mp_family_type_nr Номер семейства пункта сигнализации mp_id1 Параметр ID1 пункта сигнализации mp_id2 Параметр ID2 пункта сигнализации mp_name Имя пункта сигнализации (сообщения) mp_nr Номер пункта сигнализации (сообщения) mp_text Дополнительный текст пункта сигнализации mp_text1..5 Специальный текст пункта сигнализации 1..5 mp_type_name Имя типа пункта сигнализации (сообщения) mp_type_nr Номер типа пункта сигнализации (сообщения) net Имя сети (сообщения) net_nr Номер сети (сообщения) obj_id_text ID объекта (как текст) obj_name Имя объекта (сообщения) obj_nr Номер объекта obj_text Дополнительный текст объекта obj_type_name Имя типа объекта obj_type_nr Номер типа объекта offline Режим WINMAG без связи picture_id ID текущего рисунка picture_name1..3 Имена файлов графики в областях 1..3 priority Приоритет программы response Ответ команды "gettime" в формате даты second Текущее время в секундах severity Важность причины тревоги simulated Признак программы, запущенной имитацией state_name Имя состояния пункта сигнализации (сообщения) state_nr Номер состояния пункта сигнализации (сообщения) station_nr Номер сетевой рабочей станции (виртуальный адрес) time Текущее время в формате "чч.мм.сс". user Имя текущего пользователя user_group(1..32) Привязка текущего пользователя к группе пользователей, 1 = привязан user_priority Приоритет управления текущего пользователя weekday День недели в формате (Пн, Вт, Ср,..., Вс)


Ассистент

Для поддержки написания команд существует удобный (особенно для сложных команд с параметрами) сервис (ассистент). В зависимости структуры команды ассистент построен по-разному. Ассистент запрашивает необходимые параметры, дает варианты решения при альтернативах и вставляет команду в текущей позиции курсора. Работа с ассистентом

Сервис вызывается кнопкой или пунктом меню "Insert Command (Вставить команду)". После выбора требуемой программируемой SIAS-команды кнопкой "Assistent" открывается ассистент для написания команды. При необходимости его можно игнорировать кнопкой "Apply Now (Применить сразу)". При использовании кнопки "Assistent" открывается окно с предложением ввода данных и выбором дальнейших альтернатив с управляющими кнопками: "��" �� 1 �� "��" �� "��" �� "��" �� "��" ��

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

Нажатием кнопки "Готово" сформированная команда вставляется в текст программы на текущем месте курсора.

Кнопка "Assistent" имеется для большинства существующих команд. Ее отсутствие означает, что помощник по данной команде отсутствует, например, для команд без параметров или с простой структурой. В этом случае следует сразу воспользоваться кнопкой "Apply Now (Применить сразу)".

В диалоге формирования многих SIAS-команд предлагается вставка SIAS-переменных, при этом для выбора открывается список всех возможных переменных. Имена самостоятельно определяемых переменных задаются прямым ручным вводом. Имеющиеся ассистенты Ассистенты имеются для следующих команд SIAS (список не полный – прим. перев.):

call confirm comment confirm dec delay disable dismanual display enable exec gettime hardcopy if inc

manual maximizepicture message picture priority put reply run search seek simulate sound var wait while


Ассистент графических областей Расположение графики в WINMAG plus определяется следующим областями:

• Область 1. Для одного рисунка – правая половина окна тревоги Если больше одного рисунка – правая верхняя четверть окна тревоги

• Область 2 – правая нижняя четверть окна тревоги. • Область 3 – левая нижняя четверть окна тревоги. • Текст – левая часть окна тревоги, при трех рисунках – левая верхняя четверть окна тревоги.

Примечания: • Области заполняются графикой только в указанном порядке.

Если для рисунка задается сразу 2-я область, он все равно помещается в 1-ю область ! • Рисунок всегда занимает свою область полностью. • Если показывается только один рисунок, он полностью занимает правую половину окна тревоги. • Печать на графическом принтере производится соответствующей кнопкой панели инструментов. Ассистент выбора принтера Выбор принтера производится ассистентом в команде "hardcopy". WINMAG plus поддерживает подключение до 10 принтеров графики и до 3 принтеров протоколов. Для печати на принтерах графики они должны быть определены в каждом случае. Если одно и то же содержимое должно быть напечатано на двух принтерах, они должны быть заданы оба. Ассистент используется для выбора принтеров 1.,2.,3.,4. или 10, куда должно отправляться содержимое на печать. Принтер графики 1 определяется как graphicprinter_1, принтер графики 2 определяется как graphicprinter_2 и т.д. Какой принтер реально подключен как принтер 1, должно быть определено в меню принтеров системных настроек WINMAG plus. Можно определить только принтеры, установленные в Windows.


Ассистент типа переменной Для работы с переменными обязательно должны декларироваться их типы. Возможны следующие типы переменных: • Integer (Целое) Числовые переменные для счетчиков или других вычислений. Примеры: <<< var integer Повтор = 5 >>> <<< var integer Счетчик >>> (начальное значение = 0) • String (Строка) Последовательность символов для текста или системных переменных, таких как mp_name, answer и т.д. Примеры: <<< var string Пароль = "Привет" >>> <<< var string Строка >>> (пустое начальное значение = "" ) • Date (Дата) Переменная для определения даты, например из системной переменной day. Формат переменной: дд.мм.гггг Пример: <<< var date День_рождения = 24.12.1997 >>> • Time (Время) Переменная для определения времени, например, из системных переменных time, response. Формат переменной: чч:мм:сс Пример: <<< var time Пауза = 09:00:00 >>> <<< var time Обед = 12:00 >>> <<< var time Полночь >>> (начальное значение – ноль часов = 00:00:00) Переменные задаются: - Ключевым словом var - Типом - Именем - Начальным значением через знак равенства = ... (необязательный параметр)


Ассистент имени переменной При декларации переменной обязательно задать ее имя. Примечания: • Локальные переменные действуют только в рамках SIAS-программы, в которой они определены. • Имя переменной должно быть однозначным в программе. • Имя переменной должно иметь смысл и указывать на ее назначение. • Имя переменной не должно содержать нестандартных букв и символов (ä,ü,ö). • Имя переменной должно состоять из непрерывной последовательности символов. • Имя переменной не должно быть длиннее 20 символов. • В имени различаются прописные и строчные буквы. • Глобальные переменные, действующие за пределами данной SIAS-программы, должны

определяться системными переменными или системными пунктами сигнализацииMeldepunkt. Сеть: Система

Объект: Переменные Некоторые глобальные переменные определены в настройках при поставке: Variable 1, Variable 2, Variable 3, Initialization, Alarms

Примеры: var integer Счетчик_тревог var integer Повтор = 5 Ассистент начального значения переменной Integer Ввести начальное значение целой переменной. Если начальное значение не задано, оно принимается равным 0. Можно использовать положительные и отрицательные значения. Примеры: <<< var integer Повтор = 5 >>> <<< var integer Счетчик >>> (начальное значение = 0) Ассистент начального значения переменной String Ввести строку начального значения. Длина строки практически неограничена (примерно до 2 млрд. знаков) Если начальное значение не задано, оно принимается равным "" – пустой строке. Можно использовать любые символы. Примеры: <<< var string Пароль = "Привет" >>> <<< var string Строка >>> (пустое начальное значение = "" )


Ассистент начального значения переменной Date Ввести начальное значение времени. Если начальное значение не задано, оно принимается равным 01.01.1995. Примеры: <<< var date День_рождения = 24.12.1997 >>> <<< var date Без_начала >>> (начальное значение – 01.01.1995) Ассистент начального значения переменной Time Ввести начальное значение времени. Если начальное значение не задано, оно принимается равным 00:00:00. Формат переменной: чч:мм:сс Примеры: <<< var time Пауза = 09:00:00 >>> <<< var time Обед = 12:00 >>> <<< var time Полночь >>> (начальное значение – ноль часов = 00:00:00) Ассистент команды "display" Команда "display" отображает на экране тексты и переменные SIAS-программы. Команда может иметь несколько параметров. Параметры разделяются запятыми. Пример: display "Датчик ", mp_name," имеет состояние ", state_name Возможны многократные циклические определения строк для отображения, пока не будет нажата кнопка "Готово". В команде можно объединять следующие фрагменты: • Фиксированный текст (последовательность символов) • Отдельно определенные переменные и системные переменные. • Состояния пунктов сигнализации.

Для выбора типа отображаемого фрагмента служат кнопки опций. Ассистент типа тревоги Тип тревоги служит для классификации событий в системе. Тип тревоги индицируется значком в списках пакета программ или ручных программ.

В WINMAG plus определено множество типов тревог. Список типов тревог непрерывно расширяется.

Примеры типов тревог: • Пожар • Вторжение • Неисправность


Ассистент дерева рисунков Рисунки в WINMAG plus организованы в виде иерархической структуры. Начиная с "головного рисунка", каждый рисунок следующего уровня доступен с помощью "ссылки на рисунок". Глубина вложения в дереве структуры – практически не ограничена. Один и тот же рисунок может входить в структуру неоднократно – вместе с другими нанесенными на него символами (например, один и тот же план здания для систем пожарной и охранной сигнализации). Поэтому важно точно определить положение рисунков в дереве для правильного отображения в программах тревоги. Графический вид WINMAG plus показывает дерево рисунков, начиная с "головного рисунка". - Следующие уровни показываются с отступом. - Переход к нужному рисунку производится щелчком мыши на имени рисунка в дереве. При необходимости следует раскрыть следующий уровень дерева значком "+". При вводе рисунков в структуру его можно видеть в отдельном окне просмотра. Ассистент функционального значения Диалог выбора функционального значения пункта сигнализации для последующей обработки. Выбрать необходимый пункт из предлагаемого списка в алфавитном порядке. При вводе буквы с клавиатуры производится переход к пунктам, начинающимся на эту букву.

Ассистенты команд "if…" и "while…" Условные операторы "if…" и "while…" являются одними из самых важных элементов языка SIAS. Входящие в них условия могут содержать различные параметры, например: - сравнения - логические связи And - логические связи Or


Ассистент пункта сигнализации Диалог выбора пунктов сигнализации. Появляется, например, в таких командах как "put", "simulate", "enable" …

Условия: • Пункт сигнализации должен быть определен, то есть существовать в базе данных WINMAG plus. • Пункт сигнализации должен быть активирован.

Порядок действий: 1. В дереве структуры выбрать сеть, которая содержит нужный пункт сигнализации (в примере "IGIS-Loop 256"). 2. В дереве структуры выбрать объект, который содержит нужный пункт сигнализации (в примере "MB256"). 3. В дереве структуры выбрать пункт сигнализации (в примере "Зона 1") 4. Нажать кнопку "Далее >". Ассистент типа пункта сигнализации Диалог типа пункта сигнализации появляется при его выборе в командах "search" и "seek". Список показывает все типы пунктов сигнализации, определенные в базе данных. Примечание: • Следует аккуратно выбирать тип пункта сигнализации, так как список содержит все типы, в том числе, не относящиеся к выбранному объекту (централи) !

Ассистент предварительного просмотра После ввода всех параметров сформированная команда показывается в окне редактирования, где может быть исправлена перед вводом в текст программы. • После нажатия кнопки "Готово" команда попадает в текущую позицию текста программы. • При нажатии кнопки "Отмена" команда в текст программы не вставляется.


Ассистент имени программы Имя программы должно быть всегда задано при определении или вызове программы. Примечания: • Имя программы должно иметь смысл и указывать на ее назначение. • В имени программы в качестве букв рекомендуется использовать только латинские буквы. • Имя программы действует глобально в WINMAG plus !

> Имя должно быть однозначным > Каждая программа сохраняется в отдельном файле Примеры: call (Имя_программы) exec (Имя_программы, Приоритет[,Тип]) manual (Имя_программы, Приоритет, Тип,"Текст"[Сообщение]) Ассистент выбора звукового файла Диалог для выбора звукового файла, который воспроизводится командой "sound". Условия: • Звуковые файлы должны быть в wav-формате. • Для воспроизведения звука в компьютере должна быть установлена звуковая карта. Порядок действий: 1. В текстовое поле ввести имя звукового файла или воспользоваться кнопкой "Search for Sound files…" для выбора файла в диалоге. 2. Выбрать нужный файл с расширением *.wav в открытой папке. 3. При необходимости активизировать непрерывное звучание опцией "Play a sound loop". 4. Нажать кнопки "Далее >" и затем "Готово".


Ассистент системных переменных Позволяет выбрать системные переменные из списка. Примеры:

alarm_reason_name Имя причины тревоги alarm_reason_nr Номер причины тревоги alarm_type_name Имя типа тревоги alarm_type_nr Номер типа тревоги answer Строка ответа на запрос командой "reply" arrival Дата + время поступления сообщения day Текущая дата в формате дд.мм.гггг fkt_name Имя функционального значения fkt_nr Номер функционального значения found Количество пунктов, найденных командами "search" или "seek" mp_name Имя пункта сигнализации mp_nr Номер пункта сигнализации mp_type_name Имя типа пункта сигнализации mp_type_nr Номер типа пункта сигнализации net Имя сети obj_name Имя объекта priority Приоритет программы response Ответ на комаду "gettime" в формате даты state_name Имя состояния state_nr Номер состояния time Текущее время в формате чч.мм.сс user Имя пользователя weekday День недели в системном формате (Пн, Вт, Ср,...,Вс) Переменные, определяемые в программе, выбираются путем ручного ввода их имен. Ассистент текста Ввод текста. Форматирование текста определяется форматом предыдущего текста в программе.

Ассистент сравнения Диалог сравнения дает возможность следующих проверок:

• Соответствует ли текущее состояние пункта сигнализации заданному значению. • Равна ли системная переменная или декларированная переменная заданному значению.

Выбор варианта сравнения производится кнопками опций.


Ассистент сравнения переменных Диалог для сравнения системных переменных или декларированных переменных с заданными значениями с помощью выбранных операторов. Пример: if (answer = "123") then .... Возможные операторы: • = Равно • <> Неравно • < Меньше • > Больше • <= Меньше или равно • >= Больше или равно Ассистент операторов сравнения Показывает список возможных операторов сравнения. Возможны следующие операторы в зависимости от типа операндов: • = Равно • <> Неравно • < Меньше • > Больше • <= Меньше или равно • >= Больше или равно Ассистент значений Ввод значений в соответствии с требуемыми параметрами.

Примеры: - Проритет при вызове программы - Значение увеличения переменной в команде "inc" - Значение уменьшения переменной в команде "dec" Ассистент состояния Диалог выбора состояния пункта сигнализации для последующей обработки. Выбрать необходимый пункт из предлагаемого списка в алфавитном порядке. При вводе буквы с клавиатуры производится переход к пунктам, начинающимся на эту букву. В зависимости от команды показываются списки состояния или управления. - Управление: для команд "put", "enable", "disable" - Состояние: для команды "simulate"


Глоссарий DAO Data Access Objects = библиотека с командами управления данными JET engine = "Database engine". DEZ 9000 Digitale EmpfangZentrale (Цифровая приемная централь) – удаленная станция для приема и обработки управляющей информации через различные средства передачи. Входящие сообщения могут поступать в WINMAG plus. effeff effeff – крупнейший производитель оборудования систем безопасности с передовыми решениями в области систем охранной, пожарной сигнализации, контроля доступа, учета времени и дверных замков. С 01.04.2003 effeff переименован в Novar GmbH. IGIS Integriertes Gefahren Informations System – информационная сеть разработки effeff. IQ MultiAccess Программа контроля доступа с возможностью прямого подключения к WINMAG plus. Производитель – компания Novar. JET engine = "Database engine". Предназначено для управления текущей базой данных. Konvertg Программа конвертации данных GEMAG в структуру WINMAG. Преобразуются рисунки, символы, данные объектов с пунктами сигнализации и программы. Master (главный абонент) Абонент сети, управляющий сетью в данный момент. Должен устанавливаться на базовый адрес. Master (главный абонент) - смена Автоматическая смена главного абонента, если текущий главный абонент отключился. Функции главного мастера принимает абонент со следующим базовым адресом. Novar GmbH Novar GmbH – новое имя фирмы esser effeff alarm GmbH с 01.04.2003. Novar GmbH является членом компании Honeywell Group, которая специализируется на интеллектуальных технологиях управления зданием и насчитывает по всему миру 130 000 сотрудников. ODBC Open DataBase Connectivity – стандартный интерфейс доступа к базам данных Microsoft. Для разных баз данных необходимы соответствующие драйверы ODBC. SIAS SIcherheits Anwendungs Sprache – язык программирования систем безопасности. На этом языке пишутся программы тревог и условия запуска, например, команда "confirm" для альтернативы ДА/НЕТ.


SIASEdit Редактор и компилятор создаваемых SIAS-программ для WINMAG plus. SQL Structured Query Language – стандартный язык запросов к базе данных. Urmaster (самый главный абонент) Абонент с адресом 0, который запускает сети. В работе сети могут участвовать только те абоненты, которые известны самому главному абоненту при запуске сети. Любой базовый адрес может получать от самого главного абонента функции главного абонента. WINMAG plus Управляющая программа для систем безопасности с визуализацией процессов и индивидуальной настройкой процесса тревоги. Производитель - компания Novar. База данных Обобщенный термин для "База данных" и "Система управления базами данных". "База данных" = один или несколько файлов, содержащих все данные. "Система управления базами данных" = управляющая программа для файлов в базе данных. Базовый адрес Адрес в сети IGIS, абонент которого несет управляющие функции. Базовые адреса составляют 0, 8, 16 и т.д. через 8. Головной рисунок Верхний рисунок в дереве рисунков. Графика Графическое отображение контролируемой области. Графика может содержать динамические символы для индикации состояния датчиков и других пунктов сигнализации. Дамп Список принимаемых сообщений. Древовидная структура Иерархическое отображение с раскрывающимися уровнями: + = Раскрыть уровень - = Свернуть уровень Календарь Определение специальных дней. Распространяется на 4 года. Календарь может запрашиваться в условиях запуска и программах. Объект Устройство, подключенное к управляющей программе WINMAG plus, например, охранная централь. Окно Часть программы, которая функционирует одновременно с другими частями. Каждая программа тревоги выполняется в своем окне.


Оконечное устройство Абонент подключенных сетей, например, сетей IGIS, IGIS-LOOP. Подсеть Шина Honeywell, подключаемая к сети IGIS через интерфейс подсети IGIS-LAN. Можно подключить до 7 близко расположенных абонентов. Абоненты подсети занимают адреса IGIS между базовыми адресами (кратными 8). Причина тревоги Автоматически присваиваемое свойство тревоги, например, Пожарная тревога отдельного датчика, Пожарная тревога группы,... Несколько причин тревоги объединяются в тип тревоги, например, Пожар. Программа Последовательность исполняемых программ. Может содержать команды процесса тревоги, управления, отображения графики, элементы мультимедиа,... Программа тревоги Программа тревоги – это последовательность команд, которые выполняются системой при выполнении условий запуска. Каждая программа тревоги имеет свой приоритет. Могут содержать команды управления, тексты, графику, элементы мультимедиа, ветвящиеся процессы. Процедура Логически законченная последовательность команд. Могут служить отдельными модулями программ. Пункт сигнализации Пункт сигнализации – это адрес, под которым подключенное устройство передает свою информацию или получает ее. Пункт сигнализации может иметь до 8 состояний. Символ Графическое представление пункта сигнализации. Изображение символа зависит от текущего состояния и функционального значения пункта сигнализации. Следующий рисунок Рисунок, который открывается через ссылку на рисунок с предыдущего рисунка. Состояние Одно из 8 (максимально) информационных свойств пункта сигнализации. Различаются состояния входа и выхода. Вход = от оконечного устройства в систему управления Выход = от системы управления в оконечное устройство (управление) Ссылка на рисунок Прямоугольная рамка любого размера. Щелчок мыши на рамке открывает следующий привязанный к рамке рисунок. Тип тревоги Разновидности тревог, на которые подразделяются список тревог и программы тревог, например, Пожар, Вторжение, Система.


Условие запуска Условие запуска жестко определяет, при каких обстоятельствах в системе активизируются какие-то процессы, например, запускается программа тревоги. Функциональное значение Конкретное значение, которое принимает состояние пункта сигнализации. Состояние может иметь до 16 различных функциональных значений.

Honeywell Security & Data Collection Novar GmbH

Johannes-Mauthe-Straße 14

D-72458 Albstadt

www.honeywell.com/security/de 2009-02-12 © 2009 Novar GmbH

WINMAG plus - img.armo.ruimg.armo.ru/files/WINMAG_plus_v2_SIAS_ru.pdf · Данный...

Documents

Transcript of WINMAG plus - img.armo.ruimg.armo.ru/files/WINMAG_plus_v2_SIAS_ru.pdf · Данный...