Автоматизация

Типы сигналов

Условием для запуска задания автоматизации может являться:

• Временное расписание
  В качестве сигнала для запуска задания автоматизации может использоваться факт наступления времени по расписанию; расписание может формироваться с произвольной периодичностью: раз в минуту/час/день/неделю/год, в определенное время каждый день/неделю/месяц/год, с заданной периодичностью в определенный интервал времени и так далее.
  
  
• Событие от какого-либо узла сети, удовлетворяющее условию фильтра
  Все узлы сети НЕЙРОСС обмениваются событиями друг с другом, поэтому в качестве входного события для задания автоматизации может выступать события от контроллеров БОРЕЙ или ЯРС, серверов ПАК Интеграция, ITRIUM, IP-камер и других узлов сети.
  
  
• Событие Платформы НЕЙРОСС
  Любое событие, регистрируемое в виде записи Системного журнала (системные события, события авторизации, ошибки записи, действия операторов, сообщения о бездействии операторов и многое другое) может являться сигналом для запуска заданий автоматизации. 
  
  
• Группа сигналов
  Последовательность единичных и множественных событий. Запуск задания может осуществляться при накоплении определённого количества событий, либо по причине отсутствия событий, а также при выполнения целой последовательности условий.
  
  
• HTTP-запрос
  Для обеспечения функций интеграции с «внешними» системами предусмотрен запуск заданий автоматизации по определённому HTTP-запросу; код запроса настраивается. Предусмотрена работа как с авторизацией, так и без неё.

Типы действий

Типы действий

При выполнении условия задания автоматизации может быть выполнено:

• Управляющая команда или набор команд
  Наиболее популярным типом действия в задаче автоматизации является выполнение команд управления над элементами системы; из списка функциональных элементов формируется набор элементов, каждому элементу из набора задаётся команда. которая должна быть выполнена по факту получения сигнала. 
  Простым примером выполнения управляющей задачи автоматизации по расписанию является постановка объекта на охрану по факту окончания рабочего дня, пример задачи по событию — блокировка точек доступа по тревоге в разделе сигнализации, поворот (смена препозиции) камеры. В случае необходимости использования сложных алгоритмов анализа как входных условий, так и последовательности выполняемых действий, предоставляется механизм Scala-скриптовой логики.
  
  

• Отправка Email-cообщения/отчёта или Telegram-уведомления
  Еще одним популярным типом действия является автоматическое формирование и отправка сообщений или отчетов с получением по электронной почте или в виде Telegram-уведомления.
  Для обеспечения возможности автоматического формирования отчётов предусмотрен механизм динамического формирования временного диапазона. Отчёт формируется на базе предварительно подготовленного набора параметров и за интервал времени, рассчитываемый относительно текущего времени: за текущую неделю/месяц/год (с 00:00 начала периода); за последние несколько часов, дней и проч. (со сдвигом относительно текущего времени).
  Email-отчёт или Telegram-уведомление может быть дополнено кадрами видеоархива, если для источника события есть «связанные» камеры и но ним есть архив за время фиксации события: по каждой «связанной» камере отправляется не более одного кадра. 
  

  При необходимости записи видеоархива по расписанию или по событиям, создаются задачи на запись. Дополнительная информация представлена в разделе Настройка задач на запись.

• HTTP-запрос
  Для интеграции с «внешними» системами предусмотрена передача HTTP-запроса. Поддерживаются методы GET, POST, PUT, DELETE.
  
  
• Пользовательский скрипт
  Для реализации сложных алгоритмов с анализом входных условий предусмотрена возможность выполнения произвольного Scala-скрипта.
  
  
• Сброс счётчика пропусков
  Платформа НЕЙРОСС за счёт использования плагинов обеспечивает работу дополнительных функций, в частности — сброс счётчика пропусков.

Окно раздела

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

   Цвет иконки	Статус задания	Комментарий
   Зелёный	Активно	Задание успешно прошло проверку при запуске (инициализацию), выполняется. в ходе выполнения ошибок не возникало.
   Оранжевый	Активно, в ходе выполнения возникали ошибки	Задание успешно прошло проверку при запуске (инициализацию), выполняется, в ходе выполнения возникали ошибки. Данные по ошибкам можно просмотреть в системном журнале, либо на вкладке Диагностика. Дана ссылка на описание последней выявленной ошибки.
   Красный	Ошибка инициализации	На этапе первичной проверки (инициализации) задания возникли ошибки: неверно заданы параметры задания. Задание не выполняется.
   Серый	Отключено	Задание не выполняется, остановлено пользователем вручную.

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

