SharePoint中如何使得用户不能通过对WSS的List中添加或修改使得某个指定字段存在重复数据。并需要尽可能满足以下需求:
1) 希望解决方案比较简单,并且易于部署(客户希望在30分钟内能完成部署)
2) 希望在部署过程中不需要重新编译任何工程
3) 有一定的通用性,不能针对一个特定的List开发一个组件
---------------------------------------------------------------
目前研究的结果:
研究结果及解决方案(以新建记录为例)
==================
系统实现思路
=======
由于所涉及的步骤牵涉修改WSS默认的模板和JavaScript代码,所以请在测试环境中完成下述步骤并备份相关信息。
1. 当用户新建记录、提交表单时,WSS会首先调用ClickOnce()函数(请在新建记录页面点击右键,查看HTML源文件),然而,ClickOnce()并不存在NewForm.aspx文件中,而是在相应List模板的SCHEMA.XML中(如,我们使用Customized List,List模板的路径是C:\Program Files\Common Files\Microsoft Shared\web server extensions\60\TEMPLATE\1033\STS\LISTS\CUSTLIST)且所有WSS List都会调用OWS.JS文件,引用其中的JavaScript。表单会提交到/_vti_bin/owssvr.dll上,最终插入数据库。这是默认的表单提交过程。
2. 为了在期间加入定制的代码,检查是否会产生重复数据。我们可以采取以下几种通讯方式:
a) 在SCHEMA.XML中拦截 ClickOnce()函数,使用Microsoft.XMLHTTP对象向Server端的ASPX页发送POST请求,并接收Server端的回传数据,SCHEMA.XML的作用域是一个特定的List。在本样例中,我们选用这种方式
b) 由于在提交表单的流程中,SCHEMA.XML中定义的ClickOnce()函数最终会调用OWS.JS中的程序段,虽然,我们可以在OWS.JS的有关函数中拦截默认的提交流程,并向Server端发送请求,但是,我们不推荐这种方式,因为修改OWS.JS可能影响到多个List。只有在特定的条件下,才使用这种全局的方式,并且希望您进行全面的测试。
c) 前两种方式是在客户端向服务端发送请求,进行验证,如果需要全部PostBack回服务器端进行认证,请使用FrontPage 2003,打开NewForm.aspx,在输入WebPart上点右键,并选择“Customized SharePoint List Form”菜单项,将输入WebPart转换为表格模式,如下所示:
此时我们可以使用传统ASP.NET窗体的方式,在上面添加自定义的输入栏位和提交按钮,并可以提交到特定的后台页面。这种方式需要对每个List的NewForm.ASPX分别处理。
3. 服务器端是一个ASP.NET页面,它将接收ListID(List的Guid)和FieldValue(需要字段填充值),ASP.NET页面会读取一个XML配置文件,并比对其中的ListID,用以决定是否需要对本List进行验证(针对多个List的通用解决方案)。如果需要验证,则从XML配置中读取需要验证的字段名称等信息,并进行查询。无论成功与否ASP.NET页面会将返回信息回写到客户端。
4. 客户端的Microsoft.XMLHTTP对象获得回写的字符串后进行必要的解析,并决定相应的流程。
具体实现步骤
=======
1. 本样例中将使用Customized List模板为例,在C:\Program Files\Common Files\Microsoft Shared\web server extensions\60\TEMPLATE\1033\STS\LISTS目录中复制CUSTLIST目录,并命名位LIANGMING
2. 打开上层目录下的XML目录(C:\Program Files\Common Files\Microsoft Shared\web server extensions\60\TEMPLATE\1033\STS\XML)中的ONET.XML,并找到<ListTemplates>片段,插入如下黑斜体部分,将Type设为小于1000,且和当前List的Type字段没有重复的数值,并保持Name域的信息和复制的目录名称相同。
<ListTemplates>
<ListTemplate Name="custlist" DisplayName="Custom List" Type="100" BaseType="0" OnQuickLaunch="TRUE" SecurityBits="11" Description="Create a custom list when you want to specify your own columns. The list opens as a Web page and lets you add or edit items one at a time." Image="/_layouts/images/itgen.gif"></ListTemplate>
<ListTemplate Name="LIANGMING" DisplayName="Liang Ming Customized List" Type="500" BaseType="0" OnQuickLaunch="TRUE" SecurityBits="11" Description="LIANG MING" Image="/_layouts/images/itgen.gif"></ListTemplate>
3. 在命令窗口中调用IISReset,重启IIS服务
4. 在新建List页面(任何对List模板的修改,必须新建一个List才可以看到结果)我们会发现有个LIANGMING的List模板
5. 打开List模板目录下的SCHEMA.XML,添加如下代码:
function CheckField()
{
var fldValue;
for(i=0;i<frm.form.elements.length;i++)
{
//查找特定字段的值(需要检查的值),此处使用title属性,可根据实际情况修改
if(frm.form.elements[i].title == "Employee ID"){
fldValue = frm.form.elements[i].value;
break;
}
}
//默认List的GUID存放在Hidden的onetidIOHidden字段中
var lstId = document.getElementById("onetidIOHidden");
//使用Microsoft.XMLHTTP向服务端的页面发送请求
var xmlhttp = new ActiveXObject("Microsoft.XMLHTTP");
xmlhttp.Open("POST","/_layouts/CheckField/DoCheck.aspx?ListID=" + lstId.value + "&FieldValue=" + fldValue,false);
xmlhttp.send();
//获取返回信息
var resp = new String(xmlhttp.responseText);
//如果返回信息包含表示错误的标签则改变程序流程
if(resp.indexOf("</ERROR>") > 0)
return false;
else
return true;
}
function ClickOnce()
{
//开启点击保存按钮后的debug选项,仅仅供调试使用
//请在正式环境中注释此行
debugger;
//验证失败
if(! CheckField())
{
alert("Please check the duplicated data");
return;
}
SetAction();
if(!g_MSclicked)
……
6. 在命令窗口中调用IISReset,重启IIS服务。并新建一个List,添加Employee ID字段(和JavaScript中获取的字段名一致),在NewForm.aspx页面中查看源程序,检查是否有上述代码?如果以上步骤没有成功,请及时与我联系。
7. 将服务器端程序部署到C:\Program Files\Common Files\Microsoft Shared\web server extensions\60\TEMPLATE\LAYOUTS目录中(对应/_layouts/虚拟目录)并建立应用程序。访问GetListGuid.aspx页面,获取特定List的GUID,按照样例代码配置ListConfig.xml文件。在浏览器中传入ListID和FieldValue值,测试ASP.NET页面是否正常工作。
8. 服务端的页面需要获取SharePoint中Site,Web等对象,可能出现权限问题,请自行参考SharePoint SDK中的权限提升(Impersonate)方法,并加以实施。请详见样例代码。
9. 浏览新建记录页面,测试,并且可以激活IE的客户端debug,跟踪JavaScript的执行
补充文档
=======
http://msdn.microsoft.com/library/en-us/spsdk11/CAML_Schema/spxmlconexample8.asp?frame=true Example 8 — Creating a new template for custom lists
http://msdn.microsoft.com/library/en-us/spptsdk/html/tsptDocLibEvents.asp?frame=true Impersonate Source Code
文件列表
=======
Server端ASP.NET工程
1. DoCheck.aspx 检查重复记录
2. GetListGuid.aspx 显示List的Guid,帮助设置配置文件
3. ListConfig.xml配置文件
客户端
1. SCHEMA.XML经过修改的List模板文件
2. LIANGMING文件夹,定制的列表模板(C:\Program Files\Common Files\Microsoft Shared\web server extensions\60\TEMPLATE\1033\STS\LISTS\LIANGMING)
3. ONET.XML List模板配置文件C:\Program Files\Common Files\Microsoft Shared\web server extensions\60\TEMPLATE\1033\STS\XML
4. Process.vsd 上述流程的示意图
测试结果如下截图所示
===========
a) <List ListID="{1acc9212-2451-4f07-8411-15e6ef284fbc}" Site="http://localhost:8080/" Web="sites/WSSSite" Field="Employee ID"></List>
b) 添加第一条记录截图 (Employee ID是不可重复字段):
c) 试图添加同Employee ID的记录