通过

Workflow 元素（元素）

  • 项目

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

定义一个工作流程。

定义

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

元素和属性

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

Attributes

属性 说明
标题 可选 文本。
名称 必需 文本。 指定在 SharePoint Foundation 接口中显示的工作流名称。 工作流程名称的长度最多可以为 256 个字符。
CodeBesideAssembly 必需属性，类型为 Text。 指定程序集旁边的代码的强名称。
CodeBesideClass 必需属性，类型为 Text。 指定用于生成工作流程程序集的代码旁置文件中的工作流程类的名称。 此名称应包含类的命名空间。
说明 可选 文本。 指定要在 SharePoint Foundation 接口中显示的工作流说明。 此工作流程说明的长度最多可以为 256 个字符。
Id 必需属性，类型为 Text。 指定工作流程的全局唯一标识符 (GUID)。
EngineClass 保留供以后使用。
EngineAssembly 保留供以后使用。
AssociationUrl 可选属性，类型为 Text。 指定此工作流程的关联表单的 URL。 将 AssociationURL 属性的值设置为要用于工作流程关联的自定义表单页。 例如：

AssociationURL = MyWkflAssociationPage.aspx

注意：SharePoint Foundation 支持工作流模板定义中的绝对路径或相对于服务器的路径。 所有表单路径 URL 都必须以以下格式之一表示：例如，绝对路径（如 "http://site/library/page.aspx" 或服务器相对路径），例如 "/layouts/page.aspx"。 SharePoint Foundation 不支持工作流模板定义中的链接修复。

若要为工作流程的实例化和关联使用同一表单，请为该表单设置这两个元素。

有关关联表单的详细信息，请参阅工作流关联和初始表单 (Windows SharePoint Services) 。
InstantiationUrl 可选属性，类型为 Text。 指定此工作流程的初始表单的 URL。 例如：

InstantiationURL = MyWorkflowInitiationPage.aspx

注意：SharePoint Foundation 支持工作流模板定义中的绝对路径或相对于服务器的路径。 所有表单路径 URL 都必须以以下格式之一表示：例如，绝对路径（如 "http://site/library/page.aspx" 或服务器相对路径），例如 "/layouts/page.aspx"。 SharePoint Foundation 不支持工作流模板定义中的链接修复。

有关初始表单的详细信息，请参阅工作流关联和初始表单 (Windows SharePoint Services) 。
ModificationUrl 可选属性，类型为 Text。 指定此工作流程的处理修改的表单的 URL。 如果工作流程包含多处修改，可以使用此属性对指定的表单进行编程以：

  • 基于传递给此表单的修改标识符显示表单的不同视图。
  • 基于传递到此表单的修改标识符，重定向到其他表单。

    • 有关修改表单的详细信息，请参阅工作流修改窗体 (Windows SharePoint Services) 。
    StatusUrl 已过时。 请勿使用。
    TaskListContentTypeId 可选属性，类型为 Text。 指定分配给工作流程任务列表的内容类型的内容类型 ID。

    有关任务窗体的详细信息，请参阅工作流任务表单 (Windows SharePoint Services) 。

    子元素

    AssociationData 元素（工作流）

    MetaData 元素（工作流）

    Categories 元素（工作流）

    父元素

    Elements 元素（工作流）

    备注

    有关关联和启动表单的详细信息，请参阅工作流关联和启动表单 (Windows SharePoint Services) 。

    示例

    以下是工作流程定义元素文件中的 Workflow 元素的一个示例。 为了清楚起见，已对该示例进行了编辑。

        <?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>

    另请参阅