Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Запрос без параметра objtype возвращается результат по всем возвращает список проходов по всем objid

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

...

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

Параметр

Обязательный

Описание

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

Note
titleВнимание!

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

...

Пример запроса на отображение данных входа пользователей с personId=2 и personId=4

...

, когда параметры 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

Пример запроса на отображение данных входа всех пользователей, находящихся в области 1.2, через все точки прохода, когда параметры 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&objid=1.1.1&eventAction=ACCESS_IN&areaId=1.2&page=1&limit=1000

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

Expand
{
    "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 – успешно,

если

в противном случае завершится с ошибкой

, то см. список возможных ошибок