# assessment360.competency.update

Scope: assessment360

Кто может вызывать: Администратор портала или группа HR-отдела из настроек модуля. См. Права доступа

Обновляет существующую компетенцию.

HTTP: POST

Побочные эффекты: Изменяет состояние данных модуля assessment360.

Параметры метода

Параметр Тип Обяз. Описание
id int да Идентификатор записи
name string нет Название компетенции
active bool нет Активность компетенции
sectionId int нет ID раздела (категории) компетенции
categoryId int нет Алиас для sectionId
properties object нет Свойства компетенции по CODE инфоблока (см. ниже)

Структура properties

Ключи объекта — CODE свойств инфоблока компетенций. Неизвестный CODE → VALIDATION_ERROR с details.allowed (список допустимых кодов).

CODE Форма записи
INDICATORS { "value": [indicatorId, ...], "description": ["weight", ...] } или int[] (ID индикаторов)
INDICATORS_WEIGHT { "<indicatorId>": "weight" } или { "value", "description" } — веса сливаются в description элементов INDICATORS
INDICATORS_ENABLE_POINTS bool / xmlId indicators_enable_balls / { "xmlId" } / enumId
INDICATORS_MULTIPLE_SELECT bool / xmlId indicators_multiple_select / { "xmlId" } / enumId
INDICATORS_SCALE_SCORE bool / xmlId indicators_scale_score / { "xmlId" } / enumId
прочие CODE инфоблока скаляр, массив или { "value", "description"? } — по метаданным свойства 
"properties": {
          "INDICATORS": { "value": [201, 202], "description": ["30", "70"] },
          "INDICATORS_SCALE_SCORE": true,
          "INDICATORS_ENABLE_POINTS": false
        }

Возвращаемые данные

Ответ возвращается в конверте модуля: result.result — объект компетенции (id, name, active, sectionId, properties); result.next — null; result.error — ошибка или null; total — 0.

Обработка ошибок

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
INTERNAL_ERROR Внутренняя ошибка сервера
VALIDATION_ERROR Ошибка валидации входных параметров (в т.ч. неизвестный CODE в properties)
ACCESS_DENIED Недостаточно прав для выполнения операции

Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.competency.update.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "id": 1049,
          "name": "Коммуникация (обновлённая)",
          "active": true,
          "sectionId": 5,
          "properties": {
            "INDICATORS": { "value": [201, 202], "description": ["30", "70"] },
            "INDICATORS_SCALE_SCORE": true,
            "INDICATORS_ENABLE_POINTS": false
          }
        }'

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

{
          "result": {
            "result": {
              "id": 1049,
              "name": "Коммуникация (обновлённая)",
              "active": true,
              "sectionId": 5,
              "properties": {
                "INDICATORS": {
                  "type": "E",
                  "userType": null,
                  "multiple": true,
                  "value": [201, 202]
                }
              }
            },
            "next": null,
            "error": null
          },
          "total": 0
        }

См. также

Предыдущая
assessment360.competency.add
Следующая
assessment360.competency.delete