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

类别:Asp 点击:0 评论:0 推荐:
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="{1acc9212-2451-4f07-8411-15e6ef284fbc}" Site="http://localhost:8080/" Web="sites/WSSSite" Field="Employee ID"></List>

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

             

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

             

本文地址:http://com.8s8s.com/it/it8419.htm