Edit

Workflow Element (Elements)

  • Article

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Defines a workflow.

Definition

<Workflow
  Title="Text"
  Name="Text"
  CodeBesideAssembly="Text"
  CodeBesideClass="Text"
  Description="Text"
  Id="Text"
  EngineClass="Text"
  EngineAssembly="Text"
  AssociationUrl="Text"
  InstantiationUrl="Text"
  ModificationUrl="Text"
  StatusUrl="Text"
  TaskListContentTypeId="Text" >
</Workflow>

Elements and attributes

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
Title Optional Text.
Name Required Text. Specifies the workflow name that is displayed in the SharePoint Foundation interface. The workflow name can be up to 256 characters long.
CodeBesideAssembly Required Text. Specifies the strong name of the code beside assembly.
CodeBesideClass Required Text. Specifies the name of the workflow class in the code-beside file used to generate the workflow assembly. This should include the namespace of the class.
Description Optional Text. Specifies the workflow description to be displayed in the SharePoint Foundation interface. The workflow description can be up to 256 characters long.
Id Required Text. Specifies the globally unique identifier (GUID) for the workflow.
EngineClass Reserved for future use.
EngineAssembly Reserved for future use.
AssociationUrl Optional Text. Specifies the URL of the association form for this workflow. Set the value of the AssociationURL attribute to the custom form page you want to use for workflow association. For example:

AssociationURL = MyWkflAssociationPage.aspx

Note: SharePoint Foundation supports absolute or server-relative paths in the workflow template definition. All form path URLs must be expressed in one of these formats; for example, an absolute path, such as "http://site/library/page.aspx" or a server-relative path, such as "/layouts/page.aspx". SharePoint Foundation does not support link fix-up in workflow template definitions.

To use the same form for instantiation and association of the workflow, set both elements to that form.

For more information about association forms, see Workflow Association and Initiation Forms (Windows SharePoint Services).
InstantiationUrl Optional Text. Specifies the URL of the initiation form for this workflow. For example:

InstantiationURL = MyWorkflowInitiationPage.aspx

Note: SharePoint Foundation supports absolute or server-relative paths in the workflow template definition. All form path URLs must be expressed in one of these formats; for example, an absolute path, such as "http://site/library/page.aspx" or a server-relative path, such as "/layouts/page.aspx". SharePoint Foundation does not support link fix-up in workflow template definitions.

For more information about initiation forms, see Workflow Association and Initiation Forms (Windows SharePoint Services).
ModificationUrl Optional Text. Specifies the URL of the form handling the modifications for this workflow. If your workflow includes multiple modifications, you can program the form you specify with this attribute to:
  • Display a different view of the form, based on the modification identifier passed to this form.
  • Redirect to a separate form, based on the modification identifier passed to this form.
For more information about modification forms, see Workflow Modification Forms (Windows SharePoint Services).
StatusUrl Obsolete. Do not use.
TaskListContentTypeId Optional Text. Specifies the content type ID of the content type assigned to the workflow task list.

For more information about task forms, see Workflow Task Forms (Windows SharePoint Services).

Child elements

Parent elements

Remarks

For more information about association and initiation forms, see Workflow Association and Initiation Forms (Windows SharePoint Services).

Example

Following is an example of the Workflow element in a workflow definition elements file. The example has been edited for clarity.

<?xml version="1.0" encoding="utf-8" ?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <Workflow Name="AdventureWorksWorkflow"
            Description="Use this workflow to track sequential tasks of users."
            Id="C6964BFF-BG8D-41ac-AC5E-B61EC111731C"
            CodeBesideClass="AdventureWorks.Workflow1"
            CodeBesideAssembly="AdventureWorks, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e3bce121e9429c"
            TaskListContentTypeId="0x01080100C9C9515DE4E24001905074F980F93160"
            AssociationUrl="_layouts/myAssocPage.aspx"
            InstantiationUrl="_layouts/myIniPage.aspx"
            ModificationUrl="_layouts/myModPage.aspx">
    <Categories/>
    <AssociationData>
      …
    </AssociationData>
    <MetaData>
      …
    </MetaData>
  </Workflow>
</Elements>

See also