访问群体(Audience)是Sharepoint Portal server中个性化特性的重要基础。所以基于基于访问群体对象模型的开发场景必然也很常见。在这里列举了8个比较常用到的功能实现。
按照我对其进行了解的顺序排列:
1、显示访问群体属性
我在访问群体管理页面中创建了好多的访问群体,现在想要编程的方式来看看这些访问群体的属性。
下面的代码显示了一个访问群体的 ID,name, 和 bValid 属性。分别是访问群体的GUID,名称和是否还有效。
PortalSiteportal = topology.PortalSites[ new Uri( " http://server_name " )];
PortalContextcontext = PortalApplication.GetContext(portal);
// 创建一个audiencemanager对象
AudienceManagerAudMgr = new AudienceManager(context);
ArrayListAudienceIDList;
ArrayListAudienceNamelist = 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 (AudienceExceptione)
{}
2、编程创建访问群体
下面的代码创建了一个名为 "Customer Connection"的访问群体。
PortalSiteportal = topology.PortalSites[ new Uri( " http://server_name " )];
PortalContextcontext = PortalApplication.GetContext(portal);
AudienceManagerAudMgr = new AudienceManager(context);
AudienceCollectionac = AudMgr.Audiences;
Audiencea = null ;
string sAudName = " Engineer " ;
string sDescription = " 工程师组 " ;
try
{
a = ac.Create(sAudName,sDescription);
}
catch (AudienceDuplicateNameExceptione) // 如果创建的访问群体名已经存在,将抛出这个异常
{}
catch (AudienceExceptione1)
{}
这个访问群体仅仅是被创建出来了,这时并没有任何的规则与之对应。我们需要为其添加规则并进行收集工作。这里需要注意,收集访问群体只能在Web管理页面中进行,这个操作没有相应的对象模型可以编程。
3、为访问群体添加简单的基于AND 和OR的规则
在Web管理页面中仅仅提供了两个规则的操作项:满足所有规则的用户分组或满足任意规则的用户分组。 而且,当我们使用 Web管理页面时,我们被限制为最多使用6条规则。当然,这在多数情况下已经足够用了。但是我们还是希望可以使用多于6条的规则^_^
这种情况下我们可以通过访问群体对象模型来实现。对象模型允许您在一个访问群体上对应多于6条的规则。当然也不一定非要这种情况下才用到对象模型。我们在上面创建好的访问群体实际上没有对应任何规则,我们可以接着用代码为其添加规则,如此就完美了。
下面的例子用了 “AND”来连接多条规则,当然你也可以改为“OR”了。
PortalSiteportal = topology.PortalSites[ new Uri( " http://server_name " )];
PortalContextcontext = PortalApplication.GetContext(portal);
AudienceManagerAudMgr = new AudienceManager(context);
Audiencea = null ;
bool ruleListNotEmpty = false ;
try
{
a = AudMgr.Audiences[ " Engineer " ];
}
catch (AudienceArgumentExceptionex)
{}
ArrayListaRules = 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 ));
}
AudienceRuleComponentr1 = new AudienceRuleComponent( " FirstName " , " Contains " , " a " );
aRules.Add(r1);
AudienceRuleComponentr2 = new AudienceRuleComponent( null , " AND " , null );
aRules.Add(r2);
AudienceRuleComponentr3 = new AudienceRuleComponent( " WorkEmail " , " Contains " , " DepA.com " );
aRules.Add(r3);
a.AudienceRules = aRules;
a.Commit();
}
catch (AudienceExceptione)
{}
注意:如果使用 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',即用户) |