Управление сотрудниками организации - Synerdocs/synerdocs-sdk GitHub Wiki

Сотрудник - это сущность сервиса, которая отражает права пользователя на доступ к организации и ее подразделениям. При этом пользователь это сущность, которая отражает реального человека. Сущность сотрудник была введена для обеспечения возможность работы одного пользователя от имени нескольких организаций, т.е. один пользователь может быть сотрудником одной или нескольких организаций.

Основными возможности по управлению сотрудниками организации:

• получение текущего списка сотрудников организации возможно с помощью метода SearchEmployees. Также данный метод позволяет производить поиск сотрудников по некоторым критериям, которые представлены в перечислении EmployeeFilterFieldNameList. Критерии поиска могут быть объединены по условиям И или ИЛИ;
• для получения сведений по конкретному сотруднику организации предусмотрен метод GetEmployee. При этом получение информации о пользователе реализовано за счет метода GetUserInfo;
• добавление нового сотрудника возможно с помощью метода CreateUserAndEmployee, при этом также будет создан новый пользователь сервиса. Добавить нового сотрудника в организацию может только сотрудник с правами администратора. По умолчанию, новому сотруднику организации присваиваются права доступа к головному подразделению организации;
• изменение реквизитов сотрудника возможно с помощью с метода UpdateEmployeePersonalInfo. Стоит обратить внимание, что изменение реквизитов фактически происходит для пользователя, т.е. изменённые реквизиты будут применены и для других организаций, в которых пользователь является сотрудником. Любой сотрудник организации может обновить свои реквизиты. Только сотрудник с правами администратора организации может изменить реквизиты для любого сотрудника организации;
• изменение настроек пользователя производится с помощью метода UpdateSetting. Сотрудник с правами администратора может изменить настройки для любого сотрудника организации;
• обновление пароля пользователя возможно с помощью метода UpdatePassword, при этом только пользователь может изменить свой пароль;
• добавление или обновление сертификата сотрудника организации возможно с помощью метода UpdateEmployeeCertificate, а удаление сертификата сотрудника возможно с помощью метода DeleteEmployeeCertificate. Замена сертификата на новый не требует предварительного удаления сертификата. Сертификат связывается с сотрудником, в том числе отражая права сотрудника на подписание документов от имени организации. Любой сотрудник организации может обновить или удалить только свой сертификат. Только сотрудник с правами администратора организации может изменить сертификат или удалить для любого сотрудника организации;
• удаление сотрудника из организации, например, в случае его увольнения, возможно с помощью метода DeleteEmployee. Для удаления сотрудника необходимо наличие прав администратора организации, из которой удаляется сотрудник;
• изменить наличие прав администратора организации у сотрудника возможно с помощью метода UpdateEmployeeAdministratorAuthority. При этом пользователь, который вызывает этот метод должен обладать правами администратора сервиса. В организации всегда должен быть хотя бы один сотрудник с правами организации.