SharePoint Workflow 版本控制

时间:2022-01-17 08:58:36

你创建了一个工作流,并且将它部署到生产环境。几个月后,业务需要做一些小的改变。你打开工作流代码,增加了一些Activities使得它满足了新的需求,然后重新部署到生产环境。令你感到震惊的事情发生了,所有的流程实例都中断了!你陷入了深深的狂乱中,因为你确信已经对修改的部分充分进行了单元测试,并且找不到产生错误的原因。你没有进行版本控制!
工作流的版本控制是非常重要的技术。当一个工作流处于闲置时(指等待触发条件,如等待某人审批),工作流的属性会被保存到数据库,这称之为持久化。当它需要重新开始执行时,它的属性会从数据库中取出,工作流才得以继续执行。版本控制如此重要是因为,工作流持久化后,如果改变了工作流的程序集,就不能保证当工作流重新恢复时,它能够匹配新的程序集。一旦匹配不上,工作流将会终止。最好的做法是每一次修改都创建一个新的工作流版本。


大致的思路是每次生成项目都使程序集的版本号增加,而不是永远都是1.0.0.0。将新的程序集添加到GAC。最后指定旧版本的工作流不能创建新实例,然后把新工作流添加到对应的列表。这样,老版本的工作流没有发生改变,因此不会对已经持久化的工作流产生危害。

 

如果你没有创建新版本而仅仅只是更新了工作流,所有运行中的工作流实例将会被删除。老版本工作流将会被移除。不要更新工作流而不创建新版本,除非你完全确认你不在需要正在运行的实例。

 

 

跟随下列步骤,为已经存在的工作流创建一个新版本。
1.在你工作流的Elements.xml文件中,替换CodeBesideAssembly属性值$assemblyname$为:
[assembly name], Version=1.0.0.0,Culture=neutral, PublicKeyToken=[token]
2.将[assembly name]替换成程序集的名称。
3.将[token]替换成public key token,你可以在GAC(c:\windows\assembly)中找到你的程序集,然后右键选择属性,将token拷贝到Elements.xml件中。
4.修改Elements.xml文件中name的值(如果workflow version 1.0.0.0),使得用户能够区分老版本和新版本。
5.将旧版本的程序集添加到package中。双击Package,在Advanced tab中,添加已经存在的程序集文件,选择已经存在的1.0.0.0版本。注意:选择前应先copy一个新的程序集,放在bin\debug\V1.0.0.0目录下,选择新copy出来的文件,因为原有的文件编译后会重新生成。最后确认Source和Location是否都指向了新的文件。
6.修改Properties文件夹下的AssemblyInfo.cs文件,将最下面的两个版本号都修改为2.0.0.0
7.打开Elements.xml文件,copy整个<workflow>节点。修改name为workflow version 2.0.0.0,
version改为2.0.0.0,修改ID为新的GUID,可以使用Visual Studio自带的GUID Generator来生成。
8.部署解决方案后,在对应的列表或站点中创建一个新版本的工作流。这时,我们的列表或站点就有两个工作流了,然后选择移除工作流,选择Version 1.0.0.0版本的工作流不允许创建新实例,点击OK。

此方法用于Visual Studio 创建的工作流,如果是用SharePoint Designer创建的工作流会自动进行版本控制。

 

鼓励作者写出更好的文章

 

SharePoint Workflow 版本控制

 

SharePoint Workflow 版本控制