assessment360.points.list
Scope:
assessment360Кто может вызывать: Доступ на просмотр карточки процедуры через карточку респондента (
canViewAssessmentCard). См. Права доступа
Возвращает список оценочных баллов (points) из HL-блока с пагинацией и mongo-style фильтром.
HTTP: GET
Побочные эффекты: none
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
limit |
int |
нет | Размер страницы, по умолчанию 50, максимум 500 |
offset |
int |
нет | Смещение |
fetchAll |
bool |
нет | Вернуть все записи одним ответом (максимум 5000; при превышении — FETCH_ALL_LIMIT_EXCEEDED) |
filter |
object |
нет | Фильтр в mongo-style формате |
assessmentId |
int |
да | ID карточки респондента (UF_ASSESSMENT_360; алиасы: responderId, assessingCardId, responderCardId) |
Поля filter (Mongo)
Поддерживаемые поля: id, assessmentId, competenceId, assessmentKey, value, comment, showAssessmentEmployee, showCommentEmployee, anonymousForEmployee, showAssessmentManager, showCommentManager, anonymousForManager, indicatorIds, indicatorsEnabledPoints.
Также поддерживаются алиасы: responderId, assessingCardId, responderCardId, assessmentNum.
Возвращаемые данные
Ответ возвращается в конверте модуля: result.result — массив объектов баллов (id, assessmentId, competenceId, assessmentKey, value, comment, флаги видимости, indicatorIds, indicatorsEnabledPoints); result.next — смещение следующей страницы или null; result.error — ошибка или null; total — общее число записей.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
INVALID_LIMIT |
Некорректное значение limit |
INVALID_OFFSET |
Некорректное значение offset |
INVALID_FILTER |
Некорректный фильтр |
INVALID_FILTER_OPERATOR |
Неизвестный оператор фильтра |
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.points.list.json"
-H "Accept: application/json"
--data-urlencode "limit=20"
--data-urlencode "offset=0"
--data-urlencode "assessmentId=214"
Пример ответа
{
"result": {
"result": [
{
"id": 42,
"assessmentId": 214,
"competenceId": 11,
"assessmentKey": "employee",
"value": "4",
"comment": "Хорошо проявляет инициативу",
"showAssessmentEmployee": true,
"showCommentEmployee": true,
"anonymousForEmployee": false,
"showAssessmentManager": true,
"showCommentManager": true,
"anonymousForManager": false,
"indicatorIds": [7, 8],
"indicatorsEnabledPoints": true
}
],
"next": 20,
"error": null
},
"total": 57
}