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