Initiation Element (WorkflowConfig)

Applies to: SharePoint Foundation 2010

Contains workflow initiation information, such as the workflow initiation form, and the data fields on the initiation form.

<Initiation URL="Text"
</Initiation>

Attributes

Child Elements

Parent Elements

Remarks

The initiation form specified should contain a data field for each Field Element (Field) element defined in the Fields Element (WorkflowConfig) section of the workflow configuration file. If a data field is not present, the default value is used when the workflow starts.

Once the workflow has been associated with a specific SharePoint list, the contents of the URL attribute are stored in the InstantiationUrl property of the SPWorkflowTemplate and SPWorkflowAssociation objects for the workflow.

Applications created to work as a declarative rules-based, code-free workflow editor can use the AssociateWorkflowMarkup(String, String) 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 Initiation element contains a URL attribute that specifies the location of the workflow initiation form to use for this workflow.

The element also contains a Fields element, which in turn contains a Field element that defines the single data field on the initiation form. Note that the Parameters element contains a corresponding Parameter element, with a matching Name attribute value, that specifies the data type of the Field element.

This example has been edited for clarity.

<Initiation 
    URL="Workflows/Notify Me/Notify Me.aspx">
  <Fields>
    <Field 
      Name="Reason_for_Review" 
      …
      DisplayName="Reason_for_Review" 
      …
    >
      <Default>Standard review of new documents</Default>
    </Field>
  </Fields>
  <Parameters>
    <Parameter Name="Reason_for_Review" Type="System.String" />
  </Parameters>
</Initiation>

See Also

Concepts

Workflow Development for SharePoint Foundation

Creating Declarative, No-Code Workflow Editors

Workflow Configuration Schema Overview

SharePoint Designer Workflow Overview