ДОСТУПНО В BUSINESS ПОДПИСКЕ

Метод: updateModulesStatuses

Важно:

С помощью метода можно изменить только статус материала, входящего в состав курса. Изменить статус мероприятия, входящего в состав курса, нельзя.

Права пользователя для выполнения запроса

Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками.

Администратор подразделения или пользователь с ролью с индивидуальными настройками могут изменять статус материалов, назначенных на пользователей подразделений, которыми управляют, и вложенных в них подразделений.

Параметры запроса

Параметр	Тип	Описание
token (обязательный)	string	Токен доступа. Вы можете получить токен с помощью запроса
enrollmentIds (обязательный)	string	Назначение или несколько назначений, статусы которых вы хотите изменить
courseId (обязательный)	string	ID курса, в состав которого входит материал или несколько материалов, статус которых вы хотите изменить
moduleStatuses (обязательный)	array	Массив с данными об изменении статуса материала
contentItemId (обязательный)	string	ID материала статус которого вы хотите изменить
date (обязательный)	date	Дата завершения материала
reason (необязательный)	string	Причина, по которой вы хотите изменить статус материала
status (обязательный)	string	Статус, который вы хотите присвоить материалу. Возможные значения: сomplete — завершён, incomplete — в процессе, passed — пройден, failed — не пройден, accepted — принят, declined — отклонен
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>
          <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
        </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>

Дерево страниц

Изменение статуса материала