在 Workflow Manager 1.0 工作流中定义和使用自定义代码活动与类型

• 支持自定义代码活动
  
  
• 支持自定义数据类型
  
  
• 删除自定义代码活动或数据类型
  
  
• 通过禁用对任意代码的执行防护来支持自定义代码
  
  

注意
本主题概述了如何在 Workflow Manager 1.0 中使用自定义代码活动。有关创建自定义代码活动的详细信息，请参阅Designing and Implementing Custom Activities和Authoring Workflows, Activities, and Expressions Using Imperative Code。Workflow Manager 1.0 支持从 Activity 和 CodeActivity 继承的自定义活动。

Workflow Manager 1.0 允许用户发布和使用自己的声明性活动与声明性工作流。它还提供一组丰富的可在用户的活动和工作流中使用的现成工作流活动。Workflow Manager 1.0 还定义了一个“受信任图面”，其中包括支持的类型和活动集。

注意
有关 Workflow Manager 1.0 中的现成活动以及受信任图面的详细信息，请参阅 Workflow Manager 1.0 活动概述和 Workflow Manager 1.0 受信任图面。

扩展允许的类型和活动集可能会对 Workflow Manager 1.0 的安全性、性能、可伸缩性和可用性产生重大影响，除非绝对必要（例如，当工作流需要执行复杂的计算或数据转换，但声明性活动中的作者无法实施这种计算或转换时），否则不应考虑这种操作。在此情况下，高级用户可能需要改用自定义代码活动。服务器管理员可以扩展允许的类型集以包括此代码活动，但前提是该管理员完全信任此代码活动。

注意
执行 I/O 的活动应使用支持的 Http 消息活动，以确保通信参与一致性模型。有关详细信息，请参阅 Workflow Manager 1.0 中的消息和 Http Activities。

要扩展允许的类型集，管理员需要执行以下步骤：

1. 将包含类型的程序集（例如某个自定义代码活动）连同所有依赖文件一起复制到以下两个文件夹中：
   
   
   • C:\Program Files\Workflow Manager\1.0\Workflow\WFWebRoot\bin
     
     
   • C:\Program Files\Workflow Manager\1.0\Workflow\Artifacts
     
     
2. 在 C:\Program Files\Workflow Manager\1.0\Workflow\WFWebRoot\bin 中创建一个名为 AllowedTypes.xml 的文件
   
   
3. 编辑 AllowedTypes.xml 并在 <AllowedTypes> xml 元素内添加所需类型，如以下示例所示。
   
   
   复制

   <AllowedTypes>
     <Assembly Name="Contoso.DataTransformations">
       <Namespace Name="Contoso.DataTransformations.Activities">
         <Type>DoDomainSpecificCalculation1</Type>
       </Namespace>
     </Assembly>
   
     <Assembly Name="Contoso.StronglyTypedAssembly, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35">
       <Namespace Name="Contoso.FinancialCalculation.Activities">
         <Type> GetPresentValueOfABond</Type>
       </Namespace>
     </Assembly>
   </AllowedTypes>
   

4. 将 AllowedTypes.xml 复制到第二个文件夹：C:\Program Files\Workflow Manager\1.0\Workflow\Artifacts
   
   
5. 在下一个计划维护期段重新启动 Workflow Manager 1.0 服务器。
   
   

注意
对于多服务器部署，必须在每台服务器上执行上述步骤。

现在，在步骤 3 中添加的类型可以在新发布的活动和工作流中使用。

注意
在 Workflow Manager 1.0 中，上述方法仅限派生自 Activity 或 CodeActivity 基类的自定义代码活动。

也可以将自定义数据类型添加到允许的类型集。要在工作流中启用该类型，应执行如上所述的相同一组步骤。但是，可能需要将其他活动添加到允许的类型列表，以访问该自定义数据类型的属性或初始化该自定义数据类型。表达式转换器不会自动处理属性引用；因此，在此情况下不能使用 VB 表达式。例如，如果自定义类型 Employee 包含 Name 和 Salary 属性，并且需要从工作流访问这些属性，则应创作 GetEmployeeName 和 GetEmployeeSalary 自定义代码活动，并将其添加到允许的类型列表。

要从允许的类型列表中删除以前添加的类型，需要执行以下步骤：

1. 在每台服务器上的两个位置（C:\Program Files\Workflow Manager\1.0\Workflow\WFWebRoot\bin 和 C:\Program Files\Workflow Manager\1.0\Workflow\Artifacts）编辑 AllowedTypes.xml，然后删除你想要从允许类型列表中删除的一个或多个类型的引用。
   
   
2. 在所有服务器上停止 WorkflowServiceBackend 服务
   
   
3. 在所有服务器上停止 WorkflowMgmtPool 应用程序池 - 这会显示 Workflow Manager 1.0 服务器不可用，因此应在维护期段内执行此操作
   
   
4. 在所有服务器上删除以前已复制到 C:\Program Files\Workflow Manager\1.0\Workflow\WFWebRoot\bin 和 C:\Program Files\Workflow Manager\1.0\Workflow\Artifacts 的所有自定义文件
   
   
5. 在所有服务器上启动 WorkflowMgmtPool 应用程序池
   
   
6. 在所有服务器上启动 WorkflowServiceBackend 服务
   
   
7. 删除使用了一个或多个已删除类型的所有声明性活动和工作流，使它们不再引用已删除的类型；或者发布这些不再引用已删除类型的活动和工作流的新版本。
   
   

Workflow Manager 1.0 允许管理员禁用对任意代码的执行防护。在开发解决方案的过程中，需要使用自定义代码来避免不断向允许类型的列表添加其他需要的类型，此时该选项可能非常便利。禁用对任意代码的执行防护后，其效果类似于向允许类型的列表添加来自服务器上所有程序集的所有类型。这会牵涉到相应的安全问题，因此，仅当已对 Workflow Manager 1.0 进行配置，使得只有受信任用户才有权上载工作流活动或修改 Workflow Manager 1.0 所用的数据库时，才应使用此选项。

禁用对任意代码的执行防护

重新启用对任意代码的执行防护