演练：导入 SharePoint Designer 可重用工作流

项目
06/19/2023

本演练演示了如何将在 SharePoint Designer 2010 中创建的可重用工作流导入到 Visual Studio SharePoint 工作流项目中。

在 SharePoint Designer 中创建的工作流或声明性工作流由 XML 语句而不是代码组成。 SharePoint Designer 2010 引入了可重用工作流，这是一种可移植的声明性工作流，可供 SharePoint 网站中的不同列表使用。

在 Visual Studio 2012 中创建的工作流（例如顺序和状态机工作流）称为代码工作流。代码工作流由 XML 文件和代码模块组成，用户可以在其中自定义工作流的行为。

Visual Studio 允许你在 SharePoint Designer 2010 中导入可重用工作流，并将其转换为代码工作流，以便在 SharePoint 网站中使用。

本演练演示了下列任务：

在 SharePoint Designer 中创建简单的可重用工作流。
将 SharePoint Designer 可重用工作流导出到 .wsp 文件和 SharePoint。
使用导入可重用工作流项目将 .wsp 文件导入 Visual Studio。
通过添加代码来更改工作流。
在 SharePoint 网站中使用导入的工作流。

注意

以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。这些元素取决于你所使用的 Visual Studio 版本和你所使用的设置。有关详细信息，请参阅个性化设置 IDE。

先决条件

您需要满足以下条件才能完成本演练：

支持的 Microsoft Windows 和 SharePoint 版本。
Visual Studio。
Microsoft Office SharePoint Designer 2010。

创建目标 SharePoint 子网站

首先创建两个新的 SharePoint 子网站：一个用于托管 SharePoint Designer 中的可重用工作流，另一个用于托管转换后的工作流。

创建 SharePoint 子网站

在 SharePoint Designer 2010 的菜单栏上，选择“文件”>“新建空白网站” 。
在“新建空白网站”对话框中，浏览至要在其中创建工作流的 SharePoint 网站，或使用 http://SystemName/ 的值，然后选择“确定”按钮。

此时将显示主页。
在“子网站”部分，选择“新建”按钮。
在“新建”对话框中，从左侧窗格的列表中选择“SharePoint 模板”，然后从右侧窗格的列表中选择“团队网站” 。
在“指定网站的位置”框中，将 URL 中的“subsite”一词替换为“SPD1”，然后选择“确定”按钮。

这将在 SharePoint Designer 中打开新的子网站。关闭 SharePoint Designer 的该实例并返回到第一个实例（顶层站点）。
重复步骤 3 - 5 以创建第二个子网站，这次将 URL 中的单词“subsite”替换为“SPD2”。

创建 SharePoint Designer 可重用工作流

由于 SharePoint 不包含本示例可使用的任何可重用工作流，因此将创建一个工作流。在该简单的工作流中，当用户在具有特定标题的“任务”列表中输入新任务时，系统会将此任务分配给该用户。

创建 SharePoint Designer 可重用工作流

在“子网站”部分，选择“SPD1”站点以进行修改。
在功能区上，选择“可重用工作流”按钮。

此时将出现“创建可重用工作流”向导。
在“名称”框中，输入“SPD 任务工作流” 。
在“内容类型”列表中，选择“任务”，然后选择“确定”按钮。

工作流将在 SharePoint Designer 工作流设计器中打开。
在工作流设计器中，选择步骤 1，然后在功能区上选择“条件”按钮。
在条件列表中，选择“如果当前项字段等于值”。

此步骤将添加名为“如果字段等于值”的条件。
在“如果字段等于值”条件中，选择“字段”链接。
在值列表中，选择“标题”。
在“如果字段等于值”条件中，选择“值”链接。
在框中，输入“新建任务”。

条件语句现在显示为“If Current Item:Title equals New task”。
选择条件语句下面的行，然后在功能区上选择“操作”按钮。
在操作列表中，选择“在当前项中设置字段”。
在“将字段设置为值”操作中，选择“字段”链接，然后在列表中选择“分配给” 。
在“将字段设置为值”操作中，选择“值”链接，然后在现有用户和组的列表中，选择“创建项的用户” 。
选择“添加”按钮，然后选择“确定”按钮。

操作语句现在显示为“Set Assigned To Current Item:CreatedBy”。

保存和部署可重用工作流

由于 Visual Studio 只能导入 .wsp 文件，因此必须先将可重用工作流另存为 .wsp 文件并将其部署到 SharePoint，然后才能将其导入 Visual Studio。

