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

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

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

Метод: updateCourseStatus

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

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

Автор материала может добавить соавторов во вкладке Совместный доступ.

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

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

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

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

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

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

Заголовок

ТипОписание
taskIdstringID запроса на изменение статуса курса

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

ОшибкаОписание
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>
      <updateCourseStatusRequest>
        <credentials>
           <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
        </credentials>
        <enrollmentIds>
          <id>e1f2c50e-c1ae-11ea-8592-a6eabe1809b2</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>

Пример ответа

<?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:updateCourseStatusResult>
      <ns1:taskId>100027</ns1:taskId>
    </ns1:updateCourseStatusResult>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
  • Нет меток