06. Интеграция с мониторингом Streletz-Cloud (АРГУС-СПЕКТР)
Среди компаний, использующих Okdesk, не мало организаций, работающих в сфере внедрения и обслуживания систем противопожарной безопасности. Одним из лидеров рынка оборудования для противопожарной безопасности является компания Аргус-Спектр. Для мониторинга противопожарных датчиков и элементов противопожарной инфраструктуры, компания Аргус-Спектр создала специализированную систему для мониторинга Streletz-Cloud:
А для того, чтобы алерты и тревожные сообщения из Streletz-Cloud автоматически попадали в Okdesk, мы разработали специальный модуль для интеграции.
Сценарий интеграции
При включении интеграции Okdesk будет каждые 5 минут подключаться к сервису Streletz-Cloud и забирать информацию о новых алертах и тревожных событиях. Для каждого события будет фиксироваться вся необходимая информация для идентификации объекта, сегмента, раздела и устройства противопожарной системы.Предварительные настройки
Для того, чтобы интеграция была возможной, нужно провести ряд настроек:
- Создать в Okdesk тип заявок с кодом streletz_cloud_alerts и названием "Заявки из Streletz-Cloud". Заявки по событиям из Streletz-Cloud будут создаваться в Okdesk с этим типом;
- Добавить в Okdesk в карточку объекта обслуживания дополнительный атрибут с кодом system_id, типом строка и названием "ID соответствующей системы";
- Добавить в Okdesk в карточку заявки дополнительные параметры для хранения идентифицирующих параметров события:
- Атрибут типа "Строка" с кодом event_id и названием "Идентификатор события". В этом параметре будет храниться информация, однозначно идентифицирующая событие, связанное с заявкой, на стороне Streletz-Cloud;
- Атрибут типа "Строка" с кодом system_id и названием "ID системы события". В этом параметре будет храниться идентификатор системы, с которой связано событие в Streletz-Cloud;
- Атрибут типа "Строка" с кодом segment_id и названием "ID сегмента события". В этом параметре будет храниться идентификатор сегмента, с которым связано событие в Streletz-Cloud;
- Атрибут типа "Строка" с кодом partition_id и названием "ID раздела события". В этом параметре будет храниться идентификатор раздела, с которым связано событие в Streletz-Cloud;
- Атрибут типа "Строка" с кодом equipment_id и названием "ID устройства события". В этом параметре будет храниться идентификатор устройства, с которым связано событие в Streletz-Cloud;
- Атрибут типа "Значение из списка" с кодом event_type и названием "Тип события". В этом параметре будет храниться тип события по справочнику типов событий в Streletz-Cloud. Дополнительно вы можете указать для атрибута параметры "Отображать на списке заявок" и "Фильтровать на списке заявок" — в этом случае будет проще делать выборку списка заявок по типу инициирующего события;
- Атрибут типа "Дата/время" с кодом server_datetime и названием "Время события на сервере". В этом параметре будет храниться время появления события на сервере Streletz-Cloud;
- Атрибут типа "Дата/время" с кодом segment_datetime и названием "Время события на панели". В этом параметре будет храниться время появления события на контрольной панели.
- Создать в Streletz-Cloud технического пользователя с правами на чтение событий, иерархии объектов и справочников (этот пользователь будет использоваться для подключения Okdesk к Streletz-Cloud).
Как подключить интеграцию
Для того, чтобы подключить интеграцию, необходимо совершить все действия из указанных в разделе "Предварительные настройки", и прислать в тех. поддержку заявку на подключение, в которой сообщить:
- Логин и пароль технического пользователя для подключения к Streletz-Cloud;
- Список id типов событий на стороне Streletz-Cloud, которые необходимо исключить из интеграции (т.е. игнорировать их и не создавать по ним заявки);
- ID пользователя-сотрудника на стороне Okdesk, от имени которого будут создаваться заявки по алертам из Streletz-Cloud (можно создать технического-пользователя с произвольным ФИО и оставить его деактивированным, чтобы не занимал лицензию).
Как работает интеграция
После включения интеграции Okdesk будет каждые 5 минут опрашивать Streletz-Cloud на предмет новых событий. В случае появления новых событий (за исключением событий, типы которых выбраны вами как исключения), в Okdesk будет создаваться новая заявка по следующему алгоритму:
- Тип заявки соответствует типу, созданному в соответствии с требованиями предварительных настроек;
- Название заявки = название события + название объекта события + состояние объекта на момент события;
- В дополнительные параметры заявки, созданные в соответствии с требованиями предварительных настроек, копируются соответстующие значения события на стороне Streletz-Cloud;
- Если в Okdesk найден объект обслуживания, где в дополнительном атрибуте с кодом system_id указано значение, соответствующее ID системы, с которой связано событие в Streletz-Cloud, созданная заявка будет связана с найденным объектом обслуживания;
- В описание заявки попадает расширенная информация о событии, включая наименование объекта, раздела, сегмента и устройства, с которыми связано событие.
Загрузка данных...