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

Метод: updateModulesStatuses

Важно:

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

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

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

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

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

Параметр	Тип	Описание
credentials (обязательный)	credentials	Смотрите описание объекта Credentials.
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>
          <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>

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

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