Workflow Configuration Schema Overview

  • 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.

The workflow configuration file contains the information necessary to create a workflow template in Windows SharePoint Services from the specified workflow markup and rules files, and to associate it to a specific SharePoint list. Information included in the workflow configuration file includes:

  • The workflow markup and rules files to use, including the appropriate version of those files to use.

  • The SharePoint list to which the workflow should be associated.

  • The task list and history list for the workflow to use.

  • Conditions under which the workflow starts.

  • Workflow initiation form location, data fields, and default values.

The workflow configuration file is specified as a parameter for the following methods of the websvcWebPartPages Web Service. These methods enable declarative rules-based, code-free workflow editors, such as Office SharePoint Designer 2007, to create declarative workflow templates in Windows SharePoint Services and associate those workflow templates with SharePoint lists.

  • ValidateWorkflowMarkupAndCreateSupportObjects

    Use this method to validate the workflow markup of a declarative workflow, and optionally, create the support objects necessary for that workflow to run.

  • AssociateWorkflowMarkup

    Use this method to create a workflow template, and associate that workflow template with the specified SharePoint list.

For more information about creating workflow editors, see Creating Declarative, No-Code Workflow Editors.

The workflow configuration schema contains the following elements:

<WorkflowConfig Element>

   <Template Element (WorkflowConfig)>

   <Association Element (WorkflowConfig)>

   <ContentTypes Element (WorkflowConfig)>

      <ContentType Element (WorkflowConfig)>

   <Initiation Element (WorkflowConfig)>

      <Fields Element (WorkflowConfig)>

      <Parameters Element (WorkflowConfig)>

         <Parameter Element (WorkflowConfig)>

Example

Description

Elements have been edited for readability.

Code

<WorkflowConfig>
  <Template
    BaseID="{68B99644-EDCE-4988-9D11-7FD5CCAE09CC}"
    DocLibID="{74FAE22C-0176-46DF-AA12-988CE79C8889}"
    XomlHref="Workflows/Notify Me/Notify Me.xoml"
    XomlVersion="V3.0"
    RulesHref="Workflows/Notify Me/Notify Me.xoml.rules"
    RulesVersion="V3.0"
  >
  </Template>
  <Association
    ListID="{B8C6FEEA-8066-462E-958D-1B4E90FE1C34}"
    TaskListID="{C64BA541-9D5B-42F3-A989-96F56FD51155}"
    StartManually="true"
    StartOnCreate="true"
  >
  </Association>
  <ContentTypes>
    <ContentType 
      Name="Review New Document" 
      ContentTypeID=
        "0x0108010086C115D5C5C27B439C22EB22F050B49B00DD9F97273595EA4BA32838A26054BF08" 
      Form="/Workflows/Notify Me/Review New Document.aspx" 
      Description="Workflow used to review new documents">
      <Fields/>
    </ContentType>
  </ContentTypes>
  <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>
</WorkflowConfig>

See Also

Concepts

Workflow Development for Windows SharePoint Services

Creating Declarative, No-Code Workflow Editors

Office SharePoint Designer 2007 Overview