通过

Action 元素 (WorkflowInfo)

  • 项目

适用于：SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

包含工作流引擎处理工作流活动所需的信息，该活动在 Microsoft SharePoint Foundation 2010 中称为操作。 workflow Action 元素表示工作流活动，例如发送电子邮件通知、更新 SharePoint Foundation 2010 列表项、创建和分配任务以及许多其他活动。

默认情况下，SharePoint Foundation 2010 提供 23 个内置工作流操作。 这些操作在 WSS.ACTIONS 文件中定义。

定义

<Actions>
    <Action>
        <Parameters>
        </Parameters>
        <RuleDesigner>
        </RuleDesigner>
        <DataSources>
        </DataSources>
        <Modifications>
            <Modification>
            </Modification>
        </Modifications>
        <ActionVariables>
        </ActionVariables>
        <ActionBody>
        </ActionBody>
        <ActionConditions>
        </ActionConditions>
    </Action>
</Actions>

元素和属性

下面各部分介绍了属性、子元素和父元素。

属性

属性

说明

**名字**

必需 **text**。 表示在工作流编辑器中显示的工作流操作的说明。

**ClassName**

必需 **text**。 实现工作流操作的类的完全限定名称;例如，**Microsoft.SharePoint.WorkflowActions.EmailActivity**。

**装配**

必需 **text**。 包含实现 Action 元素的说明的 Microsoft .NET 程序集名称。 文本应包括 PublicKeyToken、版本和区域性。

**FunctionName**

可选 **text**。 对于沙盒解决方案，指定要调用的函数的名称。

**类别**

可选 **text**。 提供工作流操作的类别。 此 “text” 用于筛选可用操作的列表。

**CreatesTask**

可选 **Boolean**。 如果设置为 “true”，则会在工作流中创建任务列表项。 如果留空，则假设为 “false”，并且不会创建任何任务列表项。

**CreatesInList**

可选 **text**。 如果为此属性设置一个值，则工作流会在列表中创建项。 值必须映射到包含列表或文档库的 ID 的参数名称。

**AppliesTo**

必需 **text**。 指示此工作流操作是否可用于列表和/或文档库。 有效值包括列表、doclib 和 all。

**IsError**

可选 **Boolean**。 如果设置为 “true”，客户端应用程序会将此 Action 元素的实例视为错误。

**ListModeration**

可选 **Boolean**。 如果设置为 “true”，则此 “Action” 元素适用于启用了内容审批的列表或文档库。 如果留空，则假设为 false。

**UsesCurrentItem**

可选 **Boolean**。 如果设置为 **true**，则指示应使用或修改当前项。 如果设置为 “false” 或留空，则此 **Action** 元素仅使用指定的 SharePoint 列表或文档库项。

**CreatedTaskFormType**

可选 **text**。 指定已创建任务的类型：**DataCollectTask**，以创建从一个用户收集数据的任务;**GroupAssignedTask**，用于创建从一个或多个用户收集数据的任务;**TodoItemTask**创建一个任务，该任务不从用户收集数据，但仅存在，以验证他们是否已执行某些操作;或 “TaskProcess” ，用于创建具有允许临时协作的表单的任务，并且可能从一个或多个用户收集数据。

**__SolutionId**

可选 **text**。 指定客户端应用程序写入到特定于实现的操作的 GUID。 服务器使用 GUID 来帮助在工作流运行时查找程序集。

**SandboxedFunction**

可选 **Boolean**。 如果设置为 “true”，则当选中此操作时，客户端应用程序将插入特定于实现的操作。 操作应配置为调用由 AssemblyName、ClassName 和 FunctionName 联合定义的函数。 如果已设置，则还必须设置“AssemblyName”、“ClassName”、“FunctionName”和“__SolutionId”。

子元素

参数

RuleDesigner

DataSources

修改

ActionVariables

ActionBody

ActionConditions

父元素

操作

示例

下面的代码示例演示如何构造 Action 元素，使其显示在工作流编辑器中。 请注意，为了提高可读性，已对此 XML 代码进行了修改。

    <WorkflowInfo>
      <Conditions>…</Conditions>
      <Actions Sequential="then" Parallel="and">
        <Action Name="Update my custom SharePoint list"
                ClassName="CustomActivities.OrderListFunctions"
                Assembly="CustomActivities,
                          PublicKeyToken=b03f5f7f11d50a3a,
                          Version=1.0.0.0,
                          Culture=neutral"
                Category="My Custom Actions"
                CreatesTask="true"
                CreatesInList="UpdateList"
                AppliesTo="all"
                ListModeration="false"
                UsesCurrentItem="true">
          <RuleDesigner Sentence="Update %1">
            <FieldBind Field="UpdateList"
                       Function="UpdateOrderList"
                       DesignerType="ChooseListItem"
                       ID="1"
                       Text="My Custom List">
            </FieldBind>
          </RuleDesigner>
          <Parameters>
            <Parameter Type="System.String, mscorlib"
                       Direction="In"
                       Name="UpdateList"
            </Parameters>
        </Action>
      </Actions>
    </WorkflowInfo>

另请参阅