Метод: removeDepartment
Нельзя удалить подразделение:
- в котором есть пользователи,
- которым управляет администратор подразделения или автор,
- если оно является корневым.
Параметры запроса
Параметр | Тип | Описание |
---|---|---|
credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
departmentId (обязательный) | string | ID подразделения, которое нужно удалить. |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками.
Администратор подразделения может удалить только подразделение, которым управляет, и его дочерние подразделения.
Возвращаемые значения
После того, как запрос успешно обработан, система отправляет объект со следующими свойствами:
Параметр | Тип | Описание |
---|---|---|
success | bool | True, если подразделение было удалено. |
Возможные ошибки
Ошибка | Описание |
---|---|
Permission denied | У пользователя недостаточно прав для удаления подразделения. |
Wrong parameters | Подразделение с указанным ID не найдено, содержит пользователей или является корневым подразделением. |
Пример запроса
<?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> <RemoveDepartmentRequest> <credentials> <accountUrl>http://myaccount.ispringlearn.ru</accountUrl> <email>email@email.com</email> <password>password</password> </credentials> <departmentId>string</departmentId> </RemoveDepartmentRequest> </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://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <successResult> <success>true</success> </successResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope>