Получение данных о событиях проходов пользователя

Запрос без параметра personId возвращает список проходов всех пользователей системы.

Запрос без параметра objtype возвращает список проходов по всем objid.

Пользователей можно отфильтровать по идентификатору области (полю area_id из таблицы OBJ_PERSON, подробнее см. на странице Таблицы базового ПК Интеллект).

Все пользователи возвращаются в порядке увеличения personId.

Общий формат запроса:

GET http://<IP-адрес Web-сервера>:8081/AccessManager/ReportApi/GetEmployeeWalkwayData?from=<начало временного интервала>&to=<конец временного интервала>

Примеры параметров запроса:

Параметр	Обязательный	Описание
personId	Нет	Идентификаторы пользователей через запятую
withTempr	Нет	Данные о температуре пользователя, по умолчанию – false
from	Да	Период с: начало временного интервала, содержащего дату и время в формате ГГГГ-ММ-ДДTЧЧ:ММ:СС
to	Да	Период по: конец временного интервала, содержащего дату и время в формате ГГГГ-ММ-ДДTЧЧ:ММ:СС
objid	Нет	Идентификатор объекта, к которому относится событие
objtype	Нет	Тип объекта, к которому относится событие, например ACFA_EMULATOR_ACS_CONTROLLER. Список объектов, их названия в базе и GUI можно увидеть, используя утилиту ddi.exe
eventAction	Нет	Тип события, например ACCESS_IN
area_id	Нет	Идентификатор объекта Область, в котором находится пользователь согласно данным системы аварийного мониторинга в составе ПК ACFA-Интеллект (подробнее см. на странице Работа с функциями аварийного мониторинга)
page	Нет	Номер страницы данных, отображаемой в результате запроса, по умолчанию – 0
limit	Нет	Максимальное количество строк данных, по умолчанию выводятся все данные. Например, при установленных значениях параметров page=0 и limit=1000 будут выведены первые 1000 строк, при page=2 и limit=1000 будут выведены строки 2001-3000

Внимание!

Если в системе много объектов (>1000), то необходимо использовать постраничный вывод.

Пример запроса на отображение данных входа пользователей с personId=2 и personId=4 с сортировкой по полю area_id=1.2, когда параметры objtype, objid указаны:

GET localhost:8081/reports/AccessManager/ReportApi/GetEmployeeWalkwayData?withTempr=true&personId=2,4from=2025-03-05T00:00:00&to=2025-03-08T23:59:59&objid=1.1.1&objtype=ACFA_EMULATOR_ACS_CONTROLLER&eventAction=ACCESS_IN

Пример запроса на отображение данных входа всех пользователей, относящихся к определенной области, через все точки прохода, когда параметры personId, objtype не указаны:

GET localhost:8081/reports/AccessManager/ReportApi/GetEmployeeWalkwayData?withTempr=true&from=2025-03-04T00:00:00&to=2025-03-10T23:59:59&objid=1.1.1&eventAction=ACCESS_IN&areaId=1.2&page=1&limit=1000

Пример ответа:

{
    "employeeID": "2,4",
    "result":[
     {
       "PersonId": "2",
       "timeclockID": "Эмулятор СКУД Считыватель 1.1.1",        
       "scantime": "2025-03-06T09:01:01",
       "clockInOut": "in",
       "Temperature": "-"
     },
       {
       "PersonId": "4",
       "timeclockID": "Эмулятор СКУД Считыватель 1.1.1",        
       "scantime": "2025-03-06T09:01:19",
       "clockInOut": "in",
       "Temperature": "-"
     },
     {
       "PersonId": "2",
       "timeclockID": "Эмулятор СКУД Считыватель 1.1.1",        
       "scantime": "2025-03-07T09:00:46",
       "clockInOut": "in",
       "Temperature": "-"
     },
     {
       "PersonId": "4",
       "timeclockID": "Эмулятор СКУД Считыватель 1.1.1",        
       "scantime": "2025-03-07T09:00:53",
       "clockInOut": "in",
       "Temperature": "-"
     }
    ],
   "status": "success",
   "transactionID": 1760702475

Параметры ответа:

Параметр	Описание
employeeID	Идентификатор сотрудника
PersonId	Идентификатор пользователя
timeclockID	Идентификатор устройства учета рабочего времени сотрудника
scantime	Дата и время события прохода
clockInOut	Отметка на входе/выходе сотрудника
Temperature	Температура сотрудника
transactionID	Идентификатор транзакции
status	Статус выполненного запроса: success – успешно, в противном случае завершится с ошибкой

Page tree

Документация для версии Intellect Web Report System 4.0. Документация на другие версии также доступна.

Общий формат запроса:

Примеры параметров запроса:

Пример запроса на отображение данных входа пользователей с personId=2 и personId=4 с сортировкой по полю area_id=1.2, когда параметры objtype, objid указаны:

Пример запроса на отображение данных входа всех пользователей, относящихся к определенной области, через все точки прохода, когда параметры personId, objtype не указаны:

Пример ответа: