Skip to Content
Version 5.1 by admin on 2026/06/07 18:49
Show last authors
1 Контроллер БОРЕЙ совместно с Платформой НЕЙРОСС позволяют указывать перечень выходных и праздничных дней и ограничивать либо разрешать доступ в такие дни.
2
3 == {{id name="Доступввыходныеипраздничныедни-Общиесведения"/}}Общие сведения ==
4
5 При наличии лицензии на графики работы, управление доступом в выходные и праздничные дни обеспечивается посредством функционала [[neyross.АРМ НЕЙРОСС Доступ.Графики работы.Специальные дни.WebHome]].
6
7 {{info}}
8 [[neyross.АРМ НЕЙРОСС Доступ.Графики работы.График работы.WebHome]] строится на основе шаблонов графиков и назначения индивидуальных правил: дней нетрудоспособности, отпуска и дополнительных выходных (отгулов), неполного рабочего дня и прочих данных. При этом учитываются специальные дни: государственные праздники, предпраздничные дни, корпоративные праздники и любые другие дни, график работы в которые зависит от календарной даты. Доступ сотрудника на предприятие осуществляется строго в соответствии с его индивидуальным графиком и только к точкам доступа, заданных Маршрутом.
9 {{/info}}
10
11 При отсутствии необходимости в полновесном функционале графиков работы, доступ в выходные дни ограничивается уровнем доступа (или режимом доступа как совокупности уровней доступа), которые позволяют задать набор временных интервалов доступа в зависимости от дня недели, например, — ограничить доступ в субботу и воскресенье ~[[[neyross.АРМ НЕЙРОСС Доступ.Уровни доступа.WebHome]]]. Однако уровни доступа не позволяют учитывать праздничные дни, а также сдвиг выходных дней.
12
13 {{info}}
14 Для решения задачи управления доступом в выходные и праздничные дни реализован LUA-скрипт, который выполняется непосредственно на контроллере БОРЕЙ и переопределяет «заводскую» логику работы контроллера. Скрипт позволяет осуществлять дополнительную проверку прав доступа в конкретные дни календаря и принимать решение о разрешении или запрете доступа. Перечень выходных и праздничных дней задаётся пользователем самостоятельно в текстовом формате и обновляется ежегодно.
15 {{/info}}
16
17 == {{id name="Доступввыходныеипраздничныедни-Алгоритмработы"/}}Алгоритм работы ==
18
19 При предъявлении валидного идентификатора (карты и проч.) на контроллер БОРЕЙ выполняется базовая проверка прав пользователя. Проверка, является ли текущий день выходным или праздничным, а также проверка прав пользователя на доступ в такие дни выполняется на последнем этапе. Пример последовательности шагов приведен в таблице ниже.
20
21 |=(((
22 № шага
23 )))|=(((
24 Название
25 )))|=(((
26 Комментарий
27 )))
28 |(((
29 1
30 )))|(((
31 Поиск пропуска
32 )))|(((
33 По предъявленному идентификатору производится поиск пропуска. Если пропуск не найден, доступ блокируется. Если найден, производится переход к следующему шагу.
34 )))
35 |(((
36 2
37 )))|(((
38 Проверка второго идентификатора (если задано)
39 )))|(((
40 При двухфакторной идентификации осуществляется проверка второго фактора (биометрия по лицам или отпечаткам пальцев, ожидание ввода пин-кода). Если второй этап идентификации не пройден, доступ блокируется. В противном случае производится переход к следующему шагу.
41 )))
42 |(((
43 3
44 )))|(((
45 Проверка режима или уровня доступа
46 )))|(((
47 Производится проверка наличия текущей точки доступа (точки доступа, на которую предъявлен идентификатор) в режиме или уровне доступа пропуска, если режим не задан. Если точки доступа нет в списке, доступ блокируется. В противном случае производится переход к следующему шагу.
48 )))
49 |(((
50 4
51 )))|(((
52 Проверка временных интервалов
53 )))|(((
54 (((
55 Проверяется, заданы ли в уровне/режиме доступа временные зоны, и разрешен ли доступ в текущий день недели и в текущее время. Если день недели «выключен» в уровне доступа или текущее время вне временного интервала, доступ блокируется. В противном случае производится переход к следующему шагу.
56 )))
57 )))
58 |(((
59 5
60 )))|(((
61 Проверка, является ли день выходным/праздничным
62 )))|(((
63 Если день не является выходным или праздничным (не перечислен в конфигурационном файле скрипта), доступ разрешается. Если да, производится переход к следующему шагу.
64 )))
65 |(((
66 6
67 )))|(((
68 Проверка разрешения на доступ в выходные и праздничные дни
69 )))|(((
70 Проверяется, задано ли в свойствах пропуска право доступа в выходные и праздничные дни. Если не задано, доступ блокируется, если задано — разрешается.
71 )))
72
73 {{info}}
74 **ОБРАТИТЕ ВНИМАНИЕ**
75
76 Проверка разрешения доступа в выходные и праздничные дни производится после проверки наличия ограничений на дни недели во временных зонах. Во избежание наложений рекомендуется в уровне доступа разрешить доступ во все дни, при необходимости задав временные интервалы.
77 {{/info}}
78
79 \\
80
81 == {{id name="Доступввыходныеипраздничныедни-Порядокнастройки"/}}Порядок настройки ==
82
83 === {{id name="Доступввыходныеипраздничныедни-НастройкаПлатформыНЕЙРОСС"/}}Настройка Платформы НЕЙРОСС ===
84
85 {{info}}
86 Вам потребуется:
87
88 * Сформировать и загрузить конфигурационный файл со списком выходных и праздничных дней;
89 * Добавить пользовательское свойство, которое будет «отвечать» за разрешение или запрет доступа в выходные и праздничные дни определённым сотрудникам, в конфигурацию системы;
90 * Добавить в форму пропуска поле со свойством, сконфигурированным на предыдущем этапе.
91 {{/info}}
92
93 \\
94
95 Скопируйте приведённый ниже код и сохраните в файле calendar.json.(%%)
96
97 {{code language="java"}}
98 {
99 "1": [1, 2, 3, 4, 5, 6, 7, 8, 13, 14, 20, 21, 27, 28],
100 "2": [3, 4, 10, 11, 17, 18, 23, 24, 25],
101 "3": [2, 3, 8, 9, 10, 16, 17, 23, 24, 30, 31],
102 "4": [6, 7, 13, 14, 21, 21, 28, 29, 30],
103 "5": [1, 4, 5, 9, 10, 11, 12, 18, 19, 25, 26],
104 "6": [1, 2, 8, 9, 12, 15, 16, 22, 23, 29, 30],
105 "7": [6, 7, 13, 14, 20, 21, 27, 28],
106 "8": [3, 4, 10, 11, 17, 18, 24, 25, 31],
107 "9": [1, 7, 8, 14, 15, 21, 22, 29, 30, 31],
108 "10": [5, 6, 12, 13, 19, 20, 26, 27],
109 "11": [3, 4, 9, 10, 16, 17, 23, 24, 30],
110 "12": [1, 7, 8, 14, 15, 21, 22, 29, 30, 31]
111 }
112 {{/code}}
113
114 {{info}}
115 Файл calendar.json содержит список выходных и праздничных дней на 2024 согласно общероссийскому трудовому календарю. В кавычках указан номер месяца (например, "3" означает Март), далее в квадратных скобках через запятую перечислены выходные и праздничные дни этого месяца (например в марте это дни: 2, 3, 8, 9, 10, 16, 17, 23, 24, 30, 31).
116 {{/info}}
117
118 \\
119
120 Отредактируйте данные согласно внутреннему трудовому распорядку вашей организации. Сохраните изменения. Файл можно откорректировать в любом текстовом редакторе, например, Блокнот, Notepad++ и другие.
121
122 {{info}}
123 **ПОДСКАЗКА**
124
125 Если вы заполняете календарь в середине года, указывайте даты текущего года для текущего и всех последующих месяцев. Для уже прошедших месяцев есть смысл указывать даты следующего года.
126 {{/info}}
127
128 \\
129
130 {{id name="Доступввыходныеипраздничныедни-JSON_link"/}}Загрузите полученный конфигурационный файл в файловое хранилище Платформы НЕЙРОСС ~[[[ui.Параметры узла.Накопители и файлы.Файловое хранилище.WebHome]]].
131
132 [[image:attach:file_storage_calendar.png||width="900"]]
133
134 Скопируйте ссылку на файл. Ссылка потребуется для настройки скрипта в контроллере БОРЕЙ.
135
136 \\
137
138 Добавьте в конфигурацию Платформы НЕЙРОСС пользовательское свойство пропуска, в котором будет храниться разрешение на доступ в выходные и праздничные дни для определённых сотрудников ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Добавление пользовательских свойств.WebHome]]].
139
140 {{error}}
141 **ВАЖНО**
142
143 Обратите внимание, что требуется добавить пользовательское свойство Пропуска, а не Владельца.
144 {{/error}}
145
146 \\
147
148 [[image:attach:userfields_days_off_allowed.png||height="250"]]
149
150 |=(((
151 Поле
152 )))|=(((
153 Значение
154 )))|=(((
155 Комментарий
156 )))
157 |(((
158 Название
159 )))|(((
160 Проход в выходные и праздничные дни
161 )))|(((
162 Название поля может быть любым.
163 )))
164 |(((
165 Уникальный ключ
166 )))|(((
167 days_off_allowed
168 )))|(((
169 Ключ используется в коде скрипта контроллера БОРЕЙ. Изменение не рекомендуется.
170 )))
171 |(((
172 Тип данных
173 )))|(((
174 Переключатель
175 )))|(((
176 Другие типы полей скриптом не поддерживаются.
177 )))
178
179 \\
180
181 Добавьте новое свойство в форму пропуска ~[[[neyross.Настройка Платформы НЕЙРОСС.Настройка функций контроля доступа.Настройка форм ввода данных.WebHome]]]. Это легко сделать с помощью конструктора форм.
182
183 [[image:attach:userfields_days_off_allowed_to_form.png||width="550"]]
184
185 {{info}}
186 Если вы используете пользовательские HTML-формы, обратитесь к специалистам компании ИТРИУМ за инструкциями по добавлению поля.
187 {{/info}}
188
189 \\
190
191 === {{id name="Доступввыходныеипраздничныедни-НастройкаБОРЕЙ"/}}Настройка БОРЕЙ ===
192
193 {{info}}
194 Вам потребуется сформировать и загрузить LUA-скрипт во все контроллеры БОРЕЙ, отвечающие за доступ в выходные и праздничные дни.
195 {{/info}}
196
197 Скопируйте приведённый ниже код.
198
199 {{code language="java"}}
200 local pacs = require("pacs")
201 local log = require("log")
202 local common = require("common")
203 local http = require("http")
204
205 local logger = log.get_logger("days_off.lua")
206
207 local CALENDAR_URL = "http://10.1.29.39/api/v1/storage/get_content/?uuid=552370fa-8bb1-47c8-b433-a23d1c5c76ff"
208 local DAYS_OFF_ALLOWED_PROPERTY = "days_off_allowed"
209
210 local DAYS_OFF = {}
211
212 local function is_day_off(date_to_check)
213 logger:debug("checking if day off today")
214 if date_to_check ~=nil then
215 for i,days in pairs(DAYS_OFF) do
216 if i == tostring(date_to_check.tm_mon+1) then
217 for idx,day in pairs(days) do
218 if idx ~= "__type" then
219 if day == date_to_check.tm_mday then
220 logger:debug("It is day off today!")
221 return true
222 end
223 end
224 end
225 end
226 end
227 end
228 logger:debug("It is not day off today!")
229 return false
230 end
231
232 local function days_off_allowed(token)
233 logger:debug("checking process_data for point="..token)
234 if pacs.process_data ~= nil and type(pacs.process_data) == "table" and pacs.process_data[token] ~= nil then
235 for _,process_data in pairs(pacs.process_data[token]) do
236 if process_data.pass then
237 logger:debug("found pass="..process_data.pass.uuid)
238 if process_data.pass.properties then
239 for _,property in pairs(process_data.pass.properties) do
240 if string.sub(property.key,1,string.len(DAYS_OFF_ALLOWED_PROPERTY)) == DAYS_OFF_ALLOWED_PROPERTY then
241 return property.value == "true"
242 end
243 end
244 end
245 end
246 end
247 end
248 return false
249 end
250
251 local function check_day_off_right(token)
252 if days_off_allowed(token) == false then
253 local currenttime = common.now()
254 local datetime = common.localtime(currenttime)
255 logger:info( tostring(datetime.tm_mday) .. "/" .. tostring(datetime.tm_mon+1) .. "/" .. tostring(datetime.tm_year+1900))
256 logger:info( tostring(datetime.tm_hour) .. ":" .. tostring(datetime.tm_min) .. ":" .. tostring(datetime.tm_sec))
257
258 if is_day_off(datetime) then
259 return false
260 end
261 end
262 return true
263 end
264
265 -- calendar
266 local calendar_http_handler = {}
267
268 function calendar_http_handler:on_http_response(response_data)
269 if response_data == nil then
270 logger:error("connection has failed; no response received")
271 else
272 logger:debug("response received; status="..response_data.status..", type(body)="..log.stringify(response_data.body));
273 DAYS_OFF = response_data.body
274 end
275 end
276
277 function check_calendar_update(period)
278 logger:info("Starting timeout on "..tostring(period).." seconds")
279 set_timeout("check_calendar_update_timeout", period*1000)
280 end
281
282 function get_calendar()
283 local http_request = {
284 url = CALENDAR_URL,
285 method = http.METHOD.GET,
286 version = http.VERSION.HTTP10,
287 timeout = 5000
288 }
289 http.with(calendar_http_handler):transmit(http_request)
290 end
291
292 function check_calendar_update_timeout()
293 logger:info("Timeout!")
294 local currenttime = common.now()
295 local datetime = common.localtime(currenttime)
296 if datetime.tm_hour == 0 and datetime.tm_min == 30 then
297 get_calendar()
298 end
299 check_calendar_update(60)
300 end
301
302 get_calendar()
303 check_calendar_update(60)
304
305 local function inject_patch(instance)
306
307 instance.process_granted = function(self)
308 if (self.anonymous_mode == 0) then
309 local ready = true
310 if (self.state ~= pacs.STATE.READY) then
311 ready = false
312 end
313
314 if ready then
315 logger:debug("all points are ready; checking timezone for pacs")
316
317 if check_day_off_right(self.token) then
318 getmetatable(self).__index.process_granted(self)
319 else
320 pacs_notify(self.token, "A2")
321 getmetatable(self).__index.process_denied(self)
322 end
323 else
324 -- invoke base process_granted implementation
325 logger:debug("access point not ready; DENIE ACCESS")
326 pacs_notify(self.token, "A2")
327 getmetatable(self).__index.process_denied(self)
328 end -- if ready check
329 else
330 logger:debug("Exit pushbutton pressed; GRANTING ACCESS")
331 getmetatable(self).__index.process_granted(self)
332 end
333 end -- process_granted
334 end
335
336 -- inject to every access point if needed
337 for key,instance in pairs(pacs.ap_instance) do
338 logger:debug("injecting patch to ap with id="..instance.id.." (token="..instance.token..")")
339 inject_patch(instance)
340 end
341
342 logger:info("days off script loaded!")
343
344 {{/code}}
345
346 В веб-интерфейсе контроллера БОРЕЙ перейдите к разделу настройки скриптов ~[[[ui.Параметры узла.Скрипты.WebHome]]].
347
348 В группе **Скрипты автоматизации** нажмите на кнопку **Перейти в редактор скриптов**.
349
350 [[image:attach:scrypt_redactor_btn.png||height="160"]]
351
352 В открывшемся редакторе скриптов вставьте скопированный код скрипта.
353
354 Измените параметр
355
356 {{code language="java"}}
357 local CALENDAR_URL
358 {{/code}}
359
360 Указав в кавычках ссылку на загруженный в Платформу НЕЙРОСС конфигурационный файл ([[ссылка>>doc:||anchor="Доступввыходныеипраздничныедни-JSON_link"]]). В вашей ссылке будет IP-адрес вашей Платформы и другой уникальный идентификатор (uuid).
361
362 {{code language="java"}}
363 local CALENDAR_URL = "http://10.1.29.39/api/v1/storage/get_content/?uuid=552370fa-8bb1-47c8-b433-a23d1c5c76ff"
364 {{/code}}
365
366 [[image:attach:days_off_script_redactor.png||width="650"]]
367
368 Сохраните изменения.
369
370 Загрузите скрипт во все контроллеры БОРЕЙ, отвечающие за доступ в выходные и праздничные дни.
371
372 {{info}}
373 Скрипт меняет алгоритм доступа для всех точек доступа контроллера. включая точки доступа модулей М1 и М3. При необходимости ограничения точек доступа обратитесь к специалистам компании ИТРИУМ с запросом на доработку скрипта.
374 {{/info}}
375
376 === {{id name="Доступввыходныеипраздничныедни-Обновлениедаткалендаря"/}}Обновление дат календаря ===
377
378 При необходимости изменения календаря на следующий год, скачайте файл из файлового хранилища, измените даты на требуемые месяцы, загрузите файл обратно согласно инструкции «Замена содержимого файла» ~[[[ui.Параметры узла.Накопители и файлы.Файловое хранилище.WebHome]]].
379
380 Изменения календаря обновляются на контроллерах раз в сутки (около полуночи). При необходимости применить изменения сразу требуется зайти в редактор скриптов и повторно сохранить скрипт или перезагрузить контроллер.
381
382 == {{id name="Доступввыходныеипраздничныедни-Порядокиспользования"/}}Порядок использования ==
383
384 Оператор [[neyross.АРМ НЕЙРОСС Доступ.WebHome]] задаёт право прохода в выходные и праздничные дни. Для этого он в свойствах пропуска задаёт в поле **Проход в выходные и праздничные дни** значение [[image:confluenceAttach:page:ui.Параметры узла@fa-on.png||thumbnail="true" height="18"]] **Установлено**.
385
386 Владелец пропуска предъявляет пропуск на точку доступа в выходной день, доступ разрешается.
387
388 {{info}}
389 Если пропуску не надо разрешение на проход в выходные и праздничные дни, доступ в такие дни запрещается, формируется стандартное событие «Доступ запрещен. Пропуск неавторизован» ~[[[doc:borey3.Руководство администратора БОРЕЙ Н.События БОРЕЙ.WebHome]]].
390 {{/info}}