2. Общая информация о задании: перечень параметров приведён в таблице ниже:

   Параметр	Значение	Комментарий
   Название	Текстовое поле	Наименование задания; если задано, оно указывается в списке заданий [1].
   Статус	активно (включено) отключено ошибка инициализации	Текущий статус задания, статус отмечается цветом иконке задания в списке [1]. По факту сохранения задания автоматизации выполняется его инициализация. При возникновении ошибок заданию в списке [1] присваивается иконка красного цвета, задание не выполняется, ошибка фиксируется в Системном журнале. Для просмотра текста ошибки предоставляется ссылка.
   Успешно обработанных сигналов	Число успешно обработанных сигналов (выполненных действий)	Ведётся статистика выполнения задания (учёт количества сигналов, приведших к срабатыванию задания автоматизации). Сигнал является успешно обработанным, если действие, заданное в задании, выполнено успешно, не выявлено ошибок. Указывается общее количество успешно обработанных сигналов и время выполнения последнего. Для сброса счётчика нажмите на кнопку Очистить статистику.
   Сигналов, обработанных с ошибкой	Число сигналов, действие по которым не удалось успешно выполнить	Ведётся статистика выполнения задания (учёт количества сигналов, приведших к срабатыванию задания автоматизации). Сигнал является обработанным с ошибкой, если выполнение действия, заданного в задании, привело к возникновению ошибки. Указывается общее количество таких сигналов и время возникновения последней ошибки. Описание всех ошибок можно просмотреть в Системном журнале. Дана ссылка на описание последней найденной ошибки.

3. Параметры сигнала: предустановлено четыре типа сигнала: по расписанию, по событию, по HTTP-запросу, по системному действию (отмеченному записью в Системном журнале);
4. Параметры действия: предустановлено семь типов действий: команда управления, отправка письма на email, отправка отчёта на email, Telegram-уведомление, произвольный скрипт, HTTP-запрос, логирование.
   Выполнить тест: команда запускает задание на выполнение немедленно, вне зависимости от указанного расписания или наличия события; используется для тестирования правильности настройки параметров (не учитывается в статистике выполнения задания). В качестве альтернативы для целей тестирования можно использовать эмуляцию входного http-запроса, при этом количество выполненных заданий увеличивается на единицу.

5. Команды управления заданием:
   

   Команда	Комментарий
   Выключить	Остановить выполнение задания. Сделать задание неактивным.
   Включить	Возобновить выполнение задания. Сделать задание активным. Задание будет выполняться согласно собственному условию запуска. Будет возобновлено ведение статистики задания.
   Сбросить статистику	Обнулить данные в полях Успешно обработанных сигналов, Сигналов, обработанных с ошибкой.

6. Импорт и экспорт параметров задания автоматизации [Импорт и экспорт заданий автоматизации]
7. Диагностика: на вкладке Диагностика вы можете в режиме «живого» журнала отследить результат выполнения всех активных заданий автоматизации.
   

Управление заданиями автоматизации

Чтобы создать задание автоматизации:

1. В списке заданий [1] нажмите на кнопку Добавить новое задание .
   
2. В блоке Общая информация [2] в поле Название укажите наименование нового задания, если требуется. Оно будет отображаться в списке заданий. Если название не задано, то в списке будет отображаться номер задания, заданный тип сигнала и тип действия.

3. В блоке Параметры сигнала [3] выберите из раскрывающегося списка требуемый тип сигнала и задайте дополнительные параметры.

   Тип сигнала	Комментарий
   По расписанию	Если задание требуется выполнять в определённое время или с определённой периодичностью вне зависимости от событий в системе, в поле Тип сигнала выберите По расписанию, настройте расписание запуска задания
   По событию	Если задание требуется выполнять по какому-либо событию от какого-либо источника событий в системе, в поле Тип сигнала выберите По событию и настройте фильтр событий.
   По системному действию	Если задание следует запускать по произвольному событию, регистрируемому в Системном журнале Платформы НЕЙРОСС, в поле Тип сигнала выберите По системному действию и задайте параметры записи.
   Группа сигналов	Если задание следует запускать при накоплении определённого количества событий, либо по причине отсутствия событий, а также при выполнения целой последовательности условий, в поле Тип сигнала выберите Группа сигналов, настройте параметры группы.
   Тип сигнала: по HTTP-запросу	Если задание следует запускать по команде из внешней системы, в поле Тип сигнала выберите По HTTP-запросу, скопируйте предложенную строку и сформируйте http-запрос.

