Включить страницу | ||||
---|---|---|---|---|
|
Метод: 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> <GetOrganizationsRequest><GetDepartmentRequest> <credentials> <accountUrl>http://myaccount.ispringonline.ru</accountUrl> <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token> <email>email@email.com</email> </credentials> <password>password<<departmentId>string</password>departmentId> </credentials> </GetOrganizationsRequest>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> <GetOrganizationsResult><GetDepartmentResult> <organization><department> <organizationId>1<<departmentId>string</organizationId>departmentId> <name>Name<<name>string</name> <description>Description</description> </organization><code>string</code> <organization> ...<parentDepartmentId>string</parentDepartmentId> </organization>department> </GetOrganizationsResult>GetDepartmentResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
...