Skip to Content

Wiki source code of Автоматизация

Version 2.1 by admin on 2026/06/07 08:06
Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 (% style="color: rgb(23,43,77);" %)Данный раздел предназначен для настройки заданий автоматизации и доступен только для узлов [[Платформа НЕЙРОСС>>neyross.WebHome]].
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
24 Выполнение задач автоматизации осуществляется от имени пользователя НЕЙРОСС. Предварительно настройте учётную запись пользователя, задайте требуемые права на управление и укажите учётную запись в качестве пользователя автоматизации ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка заданий автоматизации.WebHome]]].
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 language="java"}}
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}}