Share via

Association Element (WorkflowConfig)

  • Article

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Contains the information necessary for a declarative rules-based, code-free workflow editor, such as Office SharePoint Designer 2007, to associate a workflow template with the specified SharePoint list in Windows SharePoint Services.

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

Attributes

Attribute

Description

ListID

Required Text. Specifies the GUID of the list to which the workflow should be associated.

TaskListID

Required Text. Specifies the GUID of the task list the workflow should use for workflow tasks, if any.

HistoryListID

Optional Text. Specifies the GUID of the history list the workflow should use for logging workflow history events, if any.

If not specified, the workflow logs workflow history events to a default history list.

StartManually

Optional Boolean. If set to true, the workflow may be manually started by users.

If this attribute is not present, Windows SharePoint Services treats the workflow as if this attribute is set to false.

StartOnCreate

Optional Boolean. If set to true, Windows SharePoint Services starts the workflow automatically when a new item is created on the list to which the workflow is associated.

If this attribute is not present, Windows SharePoint Services treats the workflow as if this attribute is set to false.

StartOnChange

Optional Boolean. If set to true, Windows SharePoint Services starts the workflow automatically when an item is changed on the list to which the workflow is associated.

If this attribute is not present, Windows SharePoint Services treats the workflow as if this attribute is set to false.

Child Elements

None

Parent Elements

WorkflowConfig Element

Remarks

Once the workflow has been associated with a specific SharePoint list, the values of the following attributes are stored in the SPWorkflowAssociation object for the workflow:

  • The StartManually attribute value is stored in the AllowManual property.

  • The StartOnCreate attribute value is stored in the AutoStartCreate property.

  • The StartOnChange attribute value is stored in the AutoStartChange property.

  • The HistoryListID attribute value is stored in the HistoryListId property.

  • The TaskListID attribute value is stored in the TaskListId property.

Applications created to work as a declarative rules-based, code-free workflow editor can use the AssociateWorkflowMarkup method of the websvcWebPartPages Web Service to create a workflow template and associate it to a SharePoint list specifying a workflow markup file, a workflow configuration file, and optionally, a workflow rules markup file.

For more information about creating an application that can act as a declarative rules-based, code-free workflow editor, see Creating Declarative, No-Code Workflow Editors.

Example

The following example shows an Association element for a workflow configuration. The element attributes specify the SharePoint list to which the workflow is associated, the task list the workflow uses, that the workflow can be started manually, and that the workflow starts automatically when a new item is created on the list.

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

See Also

Concepts

Workflow Development for Windows SharePoint Services

Creating Declarative, No-Code Workflow Editors

Workflow Configuration Schema Overview

Office SharePoint Designer 2007 Overview