View Source

Запрос без параметра 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 и objid не указаны, с отображением только страницы 1 и ограничением 1000 записей:

GET localhost:8081/reports/AccessManager/ReportApi/GetEmployeeWalkwayData?withTempr=true&from=2025-03-04T00:00:00&to=2025-03-10T23:59:59&eventAction=ACCESS_IN&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 – успешно, в противном случае завершится с ошибкой