通过

Association 元素 (WorkflowConfig)

  • 项目

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

包含基于声明性规则的无代码工作流编辑器（如 Microsoft SharePoint Designer 2010）将工作流模板与 SharePoint Foundation 中的指定 SharePoint 列表关联所需的信息。

定义

<Association
  ListID="Text"
  TaskListID="Text"
  HistoryListID="Text"
  StartManually="true" | "false"
  StartOnCreate="true" | "false"
  StartOnChange="true" | "false"
>
</Association>

元素和属性

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

Attributes

属性

说明

**ListID**

必需 **Text**。 指定工作流程应关联到的列表的 GUID。

**TaskListID**

必需 **Text**。 指定工作流程应为工作流程任务使用的任务列表的 GUID（如果有）。

**HistoryListID**

可选 **Text**。 指定工作流程应为记录工作流程历史事件使用的历史记录列表的 GUID（如果有）。

如果没有指定，则工作流程会将工作流程历史事件记录到默认的历史记录列表。

**StartManually**

可选 **Boolean**。 如果设置为 True，则用户可以手动启动工作流程。

如果此属性不存在，SharePoint Foundation 会将工作流视为将此属性设置为 false。

**StartOnCreate**

可选 **Boolean**。 如果设置为 true，则 SharePoint Foundation 在与工作流关联的列表上创建新项目时自动启动工作流。

如果此属性不存在，SharePoint Foundation 会将工作流视为将此属性设置为 false。

**StartOnChange**

可选 **Boolean**。 如果设置为 true，SharePoint Foundation 会在工作流所关联的列表上的项发生更改时自动启动工作流。

如果此属性不存在，SharePoint Foundation 会将工作流视为将此属性设置为 false。

子元素

无

父元素

元素
WorkflowConfig 元素

备注

工作流与特定 SharePoint 列表关联后，以下属性的值将存储在工作流的 SPWorkflowAssociation 对象中：

创建的应用程序可以用作基于声明性规则的无代码工作流编辑器，可以使用 WebsvcWebPartPages Web 服务的 AssociateWorkflowMarkup (String、String) 方法创建工作流模板并将其关联到指定工作流标记文件、工作流配置文件和工作流规则标记文件的 SharePoint 列表。

有关创建可用作基于规则的声明性无代码工作流编辑器的应用程序的详细信息，请参阅Creating Declarative, No-Code Workflow Editors。

示例

下面的示例演示工作流程配置的 Association 元素。 此元素属性指定工作流程关联到的 SharePoint 列表（工作流程使用的任务列表），指定可以手动启动工作流程，并指定当在列表上创建新项目时将自动启动工作流程。

    <Association
        ListID="{B8C6FEEA-8066-462E-958D-1B4E90FE1C34}"
        TaskListID="{C64BA541-9D5B-42F3-A989-96F56FD51155}"
        StartManually="true"
        StartOnCreate="true"
    >

另请参阅