Включить страницу | ||||
---|---|---|---|---|
|
Метод: getDepartment
Параметры запроса
Для получения информации об подразделении используйте метод getDepartment.
Права пользователя для выполнения запроса: Владелец аккаунта, Администратор, Администратор подразделения, Автор.
...
Параметр | Тип | Описание | |
---|---|---|---|
credentials token (обязательный) | credentials | string | Токен доступа. Вы можете получить токен с помощью запросаСмотрите описание объекта Credentials. |
departmentId (обязательный) | string | ID подразделения, информацию о котором нужно получить |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения, Автор или роль с индивидуальными настройками.
Администратор подразделения, Автор или пользователь с ролью с индивидуальными настройками могут получать информацию только о подразделениях, которыми управляют, и их дочерних подразделениях.
Возвращаемые значения
После того , как запрос успешно обработан, система отправляет объект со следующими свойствами:
Параметр | Тип | Описание | |
---|---|---|---|
department | array | Массив, содержащий значения |
’departmentId’, ’name’, ’code’, ’parentDepartmentId’ — ID подразделения, его название, код и родительское подразделение | |||
department_id (обязательный) | string | ID подразделения, о котором вы хотите получить информацию | |
name | string | Название подразделения | |
code | string | Код подразделения | |
parentDepartmentId | string | ID головного подразделения | |
subordination (необязательный) | array | Объект с данными о типе подчинения линейного руководителя подразделения | |
coSubordination (необязательный) | array | Объект с данными о типе подчинения функционального руководителя подразделения | |
subordinationType (обязательный) | string | Тип подчинения линейного и функционального руководителя. Возможные значения:
| |
supervisorId (необязательный) | string | ID руководителя | Указываете, если subordinationType = manual |
- | Если subordinationType = inherit, no_supervisor, указывать не нужно |
Пример запроса
Блок кода | ||
---|---|---|
| ||
<?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> <GetDepartmentRequest> <credentials> <accountUrl>http://myaccount.ispringlearn.ru</accountUrl> <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token> <email>email@email.com</email> </credentials> <password>password</password> </credentials><departmentId>string</departmentId> </GetDepartmentRequest> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
...
Блок кода | ||
---|---|---|
| ||
<SOAP-ENV:Envelope xmlns:SOAP-ENV="httphttps://schemas.xmlsoap.org/soap/envelope/" xmlns="httphttps://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <GetDepartmentResult> <department> <departmentId>string</departmentId> <name>string</name> <description>Description</description> <code>string</code> <parentDepartmentId>string</parentDepartmentId> </department> </GetDepartmentResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
...