如何:部署工作流模板
上次修改时间: 2010年4月16日
适用范围: SharePoint Foundation 2010
在创建工作流模板和所有必需的工作流表单后,还必须编译、安装和激活工作流,然后才能在 Microsoft SharePoint Foundation 2010 中实际使用该工作流。
此操作的基本步骤如下所示:
将工作流模板编译为强名称的程序集。
有关编译程序集以及为其指定强名称的详细信息,请参阅 Visual Studio 联机帮助。
创建功能定义文件,该文件可为 SharePoint Foundation 2010 提供在指定范围内部署工作流所需的信息。
创建工作流定义文件,该文件可为 SharePoint Foundation 提供使工作流实例化和运行所需的信息。
设置部署属性,以便生成的解决方案将工作流文件部署到正确的位置、将工作流程序集复制到全局程序集缓存 (GAC),并在 SharePoint Foundation 中激活工作流功能。
备注
以下过程假定您已使用 SharePoint Foundation 工作流项目模板创建了工作流模板。此项目模板(包含在工作流初学者工具包中)包含专门帮助您创建、部署和激活 SharePoint Foundation 工作流的开发功能。可从 Microsoft 下载中心获取工作流初学者工具包。
在 SharePoint Foundation 工作流项目中创建功能定义文件
在 Microsoft Visual Studio 中,打开您的 SharePoint Foundation 工作流项目,在"解决方案资源管理器"窗口中双击 feature.xml 文件。
在 feature.xml 文件中的任意位置单击右键,依次选择"插入代码段"和"SharePoint Foundation 工作流",然后单击"Feature.xml 代码"。
用您的工作流项目中的信息替换突出显示的占位符文本。占位符文本的格式为所有字母均为大写。这些信息包括:
用作功能 ID 的 GUID。它必须不同于在工作流定义文件中指定的工作流 ID。
工作流模板标题。
工作流模板的说明。
工作流定义文件相对于此文件的文件路径。项目默认值为"workflow.xml"。
有关功能定义 XML 的详细信息,请参阅 Feature.XML Files。有关创建 SharePoint Foundation 功能的详细信息,请参阅使用功能。
保存文件。
在 SharePoint Foundation 工作流项目中创建工作流定义文件
在 Microsoft Visual Studio 中,打开您的 SharePoint Foundation 工作流项目,在"解决方案资源管理器"窗口中双击 workflow.xml 文件。
在 workflow.xml 文件中的任意位置单击右键,依次选择"插入代码段"和"SharePoint Foundation 工作流",然后单击"workflow.xml 代码"。
用工作流项目中的信息替换占位符。一次替换一个占位符后,将在整个 XML 中替换该占位符。这些信息包括:
工作流名称、说明和唯一标识符。此唯一标识符针对的是工作流本身,而不是包含工作流的功能。
程序集旁边的代码和工作流程序集的类名称。
工作流的位置及该工作流所使用的任务表单。
有关创建工作流定义 XML 文件的详细信息,请参阅工作流定义。
保存文件。
使用 PostBuildActions.bat 安装和激活工作流模板
在 Microsoft Visual Studio 中,打开您的 SharePoint Foundation 工作流项目。
在"解决方案资源管理器"窗口中,右键单击项目标题,然后选择"属性"。
在"生成事件"选项卡上,编辑"后期生成命令行"字符串,以部署您的工作流解决方案。默认情况下,将此参数指定为"NODEPLOY"。
若要部署您的工作流解决方案,命令行应显示为:
call "$(ProjectDir)\Deployment Files\PostBuildActions.bat" "$(ConfigurationName)" "$(ProjectDir)" "$(TargetDir)" "$(TargetName)"
DEPLOY > BuildActions.log
备注
指定了 NODEPLOY 参数后,将编译但不部署工作流程序集。
在"生成"菜单上,选择"生成解决方案"。
当 Visual Studio 生成工作流解决方案后,它会调用 PostBuildActions 批处理文件,以自动将该工作流解决方案文件移动到 SharePoint Foundation 的正确位置,并自动激活工作流功能。
在"调试"生成模式下,此批处理文件将执行以下操作:
在服务器的适当位置创建功能目录。
将功能 XML 和工作流定义 XML 文件复制到此功能目录中。
将已编译的工作流程序集复制到全局程序集缓存 (GAC) 中。
在 SharePoint Foundation 中激活功能。
在"发布"生成模式下,此批处理文件会创建和部署 .wsp 解决方案文件,该解决方案文件可用于对生产服务器进行部署。它将执行以下操作:
用您的工作流项目中的信息替换 manifest.xml 和 wsp_structure.ddf 文件中的占位符文本。这些信息包括:
功能目录名称。
功能 XML 文件名。
工作流定义 XML 文件名。
已编译工作流程序集的名称和相对路径。
激活您的工作流模板后,管理员即可将该模板与激活它的网站上的列表和文档库相关联。
此外,将工作流与特定列表或文档库相关联后,还可以调试该工作流。