Перейти к содержимому

Изменения документа Тип сигнала: по расписанию

Редактировал(а) Редактор 2026/09/29 21:34
От версии 5.3
отредактировано Редактор
на 2026/09/29 14:48
Изменить комментарий: Auto-saved during real-time collaboration
К версии 15.4
отредактировано Редактор
на 2026/09/29 21:32
Изменить комментарий: Auto-saved during real-time collaboration

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -8,18 +8,25 @@
8 8  
9 9  Расписание позволяет задать точное время или периодичность выполнения задания автоматизации. Для его настройки предусмотрены два взаимосвязанных режима:
10 10  
11 -* Визуальный редактор — формирование распространённых расписаний с помощью списков;
12 -* Текстовый шаблон — ввод произвольного Cron-выражения вручную [].
11 +* [[Визуальный редактор>>doc:||anchor="visual"]] — формирование распространённых расписаний с помощью списков;
12 +* [[Текстовый шаблон>>doc:||anchor="text"]] — ввод произвольного Cron-выражения вручную.
13 13  
14 14  Переключение режимов осуществляется посредством соответствующих вкладок. Под редактором отображается сформированное расписание в удобном для чтения виде, например: «В 12:00».
15 15  
16 16  Для настройки расписания вы можете воспользоваться [[Cron-форматом записи>>url:https://ru.wikipedia.org/wiki/Cron||shape="rect"]]. В этом формате предусмотрено пять позиций: для установки минут, часов, дней месяца, месяцев, и дней недели. Позиции разделяются пробелом.
17 17  
18 -== Визуальный редактор ==
18 +== {{id name="visual"/}}Визуальный редактор ==
19 19  
20 +(% class="box infomessage" %)
21 +(((
22 +Визуальный редактор доступен с версии 20.57 Платформы НЕЙРОСС.
23 +)))
24 +
25 +[[image:cron_visual1.png]]
26 +
20 20  Визуальный редактор позволяет настроить расписание без ручного составления Cron-выражения.
21 21  
22 -В первом поле выберите периодичность выполнения:
29 +На первом шаге выберите периодичность выполнения:
23 23  
24 24  * год;
25 25  * месяц;
... ... @@ -30,20 +30,24 @@
30 30  
31 31  Состав остальных полей зависит от выбранной периодичности. Можно указать месяц, день месяца, день недели, часы и минуты выполнения.
32 32  
33 -Например, чтобы выполнять задание ежедневно в 12:00:
40 +Например, чтобы выполнять задание ежедневно в 08:05:
34 34  
35 -1. В поле Каждый выберите значение день.
36 -1. В поле часов укажите 12.
37 -1. В поле минут укажите 00.
42 +1. В поле **Каждый **выберите значение **день**.
43 +1. В поле **часов **укажите 08.
44 +1. В поле **минут **укажите 05.
38 38  
46 +[[image:cron_visual2.png]]
47 +
39 39  В результате будет сформировано выражение:
40 40  
41 -{{{0 12 * * *}}}
50 +{{{5 8 * * *}}}
42 42  
43 43  И его текстовое описание:
44 44  
45 -{{{В 12:00}}}
54 +{{{В 08:05}}}
46 46  
56 +Если задание нужно выполнять каждый час, выберите **каждый час** и задайте минуты.
57 +
47 47  Чтобы выполнять задание в определённые дни недели, выберите периодичность неделя, затем укажите один или несколько дней недели и время запуска.
48 48  
49 49  Для ежегодного запуска можно последовательно выбрать:
... ... @@ -53,40 +53,128 @@
53 53  * при необходимости — день недели;
54 54  * время выполнения.
55 55  
56 ->Визуальный редактор предназначен для наиболее распространённых вариантов расписания. Для использования специальных конструкций L, LW, W, # и сложных комбинаций перейдите на вкладку Текстовый шаблон.
67 +{{info}}
68 +Визуальный редактор предназначен для наиболее распространённых вариантов расписания. Для использования специальных конструкций ##L, LW, W, ### и сложных комбинаций перейдите на вкладку [[Текстовый шаблон>>doc:||anchor="text"]].
69 +{{/info}}
57 57  
58 -Рекомендуемое размещение изображений:
71 +== {{id name="text"/}}Текстовый шаблон ==
59 59  
60 -1. После первого абзаца — общий вид визуального редактора.
61 -1. После перечня периодичностей — раскрытый список «год / месяц / неделя / день / час / минута».
62 -1. После описания недельного запуска — выбор дня недели.
73 +Текстовый редактор позволяет ввести произвольное Cron-расписание. Выражение состоит из пяти позиций, разделённых пробелами:
63 63  
75 +{{code language="none"}}
76 +минута час день_месяца месяц день_недели
77 +{{/code}}
78 +
79 +Допустимые диапазоны:
80 +
81 +1. минута — 0–59;
82 +1. час — 0–23;
83 +1. день месяца — 1–31;
84 +1. месяц — 1–12;
85 +1. день недели — 1–7, где 1 — воскресенье, 2 — понедельник, 3 — вторник, 4 — среда, 5 — четверг, 6 — пятница, 7 — суббота.
86 +
87 +Секунда выполнения в диапазоне от 0 до 59 выбирается системой случайным образом.
88 +
89 +Под полем ввода отображается текстовое описание введённого расписания. Это позволяет проверить выражение перед сохранением задания.
90 +
64 64  В каждой из позиций может быть задано: 
65 65  
66 -* число или список чисел, разделённых запятыми — фиксированное значение; диапазон допустимых значений: минута (0—59), час (0—23), день месяца (1—31), месяц (1—12), день недели (1—7, 1 — воскресение);
93 +* символ * — произвольное значение (каждую минуту, каждый день и проч.);
94 +* фиксированное значение — число;
95 +* несколько значений — список чисел, разделённых запятыми;
96 +* диапазон диапазон допустимых значений: минута (0—59), час (0—23), день месяца (1—31), месяц (1—12), день недели (1—7, 1 — воскресенье);
67 67  * два числа, разделённых дефисом, для указания интервал значений с..по;
68 -* символ ##*## — произвольное значение (каждую минуту, каждый день и проч.);
69 -* два числа, разделенных символом косая черта ##М/N## — шаг выполнения: выполнять через каждые N часов / минут начиная с M .
70 70  
71 -Примеры возможных расписаний (в качестве разделителей используются пробелы):
99 +Помимо фиксированных значений, в каждой позиции можно использовать следующие конструкции:
72 72  
101 +* M/N — выполнение с шагом N, начиная со значения M,
102 +* L — последний день месяца;
103 +* L-n — за n дней до последнего дня месяца;
104 +* nL — последний указанный день недели месяца;
105 +* LW — последний будний день месяца;
106 +* W — ближайший будний день к указанной дате, например 15W;
107 +* # — определённый по счёту день недели месяца, например 5#3 — третий четверг.
108 +
109 +Символы L, LW, W и #, а также шаги вида M/N, доступны только в текстовом редакторе.
110 +
111 +{{warning}}
112 +Нельзя одновременно указывать конкретный день месяца и конкретный день недели. Одно из этих полей должно содержать *.
113 +{{/warning}}
114 +
115 +== Как читать и составлять Cron-расписание ==
116 +
117 +**Порядок полей**
118 +
119 +Запись читается слева направо: сначала //когда в течение часа// (минута), затем //в какой час//, затем //какой день месяца//, //какой месяц//, //какой день недели//. Платформа проверяет все пять условий одновременно: срабатывание возможно только если текущие дата и время подходят **каждой** позиции выражения.
120 +
121 +**Символ ##*##**
122 +
123 +Означает «без ограничения по этому полю». Например, в выражении ниже звёздочки в полях дня, месяца и дня недели означают «каждый календарный день», а ##0## и ##12## фиксируют минуту и час:
124 +
125 +{{code language="none"}}
126 +0 12 * * *
127 +{{/code}}
128 +
129 +**Списки и диапазоны**
130 +
131 +* ##9,18## в поле часа — запуск в 09:00 и 18:00;
132 +* ##2-6## в поле дня недели — с понедельника по пятницу (2 — понедельник, 6 — пятница);
133 +* ##1,7## — воскресенье и суббота.
134 +
135 +**Шаг ##M/N## или ##*/N##**
136 +
137 +* ##*/30## в минутах — каждые 30 минут (0, 30);
138 +* ##5/15## — каждые 15 минут, **начиная с 5-й** (5, 20, 35, 50);
139 +* ##8-18/2## в часах — каждые 2 часа в интервале с 8 до 18 включительно (8, 10, 12, …).
140 +
141 +**День месяца и день недели**
142 +
143 +Если нужно «каждый понедельник», задайте день недели (например, ##2##) и поставьте %%*%% в поле **день месяца**. Если нужно «15-е число каждого месяца», укажите %%15%% в дне месяца и %%*%% в дне недели. Одновременно задавать и конкретное число месяца, и конкретный день недели нельзя — одно из полей должно быть %%*%%.
144 +
145 +**Практический порядок настройки**
146 +
147 +1. Определите **время**: минута и час (точное или с шагом).
148 +1. Решите, **как часто по календарю**: каждый день ~(%%* *%%), определённые месяцы, число месяца или дни недели.
149 +1. Для редких случаев (последний день месяца, последний будний день, N-й четверг) используйте вкладку **Текстовый шаблон** и символы L, LW, W, #.
150 +1. Сохраните задание только после проверки **текстового описания** под полем ввода.
151 +
152 +{{info}}
153 +Секунда запуска в выражении не задаётся: система выбирает её случайно от 0 до 59, чтобы разнести нагрузку при массовом запуске заданий в одну и ту же минуту.
154 +{{/info}}
155 +
156 +== Примеры расписаний ==
157 +
73 73  * ##* * * * * ## — каждую минуту,
159 +* 0 * * * * — в начале каждого часа,
74 74  * ##0 12 * 1,2 *## — каждый день в 12 часов дня в январе и феврале,
161 +* ##0 0 1 1 *## — 1 января в 00:00,
162 +* ##0 0 L * *## — в 00:00 последнего дня месяца,
163 +* ##0 0 L-5 * *## — в 00:00 за пять дней до последнего дня месяца,
164 +* ##*/30 * * * * — ##каждые 30 минут,
75 75  * ##*/30 * * * 2-6## — каждые 30 минут по будням,
166 +* ##5/15 * * * *## — каждые 15 минут, начиная с 5-й минуты часа.
167 +* ##0 12 * * *## — каждый день в 12:00,
168 +* ##0 0-5 * * *## — в начале часов 0,1,2,3,4 и 5 (шесть раз за ночь),
169 +* ##0 9 * * 2## — каждый понедельник в 09:00,
170 +* ##0 9,18 * * *## — каждый день в 09:00 и 18:00,
76 76  * ##0 8-18/2 * * 2-6## — каждые 2 часа с 08:00 по 18:59 по будням,
77 -* ##0 0 L * *## — в 00:00 последнего дня месяца,
78 -* ##0 0 L-5 * * ## — в 00:00 за 5 дней до последнего дня месяца,
79 -* ##0 0 LW * *## — в 00:00 последнего буднего дня месяца ##30 17 LW * *## — в 17:30 последнего буднего дня месяца).
172 +* ##0 10 * * 1,7## — по выходным в 10:00,
173 +* ##0 0 1 * *## — в 00:00 первого числа каждого месяца,
174 +* ##0 9 15 * *## — в 09:00 пятнадцатого числа каждого месяца.
175 +* ##0 0 LW * *## — в 00:00 последнего буднего дня месяца,
176 +* ##30 17 LW * *## — в 17:30 последнего буднего дня месяца,
80 80  * ##0 0 * * 5#3## — в 00:00 в третий четверг месяца,
81 81  * ##0-59/2 * * * *## — по чётным минутам,
82 82  * ##5 21 * * *## — ежедневно в 21:05,
83 -* ##0 20 * * 5## — в 20:00, только по пятницам,
84 -* ##59 23 * 4-6 *## — В 23:59 ежедневно во втором квартале.
180 +* ##0 20 * * 6## — в 20:00, только по пятницам,
181 +* ##0 20 * * 6L ##— в 20:00, в последнюю пятницу вечера,
182 +* ##59 23 * 4-6 *## — В 23:59 ежедневно во втором квартале,
183 +* ##0 0 15W * *## — в ближайший будний день к 15-му числу.
85 85  
86 86  {{info}}
87 -Поле **Расписание** имеет подсказку, которая отображается при наведении на иконку [[image:attach:ui.node.WebHome@fa-info.png||thumbnail="true" height="21"]]. Вы можете выбрать одно из типовых расписаний и впоследствии отредактировать. Для этого достаточно щёлкнуть в строке левой клавишей мыши.
186 +Вы можете выбрать одно из типовых расписаний из примеров и впоследствии отредактировать. Для этого нажмите на кнопку **Применить**.
88 88  
89 -[[image:attach:cron.png||height="112"]]
188 +[[image:cron_examples.png]]
90 90  {{/info}}
91 91  
92 92  == {{id name="Типсигнала:порасписанию-Порядокдействий"/}}Порядок действий ==
... ... @@ -97,10 +97,17 @@
97 97  
98 98  В списке заданий нажмите на кнопку **Добавить новое задание** [[image:attach:ui.node.ui-automation.WebHome@btn_plus_new.png||thumbnail="true" height="22"]].
99 99  
100 -В блоке **Параметры сигнала** [3] в поле **Тип сигнала** выберите из раскрывающегося списка **По расписанию**, настройте расписание запуска задания. На примере ниже настроено расписание на ежедневный запуск в 9 часов вечера.
199 +В блоке **Параметры сигнала** [3] в поле **Тип сигнала** выберите из раскрывающегося списка **По расписанию**.
101 101  
102 -[[image:attach:params_shedule.png||height="184"]]
201 +Откройте вкладку [[Визуальный редактор>>doc:||anchor="visual"]] или [[Текстовый шаблон>>doc:||anchor="text"]].
103 103  
203 +Настройте периодичность и время запуска задания.
204 +
205 +Проверьте текстовое описание сформированного задания. На примере ниже настроено расписание на ежедневный запуск в 9 часов вечера.
206 +
207 +[[image:cron_text.png]]
208 +
209 +
104 104  Настройте параметры действия ~[[[Действия автоматизации>>doc:ui.node.ui-automation.ui-automation-actions.WebHome]]].
105 105  
106 106  Сохраните изменения.
params_shedule.png
Автор
... ... @@ -1,1 +1,0 @@
1 -XWiki.pugachevskaya_elena
Размер
... ... @@ -1,1 +1,0 @@
1 -8.3 KB
Содержимое
cron_examples.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +4.0 KB
Содержимое
cron_text.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +8.9 KB
Содержимое
cron_visual1.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +19.8 KB
Содержимое
cron_visual2.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +8.8 KB
Содержимое

Интерфейс НЕЙРОСС