Script DSSL

Page tree

Скрипт предназначен для учёта рабочего времени сотрудников на базе модуля Face Recognition. Также работает с Face Recognition 2.0.

Для корректной работы скрипта необходимо 2 отдельные камеры (вход/выход).
Для каждой камеры необходима лицензия TRASSIR Face Recognition Channel или (TRASSIR Face Detector + TRASSIR Face Recognition)

Основные отличия от прошлой версии

  • Имеет веб-интерфейс, доступен как модуль в Trassir
  • Умеет строить отчеты за произвольную дату
  • Умеет строить итоговые отчета за произвольный период
  • Может работать с несколькими папками

Установка

Скрипт необходимо добавить в разделе Автоматизация → Новый скрипт → Загрузить пример → Из файла…

После загрузки скрипта необходимо нажать на кнопку «Сохранить, запустить» и выполнить его настройку.

Настройка

При первой настройке скрипта, перейдите в параметры и укажите количество папок персон для которых нужно учитывать рабочее время.
В базе лиц создано 3 папки, но учитывать рабочее время нужно для папки DSSL и Zavod, в этом случае значение параметра устанавливаем 2.


Для режима отладки включить Debug mode (по умолчанию выключен).

Сохранить, запустить.

Дальнейшие настройки и работа с скриптом происходит в веб интерфейсе.

Открыть монитор → Модули → FaceWorkTime

В интерфейсе перейти на вкладку настройки: 

  1. Укажите каналы которые расположены на входе и выходе (для выбора доступны каналы с включенным распознаванием лиц)

2. Для каждой папки персон укажите:

  • Имя папки
  • Время начала рабочего дня
  • Продолжительность рабочего дня

3. Настройка отчетов. Доступны следующие параметры:

  • Папка для экспорта - путь сохранения отчетов
  • Вкл/Выкл экспорт ежедневных отчетов
  • Время ежедневного экспорта
  • Вкл/Выкл отправку отчета на почту
  • Вкл/Выкл отправку отчета в Telegram

4. Если предыдущие настройки включают рассылку на почту/Telegram заполните параметры для рассылки:

5. По завершению настройки нажать Сохранить.


На Главной странице отображается статистика за текущий день по всем выбранным папкам персон.

Рассмотрим подробнее:

  1. Выбор даты для формирования статистики. Доступный диапазон дат зависит от настройки распознавания лиц, параметр "Глубина хранения, дней"
  2. Название папки персон.
  3. Начало рабочего дня - задаем в настройках скрипта
  4. Продолжительность рабочего дня - задаем в настройках скрипта

  5. Общее количество треков персоны - при нажатии раскрывается дополнительная информация по каждому треку

  6. Первый вход - время первого распознавания на канале который работает на вход

    Если время первого распознавание позже начала рабочего дня, информация в ячейке будет подсвечена красным цветом

  7. Состояние - отображает текущее состояние, зависит от того на каком канале был распознан последний трек персоны.
  8. Рабочее время - общее количество времени проведенное на рабочем месте.
  9. Для сохранения отчета - нажмите кнопку Сохранить отчет

При переходе на вкладку Отчет - по умолчанию открывается отчет за текущий месяц:

  1. Выбор папки персон
  2. Выбор диапазона дат
  3. Поиск
  4. Сохранение отчета

Отчет содержит информацию:

  • Количество рабочих дней когда сотрудник присутствовал на работе
  • Суммарное количество часов за эти дни
  • Ежедневный отчет о времени присутствия на рабочем месте

Пример отчета в формате .xlsx:

Полезное

Предположим, скрипт имеет следующие настройки:
WORKTIME_DELTA_HOURS = 1 час

Каналы входа: Вход
Каналы выхода: Выход
Мин. % похожести: 80

Папка персон сотрудников: DSSL
Время начала рабочего дня: 08:00:00
Продолжительность рабочего дня: 08:00:00


При запросе в Базу данных будут обработаны треки с 7:00 до 17:00 с процентом похожести от 80 % до 100 %.


При расчете рабочего времени суммируются парные треки вход - выход, например:

Вход 7:55

8:40 - 7:55 = 00:45

0:45 + 2:51 = 3:36

