Команда по событию (Responsive commander 1) — различия между версиями

Материал из Integra-S Wiki
Перейти к: навигация, поиск
(Проверка)
(Алгоритм работы)
Строка 78: Строка 78:
 
==Алгоритм работы==
 
==Алгоритм работы==
  
#Проверяется, чтобы объект источник события соответствовал хотя бы одной маске из списка '''settings.source_types''', либо имел идентификатор из списка '''settings.source_guids'''.
+
#Проверяется, чтобы объект источник события имел тип'''settings.source_types''' и идентификатор из списка '''settings.source_guids''' (если указано).
 
#Проверяется, что список измененных параметров содержит состояние объекта, и значение состояния соответствует хотя бы одной маске из списка '''settings.source_states'''.
 
#Проверяется, что список измененных параметров содержит состояние объекта, и значение состояния соответствует хотя бы одной маске из списка '''settings.source_states'''.
 
#Если в '''settings.link_type''' указан тип линка и '''settings.link_same_side''' равен '''false''':
 
#Если в '''settings.link_type''' указан тип линка и '''settings.link_same_side''' равен '''false''':

Версия 12:55, 23 июля 2018

Отправка команды устройствам по событию от других устройств (или от самого себя).

Построение схемы

Для построения схемы требуется:

1. Добавить триггер EgsObjectUpdated.

Для этого необходимо:
1. Перейти на вкладку "Типы элементов" и выбрать в списке элемент EgsObjectUpdated.
ResponsiveCommander 2.png
2. Дважды нажать на выбранный элемент, после чего появится окно для добавления элемента.
Scheduled com 5.png
3. Нажать кнопку "Добавить". Элемент появится на рабочей области.
ResponsiveCommander 3.PNG

2. Аналогично пункту 1 добавить элементы Egs Модуль EgsModule, менеджер AcuarioManager и компьютер Computer.

ResponsiveCommander 4.PNG

3. Настроить сетевой адрес компьютера.

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

В окне свойств элемента указать ip адрес используемого компьютера в строке "Сетевой адрес".

Scheduled com 7.PNG

4. Связать EgsObjectUpdated и Egs Модуль, подключив пины «Egs вход: EgsInput» у EgsObjectUpdated и «Egs выход: EgsOutput» у Egs Модуля.

ResponsiveCommander 5.PNG

5. Привязать пин "Привязка к менеджеру: ManagingContent" из Egs Модуля к пину "Привязка к менеджеру: ManagingContainer" из Менеджера устройств.

Scheduled com 9.PNG

6. Подключить пин "ПО: SoftwareContent" из Менеджера устройств с пином "Установленное ПО: SoftwareContainer" из Компьютера.

ResponsiveCommander 6.PNG

7. Настроить следующие параметры триггера:

  1. текст скрипта (script) http://maps.integra-s.com:5434/resources/typedef2017/jsonpath.php?url=/egs/Responsive%20commander%202.put&path=0/params/script/value;
  2. в настройках:
    1. тип объекта источника событий (source_types), например: FireSecurityCategory;
    2. список идентификаторов объектов источников событий (source_guids), например: 7cd95cde-e320-456e-afc1-475899d78707;
    3. список масок имен событий, активирующих скрипт (source_states), например: alarm_*, error_*;
    4. имя типа линка, соединяющего источник и приемник (link_type), например: LogicLink, Position;
    5. флаг, указывающий по одну или по разные стороны линка находятся источник события и приемник команды (link_same_side), см. примеры в низу;
    6. тип объекта приемника команд (target_types), например: Turnstile;
    7. список идентификаторов объектов приемников команд (target_guids), например: 119eee75-8a52-4443-b537-aac86d3a8a8f;
    8. отправляемая команда (target_command), например: activate, deactivate, open_out.

Настройку параметров триггера можно выполнить, открыв свойства элемента.

ResponsiveCommander 9.PNG

Маски состояний

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

? - любой одиночный символ;
* - ноль или более символов;
# - любая цифра от 0 до 9;
[ charlist ] - любой одиночный символ в charlist;
[! charlist ] - любой одиночный символ, не включенный в charlist.

Проверка

После запуска скрипта в параметре "Хеш" появится хеш текста скрипта, который должен быть равен тексту по следующей ссылке http://maps.integra-s.com:5434/resources/typedef2017/jsonpath.php?url=/egs/Responsive%20commander%202.put&path=0/params/hash/value

Хэш-сумма будет совпадать только в том случае, если скрипт не был изменен.

