List添加Item时, 如何去判断某个字段, 并且保证字段数据不重复性

发表于:2007-06-30来源:作者:点击数: 标签:
SharePoint中如何使得用户不能通过对WSS的List中添加或修改使得某个指定字段存在重复数据。并需要尽可能满足以下 需求 : 1) 希望 解决方案 比较简单,并且易于部署(客户希望在30分钟内能完成部署) 2) 希望在部署过程中不需要重新编译任何工程 3) 有一定
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/default.asp?url=/library/en-us/spsdk11/CAML_Schema/spxmlconONET.asp ONET.XML



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="{1aclearcase/" target="_blank" >cc9212-2451-4f07-8411-15e6ef284fbc}" Site="http://localhost:8080/" Web="sites/WSSSite" Field="Employee ID"></List>

b) 添加第一条记录截图 (Employee ID是不可重复字段):



c) 试图添加同Employee ID的记录

原文转自:http://www.ltesting.net