使用VS2012 开发SharePoint 2013 客户化的action (代码)

本文讲述使用VS2012 开发SharePoint 2013 客户化的action (代码)。

使用代码 客户化的action的action好处是所有本地代码可以做的事情都可以做，相对声明式的action 更灵活和强大，但是Office 365和SharePoint online是不支持的，只能部署在on-promise 环境。

下面以一个简单需求为例来讲述如何使用代码开发SharePoint 2013 客户化的action：

需求：开发一个action反转一个字符，输入要反转的字符串，输出反转结果

准备工作同：http://blog.csdn.net/abrahamcheng/article/details/12652495

使用VS 2012完成以下工作：

1. 新建一个Workflow library 的项目,命名为CustomCodeActions

2. 在项目中新建 code activity Item

3. ReverseString.cs 内容为：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Activities;

namespace CustomCodeActions
{
    public sealed class ReverseSretring : CodeActivity
    {
        // Define an activity input argument of type string   

        [RequiredArgument]
        public InArgument<string> Input { get; set; }  //输入参数     

        [RequiredArgument]
        public OutArgument<string> Output { get; set; } // 输出参数

        // If your activity returns a value, derive from CodeActivity<TResult>
        // and return the value from the Execute method.
        protected override void Execute(CodeActivityContext context)
        {
            string input = Input.Get<string>(context);  //取得输入参数         
            char[] arr = input.ToCharArray();
            Array.Reverse(arr);
            string output = new string(arr);
            Output.Set(context, output);  // 设置输出参数          
        }
    }
}

4. 新建 AllowedTypes.xml，内容为：

<?xml version="1.0" encoding="utf-8" ?>
<AllowedTypes>
  <Assembly Name="CustomCodeActions">
    <Namespace Name="CustomCodeActions">
      <Type>ReverseSretring</Type>
    </Namespace>
  </Assembly>
</AllowedTypes>

该文件部署时要复制到

%ProgramFiles%\Workflow Manager\1.0\Workflow\Artifacts
%ProgramFiles%\Workflow Manager\1.0\Workflow\WFWebRoot\bin

5. 给项目添加强名

6.编译项目，使用VS2012 Command Prompt运行如下命令取PublickeyToken,第7步会用到它

sn -T CustomCodeActions.dll

7. 新建 ReverseString.actions4，内容为(注意替换PublickeyToken)

<?xml version="1.0" encoding="utf-8"?>
<WorkflowInfo Language="en-us">
  <Actions>
  <Action
    Name="ReverseSretring"
    ClassName="CustomCodeActions.ReverseSretring"
    Assembly ="CustomCodeActions, Version=1.0.0.0, Culture=neutral, PublickeyToken=e99e4e028044a473"
    Category="Custom"
    AppliesTo="all">
    <RuleDesigner Sentence="Reverse string %1 and out put to %2">
      <!-- Define the UI widgets SharePoint designer should use for configuring this action -->
      <FieldBind Field="Input" Text="Input string" Id="1" DesignerType="TextOnly" DisplayName="Input string" />
      <FieldBind Field="Output" Text="Output string" Id="2" DesignerType="ParameterNames" DisplayName="Output string" />
    </RuleDesigner>
    <Parameters>
      <Parameter Name="Input" Type="System.String, mscorlib" Direction="In" DesignerType="TextOnly" Description="Input string" />
      <Parameter Name="Output" Type="System.String, mscorlib" Direction="Out" DesignerType="ParameterNames" Description="Output string" />
    </Parameters>
  </Action>
  </Actions>
</WorkflowInfo>

部署code action: 

1.在Workflow manager box上的部署

a.将CustomCodeActions.dll 和AllowedTypes.xml拷贝到如下目录

%ProgramFiles%\WorkflowManager\1.0\Workflow\Artifacts

%ProgramFiles%\WorkflowManager\1.0\Workflow\WFWebRoot\bin

b.重启"Workflow Manager backend"服务

2. 在SharePoint box服务器上的部署

a. 将 CustomCodeActions.dll注册到GAC (使用 gacutil/iCustomCodeActions.dll)

b. 将ReverseString.actions4拷贝到 ~ProgramFiles\Common Files\microsoft shared\Web ServerExtensions\15\TEMPLATE\1033\Workflow

c. 重启IIS

测试CodeAction 

1. 清空SharePoint designer 2013 的缓存 C:\Users\v-abchen\AppData\Local\Microsoft\WebsiteCache

2. 启动SharePoint designer 2013，新建一个基于SharePoint 2013 平台的Site workflow

3. 给worklfow添加两个string变量

4. 将messageNeedReverse设置为123456789，并添加ReverString action

5. 输入变量设置为messageNeedReverse，输出变量设置为reversedMessage,将reversedMessage记录到workflow history 中，并添加go to "End of workflow" 结束工作流的语句

6. 启动测试工作流(不要使用系统帐号启动)，等待其完成，查看workflow history: