Метод: updateModulesStatuses
Важно:
- С помощью метода можно изменить только статус материала, входящего в состав курса. Изменить статус мероприятия, входящего в состав курса, нельзя.
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками.
Администратор подразделения или пользователь с ролью с индивидуальными настройками могут изменять статус материалов, назначенных на пользователей подразделений, которыми управляют, и вложенных в них подразделений.
Параметры запроса
Параметр | Тип | Описание |
---|---|---|
credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
enrollmentIds (обязательный) | string | Назначение или несколько назначений, статусы которых вы хотите изменить. |
courseId (обязательный) | string | ID курса, в состав которого входит материал или несколько материалов, статус которых вы хотите изменить. |
moduleStatuses (обязательный) | array | Массив с данными об изменении статуса материала. |
contentItemId (обязательный) | string | ID материала статус которого вы хотите изменить. |
date (обязательный) | date | Дата завершения материала. |
reason (необязательный) | string | Причина, по которой вы хотите изменить статус материала. |
status (обязательный) | string | Статус, который вы хотите присвоить материалу. сompleted — Завершён |
awardedScore (обязательный) | string | Количество баллов, заработанных за материал. |
Возвращаемые значения
Заголовок | Тип | Описание |
---|---|---|
taskId | string | ID запроса на изменение статуса материала. |
Возможные ошибки
Ошибка | Описание |
---|---|
Unknown content item | Не найден курс, назначение или материал с указанным ID. |
Permission denied | У пользователя недостаточно прав для выполнения запроса |
Пример запроса
<?xml version="1.0" encoding="utf-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/" xmlns="https://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <updateModulesStatusesRequest> <credentials> <accountUrl>https://myaccount.ispringlearn.ru</accountUrl> <email>email@email.com</email> <password>password</password> </credentials> <enrollmentIds> <id>e1f2c50e-c1ae-11ea-8592-a6eabe1809b2</soap> </enrollmentIds> <courseId>14b847e8-c10f-11ea-b4e1-ae33e75597e9</courseId> <moduleStatuses> <moduleStatus> <contentItemId>17502fac-c10f-11ea-8fbd-a6eabe1809b2</contentItemId> <date>2020-03-12</date> <reason>Прошел очно</reason> <status>complete</status> <awardedScore>100</awardedScore> </moduleStatus> </moduleStatuses> </updateModulesStatusesRequest> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Пример ответа
<?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <ns1:updateModulesStatusesResult> <ns1:taskId>100027</ns1:taskId> </ns1:updateModulesStatusesResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope>