SharePoint：扩展DVWP - 第13部分：PreSaveAction()实务——创建变量

在这一系列之前的部分，我们讨论过最基本的在保存操作提交前做些事情——PreSaveAction()，该函数被默认的NewForm和EditForm表单中的“确定”按钮所调用。我们实现了在DVWP中对该函数的调用，接下来我们将利用这一技巧，进一步使其在用户填写完信息但尚未提交到数据库时执行。

在内容编辑器(CEWP)里编写代码

你可以把PreSaveAction() JavaScript内容在SharePoint Designer(SPD)里直接添加到页面中。如果是在你的整个项目中进行实现，你还可以将其添加到母版页上。但是，通常我们是通过一个内容编辑器WebPart(CEWP)添加此类代码。

现在，让我们开始在CEWP中添加我们的函数：

1、点击“网站操作”->“编辑页面”

2、在我们添加好的CEWP上，点击“编辑”->“修改共享Web部件”

3、在右侧的属性面板中，点击“源编辑器...”

4、如果你打算使用jQuery和/或SPService JavaScript库（这两个我们在后面都会用）的话，先将其引用进来：

确保我们所获取到的都是jQuery和SPServices的最新版本

5、如果你使用了jQuery在页面加载时执行一些操作的话，需要确保PreSaveAction()位于ready()函数的外面。

<script language="javascript" type="text/javascript">
          $(document).ready(function() { // 一些在页面加载时要执行的操作
               ...
               ...
          }); // 这里是ready() 函数结束的地方

          function PreSaveAction() { // 一些在执行 "确定" 或 "保存文件"前要运行的操作
               ...
               ...
               return true; // 或者当出错时，返回false
          };
</script>

在本文的接下来的步骤中，我们将从上面的第7行开始操作。

审计跟踪与jQuery

我们并不是总能得到所要数据的及时状态；我们往往需要知道数据发生了怎样的变化。因此，我们需要在数据发生变化前获取该数据的一个快照，以便解释发生了哪些修改。

jQuery和Marc Anderson的jQuery Library for SharePoint Services（简称SPServices）提供了写审计列表的极其容易的解决方案。

表单控件=当前用户数据

要查找我们表单域的内容十分简单：只需要获取控件中那些名称中包含ff#的输入控件的值即可，该名称以“$”开头，并以“_”结尾。

换句话说，如果我们的控件在SPD中类似下面的形式：

<SharePoint:FormField runat="server" id="ff3{$Pos}" … />

在设计视图中点击该控件，将在代码视图中高亮显示出该XSLT代码块。

当我们在浏览器重查看源代码时，该控件的形式和下面类似：

<input name="ctl00$m$g_ae046c3b_1d8e_4427_95e7_41f5d9c0e374$ff3_1$ctl00$ctl01" type="text" value="Administrative Assistant" id="ctl00_m_g_ae046c3b_1d8e_4427_95e7_41f5d9c0e374_ff3_1_ctl00_ctl01" … />

在查看源代码前，先点击“编辑”表单操作链接。会在源代码中发现$ff3_。这将是唯一的名称中包含$ff3_的input对象。

因此，我们可以通过jQuery这样访问其中的值：

$("input[name*=$ff3_]").val();

从字面上来理解，这里是查找所有名称中包含'$ff3_'的input控件（这里只会有一个）并返回其value属性的值。

标签=当前列表数据

标签的内容很也容易查找：其文本形式的值位于一个id中包含ff#并由'_'包围的一个span标记内。

换句话说，如果我们的控件在SPD中类似下面的形式：

<asp:Label runat="server" id="ff11{$Pos}" … />

在设计视图中点击可见的控件，可以在代码视图中定位到相应的XSLT代码块

在浏览器重查看源代码时其形式变成类似下面的样子：

<span id="ctl00_m_g_ae046c3b_1d8e_4427_95e7_41f5d9c0e374_ff11_1">Medical Records Clerk</span>

在查看源代码前，先点击“编辑”表单操作链接。会在源代码中发现_ff11_。这将是唯一的id中包含_ff11_的span。

因此，我们可以通过jQuery这样访问其中的值：

$("span[id*=_ff11_]").text();

从字面上来理解，这里是查找所有名称中包含'_ff11_'的span块（这里只会有一个）并返回该标记内的文本信息。

创建变量

有了上面这两条信息，我们就可以创建一个'old'和一个‘new'变量，以便将它们写到我们的审计跟踪列表中。

function PreSaveAction() {
    var txtNewPos = $("input[name*=$ff3_]").val();
    var txtOldPos = $("span[id*=_ff11_]").text();
    …
    return true;
};

为每一个你想要记录进审计跟踪列表的栏重复上面的工作。

现在，我们把所需的数据都放在了变量中，下一次我们将利用它们完成一些工作。

 

参考资料

SharePoint:Extending the DVWP- Part 13:Putting PreSaveAction() to Work- Creating Variables