SharePoint：扩展DVWP - 第27部分：为DVWP添加一个备用编辑模版

就像一场有很多道菜的盛宴，本系列的范围已从可口过渡到美味，从面包屑转到了全麦面包，从馅饼发展到了羊排，从水换成了酒。但愿，这些能够勾起你的食欲，使你更想探索SharePoint DVWP，学习它到底能做什么，探索更多的可能性。
好吧，准备好您的刀叉。 我们有一些烤肉要上来了（是的！同时还有甜点！）
如果你还没有准备好，现在有一个好机会可以提升你的XSLT技能，来学习Marc Anderson的“解开SharePoint数据视图Web部件XSLT 标记之谜”系列吧。

对删除操作的审计

在本系列中，我们已经深入到DVWP的内部，但现在我要把你的注意力带回到一开始。在“第1部分：布局增强 – 在默认值模板和编辑模板中重新排列栏”中 ，我们一直是在默认值模板和编辑模板中移动链接。其中很重要的一点是，我们需要在每个模版中都进行修改，因为它们共享模板标题行，但有各自的数据行。
当我们转到插入模板中时，不得不再进行一次数据行的布局更改。
在第5-9部分，我们对这些链接进行了加工：调用工作流，传递变量，等等。接下来的第15-23部分详细了解了DVWP编辑模板的组成部分。然后，在一个实例中，我们通过将列表项的变更写入一个审计列表，实现了列表审计。（列表项的插入很容易通过在新建时启动工作流来实现审计。）上一篇中，我们修改了编辑模版以便容纳多行数据，添加了栏标签，并在编辑/插入表单外添加了一个彩色的边框，可以指示不同的表单状态。
现在，让我们来看看如何将删除操作记录在审计列表中。

需要一个备用编辑模板

回到“第6部分：分析列表表单操作链接”，我们发现DVWP生成的删除链接并没有自己的模板。它只是单纯的删除列表项和重绘列表。

删除

<a href="javascript: {ddwrt:GenFireServerEvent(concat('__cancel;__delete={',$KeyField,'=',$KeyValue,'};__commit'))}">删除</a>

删除链接用于通过默认值模板重绘该DVWP，但不包含已删除的列表项。它实际上执行了3个函数：

1、cancel(用于阻止该表单执行常规的提交函数)；

2、delete(用于传递即将删除的列表项ID给执行删除的函数）；和

3、commit(用于提交删除操作，以使其执行）。

注意，这里不存在是否应该被删除的验证；只是一个操作的执行（当然，我们可以很方便的通过回收站进行恢复）。在将来的博文中，我们会修改其执行的方式。

如果只是想弹出一个确认对话框，，你可以通过在删除表单操作链接上调用PreSaveAction()来实现。
但如果你想保存该记录到审计列表，同时记录一个Effective Date该怎么做？ 这时，你就需要一条途径来在从主列表中删除该记录前输入Effective Date并存储到审计列表中。
进一步，可能还需要记录不同的删除记录的原因。比如以雇员为例，删除其记录的原因可能是辞职（员工发起的）或辞退（公司发起的）。
对应这些内容，都需要在列表项删除之前执行单独的步骤。


我们将要创建的“删除”模板

分析编辑模板

让我们看一下内置的编辑模板的XSLT，以便找到创建一个备用模版必须复制的部分。

   1. 打开 SharePoint Designer (SPD)，然后
   2. 打开包含你的多项目视图的DVWP表单的所在的站点，
   3. 确保你已经修改了DVWP，使其允许编辑（参见扩展DVWP -第1部分以获取更多信息）
   4. Hover over your webpart and click on the right-arrow (chevron)将鼠标悬停在您的WebPart上，然后点击右上角出现的右尖括号图标。

   5. 单击数据视图预览下拉框，选择“编辑模板”

请注意页面的变化，让你可以修改该列表项的栏。


编辑模板（更改后） 

分析编辑模板的组成

点击编辑模板最左上角的控件。 在代码窗格中，你会发现，这个模板是完整包含于一个XSLT模板中。

<xsl:template name="dvt_1.rowedit">
    <xsl:param name="Pos" />
    <tr>
        . . .
    </tr>
</xsl:template>

为了创建删除模板，我们会将该XSLT做一个拷贝。

但是，我们还需要弄清楚如何调用和何时调用该模版。 搜索一下call-template name="dvt_1.rowedit" ，你会发现一段脚本，看起来像这样：

<xsl:if test="not($dvt_HideGroupDetail)" ddwrt:cf_ignore="1">
    <xsl:choose>
        <xsl:when test="$dvt_1_form_editkey = ddwrt:EscapeDelims(string(@ID))">
            <xsl:call-template name="dvt_1.rowedit">
                <xsl:with-param name="Pos" select="concat('_', position())" />
            </xsl:call-template>
        </xsl:when>
        <xsl:otherwise>
            <xsl:call-template name="dvt_1.rowview" />
        </xsl:otherwise>
    </xsl:choose>
</xsl:if>

我们需要确定何时调用删除的XSL 模板，所以在这个选择语句中添加一个xsl:when。 编辑模板会在$ dvt_1_form_editkey等于该列表项的@ID时被调用。我们会以类似的方式调用我们的模板。 那么，$ dvt_1_form_editkey是在哪里被赋值的？搜索一些它（不带$），来找出答案。
哇！ 跳回到ParameterBindings节点时，我们找到这个：

<ParameterBinding Name="dvt_1_form_editkey" Location="Postback;Connection"/>

这就是声明它的地方，但它在哪里赋值的呢？ 继续向下搜索。

<xsl:otherwise><tr>
    <td class="ms-vb" width="1%" nowrap="">
        <a href="javascript: {ddwrt:GenFireServerEvent(concat('__cancel;dvt_1_form_editkey={',$KeyValue,'}'))}">update</a>
    </td>
    <td class="ms-vb" width="1%" nowrap="" style="border-left:1px black solid; padding-left:3px">
        <a href="javascript: {ddwrt:GenFireServerEvent(concat('__cancel;__delete={',$KeyField,'=',$KeyValue,'};__commit'))}">remove</a>
    </td>
</tr></xsl:otherwise>

哦！ 当我们点击链接时它赋的值。 同时注意到删除当前并不是以同样的方式运作：它传递了一个KeyField，用来删除列表项。所以，这一块也是我们需要修改的地方。

还有什么地方用了呢？ 另一处搜索的发现：

<xsl:stylesheet . . .>
        <xsl:output method="html" indent="no"/>
        <xsl:param name="dvt_adhocmode">sort</xsl:param>
        <xsl:decimal-format NaN=""/>
        <xsl:param name="dvt_apos">'</xsl:param>
        <xsl:param name="dvt_1_form_editkey" />
        <xsl:param name="dvt_1_form_insertmode" />
        <xsl:param name="dvt_groupfield" />

stylesheet也需要一个参数声明，以便可以使用它。
OK.所以，我们需要：

   1. 为stylesheet创建一个新的ParameterBinding变量，和一个新的xsl:param;
   2. 修改remove表单操作，回传一个ID给页面，以便DVWP知道哪条列表项正被删除;
   3. 告诉该模板显示对应该删除功能的备用编辑模板
   4. 复制现有的rowedit模板，来创建我们希望绘制的新模版，然后，
   5. 修改新的备用模板，使其按我们想要的方式进行绘制和运行。

步骤1：创建一个新的ParameterBinding变量

因此，让我们创建自己版本的edit key...

<ParameterBinding Name="dvt_1_form_editkey" Location="Postback;Connection"/>
<ParameterBinding Name="dvt_1_form_removekey" Location="Postback;Connection"/>

..和stylesheet参数。

<xsl:param name="dvt_1_form_editkey" />
<xsl:param name="dvt_1_form_removekey" />

第2步：修改表单操作链接

它现在看起来很像一个更新链接 。

<xsl:otherwise><tr>
    <td class="ms-vb" width="1%" nowrap="">
        <a href="javascript: {ddwrt:GenFireServerEvent(concat('__cancel;dvt_1_form_editkey={',$KeyValue,'}'))}">update</a>
    </td>
    <td class="ms-vb" width="1%" nowrap="" style="border-left:1px black solid; padding-left:3px">
        <a href="javascript: {ddwrt:GenFireServerEvent(concat('__cancel;dvt_1_form_removekey={',$KeyValue,'}'))}">remove</a>
    </td>
</tr></xsl:otherwise>

第3步：调用remove模板

我们只需要再添加一个xsl:when到choose中，条件也是当dvt_1_form_removekey为当前行时。

<xsl:if test="not($dvt_HideGroupDetail)" ddwrt:cf_ignore="1">
    <xsl:choose>
        <xsl:when test="$dvt_1_form_editkey = ddwrt:EscapeDelims(string(@ID))">
            <xsl:call-template name="dvt_1.rowedit">
                <xsl:with-param name="Pos" select="concat('_', position())" />
            </xsl:call-template>
        </xsl:when>
        <xsl:when test="$dvt_1_form_removekey = ddwrt:EscapeDelims(string(@ID))">
            <xsl:call-template name="dvt_1.rowremove">
                <xsl:with-param name="Pos" select="concat('_', position())" />
            </xsl:call-template>
        </xsl:when>
        <xsl:otherwise>
            <xsl:call-template name="dvt_1.rowview" />
        </xsl:otherwise>
    </xsl:choose>
</xsl:if>

第4步：复制编辑模板到一个新的“remove”模板编辑

（我们简单的就叫它为remove模板 ）

<xsl:template name="dvt_1.rowedit">
    <xsl:param name="Pos" />
    <tr>
        . . .
    </tr>
</xsl:template>
<xsl:template name="dvt_1.rowremove">
    <xsl:param name="Pos" />
    <tr>
        . . .
    </tr>
</xsl:template>

下一次：继续我们的扩展DVWP系列 ，将讨论第5步：修改remove模板 。

 

参考资料

SharePoint: Extending the DVWP – Part 27: Adding an Alternate Edit Template to a DVWP