重要

如果在执行以下过程时遇到运行时错误，则必须在有权访问 SharePoint 网站的系统上执行该过程。

保存和部署可重用工作流

在 SharePoint Designer 顶部，选择“保存”按钮以保存进度，然后选择“发布”按钮将工作流部署到 SPD1 SharePoint 网站。
在导航窗格中，选择“工作流”对象。
在“可重用工作流”下，选择“SPD 任务工作流” 。
在功能区上，选择“另存为模板”按钮，将工作流另存为 .wsp 文件。
在浏览器中打开 SPD1 SharePoint 网站，查看 SharePoint 中的 .wsp 文件。
在快速启动栏上，选择“库”链接。
在“文档库”部分，选择“网站资产”链接。

“SPD 任务工作流”文件与其他站点资产一起列出。
在文件列表中，选择该文件的名称
在“文件下载”对话框中，选择“保存”按钮，将 .wsp 文件保存在本地系统上。

将 .wsp 文件导入 Visual Studio

使用导入可重用工作流项目将 .wsp 文件导入 Visual Studio。该项目将工作流从可重用的声明性工作流转换为代码工作流。转换工作流后，将使用代码修改其行为。

从 .wsp 文件导入工作流并对其进行修改

在 Visual Studio 的菜单栏上，选择“文件”>“新建”>“项目”。
在“新建项目”对话框中，展开 Visual C# 或 Visual Basic 下的 SharePoint 节点，然后选择 2010 节点。
在“模板”窗格中，选择“导入可重用 SharePoint 2010 工作流”模板，将项目名称保留为 WorkflowImportProject1，然后选择“确定”按钮。

“SharePoint 自定义向导”随即出现。
在“指定用于调试的站点和安全级别”页面上，输入之前创建的第二个 SharePoint 子网站的 URL：http://system name/SPD2。
在“此 SharePoint 解决方案的信任级别是什么？”部分，选择“部署为场解决方案”选项按钮，然后选择“下一步”按钮。

有关沙盒解决方案与场解决方案的详细信息，请参阅沙盒解决方案注意事项。
在“指定新项目源”页上，浏览到系统上之前保存 .wsp 文件的位置，打开该文件，然后选择“下一步”按钮。

备注

选择“完成”按钮导入 .wsp 文件中的所有可用项。

这将显示可用于导入的可重用工作流列表。
在“选择要导入的项”框中，选择工作流“SPD 任务工作流”，然后选择“完成”按钮。

导入操作完成后，将创建一个名为 WorkflowImportProject1 的项目，其中包含名为 SPD_Workflow_TestFT 的工作流。此文件夹中包含工作流的定义文件 Elements.xml 和工作流设计器文件 (.xoml) 。设计器包含两个文件：规则文件 (.rules) 和代码隐藏文件（.cs 或 .vb，具体取决于项目的编程语言）。
在“解决方案资源管理器”中，删除 Other Imported Files 文件夹。
在 Elements.xml 文件中，删除 InstantiationURL="_layouts/IniErkflIP.sspx"。
在“解决方案资源管理器”中，选择“WorkflowImportProject1”，然后在菜单栏上依次选择“项目”>“设为启动项目”，将“WorkflowImportProject1”设置为启动项。

这将在调试项目时立即显示列表。
由于“导入可重用 SharePoint 2010 工作流”模板不会为导入的工作流导入关联属性值，因此必须输入这些值。若要实现此目的，请执行以下操作：
1. 在“解决方案资源管理器”中，选择“SPD_Workflow_TestFT”节点。
2. 选择某个列表属性（如“目标列表”属性）旁边的省略号（）按钮。
3. 在“SharePoint 自定义向导”中填入缺少的值，然后选择“完成”按钮。
选择 .xoml 文件，然后在菜单栏上依次选择“视图”>“设计器”以在工作流设计器中查看导入的工作流。
在“工具箱”的“Windows Workflow v3.0”节点中，执行以下步骤之一：
- 打开“代码”活动的快捷菜单，然后选择“复制” 。在工作流设计器中，打开“SequenceActivity1”活动下方的行的快捷菜单，然后选择“粘贴” 。
- 将“工具箱”的“代码”活动拖动到工作流设计器，并将其连接到“SequenceActivity1”活动下方的行。
  
  这会向名为 CodeActivity1 的工作流设计器添加一个活动。在此活动中，你将添加一个代码操作，当用户启动工作流时，该操作会在“公告”列表中创建公告。
