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

时间:2022-11-23 14:58:38
来自与微软专家Liang Ming的讨论

SharePoint中如何使得用户不能通过对WSSList中添加或修改使得某个指定字段存在重复数据。并需要尽可能满足以下需求:

 

1   希望解决方案比较简单,并且易于部署(客户希望在30分钟内能完成部署)

2   希望在部署过程中不需要重新编译任何工程

3   有一定的通用性,不能针对一个特定的List开发一个组件

---------------------------------------------------------------  
目前研究的结果:

研究结果及解决方案(以新建记录为例)

==================

系统实现思路

=======

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

由于所涉及的步骤牵涉修改WSS默认的模板和JavaScript代码,所以请在测试环境中完成下述步骤并备份相关信息。

 

1.  当用户新建记录、提交表单时,WSS会首先调用ClickOnce()函数(请在新建记录页面点击右键,查看HTML源文件),然而,ClickOnce()并不存在NewForm.aspx文件中,而是在相应List模板的SCHEMA.XML中(如,我们使用Customized ListList模板的路径是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转换为表格模式,如下所示:

List添加Item时, 如何去判断某个字段, 并且保证字段数据不重复性此时我们可以使用传统ASP.NET窗体的方式,在上面添加自定义的输入栏位和提交按钮,并可以提交到特定的后台页面。这种方式需要对每个ListNewForm.ASPX分别处理。

 

3.  服务器端是一个ASP.NET页面,它将接收ListIDListGuid)和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,并找到片段,插入如下黑斜体部分,将Type设为小于1000,且和当前ListType字段没有重复的数值,并保持Name域的信息和复制的目录名称相同。

 

       

       

 

3. 在命令窗口中调用IISReset,重启IIS服务

 

4. 在新建List页面(任何对List模板的修改,必须新建一个List才可以看到结果)我们会发现有个LIANGMINGList模板

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

5. 打开List模板目录下的SCHEMA.XML,添加如下代码:

        function CheckField()

        {

                var fldValue;

                for(i=0;i

                {

                        //查找特定字段的值(需要检查的值),此处使用title属性,可根据实际情况修改

                        if(frm.form.elements[i].title == "Employee ID"){

                           fldValue = frm.form.elements[i].value;

                           break;

                           }

                }

                //默认ListGUID存放在HiddenonetidIOHidden字段中

                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("") > 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页面,获取特定ListGUID,按照样例代码配置ListConfig.xml文件。在浏览器中传入ListIDFieldValue值,测试ASP.NET页面是否正常工作。

 

8. 服务端的页面需要获取SharePointSiteWeb等对象,可能出现权限问题,请自行参考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

           

 

文件列表

=======

ServerASP.NET工程

1. DoCheck.aspx 检查重复记录

2. GetListGuid.aspx 显示ListGuid,帮助设置配置文件

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是不可重复字段)

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

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

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



Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=130237