Выход 8:40
Вход 8:49

11:40 - 8:49 = 2:51

Выход 11:40


Предположим ситуацию, когда лицо было распознано на вход, затем человек вышел без распознавания (либо процент распознавания был меньше заданного) и повторно вошел, в этом случае время будет рассчитано между последним распознанным треком на вход и выход:

Вход 7:558:40 - 8:05 = 00:3500:35 + 00:25 = 01:00

Вход 7:59
Вход 8:05
Выход 8:40
Вход 9:109:35 - 9:10 = 00:25
Выход 9:35

Если рабочий день с 08:00 до 17:00 то скрипт ищет треки в диапазоне с 07:00 до 18:00 по умолчанию +/- 1 час.
Сделано это для того чтобы не перебирать в БД лишние записи, но и учесть что сотрудник может прийти на 15,20,...,59 минут раньше на работу.

Данный параметр зависит от глобальной переменной WORKTIME_DELTA_HOURS. которая по умолчанию равна 1.
Переменную можно изменить, если в скрипте после параметров, перед ресурсами указать свое значение, например WORKTIME_DELTA_HOURS = 2

Version 2.2.13

Released 2022-08-09

Bug Fixes:

  • Fixed bug of ignoring parameter Confidence

Version 2.2.12

Released 2021-09-23

Bug Fixes:

  • Added a key for the filter

Version 2.2.11

Released 2021-09-03

Bug Fixes:

  • Changed query to faceworktime_log from one_or_none to first

Version 2.2.10

Released 2021-08-27

Bug Fixes:

  • Changed query to faceworktime_log from one_or_none to first

Version 2.2.9

Released 2021-08-06

Bug Fixes:

  • Added bool statement EXPORT_LAST_MONTH if export was done

Version 2.2.8

Released 2021-03-04

New Features:

  • Added check for export of the report for the previous month

Version 2.2.7

Released 2020-12-21

Bug Fixes:

  • Added english translation

Version 2.2.6

Released 2020-11-02

New Features:

  • Column Name -> Full name
  • Transfer of full name and alignment to the left in the general report

Bug Fixes

  • Fix file name

Version 2.2.5

Released 2020-10-22 

New Features:

  • Module name by script name
  • Added file name

Bug Fixes

  • Sheet name is more than 31 characters
  • Transfer of name in the report by words

Version 2.2.4

Released 2020-10-07

Bug Fixes

  • Fix web and skip ch archive_zombie_flag(SCR-5891)

Version 2.2.3

Released 2020-05-22

New Features:

  • Added statistics on the number of people in the workplace
  • Added the ability to run multiple copies of the script
  • To migrate the database to a new version in the script name add `clear_db`
  • Updated exhttp

Bug Fixes:

  • Before the beginning of the working day we received yesterdays tracks - corrected

Version 2.2.2

Released 2020-05-15

New Features:

  • A comment was added to the general report for each cell with the time of the first entry and last exit
  • Moved to script parameters WORKTIME_DELTA_HOURS
  • Verification added: working hours + delta no more than 24 hours

Version 2.2.1

Released 2020-04-27

Bug Fixes:

  • Fix two-day report export (SCR-5176)

Version 2.2.0

Released 2020-04-20

New Features:

  • Add min day for datepicker, depends on FR storage depth
  • Now script can work with several persons folders
  • Check if there is no fr service on server
  • Add summary reports + monthly export

Version 2.1.10

Released 2020-04-03

Bug Fixes:

  • Fix typo работет

Version 2.1.9

Released 2020-04-03

New Features:

Bug Fixes

  • Fix translations

Version 2.1.8

Released 2020-04-01

Bug Fixes:

  • Tracks info random sorting (SCR-5049)
  • Wrong cols indexes in exporting detail table (SCR-5049)
  • Translating with tags not working (SCR-5065)
  • Miss sid after saving settings (SCR-5065)
  • Set local server guid if fr master_guid is empty (SCR-5065)

Version 2.1.4

Released 2020-03-20

Bug Fixes:

  • Undefined variable default_script_name

Version 2.1.3

Released 2020-03-06

First beta release...

Запросить данный скрипт Вы можете через вашего менеджера.