SharePoint Desiner 2007 工作流操作扩展
在
MOSS
工作流开发中，
SharePoint Designer 2007
可以对
MOSS
工作流实现无代码的快速开发以及部署，提高工作人员开发工作流的效率和降低工作强度，
SharePoint Designer 2007
虽然自带了丰富的工作流操作，但是在实际工作中，
Designer
工作流操作并不能满足我们的全部需求，所以需要开发
SharePoint Designer
工作流扩展操作，提高
SharePoint Designer 2007
的实用性；由于开发的操作是【工作流
Activity
库】，可以在任务
.net
工作流中重复使用，一劳永逸！
一．ACTIONS文件格式
SharePoint Designer
在加载服务器工作流条件与操作的时候，都是读取指定路径下的
.ACTIONS
文件，该文件是一个基于
xml
格式编写的配置文件，里面记录了对应的操作或条件所对应的程序集，已经程序集中声明的属性，参数类型等信息，
MOSS
服务器默认有一个
WSS.ACTIONS
文件，用户可以在该文件中加入
<ACTION>
节点来定义自己的操作，也可以自己创建
.ACTIONS
文件，
Sharepoint Designer
会自动加载该文件夹下的所有
.ACTIONS
后缀的文件。
|
.ACTIONS
文件路径：
|
|
C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\2052\Workflow\
|
1.主要节点概述
|
节点名称
|
父节点
|
含义
|
|
<WorkflowInfo>
|
无
|
头节点
|
|
<Actions>
|
<WorkflowInfo>
|
|
|
<Action>
|
<Actions>
|
定义工作流操作
|
|
<RuleDesigner>
|
<Action>
|
具体操作中显示的信息，已经参数位置
|
|
<FieldBind>
|
<RuleDesigner>
|
控制
Designer
中操作显示的信息，以及参数默认类型默认文本
|
|
<Option>
|
<FieldBind>
|
可自定义
FielBind
内的值
|
|
<Parameters>
|
<Action>
|
定义对应程序集属性的参数集
|
|
<Parameter>
|
<Parameters>
|
参数与引用程序集对应的信息，如类型、名称等
|
2.节点属性
2.1 <WorkflowInfo>
|
属性
|
含义
|
2.2 <Actions>
|
属性
|
含义
|
|
Sequential
|
|
|
Parallel
|
|
2.3 <Action>
|
属性
|
含义
|
|
Name
|
操作的名称
|
|
ClassName
|
引用的程序集
|
|
Assembly
|
程序集信息（集名、版本、
Culture
、公钥）
|
|
AppliesTo
|
|
|
Category
|
在
Designer
中的操作选择项中的类表（自定义）
|
2.4 <RuleDesigner>
|
属性
|
含义
|
|
Sentence
|
选择操作以后显示的信息，如果句子有参数，在需要加参数的地方插入
[
％
+
数字
]
，如：
%1
|
2.5 <FieldBind>
|
属性
|
含义
|
|
Field
|
参数名称
|
|
DesignerType
|
定义
Designer
输入参数的方式
|
|
Text
|
默认显示的文本
|
|
Id
|
对应父节点
Sentence
属性中的参数编号，如：对应父节点的
%1
则
id=”1”
|
2.6 <Parameters>
|
属性
|
含义
|
2.7 <Parameter>
|
属性
|
含义
|
|
Name
|
参数名称，必须与引用程序集中声明的属性同名
|
|
Type
|
参数在
Designer
中的默认值
|
|
Direction
|
定义变量是输出还是输入，值为
”Out”
、
“In”
、
” Optional”
|
3.节点属性参数取值含义详解
3.1 <WorkflowInfo>
无属性
3.2 <Actions>
Sequential
|
参数名
|
含义
|
|
|
|
Parallel
|
参数名
|
含义
|
|
|
|
3.4 <Action>
节点属性无特殊限制
3.5 <RuleDesigner>
节点属性无特殊限制
3.6 <FieldBind>
DesignerType
|
参数名
|
含义
|
|
ParameterNames
|
|
|
ChooseListItem
|
|
|
ListNames
|
|
|
ChooseDoclibItem
|
|
|
TextArea
|
|
|
FieldName
|
|
|
Stringbuilder
|
|
|
Operator
|
|
|
Integer
|
|
|
Dropdown
|
|
|
Date
|
|
|
Email
|
|
3.7 <Parameters>
无参数
3.8 <Parameter>
Type
对应
.net
代码中声明属性的类型
Direction
|
参数名
|
含义
|
|
In
|
|
|
Out
|
|
|
Optional
|
|
4. Actions文件实例
|
<?
xml
version
=
"1.0" encoding="utf-8" ?>
<
WorkflowInfo
>
<
Actions
Sequential
=
"then" Parallel="and">
<
Action
Name
=
"
从用户中获取名称
"
ClassName
=
"MyCustomActivity.EventLogger"
Assembly
=
"MyCustomActivity.EventLogger, Version=1.0.0.0, Culture=neutral, PublicKeyToken=0d31bafc5a063039"
AppliesTo
=
"all"
Category
=
"
自定义工作流操作
">
<
RuleDesigner
Sentence
=
"
将 %1 转化为 %2
">
<
FieldBind
Field
=
"UserName" DesignerType="parameterNames" Text="
名称
" Id="1" />
<
FieldBind
Field
=
"UserLoginName" DesignerType="parameterNames" Text="
工程师帐号
" Id="2" />
</
RuleDesigner
>
<
Parameters
>
<
Parameter
Name
=
"__Context" Type="Microsoft.SharePoint.WorkflowActions.WorkflowContext, Microsoft.SharePoint.WorkflowActions" Direction="In"/>
<
Parameter
Name
=
"UserName" Type="System.String, mscorlib" Direction="In" />
<
Parameter
Name
=
"UserLoginName" Type="System.String, mscorlib" Direction="Out" />
</
Parameters
>
</
Action
>
</
Actions
>
</
WorkflowInfo
>
|
说明：
以上定义了一个 SharePoint Designer 2007 工作流操作。该操作引用程序集的 MyCustomActivity.EventLogger 类
操作名称：从用户中获取名称（图1）
（图1）
组：自定义工作流操作（图2）
（图2）
操作详细设置设两个参数（图3），都为工作流变量类型（图4），点击新建变量 默认类型为 字符串（图5）
（图3）
（图4）
（图5）
Parameters
节点内的信息是与.net代码内声明的属性对应应的参数，要求必须名称和类型都与代码中的属性保持一致
二．用Microsoft Visual Studio 2005开发 SharePoint Designer 2007 工作流扩展操作
系统需求：
Microsoft Visual Studio 2005
.NET Framework 2.0
.NET Framework 3.0
Windows WorkFlow Fundation
1. 工作流项目模板
安装好所需的软件后，打开
Microsoft Visual Studio 2005
，文件
->
新建
->
项目，展开你所需要的语言，选择
【
Workfow
】
(
该选项要在安装
Windows WorkFlow Fundation
基础上才会出现
)
微软提供多个工作流模板，这里由于我们要开发的是一个
Designer
的扩展操作，所以选择
【工作流
Activity
库】，新建一个项目
创建项目后可以看到【工具箱】中多了【
Windows workflow
】，这是微软提供的一组可视化工作流设计空间，当前实验并未涉及到这些控件的使用，使用不做介绍。
2. 开发实例
以下使用一个简单的实例，说明整个开发的方法
功能：由用户的姓名
在解决方案中，选择
Activty1.cs
文件，右键－【查看代码】，我们需要实现功能的代码还有属性的声明，都将写在
Activty1.cs
文件内
首先声明一个变量
LoginName
用于获取用户的帐号，声明代码：
|
public
static DependencyProperty LoginNameProperty =
System.Workflow.ComponentModel.DependencyProperty.Register("LoginName",typeof(string),typeof(Activty1));
[Category("
自定义工作流操作"
), Browsable(true)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
public
string LoginName{
get{
return ((string)(base.GetValue(LoginNameProperty)));
}
set{
base.SetValue(LoginNameProperty, value);
}
}
|
再声明一个变量
Name
来得到用户的姓名，声明代码
|
public
static DependencyProperty NameProperty =
System.Workflow.ComponentModel.DependencyProperty.Register("Name", typeof(string), typeof(Activty1));
[Category("
自定义工作流操作"
), Browsable(true)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
public
string Name{
get{
return ((string)(base.GetValue(NameProperty)));
}
set{
base.SetValue(NameProperty, value);
}
}
|
说明：
在实例化
DependencyProperty
变量时候必须注意，
参数格式为：
DependencyProperty
.Register(
参数1：所声明属性的名称，参数2：typeof(声明属性的类型)，参数3：typeof(所在类的名称))
由于需要获取的是MOSS中的信息，所以还需要一个参数，但是这个参数不会显示到Designer的操作界面上
|
public
static DependencyProperty __ContextProperty =
DependencyProperty
.Register("__Context", typeof(WorkflowContext), typeof(EventLogger));
[ValidationOption(ValidationOption.Required)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
public
WorkflowContext __Context{
get{
return (WorkflowContext)base.GetValue(__ContextProperty);
}
set{
base.SetValue(__ContextProperty, value);
}
}
|
使用这个属性，获取当前MOSS站点的信息，包括我们所需要获取的用户帐号以及姓名，由于需要使用到Microsoft.SharePoint.WorkflowActions. WorkflowContext类，但是默认情况该平台内未注册Microsoft.SharePoint.WorkflowActions名称空间，所以必须从MOSS服务器下找到该类，注册到我们的当前系统中。
一般情况下，这个DLL在MOSS服务器以下路径找到：
|
C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\ISAPI
|
找到后直接使用 【所有程序】－【Microsoft Visual Studio 2005】－【Visual Studio Tools】－【Visual Studio 2005 命令提示】
输入以下命令，将DLL注册到GAC中
|
gacutil /i DLL
在本机的路径
|
然后应用该重启Microsoft Visual Studio 2005，添加应用该程序集合
接下来我们重载Execute()方法，完成我们需要的操作，具体的代码如下：
|
protected
override ActivityExecutionStatus Execute(ActivityExecutionContext executionContext){
try{
//
定义 SPUserCollection 从 __Context 中获取MOSS站点所有用户信息
SPUserCollection spUserCollection = __Context.Web.AllUsers;
//
定义 foreach 循环
foreach (SPUser spUser in spUserCollection){
//
判断对比用户的登录帐号
if (spUser.LoginName == LoginName){
//
将用户的姓名存储到 NameProperty 属性中
base.SetValue(NameProperty, spUser.Name);
break;
}
}
}
catch(){}
return
ActivityExecutionStatus.Closed;
}
|
通过比对用户帐号，从网站的用户信息中搜索到用户的名称，并获取匹配用户的姓名
代码开发工作到此就算完成了，由于我们的DLL最后是要部署到MOSS服务器上的GAC中，所有必须给它加上强签名：
选中解决方案中的项目 【右键】－【属性】
在属性页面中选择【签名】－【为程序集签名】
在下拉框中选择【
<新建
>】，给签名文件添加名称，密码可以不用输入
最后还必须注意一点的是，VS开发的解决方案内的项目默认的程序集名称都是项目名称
程序集名称必须改为：命名空间
+ 项目名称，否则
Designer无法加载到该程序集
最后生成项目，这样就得到我们需要的DLL了
3. 部署
程序开发好后，剩下的就是部署到
MOSS
服务器上，首先，先获取我们开发的
DLL
的
PublicKeyToken
，方法如下
【所有程序】－【Microsoft Visual Studio 2005】－【Visual Studio Tools】－【Visual Studio 2005 命令提示】
|
sn �CT DLL
路径
|
记录下
PublicKeyToken
后，将
DLL
部署到
GAC
中
|
gacutil /i DLL
路径
|
这样，我们开发的
DLL
已经注册到
MOSS
服务器上的程序集中了，可以将它加到
MOSS
中了
由于
Designer
中的工作流操作以及条件全部都是从
MOSS
服务器上获取去的，接下来就是配置一下
.ACTIONS
文件，把我们自定义的操作加到
Designer
中，打开以下路径
|
C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\2052\Workflow\
|
可以看到文件下有一个
WSS.ACTIONS
文件，这个文件是
XML
格式编写的，所有可以直接用记事本打开，里面是
MOSS
自带的工作流条件和操作，我们可以直接在该文件下配置我们的操作，但是不推荐这样做，不利与区分，且维护起来十分麻烦。在该文件下新建一个
.ACTIONS
文件，名字可以随意，
Designer
都可以识别到该文件夹下
.ACTIONS
后缀的文件
配置文件编写如下：
|
<?
xml
version
=
"1.0" encoding="utf-8" ?>
<
WorkflowInfo
>
<
Actions
Sequential
=
"then" Parallel="and">
<
Action
Name
=
"
从用户帐号获取用户名字
"
ClassName
=
"ActivityLibrary1.ActivityLibrary1"
Assembly
=
"ActivityLibrary1.ActivityLibrary1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=DLL
的PublicKeyToken
"
AppliesTo
=
"all"
Category
=
"
自定义工作流操作
">
<
RuleDesigner
Sentence
=
"
从 %1 获取 %2
">
<
FieldBind
Field
=
"LoginName" DesignerType="
SinglePerson
" Text="
帐号
" Id="1" />
<
FieldBind
Field
=
"Name" DesignerType="parameterNames" Text="
名字
" Id="2" />
</
RuleDesigner
>
<
Parameters
>
<
Parameter
Name
=
"__Context" Type="Microsoft.SharePoint.WorkflowActions.WorkflowContext, Microsoft.SharePoint.WorkflowActions" Direction="In"/>
<
Parameter
Name
=
"LoginName" Type="System.String, mscorlib" Direction="In" />
<
Parameter
Name
=
"Name" Type="System.String, mscorlib" Direction="Out" />
</
Parameters
>
</
Action
>
</
Actions
>
</
WorkflowInfo
>
|
需注意的是在
Parameter
节点中，
Type
的值，逗号必须紧跟类型后面，如
Type
=
"System.String, mscorlib"
，如果
Type
=
"System.String , mscorlib"
中间出现空格，
Designer
将无法识别该默认类型，这个错误比较不容易发现。
这样
Designer
已经可以识别到我们的所定义的操作了，最后还需要在我们所要使用的
MOSS
站点中
web.CONFIG
中添加相应的节点
在
<authorizedTypes>
中，添加
|
<
authorizedType
Assembly
=
" ActivityLibrary1.ActivityLibrary1, Version=1.0.0.0, Culture=neutral, PublicKeyToken= DLL
的PublicKeyToken
" Namespace=" ActivityLibrary1" TypeName="*" Authorized="True" />
|
OK
，重启一下
IIS
【开始】－【运行】，输入
CMD
，键入以下命令
|
Iisreset /noforce
|