现在的位置: 首页 > 综合 > 正文

浅谈Sharepoint权限

2012年11月07日 ⁄ 综合 ⁄ 共 6356字 ⁄ 字号 评论关闭

基于Sharepoint做一个客户管理的系统,由于客户方对权限的要求非常严格,所以不得不自己去定义网站的权限,好在Sharepoint提供的权限系统比较完善,我们所创建的权限包括从创建SPWeb到创建SPListItem均实现了一遍,也算是顺利的解决了问题。项目做到第一阶段,谈谈自己的一些认识。

 

在开始之前先明确几个类或者定义:

Sharepoint权限系统采用 权限——角色 ——对象——关联 的概念,即:对于一个对象(如:SPWeb,SPList,SPListItem),可以通过添加某个已经包含了角色(SPRoleDefinition)的关联(SPRoleAssignment)而更改该对象的权限,而角色(SPRoleDefinition)则是提前通过SPWeb.RoleDefinitions添加到网站内的,注意:只有SPWeb有此属性可以添加角色定义,其他对象如SPSiteSPListSPListItem均不能添加角色定义,当然他们也不需要。

 

相关类:

 

用户或用户组:SPPrincipal 扩展了两个子类:SPUserSPGroup

权限基类:SPBasePermissions,通过或计算合成一个自定义的权限,注意:需要编辑权限的前提是有查看权限;

角色类:SPRoleDefinition,采用web.RoleDefinitions.Add(definition)的方式添加角色;

关联类:对于某个SPPrincipal添加一个SPRoleDefinition的角色,然后再将该关联添加到对象上去,注意:在未将该关联添加到对象上时,该关联都无效。

 

首先定义自己的权限系统,我定义了四个级别的角色,本别具有权限:查看、新建、编辑、删除,这四个权限要远低于Sharepoint本身的权限,这里以新建角色为例说明: 同时定义了负责向网站添加角色Register类,每一个角色都会对应一个Register类,是为了方便权限的扩展,采用依赖倒置。

为对象分配权限:参数SPListItem 也可以是 SPWebSPList,权限的分配一般是在对象刚刚创建后来实现,如

SPWebTemplate template = web.Site.GetCustomWebTemplates((uint)web.Locale.LCID)[WebTemplate];

SPWeb newWeb = RootSPWeb.Webs.Add(rurl, customerName, string.Empty, (uint)2052, template, true, false);

此时就应该对该newWeb做权限操作。而SPListItem的操作一般是在SPItemEventReceiver的ItemAdded事件中去实现

Code:

private void RoleAssignment(SPListItem item, SPPrincipal groupOrUser, SPRoleDefinition role)
        {
        
if (!item.HasUniqueRoleAssignments)
        {
            item.BreakRoleInheritance(
true);//true则断开并继承原有权限,false则断开不继承原有权限
        }
        
            
            
this.DisableEventFiring();

            item.Web.AllowUnsafeUpdates = true;

            SPRoleAssignment assignment = new SPRoleAssignment(groupOrUser);
            assignment.RoleDefinitionBindings.Add(role);
            item.RoleAssignments.Add(assignment);

            item.Update();

            this.EnableEventFiring();
        }

 Code:

//角色基类:实际上基类提供了查看的权限,因此在查看中不需要扩展
public abstract class BasePermissionRole
    {
        
private string roleName;
        
public virtual string RoleName
        {
            
get
            {
                
return roleName;
            }
            
set
            {
                roleName 
= value;
            }
        }

        private string roleDescription;
        
public virtual string RoleDescription
        {
            
get
            {
                
return roleDescription;
            }
            
set
            {
                roleDescription 
= value;
            }
        }

        public abstract SPBasePermissions ComposePermission();

        protected virtual SPBasePermissions ComposeViewPermission()
        {
        
//对应Sharepoint下的34个基本权限
            return SPBasePermissions.ViewListItems | SPBasePermissions.ViewVersions |
                   SPBasePermissions.ViewFormPages 
| SPBasePermissions.ViewPages |
                   SPBasePermissions.OpenItems 
| SPBasePermissions.CreateAlerts |
                   SPBasePermissions.BrowseUserInfo 
| SPBasePermissions.UseRemoteAPIs |
                   SPBasePermissions.UseClientIntegration 
| SPBasePermissions.Open;
        }

        public abstract BaseRoleRegister CreateRegister();//通过依赖倒置以及单件实现角色注册
    }
//新建角色,override基类的ComposePermission()方法,并在View的基础上扩展
public class AddPermissionRole : BasePermissionRole
    {
        
public AddPermissionRole()
        {
            
this.RoleName = "新建"
            
this.RoleDescription = "向列表中添加项目,向文档库中添加文档,以及添加 Web 讨论评论";
        }

        public override string RoleName
        {
            
get
            {
                
return base.RoleName;
            }
            
set
            {
                
base.RoleName = value;
            }
        }

        public override SPBasePermissions ComposePermission()
        {
            
return base.ComposeViewPermission() | SPBasePermissions.AddListItems;
        }

        public override BaseRoleRegister CreateRegister()
        {
            
return new AddRoleRegister(this);
        }
    }

