====== Класс Permissions ======

Данный класс предоставляет возможности программного управления пользователями, группами пользователей и правами доступа.

=====Методы=====

==== AddChildGroupToParentGroup ====
<code csharp>
public void AddChildGroupToParentGroup(int parent_group_id, int child_group_id)
</code>

Задает для группы c идентификатором //child_group_id// родительскую группу с идентификатором //parent_group_id//. 

====AddGroup====
<code csharp>
public int AddGroup(string name)
public int AddGroup(string name, bool AllowSharedOwnershipOfItem)
</code>

Метод создает новую группу с именем //name// и возвращает ее идентификатор. 

Флаг //AllowSharedOwnershipOfItem// позволяет установить опцию **Совместное использование статей** в [[:user_group|свойствах группы]]. Значение по умолчанию - //false//.

==== AddGroupToContentPermission ====
<code csharp>
public void AddGroupToContentPermission(int groupId, int contentId, int permissionId)
public void AddGroupToContentPermission(int groupId, int contentId, int permissionId, bool propagateToItems) 
</code>

Задает (обновляет) права доступа для группы пользователей на заданный контент. Параметр //propagateToItems// означает, что эти права доступа также будут применяться к новым статьям, создаваемым в данном контенте.

==== AddGroupToItemPermission ====
<code csharp>
public void AddGroupToItemPermission(int groupId, int itemId, int permissionId) 
</code>
Задает (обновляет) права доступа для группы пользователей на заданную статью.

====AddUser====
<code csharp>
public int AddUser(string username, string password, string First_Name, string Last_Name, string Email) 
</code>
Метод создает нового пользователя и возвращает его идентификатор. 

==== AddUserToContentPermission ====
<code csharp>
public void AddUserToContentPermission(int userId, int contentId, int permissionId)
public void AddUserToContentPermission(int userId, int contentId, int permissionId, bool propagateToItems) 
</code>
Задает (обновляет) права доступа для пользователя на заданный контент. Параметр //propagateToItems// означает, что эти права доступа также будут применяться к новым статьям, создаваемым в данном контенте

==== AddUserToGroup ====
<code csharp>
public void AddUserToGroup(int userId, int groupId)
</code>
Выполняет привязку пользователя к группе.

==== AddUserToItemPermission ====
<code csharp>
public void AddUserToItemPermission(int userId, int itemId, int permissionId)
</code>
Задает (обновляет) права доступа для пользователя на заданную статью.

====AuthenticateUser====
<code csharp>
public int AuthenticateUser(string username, string password)
</code>
Производит попытку аутентификации пользователя в соответствии с заданными параметрами. Возвращает идентификатор пользователя при успешной аутентификации, либо 0 -- при неуспешной.

==== CopyUsersFromGroupToGroup ====
<code csharp>
public void CopyUsersFromGroupToGroup(int fromGroupId, int toGroupId)
</code>
Копирует пользователей из группы //fromGroupId// в группу //toGroupId//. Копируются только отсутствующие пользователи.

==== GetAllGroups ====
<code csharp>
public DataTable GetAllGroups() 
</code>
Возвращает все группы пользователей. Возвращаемые поля: group_id, group_name, created, modified.

==== GetAllGroupsForContentPermission ====
<code csharp>
public DataTable GetAllGroupsForContentPermission(int contentId)
</code>
Возвращает все группы пользователей, для которых явно настроены права доступа на заданный контент. Возвращаемые поля: group_id, group_name, created, modified.    

==== GetAllGroupsForItemPermission ====
<code csharp>
public DataTable GetAllGroupsForItemPermission(int itemId)
</code>
Возвращает все группы пользователей, для которых явно настроены права доступа на заданную статью. Возвращаемые поля: group_id, group_name, created, modified.      

==== GetAllUsersForItemPermission ====
<code csharp>
public DataTable GetAllUsersForItemPermission(int itemId)
</code>
Возвращает всех пользователей, для которых явно настроены права доступа на заданную статью. Возвращаемые поля: user_id, login, password, disabled, first_name, last_name, email, created, modified.

==== GetAllUsersForContentPermission ====
<code csharp>
public DataTable GetAllUsersForContentPermission(int contentId)
</code>
Возвращает всех пользователей, для которых явно настроены права доступа на заданный контент. Возвращаемые поля: user_id, login, password, disabled, first_name, last_name, email, created, modified.

==== GetChildParentGroups ====
<code csharp>
public DataTable GetChildParentGroups()
</code>
Возвращает список групп с информацией о родителе. Возвращаемые поля: child_group_id, child_group_name, parent_group_id, parent_group_name.

====GetGroupInfo====
<code csharp>
public DataTable GetGroupInfo(int group_id)
public DataTable GetGroupInfo(string group_name)
</code>
Возвращает информацию о выбранной группе по идентификатору или имени. Возвращаемые поля: group_id, group_name, created, modified.          

==== GetPermissionLevels ====
<code csharp>
public DataTable GetPermissionLevels()
</code>
Возвращает информацию об уровнях доступа. Возвращаемые поля: permission_level_id, permission_level, permission_level_name

==== GetRootGroupsForUser ====
<code csharp>
public DataTable GetRootGroupsForUser(int user_id)
</code>

