SharePoint高级内容--访问群体对象模型的开发之一
发布日期:2021-06-29 03:55:12 浏览次数:2 分类:技术文章

本文共 3652 字,大约阅读时间需要 12 分钟。

访问群体(Audience)是Sharepoint Portal server中个性化特性的重要基础。所以基于基于访问群体对象模型的开发场景必然也很常见。在这里列举了8个比较常用到的功能实现。

按照我对其进行了解的顺序排列:
1、显示访问群体属性

我在访问群体管理页面中创建了好多的访问群体,现在想要编程的方式来看看这些访问群体的属性。

下面的代码显示了一个访问群体的 ID,name, 和 bValid 属性。分别是访问群体的GUID,名称和是否还有效。

TopologyManager topology 
=
 
new
 TopologyManager();
PortalSite portal 
=
 topology.PortalSites[
new
 Uri(
"
http://server_name
"
)];
PortalContext context 
=
 PortalApplication.GetContext(portal);
//
创建一个 audience manager对象
AudienceManager AudMgr 
=
 
new
 AudienceManager(context);
ArrayList AudienceIDList;
ArrayList AudienceNamelist 
=
 
new
 ArrayList();
AudienceNamelist.Add(
"
Engineer
"
);
try
{
   AudienceIDList 
=
 AudMgr.GetAudienceIDs(AudienceNamelist);
   
if
 (AudienceIDList 
!=
 
null
)
   {
       
for
 (
int
 i
=
0
; i 
<
 AudienceIDList.Count; i
++
)
       {
          Console.WriteLine(((AudienceNameID)AudienceIDList[i]).AudienceID.ToString());
          Console.WriteLine(((AudienceNameID)AudienceIDList[i]).AudienceName);
           Console.WriteLine(((AudienceNameID)AudienceIDList[i]).bValid.ToString());
       }
    }
}
catch
(AudienceException e)
{}

2、编程创建访问群体

 

下面的代码创建了一个名为 "Customer Connection"的访问群体。

TopologyManager topology 
=
 
new
 TopologyManager();
PortalSite portal 
=
 topology.PortalSites[
new
 Uri(
"
http://server_name
"
)];
PortalContext context 
=
 PortalApplication.GetContext(portal);
AudienceManager AudMgr 
=
 
new
 AudienceManager(context);
AudienceCollection ac 
=
 AudMgr.Audiences;
Audience a 
=
 
null
;
string
 sAudName 
=
 
"
Engineer
"
;
string
 sDescription 
=
 
"
工程师组
"
;
try
{
   a 
=
 ac.Create( sAudName, sDescription );
}
catch
(AudienceDuplicateNameException e)  
//
如果创建的访问群体名已经存在,将抛出这个异常
{}
catch
(AudienceException e1)
{}

这个访问群体仅仅是被创建出来了,这时并没有任何的规则与之对应。我们需要为其添加规则并进行收集工作。这里需要注意,收集访问群体只能在Web管理页面中进行,这个操作没有相应的对象模型可以编程。

3、为访问群体添加简单的基于AND 和OR的规则

在Web管理页面中仅仅提供了两个规则的操作项:满足所有规则的用户分组或满足任意规则的用户分组。 而且,当我们使用 Web管理页面时,我们被限制为最多使用6条规则。当然,这在多数情况下已经足够用了。但是我们还是希望可以使用多于6条的规则^_^

 
这种情况下我们可以通过访问群体对象模型来实现。对象模型允许您在一个访问群体上对应多于6条的规则。当然也不一定非要这种情况下才用到对象模型。我们在上面创建好的访问群体实际上没有对应任何规则,我们可以接着用代码为其添加规则,如此就完美了。

 下面的例子用了 “AND”来连接多条规则,当然你也可以改为“OR”了。

TopologyManager topology 
=
 
new
 TopologyManager();
PortalSite portal 
=
 topology.PortalSites[
new
 Uri(
"
http://server_name
"
)];
PortalContext context 
=
 PortalApplication.GetContext(portal);
AudienceManager AudMgr 
=
 
new
 AudienceManager(context);
Audience a 
=
 
null
;
bool
 ruleListNotEmpty 
=
 
false
;
try
{
   a 
=
 AudMgr.Audiences[
"
Engineer
"
];
}
catch
(AudienceArgumentException  ex)
{}
ArrayList aRules 
=
 a.AudienceRules;
if
( aRules 
==
 
null
 )
{
  aRules 
=
 
new
 ArrayList();
}
else
{
      ruleListNotEmpty 
=
 
true
;
}
//
Audience的规则AudienceRules这个ArrayList里面,实际上放着Microsoft.SharePoint.Portal.Audience.AudienceRuleComponent对象。
//
这个对象包括了规则的描述:操作符和值。格式是三个字符串,分别对应操作数,操作符和值。
try
{
 
//
如果已经有规则了,那么已一个组操作符'AND'开始扩展
  
if
 (ruleListNotEmpty)
  {
        aRules.Add(
new
 AudienceRuleComponent(
null
"
AND
"
null
));
  }
  AudienceRuleComponent r1 
=
 
new
 AudienceRuleComponent(
"
FirstName
"
"
Contains
"
,  
"
a
"
);
  aRules.Add(r1);
  AudienceRuleComponent r2 
=
 
new
 AudienceRuleComponent(
null
"
AND
"
,  
null
);
  aRules.Add(r2);
  AudienceRuleComponent r3 
=
 
new
 AudienceRuleComponent(
"
WorkEmail
"
"
Contains
"
,  
"
DepA.com
"
);
  aRules.Add(r3);
  a.AudienceRules 
=
 aRules;
  a.Commit();
}
catch
(AudienceException e)
{}

 

注意:如果使用 Audience.AudienceRules.Add 增加一条规则,然后调用 Audience类的 Commit 方法并不能保存这条新规则。 我们必须在调用 Commit方法前设置AudienceRules属性。避免这样做的另一个方法就是创建一个新的规则 ArrayList,然后让 Audience.AudienceRules =新的规则的ArrayList。原因大家估计已经可以猜到了。是的,只有指定这个属性值的方式才能告诉Commit这个访问群体的规则变化了。(迟 钝!)

下面是 AudienceRuleComponent 对象中支持的操作符:

 

操作符

需要左右两个操作数 (并非针对一个组的操作)

=

Yes

Yes

>=

Yes

Yes

<=

Yes

Contains

Yes

Reports Under

Yes (左边操作数必须为 'Everyone',即所有用户)

<> 

Yes

Not Contains

Yes

AND

No

OR

No

(

No

)

No

Member Of

Yes (左边操作数必须为 'DL',即用户)

转载地址:https://blog.csdn.net/zengjibing/article/details/3816011 如侵犯您的版权,请留言回复原文章的地址,我们会给您删除此文章,给您带来不便请您谅解!

上一篇:WSS3SDK之:使用Feature
下一篇:SharePoint高级内容--访问群体对象模型的开发之二

发表评论

最新留言

很好
[***.229.124.182]2024年04月21日 06时57分18秒

关于作者

    喝酒易醉,品茶养心,人生如梦,品茶悟道,何以解忧?唯有杜康!
-- 愿君每日到此一游!

推荐文章