//注册基类:
public class BaseRoleRegister
    {
        
public BaseRoleRegister(BasePermissionRole role)
        {
            
this.Permission = role;
        }

        protected BasePermissionRole Permission;

        public virtual SPRoleDefinition ExecuteRegister(SPWeb web)
        {
            
foreach (SPRoleDefinition rd in web.RoleDefinitions)
            {
                
if (rd.Name == this.Permission.RoleName)
                    
return rd;
            }

            SPRoleDefinition definition = new SPRoleDefinition();
            definition.Name 
= this.Permission.RoleName;
            definition.BasePermissions 
= this.Permission.ComposePermission();
            definition.Description 
= this.Permission.RoleDescription;

            web.RoleDefinitions.BreakInheritance(truetrue);
            web.RoleDefinitions.Add(definition);
            web.Update();

            return web.RoleDefinitions[this.Permission.RoleName];
        }
    }

//新建角色的注册类:
public class ApproveRoleRegister : BaseRoleRegister
    {
        
public ApproveRoleRegister(BasePermissionRole role)
            : 
base(role)
        { }

    }

基础权限列表:

 

ViewListItems

查看项目  -  查看列表中的项目、文档库中的文档和查看 Web 讨论评论。

OpenItems

打开项目  -  使用服务器端文件处理程序查看文档源。

ViewVersions

查看版本  -  查看列表项或文档的以前版本。

CreateAlerts

创建通知  -  创建电子邮件通知。

ViewFormPages

查看应用程序页面  -  查看表单、视图和应用程序页面。枚举列表。

ViewPages

查看网页  -  查看网站中的网页。

BrowseUserInfo

浏览用户信息  -  查看有关网站用户的信息。

UseRemoteAPIs

使用远程接口  -  使用 SOAPWeb DAV SharePoint Designer 接口访问网站。

UseClientIntegration

使用客户端集成功能  -  使用启动客户端应用程序的功能。如果没有此权限,用户必须本地处理文档并上载更改。

Open

打开  -  允许用户打开网站、列表或文件夹,以便访问该容器中的项目。

 

 

 

 

 

 

ManageLists

管理列表  -  创建和删除列表,添加或删除列表中的栏,以及添加或删除列表的公共视图。

CancelCheckout

替代签出版本  -  放弃或签入已由其他用户签出的文档。

AddListItems

添加项目  -  向列表中添加项目,向文档库中添加文档,以及添加 Web 讨论评论。

EditListItems

编辑项目  -  编辑列表中的项目、文档库中的文档、文档中的 Web 讨论评论以及自定义文档库中的 Web 部件页。

DeleteListItems

删除项目  -  从列表中删除项目、从文档库中删除文档,以及删除文档中的 Web 讨论评论。

ApproveItems

批准项目  -  批准列表项或文档的次要版本。

DeleteVersions

删除版本  -  删除列表项或文档的以前版本。

ManagePermissions

管理权限  -  创建和更改网站上的权限级别,并为用户和用户组分配权限。

ViewUsageData

查看使用率数据  -  查看有关网站使用率的报告。

ManageSubwebs

创建子网站  -  创建子网站,例如工作组网站、会议工作区网站和文档工作区网站。

ManageWeb

管理网站  -  授予执行该网站的所有管理任务并管理内容的能力。

AddAndCustomizePages

添加和自定义网页  -  添加、更改或删除 HTML 网页或 Web 部件页,并使用与 Windows SharePoint Services 兼容的编辑器编辑网站。

ApplyThemeAndBorder

应用主题和边框  -  将主题或边框应用于整个网站。

ApplyStyleSheets

应用样式表  -  将样式表(.CSS 文件)应用于网站。

CreateGroups

创建用户组  -  创建一个用户组,该用户组可用于网站集中的任何位置。

BrowseDirectories

浏览目录  -  使用 SharePoint Designer Web DAV 接口枚举网站中的文件和文件夹。

EnumeratePermissions

枚举权限  -  枚举网站、列表、文件夹、文档或列表项中的权限。

ManageAlerts

管理通知  -  管理网站中所有用户的通知。

EditMyUserInfo

编辑个人用户信息  -  允许用户更改个人用户信息,例如添加图片。

ManagePersonalViews

管理个人视图  -  创建、更改和删除列表的个人视图。

AddDelPrivateWebParts

添加/删除个人 Web 部件  -  Web 部件页中添加或删除个人 Web 部件。

UpdatePersonalWebParts

更新个人 Web 部件  -  更新 Web 部件以显示个性化信息

 

抱歉!评论已关闭.