Для заданного пользователя возвращается список групп, в которые он входит явно. Возвращаемые поля: group_id.
    
====GetUserInfo====
<code csharp>
public DataTable GetUserInfo(int user_id)
public DataTable GetUserInfo(string login) 
</code>
Возвращает информацию о выбранном пользователе по идентификатору или имени. Возвращаемые поля: user_id, login, password, disabled, first_name, last_name, email, created, modified.

==== GetUsersForGroup ====
<code csharp>
public DataTable GetUsersForGroup(int group_id)
</code>
Возвращает список пользователей, явно входящих в группу. Возвращаемые поля: user_id, login, password, disabled, first_name, last_name, email, created, modified.

==== MoveUsersFromGroupToGroup ====
<code csharp>
public void MoveUsersFromGroupToGroup(int fromGroupId, int toGroupId)
</code>
Перемещает пользователей из группы //fromGroupId// в группу //toGroupId//. 

==== RemoveAllEntitiesFromContentPermission ====
<code csharp>
public void RemoveAllEntitiesFromContentPermission(int contentId)
</code>
Удаляет все права доступа, явно определенные для данного контента.

==== RemoveAllEntitiesFromItemPermission ====
<code csharp>
public void RemoveAllEntitiesFromItemPermission(int itemId)
</code>
Удаляет все права доступа, явно определенные для данной статьи.

==== RemoveAllGroupsFromContentPermission ====
<code csharp>
public void RemoveAllGroupsFromContentPermission(int contentId)
</code>
Удаляет все права доступа групп пользователей, явно определенные для данного контента.

==== RemoveAllGroupsFromItemPermission ====
<code сsharp>
public void RemoveAllGroupsFromItemPermission(int itemId)
</code>
Удаляет все права доступа групп пользователей, явно определенные для данной статьи.

==== RemoveAllUsersFromContentPermission ====
<code csharp>
public void RemoveAllUsersFromContentPermission(int contentId)
</code>
Удаляет все права доступа пользователей, явно определенные для данного контента.

==== RemoveAllUsersFromItemPermission ====
<code csharp>
public void RemoveAllUsersFromItemPermission(int itemId)
</code>
Удаляет все права доступа пользователей, явно определенные для данной статьи.


==== RemoveChildGroupFromParentGroup ====
<code csharp>
public void RemoveChildGroupFromParentGroup(int parent_group_id, int child_group_id) 
</code>
Удаляет связь родитель-потомок для заданной родительской и дочерней групп.

==== RemoveGroup ====
<code csharp>
public void RemoveGroup(int groupId) 
</code>
Удаляет группу пользователей из системы

==== RemoveGroupFromContentPermission ====
<code csharp>
public void RemoveGroupFromContentPermission(int groupId, int contentId)
</code>
Удаляет явно определенные права доступа группы пользователей на данный контент.

==== RemoveGroupFromItemPermission ====
<code csharp>
public void RemoveGroupFromItemPermission(int groupId, int itemId)
</code>
Удаляет явно определенные права доступа группы пользователей на данную статью.

====RemoveUser====
<code csharp>
bool RemoveUser(int userId)
</code>
Удаляет пользователя из системы

==== RemoveUserFromContentPermission ====
<code csharp>
public void RemoveUserFromContentPermission(int userId, int contentId) 
</code>
Удаляет явно определенные права доступа пользователя на данный контент.

==== RemoveUserFromItemPermission ====
<code csharp>
public void RemoveUserFromItemPermission(int userId, int itemId)
</code>
Удаляет явно определенные права доступа пользователя на данную статью.

==== RemoveUserFromGroup ====
<code csharp>
public void RemoveUserFromGroup(int userId, int groupId)
</code>
Удаляет привязку пользователя к группе

====UpdateGroup====
<code csharp>
public void UpdateGroup(int groupId, string newName)
public void UpdateGroup(int groupId, string newName, bool AllowSharedOwnershipOfItems)
</code>
Обновляет информацию о группе с заданным идентификатором.

==== UpdateGroupContentPermission ====
<code csharp>
public void UpdateGroupContentPermission(int groupId, int contentId, int permissionId)
public void UpdateGroupContentPermission(int groupId, int contentId, int permissionId, bool propagateToItems)
</code>           
Обновляет явно определенные права доступа группы пользователей на данный контент.

==== UpdateGroupItemPermission ====
<code csharp>
public void UpdateGroupItemPermission(int groupId, int itemId, int permissionId)
</code>               
            
Обновляет явно определенные права доступа группы пользователей на данную статью.

====UpdateUser====
<code csharp>
public void UpdateUser(int userId, string newUserName, string newPassword, string newFirst_Name, string newLast_Name, string newEmail)
</code>   
Обновляет информацию о пользователе с заданным идентификатором.

==== UpdateUserContentPermission ====
<code csharp>
public void UpdateUserContentPermission(int userId, int contentId, int permissionId, bool propagateToItems)
</code>               
Обновляет явно определенные права доступа пользователя на данный контент.

====UpdateUserItemPermission ====
<code csharp>
public void UpdateUserItemPermission(int userId, int itemId, int permissionId)
</code>            
Обновляет явно определенные права доступа пользователя на данную статью.