Алгоритм работы

  1. Проверяется, чтобы объект источник события имел типsettings.source_types и идентификатор из списка settings.source_guids (если указано).
  2. Проверяется, что список измененных параметров содержит состояние объекта, и значение состояния соответствует хотя бы одной маске из списка settings.source_states.
  3. Если в settings.link_type указан тип линка и settings.link_same_side равен false:
    1. выбираются все объекты, находящиеся с ранее выбранными по разную сторону линка settings.link_type;
    2. выбранным объектам в поле command записывается команда settings.target_command.
  4. Если в settings.link_type указан тип линка и settings.link_same_side равен true:
    1. выбираются все объекты, находящиеся с ранее выбранными по одну сторону линка settings.link_type;
    2. выбранным объектам в поле command записывается команда settings.target_command.
  5. Если в settings.link_type не указан тип линка:
    1. выбираются все объекты типов, соответствующих хотя бы одной маске из списка settings.target_types, либо имеющие идентификатор из списка settings.target_guids.
    2. выбранным объектам в поле command записывается команда settings.target_command.

Примеры использования

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

{   
   "source_types": ["FireSecurityCategory"],
   "source_guids": null,
   "source_states": ["alarm_*"],
   "link_type": "",
   "link_same_side": false,
   "target_types": ["Turnstile"],
   "target_guids": null,
   "target_command": "open_out" 
}

2. По тревоге от датчика пожарной сигнализации открыть на выход турникет, связанный с ним линком LogicLink.

{
   "source_types": ["FireSecurityCategory"],
   "source_guids": null,
   "source_states": ["alarm_*"],
   "link_type": "LogicLink",
   "link_same_side": false,
   "target_types": ["Turnstile"],
   "target_guids": null,
   "target_command": "open_out" 
}

3. По тревоге от датчика пожарной сигнализации открыть на выход турникет, находящийся в том же помещении, т.е. связанный с тем же объектом типа Space.

{
   "source_types": ["FireSecurityCategory"],
   "source_guids": [],
   "source_states": ["alarm_*"],
   "link_type": "Position",
   "link_same_side": true,
   "target_types": ["Turnstile"],
   "target_guids": [],
   "target_command": "open_out" 
}

4. По тревоге от датчика пожарной сигнализации c идентификатором 7cd95cde-e320-456e-afc1-475899d78707 открыть на выход турникет с идентификатором 119eee75-8a52-4443-b537-aac86d3a8a8f.

{
   "source_types": [],
   "source_guids": ["7cd95cde-e320-456e-afc1-475899d78707"],
   "source_states": ["alarm_*"],
   "link_type": "",
   "link_same_side": false,
   "target_types": [],
   "target_guids": ["119eee75-8a52-4443-b537-aac86d3a8a8f"],
   "target_command": "open_out" 
}

Пример работы

Для построения схемы необходимо:

1. Создать схему по выше описанному алгоритму (см. Построение схемы).

ResponsiveCommander 6.PNG

2. Добавить элемент Турникет и Болид Пожарный датчик.

ResponsiveCommander 10.PNG

3. Настроить параметр "Сетевой адрес" компьютера.

4. Настроить следующие параметры триггера:

  1. список масок имен типов источников событий (source_types): [];
  2. список масок имен событий, активирующих скрипт (source_states): alarm_*;
  3. имя типа линка, соединяющего источник и приемник (link_type): "";
  4. флаг, указывающий по одну или по разные стороны линка находятся источник события и приемник команды (link_same_side): false;
  5. список масок имен типов приемников команд (target_types): [];
  6. список идентификаторов объектов приемников команд (target_guids). В данном случае это турникет с идентификатором: 70500b89-8b04-46b3-9173-6a48ecd78e61;
  7. отправляемая команда (target_command): open_out;
  8. список идентификаторов объектов источников событий (source_guids).

Для этого необходимо зайти в свойства пожарного датчика и нажать на ссылку "Болид Пожарный датчик". Идентификатор будет скопирован в буфер обмена. В данном случае это: 2ff2420d-a001-4d59-99b7-4ca66d507e6f.

ResponsiveCommander 11.png

Результат:

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

Дополнения

1. В пункте 1 раздела Построение схемы добавление триггера EgsObjectUpdated можно осуществить по ссылке.

Для этого необходимо:

1. Импортировать скрипт по следующей ссылке: http://maps.integra-s.com/resources/typedef2017/egs/Responsive%20commander%201.put.
2. Выбрать пункт главного меню "Файл". После этого выбрать "Импорт элементов".
Scheduled com 1.png
3. В открывшемся окне выбрать импортированный скрипт "Outdated remover 1.put".
ResponsiveCommander 1.PNG
Элемент появится на рабочей области.
ResponsiveCommander 3.PNG

2. В пункте 7 раздела Построение схемы редактирование параметров элемента можно осуществить, выделив элемент правой кнопкой мыши и в контекстном меню выбрав пункт "Редактировать параметры".

ResponsiveCommander 7.png
После этого откроется окно для редактирования параметров.
ResponsiveCommander 8.PNG