This documentation is archived and is not being maintained.

Tasks

A task specifies work that must occur to configure something specific to the process in a new team project. Tasks can perform work such as create a new work item type, add a report, copy a file to the project portal, and configure a security group.

For example, the following XML shows a task that creates all the work item types by referencing the work item type definition files:

<task
   id="WITs"
   name="WorkItemType definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage="WorkItemTypes created"         
   completionDescription = "Processing work item types used by work item tracking">
   <taskXml>
      <WORKITEMTYPES>
         <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml"/>
         <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml"/>
         <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Qos.xml"/>
         <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Scenario.xml"/>
         <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Risk.xml"/>
      </WORKITEMTYPES>
   </taskXml>
</task>

The following table describes each element in a task.

Element

Description

id

Identifies the task. If another task depends on this task, it references this id.

name

Describes what the task does.

plugin

Identifies which plug-in must run this task.

completionMessage

Displays a message to the user if the task is completed successfully. The message is displayed during team project creation.

completionDescription

Displays a description while the task is in process. The description is displayed during team project creation.

dependency

Specifies the id of another task that this task depends on. The other task must complete before this task can start.

taskXml

Contains information describing the work that must occur to complete this task. The XML inside this element block varies and is specific to each plug-in.

Show: