Управление пользователями и оргструктурой
CreateOrgUnit
Запись. Блокируется режимом PILOT_READONLY.
Создать организационную единицу. kind: Department (отдел), Position (должность), Group (группа). Требует учётку администратора сервера.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
title |
string |
да | Название | |
kind |
string |
нет | "Position" |
Вид: Department, Position, Group |
parentId |
int |
нет | 0 |
ID родительской оргединицы (0 = корень) |
isBoss |
bool |
нет | false |
Руководящая должность (true/false) |
CreatePerson
Запись. Блокируется режимом PILOT_READONLY.
Создать пользователя базы. Требует учётку администратора сервера (PILOT_ADMIN_LOGIN/PILOT_ADMIN_PASSWORD). Важно: войти в систему новый пользователь сможет только после назначения на должность (SetPersonOnPosition) — иначе сервер отвечает 'Person must hold the position'.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
login |
string |
да | Логин (латиницей, уникальный) | |
displayName |
string |
да | Отображаемое имя | |
password |
string |
да | Пароль | |
isAdmin |
bool |
нет | false |
Администратор базы (true/false) |
email |
string |
нет | "" |
Email (пусто = нет) |
comment |
string |
нет | "" |
Комментарий (пусто = нет) |
DeleteOrgUnit
Запись. Блокируется режимом PILOT_READONLY.
Удалить организационную единицу (пометить IsDeleted). Отклоняется, если есть неудалённые дочерние. Требует учётку администратора сервера.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
unitId |
int |
да | ID оргединицы |
DeletePerson
Запись. Блокируется режимом PILOT_READONLY.
Удалить пользователя (пометить IsDeleted, как это делает myAdmin). Требует учётку администратора сервера.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
login |
string |
да | Логин пользователя |
MoveOrgUnits
Запись. Блокируется режимом PILOT_READONLY.
Переместить организационные единицы к новому родителю. Требует учётку администратора сервера.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
unitIds |
string |
да | ID оргединиц через запятую | |
newParentId |
int |
да | ID новой родительской оргединицы (0 = корень) |
RemovePersonFromPosition
Запись. Блокируется режимом PILOT_READONLY.
Снять пользователя с должности (позиции). Требует учётку администратора сервера.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
positionId |
int |
да | ID оргединицы-должности |
SetPersonOnPosition
Запись. Блокируется режимом PILOT_READONLY.
Назначить пользователя на должность (позицию). Требует учётку администратора сервера.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
positionId |
int |
да | ID оргединицы-должности | |
personId |
int |
да | ID пользователя (personId) |
UpdateOrgUnit
Запись. Блокируется режимом PILOT_READONLY.
Изменить организационную единицу. Пустые параметры не меняются. Требует учётку администратора сервера.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
unitId |
int |
да | ID оргединицы | |
title |
string |
нет | "" |
Новое название (пусто = не менять) |
isBoss |
string |
нет | "" |
Руководящая: true/false (пусто = не менять) |
UpdatePersonAdmin
Запись. Блокируется режимом PILOT_READONLY.
Изменить пользователя через админский API: логин, отображаемое имя, пароль, признак администратора, признак активности. Пустые параметры не меняются. Требует учётку администратора сервера.
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
login |
string |
да | Текущий логин пользователя | |
newLogin |
string |
нет | "" |
Новый логин (пусто = не менять) |
displayName |
string |
нет | "" |
Новое отображаемое имя (пусто = не менять) |
password |
string |
нет | "" |
Новый пароль (пусто = не менять) |
isAdmin |
string |
нет | "" |
Администратор базы: true/false (пусто = не менять) |
isInactive |
string |
нет | "" |
Сделать неактивным: true/false (пусто = не менять) |