Wiki source code of Автоматизация
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
4.1 | 1 | Данный раздел предназначен для настройки заданий автоматизации и доступен только для узлов [[Платформа НЕЙРОСС>>neyross.WebHome]]. |
| |
1.1 | 2 | |
| 3 | {{info}} | ||
| 4 | **Переход к функционалу**: | ||
| 5 | |||
| 6 | * С версии 20.40 ~[[[doc:ui.Рабочий стол НЕЙРОСС.Изменения интерфейса НЕЙРОСС.WebHome]]]: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > [[doc:ui.Параметры узла.WebHome]] > Автоматизация. | ||
| 7 | * До версии 20.39 включительно: [[doc:ui.Рабочий стол НЕЙРОСС.WebHome]] > Конфигурация узлов > Автоматизация. | ||
| 8 | {{/info}} | ||
| 9 | |||
| 10 | == {{id name="Автоматизация-Общиесведения"/}}Общие сведения == | ||
| 11 | |||
| 12 | Платформа НЕЙРОСС обеспечивает автоматическое выполнение заданий автоматизации по факту возникновения какого-либо внутреннего или внешнего события или по фиксированному расписанию. Это может быть информирование ответственных лиц (по электронной почте или в канал Telegram), автоматические действия в системе (в том числе, — взаимодействие с «внешней» системой). Возможны сложные условия запуска задания автоматизации (выполнение нескольких условий, накопление определённого количества сигналов, либо наоборот — отсутствие сигналов). Предусмотрена возможность тестирования выполнения задания без ожидания выполнения входного условия. | ||
| 13 | |||
| 14 | {{info}} | ||
| 15 | **Задание автоматизации** — это совокупность действия с сигналом, по которому это действие может выполняться. Есть набор предустановленных типов сигналов и типов действий. Задание автоматизации может быть сформировано по любому сигналу или набору сигналов — событию в Платформе НЕЙРОСС или событию сети НЕЙРОСС, которое проходит [[входной фильтр событий.>>doc:ui.Параметры узла.Дополнительные настройки.WebHome||anchor="Дополнительныенастройки-Входнойфильтрсобытий"]] | ||
| 16 | {{/info}} | ||
| 17 | |||
| 18 | {{error}} | ||
| 19 | **ВАЖНО** | ||
| 20 | |||
| |
1.2 | 21 | Выполнение задач автоматизации осуществляется от имени пользователя НЕЙРОСС. Предварительно настройте учётную запись пользователя, задайте требуемые права на управление и укажите учётную запись в качестве пользователя автоматизации ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка заданий автоматизации.WebHome]]]. |
| |
1.1 | 22 | {{/error}} |
| 23 | |||
| 24 | [[image:attach:ui.Параметры узла.WebHome@content.png||thumbnail="true" height="10"]] Содержание: | ||
| 25 | |||
| 26 | {{toc depth="3"/}} | ||
| 27 | |||
| 28 | {{excerpt-include nopanel="true" 0="ui.Параметры узла.Автоматизация.Сигналы автоматизации.WebHome"/}} | ||
| 29 | |||
| 30 | {{excerpt-include nopanel="true" 0="ui.Параметры узла.Автоматизация.Действия автоматизации.WebHome"/}} | ||
| 31 | |||
| 32 | == {{id name="Автоматизация-Окнораздела"/}}Окно раздела == | ||
| 33 | |||
| 34 | [[image:attach:s_automat_conf_wnd.png||width="900"]] | ||
| 35 | |||
| 36 | 1. ((( | ||
| 37 | **Список заданий**: перечень имеющихся заданий; если наименование задания не задано, после номера задания через вертикальную черту указывается тип сигнала и тип действия. Иконка задания отображает его статус. Список статусов см. в таблице ниже. | ||
| 38 | |||
| 39 | |=((( | ||
| 40 | Цвет иконки | ||
| 41 | )))|=((( | ||
| 42 | Статус задания | ||
| 43 | )))|=((( | ||
| 44 | Комментарий | ||
| 45 | ))) | ||
| 46 | |(% class="highlight-green" title="Цвет фона: Зеленый" style="background-color: #e3fcef" %)((( | ||
| |
4.1 | 47 | Зелёный |
| |
1.1 | 48 | )))|((( |
| 49 | Активно | ||
| 50 | )))|((( | ||
| 51 | Задание успешно прошло проверку при запуске (инициализацию), выполняется. в ходе выполнения ошибок не возникало. | ||
| 52 | ))) | ||
| 53 | |(% class="highlight-yellow" title="Цвет фона: Желтый" style="background-color: #fffae6" %)((( | ||
| |
4.1 | 54 | Оранжевый |
| |
1.1 | 55 | )))|((( |
| |
4.1 | 56 | Активно, в ходе выполнения возникали ошибки |
| |
1.1 | 57 | )))|((( |
| 58 | Задание успешно прошло проверку при запуске (инициализацию), выполняется, в ходе выполнения возникали ошибки. Данные по ошибкам можно просмотреть в системном журнале, либо на вкладке Диагностика. Дана ссылка на описание последней выявленной ошибки. | ||
| 59 | ))) | ||
| 60 | |(% class="highlight-red" title="Цвет фона: Красный" style="background-color: #ffebe6" %)((( | ||
| |
4.1 | 61 | Красный |
| |
1.1 | 62 | )))|((( |
| 63 | Ошибка инициализации | ||
| 64 | )))|((( | ||
| 65 | На этапе первичной проверки (инициализации) задания возникли ошибки: неверно заданы параметры задания. Задание не выполняется. | ||
| 66 | ))) | ||
| 67 | |(% class="highlight-grey" title="Цвет фона: Серый" style="background-color: #f4f5f7" %)((( | ||
| |
4.1 | 68 | Серый |
| |
1.1 | 69 | )))|((( |
| 70 | Отключено | ||
| 71 | )))|((( | ||
| 72 | Задание не выполняется, остановлено пользователем вручную. | ||
| 73 | ))) | ||
| 74 | |||
| 75 | **Команды управления списком заданий**: Добавить задание [[image:attach:btn_plus_new.png||thumbnail="true" width="18"]], Поиск по списку заданий[[image:attach:fa-search.png||thumbnail="true" width="18"]], удалить задание [[image:attach:btn_del_new.png||thumbnail="true" height="15"]], копировать задание[[image:confluenceAttach:page:neyross.Уровни доступа@fa-copy.png||thumbnail="true" height="21"]] для возможности создания нового на основе старого. | ||
| 76 | ))) | ||
| 77 | 1. ((( | ||
| 78 | **Общая информация о задании**: перечень параметров приведён в таблице ниже: | ||
| 79 | |||
| 80 | |=((( | ||
| 81 | Параметр | ||
| 82 | )))|=((( | ||
| 83 | Значение | ||
| 84 | )))|=((( | ||
| 85 | Комментарий | ||
| 86 | ))) | ||
| 87 | |((( | ||
| 88 | Название | ||
| 89 | )))|((( | ||
| 90 | Текстовое поле | ||
| 91 | )))|((( | ||
| 92 | Наименование задания; если задано, оно указывается в списке заданий [1]. | ||
| 93 | ))) | ||
| 94 | |((( | ||
| 95 | Статус | ||
| 96 | )))|((( | ||
| 97 | * активно (включено) | ||
| 98 | * отключено | ||
| 99 | * ошибка инициализации | ||
| 100 | )))|((( | ||
| 101 | (% class="content-wrapper" %) | ||
| 102 | ((( | ||
| 103 | Текущий статус задания, статус отмечается цветом иконке задания в списке [1]. По факту сохранения задания автоматизации выполняется его инициализация. При возникновении ошибок заданию в списке [1] присваивается иконка красного цвета, задание не выполняется, ошибка фиксируется в Системном журнале. Для просмотра текста ошибки предоставляется ссылка. | ||
| 104 | |||
| 105 | [[image:attach:task_error.png||width="600"]] | ||
| 106 | |||
| 107 | [[image:attach:task_error_journal.png||width="800"]] | ||
| 108 | ))) | ||
| 109 | ))) | ||
| 110 | |((( | ||
| 111 | Успешно обработанных сигналов | ||
| 112 | )))|((( | ||
| 113 | Число успешно обработанных сигналов (выполненных действий) | ||
| 114 | )))|((( | ||
| 115 | Ведётся статистика выполнения задания (учёт количества сигналов, приведших к срабатыванию задания автоматизации). Сигнал является успешно обработанным, если действие, заданное в задании, выполнено успешно, не выявлено ошибок. Указывается общее количество успешно обработанных сигналов и время выполнения последнего. Для сброса счётчика нажмите на кнопку **Очистить статистику**. | ||
| 116 | ))) | ||
| 117 | |((( | ||
| 118 | Сигналов, обработанных с ошибкой | ||
| 119 | )))|((( | ||
| 120 | Число сигналов, действие по которым не удалось успешно выполнить | ||
| 121 | )))|((( | ||
| 122 | (% class="content-wrapper" %) | ||
| 123 | ((( | ||
| 124 | Ведётся статистика выполнения задания (учёт количества сигналов, приведших к срабатыванию задания автоматизации). Сигнал является обработанным с ошибкой, если выполнение действия, заданного в задании, привело к возникновению ошибки. Указывается общее количество таких сигналов и время возникновения последней ошибки. Описание всех ошибок можно просмотреть в Системном журнале. Дана ссылка на описание последней найденной ошибки. | ||
| 125 | [[image:attach:task_stat.png||width="600"]] | ||
| 126 | [[image:attach:action_journal.png||width="800"]] | ||
| 127 | ))) | ||
| 128 | ))) | ||
| 129 | ))) | ||
| 130 | 1. **Параметры сигнала**: предустановлено четыре типа сигнала: по расписанию, по событию, по HTTP-запросу, по системному действию (отмеченному записью в Системном журнале); | ||
| 131 | 1. **Параметры действия**: предустановлено семь типов действий: команда управления, отправка письма на email, отправка отчёта на email, Telegram-уведомление, произвольный скрипт, HTTP-запрос, логирование. | ||
| 132 | **Выполнить тест**: команда запускает задание на выполнение немедленно, вне зависимости от указанного расписания или наличия события; используется для тестирования правильности настройки параметров (не учитывается в статистике выполнения задания). В качестве альтернативы для целей тестирования можно использовать эмуляцию входного http-запроса, при этом количество выполненных заданий увеличивается на единицу. | ||
| 133 | 1. ((( | ||
| 134 | **Команды управления заданием: | ||
| 135 | ** | ||
| 136 | |||
| 137 | |=((( | ||
| 138 | Команда | ||
| 139 | )))|=((( | ||
| 140 | Комментарий | ||
| 141 | ))) | ||
| 142 | |((( | ||
| 143 | Выключить | ||
| 144 | )))|((( | ||
| 145 | Остановить выполнение задания. Сделать задание неактивным. | ||
| 146 | ))) | ||
| 147 | |((( | ||
| 148 | Включить | ||
| 149 | )))|((( | ||
| 150 | Возобновить выполнение задания. Сделать задание активным. Задание будет выполняться согласно собственному условию запуска. Будет возобновлено ведение статистики задания. | ||
| 151 | ))) | ||
| 152 | |((( | ||
| 153 | Сбросить статистику | ||
| 154 | )))|((( | ||
| 155 | Обнулить данные в полях //Успешно обработанных сигналов//, //Сигналов, обработанных с ошибкой//. | ||
| 156 | ))) | ||
| 157 | ))) | ||
| 158 | 1. **Импорт и экспорт **параметров задания автоматизации ~[[[#Импорт и экспорт заданий автоматизации>>doc:||anchor="Автоматизация-Импортиэкспортзаданийавтоматизации"]]] | ||
| 159 | 1. **Диагностика**: на вкладке //Диагностика// вы можете в режиме «живого» журнала отследить результат выполнения всех активных заданий автоматизации. | ||
| 160 | [[image:attach:action_diagnosys.png||width="700"]] | ||
| 161 | |||
| 162 | == {{id name="Автоматизация-Управлениезаданиямиавтоматизации"/}}Управление заданиями автоматизации == | ||
| 163 | |||
| 164 | Чтобы //**создать** //задание автоматизации: | ||
| 165 | |||
| 166 | 1. В списке заданий [1] нажмите на кнопку **Добавить новое задание** [[image:attach:btn_plus_new.png||thumbnail="true" width="18"]]. | ||
| 167 | [[image:attach:action_newtask.png]] | ||
| 168 | 1. В блоке **Общая информация** [2] в поле **Название** укажите наименование нового задания, если требуется. Оно будет отображаться в списке заданий. Если название не задано, то в списке будет отображаться номер задания, заданный тип сигнала и тип действия. | ||
| 169 | 1. ((( | ||
| 170 | В блоке **Параметры сигнала** [3] выберите из раскрывающегося списка требуемый тип сигнала и задайте дополнительные параметры. | ||
| 171 | |||
| 172 | |=((( | ||
| 173 | Тип сигнала | ||
| 174 | )))|=((( | ||
| 175 | Комментарий | ||
| 176 | ))) | ||
| 177 | |((( | ||
| 178 | [[По расписанию>>doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.Тип сигнала\: по расписанию.WebHome]] | ||
| 179 | )))|((( | ||
| 180 | Если задание требуется выполнять в определённое время или с определённой периодичностью вне зависимости от событий в системе, в поле **Тип сигнала** выберите **По расписанию**, настройте расписание запуска задания | ||
| 181 | ))) | ||
| 182 | |((( | ||
| 183 | [[По событию>>doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.Тип сигнала\: по событию.WebHome]] | ||
| 184 | )))|((( | ||
| 185 | Если задание требуется выполнять по какому-либо событию от какого-либо источника событий в системе, в поле **Тип сигнала** выберите **По событию** и настройте фильтр событий. | ||
| 186 | ))) | ||
| 187 | |((( | ||
| 188 | [[По системному действию>>doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.Тип сигнала\: по сообщению системного журнала.WebHome]] | ||
| 189 | )))|((( | ||
| 190 | Если задание следует запускать по произвольному событию, регистрируемому в Системном журнале Платформы НЕЙРОСС, в поле **Тип сигнала** выберите **По системному действию** и задайте параметры записи. | ||
| 191 | ))) | ||
| 192 | |((( | ||
| 193 | [[Группа сигналов>>doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.Тип сигнала\: группа сигналов.WebHome]] | ||
| 194 | )))|((( | ||
| 195 | Если задание следует запускать при накоплении определённого количества событий, либо по причине отсутствия событий, а также при выполнения целой последовательности условий, в поле **Тип сигнала** выберите **Группа сигналов**, настройте параметры группы. | ||
| 196 | ))) | ||
| 197 | |((( | ||
| 198 | [[doc:ui.Параметры узла.Автоматизация.Сигналы автоматизации.Тип сигнала\: по HTTP-запросу.WebHome]] | ||
| 199 | )))|((( | ||
| 200 | Если задание следует запускать по команде из внешней системы, в поле **Тип сигнала** выберите **По HTTP-запросу**, скопируйте предложенную строку и сформируйте http-запрос. | ||
| 201 | ))) | ||
| 202 | ))) | ||
| 203 | 1. ((( | ||
| |
4.1 | 204 | В блоке **Параметры действия** [4] выберите из раскрывающегося списка требуемый тип действия и задайте дополнительные параметры.\\ |
| |
1.1 | 205 | |
| 206 | |=((( | ||
| 207 | Тип действия | ||
| 208 | )))|=((( | ||
| 209 | Комментарий | ||
| 210 | ))) | ||
| 211 | |((( | ||
| 212 | [[Команда управления>>doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: команда управления.WebHome]] | ||
| 213 | )))|((( | ||
| 214 | Если по сигналу требуется отправить команды управления элементам, в поле **Тип действия** выберите **Команда управления**, настройте список элементов и команд управления. | ||
| 215 | ))) | ||
| 216 | |((( | ||
| 217 | [[Отправка письма на email>>doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: отправка письма по email.WebHome]] | ||
| 218 | )))|((( | ||
| 219 | Если по сигналу требуется отправить уведомительное письмо по электронной почте, в поле **Тип действия** выберите **Команда управления**, настройте список элементов и команд управления. | ||
| 220 | ))) | ||
| 221 | |((( | ||
| 222 | [[Отправка отчёта на email>>doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: отправка отчёта по email.WebHome]] | ||
| 223 | )))|((( | ||
| 224 | Если по сигналу требуется отправить команды управления элементам, в поле **Тип действия** выберите **Команда управления**, настройте список элементов и команд управления. | ||
| 225 | ))) | ||
| 226 | |((( | ||
| 227 | [[Telegram-уведомление>>doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: Telegram-уведомление.WebHome]] | ||
| 228 | )))|((( | ||
| 229 | Если по сигналу требуется отправить команды управления элементам, в поле **Тип действия** выберите **Отправка письма по email**, настройте параметры сообщения. | ||
| 230 | ))) | ||
| 231 | |((( | ||
| 232 | [[Пользовательский скрипт>>doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: пользовательский скрипт.WebHome]] | ||
| 233 | )))|((( | ||
| 234 | Если по сигналу требуется отправить команды управления элементам, в поле **Тип действия** выберите **Отправка отчёта по email**, настройте параметры сообщения и параметры отчёта. | ||
| 235 | ))) | ||
| 236 | |((( | ||
| 237 | [[HTTP-запрос>>doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: HTTP-запрос.WebHome]] | ||
| 238 | )))|((( | ||
| 239 | Если по сигналу требуется отправить команды управления элементам, в поле **Тип действия** выберите **HTTP запрос**, укажите параметры запроса. | ||
| 240 | ))) | ||
| 241 | |((( | ||
| 242 | [[Счётчик пропусков>>doc:ui.Параметры узла.Автоматизация.Действия автоматизации.Тип действия\: счётчик пропусков.WebHome]] | ||
| 243 | )))|((( | ||
| 244 | Если по сигналу требуется отправить команды управления элементам, в поле **Тип действия** выберите **Счётчик пропусков**, укажите название счётчика. | ||
| 245 | ))) | ||
| 246 | ))) | ||
| 247 | 1. Нажмите на кнопку **Создать новое задание**. | ||
| 248 | 1. ((( | ||
| 249 | При необходимости проверки действия задания, нажмите **выполнить тест**. | ||
| 250 | |||
| 251 | {{error}} | ||
| 252 | **ВНИМАНИЕ** | ||
| 253 | |||
| 254 | Команда **выполнить тест** запускает на выполнение действия, заданные в задании. В зависимости от параметров задания, будет произведена попытка выполнения команд управления, либо отправлено письмо/Telegram-уведомление. Если задание создано для запуска по событию и в шаблоне письма/уведомления заданы переменные, относящиеся к источнику события, то в тестовом сообщении данные поля будут пустыми. | ||
| 255 | |||
| 256 | Команда доступа только для включенных заданий автоматизации. | ||
| 257 | {{/error}} | ||
| 258 | ))) | ||
| 259 | |||
| 260 | Чтобы **//приостановить//** выполнения задания, нажмите на кнопку **Выключить**. Для возобновления — нажмите на кнопку **Включить**. | ||
| 261 | |||
| 262 | Чтобы //**удалить задание**//, наведите указатель мыши на имя задания в списке заданий [1] и нажмите на кнопку [[image:attach:btn_del_new.png||thumbnail="true" height="15"]]** Удалить задание**, расположенную в строке задания. | ||
| 263 | |||
| 264 | Чтобы **//создать новое задание на основе имеющегося//**, наведите указатель мыши на имя задания в списке заданий [1] и нажмите на кнопку [[image:confluenceAttach:page:neyross.Уровни управления@fa-copy.png||thumbnail="true" width="18"]]** Копировать задание**, расположенную в строке задания. повторите шаги пп.2-6 инструкции выше. | ||
| 265 | |||
| |
4.1 | 266 | == {{id name="Автоматизация-Импортиэкспортзаданийавтоматизации"/}}Импорт и экспорт заданий автоматизации(%%) == |
| |
1.1 | 267 | |
| 268 | С версии Платформы НЕЙРОСС 20.5.757 реализована возможность передачи заданий автоматизации с одного узла Платформа НЕЙРОСС на другой. | ||
| 269 | |||
| 270 | **Экспорт** | ||
| 271 | |||
| 272 | Чтобы выполнить экспорт задания автоматизации, то есть сохранить набор параметров в файле формата JSON: | ||
| 273 | |||
| 274 | 1. В списке заданий [1] выберите задание, параметры которого требуется сохранить. | ||
| 275 | 1. ((( | ||
| 276 | В карточке задания нажмите на кнопку **Экспорт **[6]. Будет сформирован файл, содержащий сведения о номере задания и его названии вида: | ||
| 277 | |||
| |
2.1 | 278 | {{code language="java"}} |
| |
1.1 | 279 | задание_автоматизации_№1__ По расписанию → Команда управления.json |
| 280 | {{/code}} | ||
| 281 | |||
| 282 | и сохранён в папку загрузок браузера. | ||
| 283 | ))) | ||
| 284 | 1. Сохраните файл на надёжном носителе и, при необходимости, передайте лицу, осуществляющему импорт на другом узле Платформа НЕЙРОСС. | ||
| 285 | |||
| 286 | \\ | ||
| 287 | |||
| 288 | **Импорт** | ||
| 289 | |||
| 290 | Чтобы выполнить импорт задания автоматизации: | ||
| 291 | |||
| 292 | 1. В списке заданий [1] нажмите на кнопку **Добавить новое задание** [[image:attach:btn_plus_new.png||thumbnail="true" width="18"]]. | ||
| 293 | 1. В карточке задания нажмите на кнопку **Импорт** [6]. | ||
| 294 | [[image:attach:action_newtask.png]] | ||
| 295 | 1. Укажите путь к сформированному на этапе экспорта файлу формата JSON. Параметры задания будут отображены в карточке задания. | ||
| 296 | 1. ((( | ||
| 297 | При необходимости, откорректируйте параметры и нажмите на кнопку **Создать новое задание**. | ||
| 298 | |||
| 299 | {{info}} | ||
| 300 | Вследствие разницы в конфигурации разных узлов Платформа НЕЙРОСС (отличается список элементов, фильтры) часто бывает необходима корректировка параметров задания автоматизации перед его запуском. | ||
| 301 | {{/info}} | ||
| 302 | ))) |