Контроль активности пропуска

Version 1.2 by admin on 2026/05/30 23:01
Warning
For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

Часто бывает полезно выявить неактивные пропуска, то есть пропуска, по которым давно не было никаких событий доступа. Для решения этой задачи в Платформе НЕЙРОСС реализован скрипт автоматизации, позволяет автоматически обнаружить неактивные пропуска и поместить их в отдельную группу, а также, при необходимости, — выполнить бессрочную приостановку пропуска. 

Контролируются не все пропуска, а только пропуска выбранных владельцев.

Посредством настройки свойств скрипта автоматизации вы можете:

  • задать имя группы для помещения пропусков;
  • определить, требуется ли автоматически выполнять изъятие пропусков, либо решение будет принимать оператор бюро пропусков;
  • задать период неактивности — временной интервал в днях, по истечении которого при отсутствии событий доступа пропуск считается неактивным;
  • указать, требуется ли учитывать факт изменения пропуска совместно с событием доступа — пропуск будет считаться неактивным, если за заданный период не было ни события доступа, ни факта изменения пропуска оператором бюро пропусков;
  • пометить, что пропуск приостановлен скриптом автоматизации.
Information

Задание автоматизации может запускаться оператором вручную, по расписанию (например, раз в неделю по воскресеньям), либо по какому-либо событию/системному действию.

Пример: Найти пропуска, по которым не было событий доступа в течение 60 дней и поместить их в группу «Устаревшие пропуска»

Задание автоматизации запускается автоматически ежедневно в 23:00, производится поиск за интервал в 60 дне. Найденные неактивные пропуска не приостанавливаются, остаются действительными и принадлежащими «своим» группам, но дополнительно помещаются в группу «Устаревшие пропуска». Анализируются только события доступа, факт изменения пропуска оператором АРМ Доступ не анализируется.

card_inactivity_scrypt.png


Настройки СКУД

Вам потребуется:

  1. Создать пользовательское свойство владельца пропуска для указания перечня лиц, для которых требуется проводить контроль активности пропуска.
  2. Добавить свойство на форму владельца пропуска и задать в значение true для владельцев, чьи пропуска требуется анализировать.
  3. Создать пользовательское свойство пропуска для пометок о том, что пропуск приостановлен скриптом.
  4. Добавить свойство на форму пропуска. 

Порядок действий:

Задача

Комментарий

Создание пользовательского свойства

В разделе Настройки СКУД АРМ НЕЙРОСС Доступ:

  1. На вкладке Свойства владельца пропуска добавьте новое свойство, задайте название и ключ свойства, укажите тип «Переключатель».
    card_inactivity_appprp.png
  2. На вкладке Свойства пропуска добавьте новое свойство, задайте название и ключ свойства, укажите тип «Переключатель».
    PausedByScrypt_addprp.png

Добавление пользовательских свойств

Изменение формы владельца пропуска

В разделе Персонал АРМ НЕЙРОСС Доступ выберите группу пропусков, для которой нужно настроить контроль активности, перейдите к вкладке Настройки группы:

  1. На вкладке Форма ввода: Владелец пропуска добавьте поле Контроль активности (название может быть любым) на форму владельца пропуска.
  2. На вкладке Форма ввода: Пропуск добавьте поле Приостановлен скриптом (название может быть любым) на форму пропуска.
Information

Рекомендуем использовать Конструктор форм. При использовании нестандартных форм, обратитесь к специалистам компании ИТРИУМ за услугой по доработке формы.

Настройка форм ввода данных

При необходимости вывода информации в таблице пропусков, на вкладке Настройка таблицы добавьте вывод данных свойств.

Настройка таблицы пропусков

Включение необходимости контроля активности пропуска

Выберите владельцев, для которых требуется проводить контроль активности пропуска, и в режиме редактирования пропуска / группы пропусков в поле Контроль активности установите переключатель в положение fa-on.pngВключено. Сохраните данные владельца.

card_inactivity_person_form.png

Управление пропусками

Просмотр результатов работы скрипта

Дождитесь выполнения условия запуска задания (в нашем примере это 23:00 текущего дня).

Настройки автоматизации

Скопируйте приведённый ниже код скрипта и создайте файл с произвольным именем и расширением JSON, например: задание_автоматизации_Контроль_устаревших пропусков.json. Для этого удобно использовать простые текстовые редакторы типа Блокнот или Notepad++. Вы также можете обратиться к специалистам компании ИТРИУМ, мы вышлем подготовленный файл.

Unknown macro: expand. Click on this message for details.

Добавьте задание автоматизации

  1. В разделе Автоматизация нажмите на кнопку  Добавить новое задание btn_add_new.png, нажмите на кнопку Импорт и укажите путь к подготовленному на предыдущем этапе файлу [Автоматизация].
  2. В блоке Параметры сигнала выберите По расписанию, настройте расписание (например, 0 23 * * * для ежедневного запуска, или 0 23 * * 1 для запуска раз в неделю по воскресеньям). 
  3. В блоке Параметры действия настройте параметры задания автоматизации согласно таблице ниже.

    Параметр

    Комментарий

    Название группы устаревших пропусков

    Название группы. При запуске скрипта проверяется наличие группы с указанным именем в группе Все. При отсутствии, — она будет создана. В эту группу помещаться все найденные пропуска и их владельцы. Если название пустое, задание не выполняется. 

    Идентификатор свойства — признака контроля

    Уникальный идентификатор пользовательского свойства владельца пропуска, созданный на этапе #Настройки СКУД. В нашем примере: inactivity

    Значение свойства — признака контроля

    • true — если требуется проверять пропуска, для владельцев которого в поле Контроль пропусков переключатель установлен в положение fa-on.png Включено.
    • false — если требуется проверять пропуска, для владельцев которого в поле Контроль пропусков переключатель установлен в положение fa-off.png Выключено.

    В нашем примере: true

    Режим работы

    Выберите из раскрывающегося списка требуемые действия с пропусками:  требуется ли просто помещать пропуска в дополнительную группу для принятия решения оператором о дальнейших действиях с пропуском, либо необходимо приостанавливать действие найденных пропусков и помещать в группу.

    • Помещение устаревших пропусков в группу — просто помещать пропуска в дополнительную группу для принятия решения оператором о дальнейших действиях с пропуском. Пропуск остаётся действительным. Доступ по нему возможен.
    • Приостановка и помещение устаревших пропусков в группу — приостанавливать пропуск и помещать в дополнительную группу. Пропуск не удаляется из контроллеров доступа, но доступ блокируется.

    Максимальный период неактивности, дней

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

    Анализировать время изменения пропуска

    Установите флаг в поле, если, помимо событий доступа при расчёте активности пропуска требуется учитывать не только события доступа, но и события изменения пропуска оператором бюро пропусков. 

    Идентификатор свойства-маркера контроля

    Уникальный идентификатор пользовательского свойства пропуска, значение которого будет устанавливаться в true для пропусков, которые приостановлены данным скриптом. В нашем примере: PausedByScrypt

    Алгоритм работы

    1. Поиск владельцев, для которых в поле с указанным идентификатором задано указанное значение.
    2. Поиск активных пропусков для найденных владельцев (если пропуск уже приостановлен или находится в группе устаревших пропусков операции с ним не выполняются).
    3. Поиск времени «активизации пропуска»:
      1. Если флаг в поле Анализировать время изменения пропуска установлен, то выбирается наиболее позднее из времени последнего редактирования и времени последнего прохода по пропуску
      2. Если флаг не установлен, выбирается время последнего прохода по пропуску.
    4. Если «время активизации» раньше чем текущее время минус Максимальный период неактивности, пропуск дополнительно помещается в группу устаревших пропусков.
    5. Если указан режим работы «Приостановка и перемещение устаревших пропусков в группу», все найденные пропуска бессрочно приостанавливаются. В поле Приостановлен с задаётся текущее время.
  4. Нажмите на кнопку Сохранить задание.
Error

ВАЖНО

В НЕЙРОСС пропуск не «привязывается» жёстко к одной группе. Принадлежность пропуска группе пропусков является просто свойством пропуска. Пропуск может принадлежать нескольким группам одновременно. При помещении пропуска в группу Устаревшие пропуска, пропуск остаётся также и в групе, в которой он располагался до запуска скрипта. Изъятие пропуска из группы осуществляется оператором АРМ Доступ с помощью команды Другие действия > Действие с группами > Изъять из текущей группы.

Запуск задания

Дождитесь выполнения условия запуска задания или запустите задание вручную. Для ручного запуска в поле Тип сигнала выберите значение По HTTP-запросу, сохраните задание и нажмите отправить запрос.

task_run_manually.png

Вы можете отслеживать процедуру инициализации и выполнения задания в Журнале аудита [Журнал аудита].

card_inactivity_scrypt_log.png

Запуск и выполненные скриптом действия фиксируются в системном журнале [Системный журнал].

card_inactivity_journal.png

Если в поле Режим работы задана необходимость приостановки пропуска. В системном журнале отражается факт блокировки действия на контроллерах и задания срока приостановки с текущего времени:

card_inactivity_journal1.png

Пропуска приостанавливаются с текущего времени, свойство Приостановлен скриптом у приостановленных пропусков устанавливается в значение Да (true).

card_inactivity_card_form.png

Платформа НЕЙРОСС