Skip to Content

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

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