SharePoint:扩展DVWP - 第14部分:用jQuery编写PreSaveAction()实务
通过前面的学习,我们已经掌握了如何在DVWP中使用PreSaveAction(),并利用jQuery协助我们创建了一些变量,接下让我们将变量的值写到审计列表中。
使用SharePoint Web服务新建审计记录
Marc的库中的UpdataListItems为我们提供了一种快速记录审计跟踪信息变更的方式。
首先把老的域值(或者说是表单本身的值)作一个记录...
$().SPServices({ operation: "UpdateListItems", // 下面的Cmd决定了要进行插入操作 async: false, listName: "FTE Change Audit", // 我之前创建好的审计列表的显示名称 updates: "<Batch OnError='Continue' PreCalc='TRUE'>" + "<Method ID='1' Cmd='New'>" + "<Field Name='FromTo'>From</Field>" + // Field Name 为该列表栏的 'Static Name' "<Field Name='Title'>" + txtOldName + "</Field>" + "<Field Name='Location'>" + txtOldLoc + "</Field>" + "<Field Name='Group'>" + txtOldGrp + "</Field>" + "<Field Name='Position'>" + txtOldPos + "</Field>" + "<Field Name='WorkShift'>" + txtOldShift + "</Field>" + "<Field Name='FTE'>" + txtOldFTE + "</Field>" + "<Field Name='EffDate'>" + txtEffDate + "</Field>" + "<Field Name='ChangeType'>" + txtChangeType + "</Field>" + "</Method>" + "</Batch>", completefunc: function(xData, Status) { } });
...然后,为所有的新(或修改后)纪录重复以上过程。修改FromTo的值为To;注意到我们在这两个过程中使用相同的EffDate(你的需求或许不同)。ChangeType可以自动设置或者基于已有的一些变更计算出来。
现在合在一起
尽管你写的代码可能根据你的需求进行了修改,但是到目前为止大致上我们的PreSaveAction()的样子如下所示:
function PreSaveAction() { var txtChangeType = "Update"; var txtNewName = $("input[name*=$ff1_]").val(); var txtOldName = $("span[id*=_ff9_]").text(); var txtNewPos = $("input[name*=$ff3_]").val(); var txtOldPos = $("span[id*=_ff11_]").text(); var txtNewShift = $("select[name*=$ff4_]").val(); var txtOldShift = $("span[id*=_ff12_]").text(); var txtNewFTE = $("input[name*=$ff5_]").val(); var txtOldFTE = $("span[id*=_ff13_]").text(); var txtNewGrp = $("input[name*=$ff2_]").val(); var txtOldGrp = $("span[id*=_ff10_]").text(); var txtNewLoc = $("input[name*=$ff6_]").val(); var txtOldLoc = $("span[id*=_ff14_]").text(); var txtEffDate = $("input[name*=$ff7_]").val(); $().SPServices({ operation: "UpdateListItems", async: false, listName: "FTE Change Audit", updates: "<Batch OnError='Continue' PreCalc='TRUE'>" + "<Method ID='1' Cmd='New'>" + "<Field Name='FromTo'>From</Field>" + "<Field Name='Title'>" + txtOldName + "</Field>" + "<Field Name='Location'>" + txtOldLoc + "</Field>" + "<Field Name='Group'>" + txtOldGrp + "</Field>" + "<Field Name='Position'>" + txtOldPos + "</Field>" + "<Field Name='WorkShift'>" + txtOldShift + "</Field>" + "<Field Name='FTE'>" + txtOldFTE + "</Field>" + "<Field Name='EffDate'>" + txtEffDate + "</Field>" + "<Field Name='ChangeType'>" + txtChangeType + "</Field>" + "</Method>" + "</Batch>", completefunc: function(xData, Status) { } }); $().SPServices({ operation: "UpdateListItems", async: false, listName: "FTE Change Audit", updates: "<Batch OnError='Continue' PreCalc='TRUE'>" + "<Method ID='1' Cmd='New'>" + "<Field Name='FromTo'>To</Field>" + "<Field Name='Title'>" + txtNewName + "</Field>" + "<Field Name='Location'>" + txtNewLoc + "</Field>" + "<Field Name='Group'>" + txtNewGrp + "</Field>" + "<Field Name='Position'>" + txtNewPos + "</Field>" + "<Field Name='WorkShift'>" + txtNewShift + "</Field>" + "<Field Name='FTE'>" + txtNewFTE + "</Field>" + "<Field Name='EffDate'>" + txtEffDate + "</Field>" + "<Field Name='ChangeType'>" + txtChangeType + "</Field>" + "</Method>" + "</Batch>", completefunc: function(xData, Status) { } }); return true; };
其他用途
你可以通过PreSaveAction()做什么?
1、栏验证 - 确保你即将写入到数据库中的数据满足一些要求,比如:
i.结束日期在起始日期后面
ii.一个时间段内至少包含x天(或这说天数大于x天)
iii.某个人已经在某个列表中(或在某个列表中不存在)
iv.如果一些可选字段在某些字段填写后会变成必填字段
v.等等
2、添加“您的意思是...?”功能
i.“...要进行修改,但是并不更新有效日期?”
ii.“...要在以后再设置这个日期?”
iii.“...找的是这个名子与此很接近的人?”
iv.“...指这个转换后的结果?或者是指这个最终结果?”
v.等等
3、需要做审计跟踪
4、确认是否要删除
5、查找存储在该列表项中的信息
5、其他你的创意...
想了解更多应用场景?
不妨搜索一下PreSaveAction(),看看其他博文作者有什么好的想法。
下一次:如何在DVWP中使用用户自定义的下拉列表框?网上有些最佳实践,不论你是不是在用DVWP都可能会用到。但如果你需要在你的DVWP中使用级联下拉框,那么你需要提前进行规划。我们将开始着手这一规划,并指出其中可能存在的一些陷阱。
从现在开始接下来的4篇文章中,我们将在DVWP中实现级联下拉列表框功能。相应列表的所有者将在SharePoint列表中管理其内容和相互之间的关系。
参考资料
SharePoint:Extending the DVWP- Part 14:Putting PreSaveAction() to Work with jQuery