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

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Включить страницу
Лэйблы с указанием тарифа
Лэйблы с указанием тарифа

Метод: updateCourseStatus

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

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

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

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

ПараметрТипОписание
credentials
token (обязательный)
credentialsСмотрите описание объекта Credentials.
stringТокен доступа. Вы можете получить токен с помощью запроса
courseId (обязательный)stringID курса, статус которого вы хотите изменить
.
enrollmentIds (обязательный)stringНазначение или несколько назначений курса, статусы которых вы хотите изменить
. (необязательный
date 
date (обязательный, если статус курса меняется на Завершён)stringДата
изменения статуса.
завершения курса
reason (необязательный)stringПричина, по которой вы хотите изменить статус
назначения или нескольких назначений
курса
.
status (обязательный)stringСтатус, который вы хотите присвоить курсу.

Возможные значения:
completed —

complete — статус
курса
изменится на Завершён,
automatic — статус
курса
автоматически пересчитается в зависимости от того, сколько материалов курса прошел пользователь

...

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

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

Возвращаемые значения

Заголовок

ТипОписание
taskIdstringID
задачи, по которой можно отследить статус выполнения запроса.
запроса на изменение статуса курса

Возможные ошибки

ОшибкаОписание
Unknown content itemНе найден курс
или назначение
с указанным ID
.
Permission deniedУ пользователя недостаточно прав для выполнения запроса

Пример запроса

Блок кода
languagexml
<?xml version="1.0" encoding="utf-8"?>
  <SOAP-ENV:Envelope xmlns:SOAP-ENV="httphttps://schemas.xmlsoap.org/soap/envelope/"
                     xmlns="httphttps://ispringlearn.com/go/services/api/soap">
    <SOAP-ENV:Body>
      <updateCourseStatusRequest>
        <credentials>
              <accountUrl>http://myaccount.ispringlearn.ru</accountUrl>
          <email>email@email.com</email>
          <password>password</password>
        </  <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
        </credentials>
        <enrollmentIds>
          <id>e1f2c50e-c1ae-11ea-8592-a6eabe1809b2</soap>id>
        </enrollmentIds>
        <courseId>14b847e8-c10f-11ea-b4e1-ae33e75597e9</courseId>
        <date>2020-07-22</date>
        <reason>Прошел очно</reason>
        <status>complete</status>
      </updateCourseStatusRequest>
    </SOAP-ENV:Body>
  </SOAP-ENV:Envelope>

...

Блок кода
languagexml
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="httphttps://schemas.xmlsoap.org/soap/envelope/"
                   xmlns:ns1="httphttps://ispringlearn.com/go/services/api/soap">    
  <SOAP-ENV:Body>
    <ns1:updateCourseStatusResult>
      <ns1:taskId>100027</ns1:taskId>
    </ns1:updateCourseStatusResult>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

...