Документация по iSpring Learn

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

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

Старая версия 3

changes.mady.by.user admin

Сохранено

по сравнению с

Новая версия Текущий

changes.mady.by.user elena.antipova

Сохранено

Ключ

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

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

Метод: updateCourseStatus

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

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

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

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

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

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

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>

...