Вы можете обновить название и код подразделения, а также изменить его родительское подразделение, с помощью метода updateDepartment.
Права пользователя для выполнения запроса: Владелец аккаунта, Администратор, Администратор подразделения.
Администратор подразделения может отредактировать только свое подразделение и вложенные в него подразделения.
Параметры запроса
| Параметр | Тип | Описание |
|---|
| credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
| departmentId (обязательный) | string | ID подразделения, которое нужно отредактировать. |
| name (необязательный) | string | Название подразделения. |
| code (необязательный) | string | Код подразделения. |
| parentDepartmentId (необязательный) | string | ID родительского подразделения. |
Возвращаемые значения
После того, как запрос успешно обработан, система отправляет объект со следующими свойствами:
| Параметр | Тип | Описание |
|---|
| success | bool | True, если подразделение было успешно отредактировано. |
Возможные ошибки
| Тип | Описание |
|---|
| Unknown Department | Подразделение не найдено. |
| Permission denied | У пользователя недостаточно прав для обновления данных подразделения. |
| Wrong Parameters | Один из указанных параметров задан неверно. |
Пример запроса
| Блок кода |
|---|
|
POST /api/v2/soap/2.0 HTTP/1.1
SOAPAction: "updateDepartment"
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns="http://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<UpdateDepartmentRequest>
<credentials>
<accountUrl>http://myaccount.ispringlearn.ru</accountUrl>
<email>email@mail.ru</email>
<password>password</password>
</credentials>
<departmentId>2bbc2ed0-8841-11e9-93c1-0242c0a85016</departmentId>
<name>Контроль качества</name>
<code>1</code>
<parentDepartmentId>be676588-5448-11e9-b7f7-62fb686e6fbe</parentDepartmentId>
</UpdateDepartmentRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |
Пример ответа
| Блок кода |
|---|
|
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns="http://new.webservice.namespace">
<SOAP-ENV:Body>
<updateDepartmentResult>
<success>true</success>
</updateDepartmentResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |