演练：创建自定义站点工作流活动

本演练演示如何使用 Visual Studio 为网站级工作流创建自定义活动。 （网站级工作流应用于整个网站，而不只是网站上的列表。）自定义活动会创建备份公告列表，然后将公告列表的内容复制到其中。

本演练演示了下列任务：

• 创建网站级工作流。

• 创建自定义工作流活动。

• 创建和删除 SharePoint 列表。

• 将项从一个列表复制到另一个列表。

• 在“快速启动”栏上显示列表。

  注意

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

先决条件

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

• 支持的 Microsoft Windows 和 SharePoint 版本。

• Visual Studio。

创建网站工作流自定义活动项目

首先，创建一个项目来保存和测试自定义工作流活动。

创建网站工作流自定义活动项目

1. 在菜单栏上，选择“文件”>“新建”>“项目”，打开“新建项目”对话框。

2. 展开“Visual C#”或“Visual Basic”下的“SharePoint”节点，然后选择“2010”节点。

3. 在“模板”窗格中，选择“SharePoint 2010 项目”模板。

4. 在“名称”框中，输入 AnnouncementBackup，然后选择“确定”按钮。

   “SharePoint 自定义向导”随即出现。

5. 在“为调试指定网站和安全级别”页上，选择“部署为场解决方案”选项按钮，然后选择“完成”按钮以接受信任级别和默认网站。

   此步骤将解决方案的信任级别设置为场解决方案，这是工作流项目的唯一可用选项。

6. 在“解决方案资源管理器”中，选择项目节点，然后在菜单栏上选择“项目”>“添加新项”。

7. 展开“Visual C#”或“Visual Basic”下的“SharePoint”节点，然后选择“2010”节点。

8. 在“模板”窗格中，选择“顺序工作流(仅场解决方案)”模板，然后选择“添加”按钮。

   “SharePoint 自定义向导”随即出现。

9. 在“指定用于调试的工作流名称”页上，接受默认名称 (AnnouncementBackup - Workflow1)。 更改工作流模板类型“网站工作流”，然后选择“下一步”按钮。

10. 选择“完成”按钮以接受剩余的默认设置。

添加自定义工作流活动类

接下来，向项目添加一个类，以包含自定义工作流活动代码。

添加自定义工作流活动类

1. 在菜单栏中，依次选择“项目”>“添加新项”以显示“添加新项”对话框。

2. 在“已安装的模板”树视图中，选择“代码”节点，然后选择项目项模板列表中的“类”模板。 使用默认名称 Class1。 选择“添加”按钮。

3. 用下面的代码替换 Class1 中的所有代码：

   C#

   using System;
   using System.Collections.Generic;
   using System.Linq;
   using System.Text;
   using Microsoft.SharePoint;
   
   namespace AnnouncementBackup
   {
       // This custom activity will back up all of the announcements in 
       // the Announcements list on the SharePoint site.
       public class Class1 : System.Workflow.ComponentModel.Activity
           {
           public Class1()
           { }
           
           // Triggers when the activity is executed.
           protected override System.Workflow.ComponentModel.ActivityExecutionStatus Execute(System.Workflow.ComponentModel.ActivityExecutionContext executionContext)
           {
               try
               {
                   // Get a reference to the SharePoint site.
                   SPSite site = new SPSite("http://" + System.Environment.MachineName);
                   SPWeb web = site.OpenWeb("/");
   
                   // Reference the original Announcements list.
                   SPList aList = web.GetList("/Lists/Announcements");
   
                   // If the Announcements Backup list already exists, delete it.
                   try
                   {
                       SPList bList = web.GetList("/Lists/Announcements Backup");
                       bList.Delete();
                   }
                   catch
                   { }
   
                   // Create a new backup Announcements list and reference it.
                   Guid newAnnID = web.Lists.Add("Announcements Backup", "A backup Announcements list.", SPListTemplateType.Announcements);
                   SPList bakList = web.Lists[newAnnID];
   
                   // Copy announcements from original to backup Announcements list.
                   foreach (SPListItem item in aList.Items)
                   {
                       SPListItem newAnnItem = bakList.Items.Add();
                       foreach (SPField field in aList.Fields)
                       {
                           if (!field.ReadOnlyField)
                               newAnnItem[field.Id] = item[field.Id];
                       }
                       newAnnItem.Update();
                   }
   
                   // Put the Backup Announcements list on the QuickLaunch bar.
                   bakList.OnQuickLaunch = true;
                   bakList.Update();
   
               }
   
               catch (Exception errx)
               {
                   System.Diagnostics.Debug.WriteLine("Error: " + errx.ToString());
               }
               
               return base.Execute(executionContext);
           }
   
   
       }
   }
   

   VB

   Imports System
   Imports System.Collections.Generic
   Imports System.Linq
   Imports System.Text
   Imports Microsoft.SharePoint
   
   Namespace AnnouncementBackup
       ' This custom activity will back up all of the announcements 
       ' in the Announcements list on the SharePoint site.
       Public Class Class1
           Inherits System.Workflow.ComponentModel.Activity
           Public Sub New()
               MyBase.New()
           End Sub
   
           ' Triggers when the activity is executed.
           Protected Overrides Function Execute(ByVal executionContext As System.Workflow.ComponentModel.ActivityExecutionContext) As System.Workflow.ComponentModel.ActivityExecutionStatus
               Try
                   ' Get a reference to the SharePoint site.
                   Dim site As SPSite = New SPSite(("http://" + System.Environment.MachineName))
                   Dim web As SPWeb = site.OpenWeb("/")
                   ' Reference the original Announcements list.
                   Dim aList As SPList = web.GetList("/Lists/Announcements")
                   ' If the Announcements Backup list already exists, delete it.
                   Try
                       Dim bList As SPList = web.GetList("/Lists/Announcements Backup")
                       bList.Delete()
                   Catch
                   End Try
                   ' Create a new backup Announcements list and reference it.
                   Dim newAnnID As Guid = web.Lists.Add("Announcements Backup", "A backup Announcements list.", SPListTemplateType.Announcements)
                   Dim bakList As SPList = web.Lists(newAnnID)
                   ' Copy announcements from original to backup Announcements list.
                   For Each item As SPListItem In aList.Items
                       Dim newAnnItem As SPListItem = bakList.Items.Add
                       For Each field As SPField In aList.Fields
                           If Not field.ReadOnlyField Then
                               newAnnItem(field.Id) = item(field.Id)
                           End If
                       Next
                       newAnnItem.Update()
                   Next
                   ' Put the Backup Announcements list on the QuickLaunch bar.
                   bakList.OnQuickLaunch = True
                   bakList.Update()
               Catch errx As Exception
                   System.Diagnostics.Debug.WriteLine(("Error: " + errx.ToString))
               End Try
               Return MyBase.Execute(executionContext)
           End Function
       End Class
   End Namespace
   

4. 保存项目，然后在菜单栏上，依次选择“生成”>“生成解决方案”。

   Class1 显示为“AnnouncementBackup 组件”选项卡上的“工具箱”中的自定义操作。

将自定义活动添加到网站工作流

接下来，将活动添加到工作流以包含自定义代码。

将自定义活动添加到网站工作流

1. 在设计视图中的工作流设计器中打开 Workflow1。

2. 从“工具箱”中拖动 Class1，使其显示在 onWorkflowActivated1 活动下，或打开 Class1 的快捷菜单，选择“复制”，打开 onWorkflowActivated1 活动下行的快捷菜单，然后选择“粘贴”。

3. 保存项目。

测试网站工作流自定义活动

接下来，运行项目并启动站点工作流。 自定义活动创建备份公告列表，并将当前公告列表中的内容复制到该列表。 该代码还会在创建备份列表之前检查备份列表是否已存在。 如果备份列表已存在，则删除它。 该代码还会添加指向 SharePoint 网站的“快速启动”栏上新列表的链接。

测试网站工作流自定义活动

1. 按 F5 运行项目并将其部署到 SharePoint。

2. 在“快速启动”栏上，选择“列表”链接以显示在 SharePoint 网站中可用的所有列表。 请注意，只有一个名为 Announcements 的公告列表。

3. 在 SharePoint 网页顶部，选择“网站工作流”链接。

4. 在“启动新工作流”部分下，选择“AnnouncementBackup - Workflow1”链接。 这会启动网站工作流，并运行自定义操作中的代码。

5. 在“快速启动”栏上，选择“公告备份”链接。 请注意，“Announcements”列表中包含的所有公告均已复制到此新列表。

相关内容

• 操作说明：创建事件接收器
• 开发 SharePoint 解决方案