执行下面的某一组步骤：
- 双击 CodeActivity1 以生成事件处理程序并查看代码。
- 在“CodeActivity1”的“属性”窗口中，将“ExecuteCode”属性的值设置为“codeActivity_ExecuteCode” 。

在现有的 using 或 Imports 指令下添加以下代码：

using Microsoft.SharePoint;
using System;

Imports Microsoft.SharePoint
Imports System

将 codeActivity1_ExecuteCode 替换为以下代码：

private void codeActivity1_ExecuteCode(object sender, System.EventArgs e)
{
    
    try
    {
        // Get reference to SharePoint site.
        SPSite site = new SPSite("http://MyServer");
        SPWeb web = site.OpenWeb("SPD2/");
        // Get reference to Announcements list.
        SPList announcementsList = web.Lists["Announcements"];

        // Add announcement to Announcements list for the Task.
        SPListItem oListItem = announcementsList.Items.Add();
        oListItem["Title"] = "Assigned task on " + DateTime.Now.ToString();
        oListItem.Update();
    }

    catch (Exception err)
    {
        Console.WriteLine("Error: " + err.ToString());
    }        
}

Private Sub codeActivity1_ExecuteCode(ByVal sender As System.Object, ByVal e As System.EventArgs)
    Try
        ' Get reference to SharePoint site.
        Dim site As SPSite = New SPSite("http://MyServer")
        Dim web As SPWeb = site.OpenWeb("SPD2/")
        ' Get reference to Announcements list.
        Dim announcementsList As SPList = web.Lists("Announcements")
        ' Add announcement to Announcements list for the Task.
        Dim oListItem As SPListItem = announcementsList.Items.Add
        oListItem("Title") = ("Assigned task on " + DateTime.Now.ToString)
        oListItem.Update()
    Catch err As Exception
        Console.WriteLine(("Error: " + err.ToString))
    End Try
End Sub

部署项目并关联工作流

接下来，运行 WorkflowImportProject1 以将其部署到 SharePoint 网站，然后将工作流与任务列表相关联，以查看和测试已修改、已转换的工作流。

部署项目并关联工作流

在 Visual Studio 中，选择 F5 键运行并部署已转换的工作流项目。
在快速启动栏上，选择“任务”链接以显示任务列表。
在“列表工具”选项卡上，选择“项”按钮，然后选择“新建项”按钮。

“任务 - 新建项”对话框将打开。
在“标题”框中，输入“新建任务”，然后选择“保存”按钮。
在“列表工具”选项卡上，选择“列表”按钮，然后选择“列表设置”按钮。

将显示“列表设置”页。
在“权限和管理”部分中，选择“工作流设置”链接。

将显示“工作流设置”页。
选择“添加工作流”链接。
在“工作流”列表中，选择“WorkflowImportProject1 - SPD 工作流测试” 。
在“名称”框中，输入“SPD 工作流测试”，然后选择“确定”按钮。
在快速启动栏上，选择“任务”列表。
选择“新建任务”旁边的箭头，然后在列表中选择“工作流” 。
在“启动新工作流”部分中，选择“SPD 工作流测试”链接，然后选择“启动”按钮以初始化工作流。

备注

也可通过运行工作流设置向导并将工作流设置为自动关联来将工作流与列表自动关联。

请注意，工作流会执行两个操作：你的姓名出现在任务的“分配到”列中，并且通知出现在“通知”列表中。

通过

演练：导入 SharePoint Designer 可重用工作流

先决条件

创建目标 SharePoint 子网站

创建 SharePoint 子网站

创建 SharePoint Designer 可重用工作流

创建 SharePoint Designer 可重用工作流

保存和部署可重用工作流

保存和部署可重用工作流

将 .wsp 文件导入 Visual Studio

从 .wsp 文件导入工作流并对其进行修改

部署项目并关联工作流

部署项目并关联工作流

反馈

其他资源

通过

演练：导入 SharePoint Designer 可重用工作流

先决条件

创建目标 SharePoint 子网站

创建 SharePoint 子网站

创建 SharePoint Designer 可重用工作流

创建 SharePoint Designer 可重用工作流

保存和部署可重用工作流

保存和部署可重用工作流

将 .wsp 文件导入 Visual Studio

从 .wsp 文件导入工作流并对其进行修改

部署项目并关联工作流

部署项目并关联工作流

相关内容

反馈

其他资源