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

来自与微软专家Liang Ming的讨论

---

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，并找到 片段，插入如下黑斜体部分，将Type设为小于1000，且和当前List的Type字段没有重复的数值，并保持Name域的信息和复制的目录名称相同。

 

       

       

 

3． 在命令窗口中调用IISReset，重启IIS服务

 

4． 在新建List页面（任何对List模板的修改，必须新建一个List才可以看到结果）我们会发现有个LIANGMING的List模板

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;

                           }

                }

                //默认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("") > 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="{1acc9212-2451-4f07-8411-15e6ef284fbc}" Site="http://localhost:8080/" Web="sites/WSSSite" Field="Employee ID"> List>

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

             

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

             

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