4. В блоке Параметры действия [4] выберите из раскрывающегося списка требуемый тип действия и задайте дополнительные параметры.
   

   Тип действия	Комментарий
   Команда управления	Если по сигналу требуется отправить команды управления элементам, в поле Тип действия выберите Команда управления, настройте список элементов и команд управления.
   Отправка письма на email	Если по сигналу требуется отправить уведомительное письмо по электронной почте, в поле Тип действия выберите Команда управления, настройте список элементов и команд управления.
   Отправка отчёта на email	Если по сигналу требуется отправить команды управления элементам, в поле Тип действия выберите Команда управления, настройте список элементов и команд управления.
   Telegram-уведомление	Если по сигналу требуется отправить команды управления элементам, в поле Тип действия выберите Отправка письма по email, настройте параметры сообщения.
   Пользовательский скрипт	Если по сигналу требуется отправить команды управления элементам, в поле Тип действия выберите Отправка отчёта по email, настройте параметры сообщения и параметры отчёта.
   HTTP-запрос	Если по сигналу требуется отправить команды управления элементам, в поле Тип действия выберите HTTP запрос, укажите параметры запроса.
   Счётчик пропусков	Если по сигналу требуется отправить команды управления элементам, в поле Тип действия выберите Счётчик пропусков, укажите название счётчика.

5. Нажмите на кнопку Создать новое задание.

6. При необходимости проверки действия задания, нажмите выполнить тест.

   ВНИМАНИЕ

   Команда выполнить тест запускает на выполнение действия, заданные в задании. В зависимости от параметров задания, будет произведена попытка выполнения команд управления, либо отправлено письмо/Telegram-уведомление. Если задание создано для запуска по событию и в шаблоне письма/уведомления заданы переменные, относящиеся к источнику события, то в тестовом сообщении данные поля будут пустыми. 

   Команда доступа только для включенных заданий автоматизации.

Чтобы приостановить выполнения задания, нажмите на кнопку Выключить. Для возобновления — нажмите на кнопку Включить.

Чтобы удалить задание, наведите указатель мыши на имя задания в списке заданий [1] и нажмите на кнопку  Удалить задание, расположенную в строке задания.

Чтобы создать новое задание на основе имеющегося, наведите указатель мыши на имя задания в списке заданий [1] и нажмите на кнопку  Копировать задание, расположенную в строке задания. повторите шаги пп.2-6 инструкции выше.

Импорт и экспорт заданий автоматизации

С версии Платформы НЕЙРОСС 20.5.757 реализована возможность передачи заданий автоматизации с одного узла Платформа НЕЙРОСС на другой.

Экспорт

Чтобы выполнить экспорт задания автоматизации, то есть сохранить набор параметров в файле формата JSON:

1. В списке заданий [1] выберите задание, параметры которого требуется сохранить.

2. В карточке задания нажмите на кнопку Экспорт [6]. Будет сформирован файл, содержащий сведения о номере задания и его названии вида:

   задание_автоматизации_№1__ По расписанию → Команда управления.json

   и сохранён в папку загрузок браузера.

3. Сохраните файл на надёжном носителе и, при необходимости, передайте лицу, осуществляющему импорт на другом узле Платформа НЕЙРОСС.

Импорт

Чтобы выполнить импорт задания автоматизации:

1. В списке заданий [1] нажмите на кнопку Добавить новое задание .
2. В карточке задания нажмите на кнопку Импорт [6].
   
3. Укажите путь к сформированному на этапе экспорта файлу формата JSON. Параметры задания будут отображены в карточке задания. 

4. При необходимости, откорректируйте параметры и нажмите на кнопку Создать новое задание.

    Вследствие разницы в конфигурации разных узлов Платформа НЕЙРОСС (отличается список элементов, фильтры) часто бывает необходима корректировка параметров задания автоматизации перед его запуском.