Partager via


Task Element

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.

There must be at least one task in each Tasks collection.

<Task>
  ComplexTypeValue
</Task>

Parent Elements

Tasks

Child Elements

Element

Required / Optional

Description

UID

Required

Unique ID for the task.

ID

Optional

Position identifier of the task in the list of tasks.

Name

Optional

Name of the task.

Type

Optional

Type of the task (fixed units, fixed duration, or fixed work).

IsNull

Optional

Indicates whether a task is null.

CreateDate

Optional

Date and time that a task was added to a project.

Contact

Optional

Name of the individual who is responsible for a task.

WBS

Optional

A unique code (work breakdown structure) used to represent a task's position within the hierarchical structure of tasks.

WBSLevel

Optional

Right-most level of the task. For example, if the task WBS is A.01.03, the right-most level is 03.

OutlineNumber

Optional

Number that indicates the level of a task in the project outline hierarchy.

OutlineLevel

Optional

Indicates the exact position of a task in the outline.

Priority

Optional

Indicates the level of importance assigned to a task

Start

Optional

Date and time that a task is scheduled to begin.

Finish

Optional

The date and time that a task is scheduled to be completed.

Duration

Optional

Total span of active working time for a task.

DurationFormat

Optional

Format used to show the duration of the task.

Work

Optional

Total amount of work scheduled to be performed on a task by all assigned resources.

Stop

Optional

Date that represents the end of the actual portion of a task.

Resume

Optional

Date the remaining portion of a task is scheduled to resume.

ResumeValid

Optional

Indicates whether the task can be resumed.

EffortDriven

Optional

Indicates whether scheduling for a task is effort-driven.

Recurring

Optional

Indicates whether a task is a recurring task.

OverAllocated

Optional

Indicates whether an assigned resource on a task has more work than can be done within the normal working capacity.

Estimated

Optional

Indicates whether the task's duration is flagged as an estimate.

Milestone

Optional

Indicates whether a task is a milestone.

Summary

Optional

Indicates whether a task is a summary task.

Critical

Optional

Indicates whether a task has room in the schedule to slip, or if it is on the critical path.

IsSubproject

Optional

Indicates whether the task is an inserted project.

IsSubprojectReadOnly

Optional

Indicates whether the inserted project is a read-only project.

SubprojectName

Optional

Source location of the inserted project.

ExternalTask

Optional

Indicates whether the task is linked from another project or whether it originated in the current project.

ExternalTaskProject

Optional

Source of an external task.

EarlyStart

Optional

The earliest date that a task can begin, based on the early start dates of predecessor and successor tasks and other constraints.

EarlyFinish

Optional

The earliest date that a task can finish, based on early finish dates of predecessor and successor tasks, other constraints, and any leveling delay.

LateStart

Optional

The latest date that a task can start without delaying the finish of the project.

LateFinish

Optional

The latest date that a task can finish without delaying the finish of the project.

StartVariance

Optional

The difference between a task's baseline start date and its currently scheduled start date.

FinishVariance

Optional

The amount of time that represents the difference between a task's baseline finish date and its current finish date.

WorkVariance

Optional

The difference between a task's baseline work and the currently scheduled work.

FreeSlack

Optional

The amount of time that a task can be delayed without delaying any successor tasks.

TotalSlack

Optional

The amount of time a task can be delayed without delaying a project's finish date.

FixedCost

Optional

A task expense that is not associated with a resource cost.

FixedCostAccrual

Optional

Indicates how fixed costs are to be charged, or accrued, to the cost of a task.

PercentComplete

Optional

The current status of a task, expressed as the percentage of the task's duration that has been completed.

PercentWorkComplete

Optional

The current status of a task, expressed as the percentage of the task's work that has been completed.

Cost

Optional

The total scheduled, or projected, cost for a task.

OvertimeCost

Optional

Sum of the actual overtime cost for the task.

OvertimeWork

Optional

Amount of overtime scheduled to be performed by all resources assigned to a task and charged at overtime rates.

ActualStart

Optional

Date and time that a task actually began.

ActualFinish

Optional

Date and time that a task actually finished.

ActualDuration

Optional

Span of actual working time for a task so far, based on the scheduled duration and current remaining work or percent complete.

ActualCost

Optional

Costs incurred for work already performed by all resources on a task, along with any other recorded costs associated with the task.

ActualOvertimeCost

Optional

Costs incurred for overtime work already performed on a task by all assigned resources.

ActualWork

Optional

Amount of work that has already been done by the resources assigned to a task.

ActualOvertimeWork

Optional

Actual amount of overtime work already performed by all resources assigned to a task.

RegularWork

Optional

Total amount of non-overtime work scheduled to be performed by all resources assigned to a task.

RemainingDuration

Optional

Total amount of non-overtime work scheduled to be performed by all resources assigned to a task.

RemainingCost

Optional

Amount of time required to complete the unfinished portion of a task.

RemainingWork

Optional

Remaining scheduled expense of a task that will be incurred in completing the remaining scheduled work by all resources assigned to a task.

RemainingOvertimeCost

Optional

Remaining scheduled overtime expense for a task.

RemainingOvertimeWork

Optional

Amount of remaining overtime scheduled by all assigned resources to complete a task.

ACWP

Optional

Costs incurred for work already done on a task, up to the project status date or today's date.

CV

Optional

Difference between how much it should have cost to achieve the current level of completion on the task and how much it has actually cost.

ConstraintType

Optional

Start or finish constraint on a scheduled task.

CalendarUID

Optional

Refers to a valid UID for a project calendar.

ConstraintDate

Optional

Indicates the constrained start or finish date as defined in ConstraintType.

Deadline

Optional

Date entered as a deadline for the task.

LevelAssignments

Optional

Indicates whether the leveling function can delay and split individual assignments (rather than the entire task) to resolve overallocations.

LevelingCanSplit

Optional

Indicates whether the resource leveling function can cause splits on remaining work on a task.

LevelingDelay

Optional

Amount of time that a task is to be delayed from its early start date as a result of resource leveling.

LevelingDelayFormat

Optional

Format for expressing the duration of the delay.

PreLeveledStart

Optional

Start date of a task as it was before resource leveling was done.

PreLeveledFinish

Optional

Finish date of a task as it was before resource leveling was done.

Hyperlink

Optional

Title or explanatory text for a hyperlink associated with a task.

HyperlinkAddress

Optional

Address for a hyperlink associated with a task.

HyperlinkSubAddress

Optional

Specific location in a document within a hyperlink associated with a task.

IgnoreResourceCalendar

Optional

Indicates whether the scheduling of the task takes into account the calendars of the resources assigned to the task.

Notes

Optional

Notes entered about a task.

HideBar

Optional

Indicates whether the Gantt bars and Calendar bars for a task are hidden.

Rollup

Optional

Indicates whether the summary task in a Gantt chart displays information rolled up from subtasks.

BCWS

Optional

Cumulative timephased baseline costs up to the status date or today's date; also known as budgeted cost of work scheduled.

BCWP

Optional

Cumulative value of the task's timephased percent complete multiplied by the task's timephased baseline cost, up to the status date or today's date; also known as budgeted cost of work performed.

PhysicalPercentComplete

Optional

Physical percent of the total work on a task that has been completed.

EarnedValueMethod

Optional

Indicates the type of earned value method to use.

PredecessorLink

Optional

Specifies the predecessor task of the current task.

ActualWorkProtected

Optional

Specifies the duration through which actual work is protected.

ActualOvertimeWorkProtected

Optional

Specifies the duration through which actual overtime work is protected.

Baseline

Optional

Collection of baseline values of the task.

IsPublished

Optional

New in Microsoft Office Project 2007. Indicates whether the task is published.

StatusManager

Optional

New in Project 2007. Name of the task status manager.

CommitmentStart

Optional

New in Project 2007. Start date of the deliverable.

CommitmentFinish

Optional

New in Project 2007. Finish date of the deliverable.

CommitmentType

Optional

New in Project 2007. Indicates whether the task has an associated deliverable or a dependency on an associated deliverable.

b408000 – b417fff

Optional

New in Project 2007. A task-level enterprise custom field value.

b608000 – b617fff

Optional

New in Project 2007. A project-level enterprise custom field value.

ExtendedAttribute

Optional

Specifies the value of a task custom field.

OutlineCode

Optional

Specifies the value of a task outline code.

TimephasedData

Optional

Timephased data associated with the task.

Project

Optional

If the task is a subproject, specifies the inserted subproject data.

Occurrences

Minimum: 0

Maximum: Unbounded

Example

In the following example, the task UID = 4 although the task ID = 3, because a task was deleted before task T3 was created. UID values must be unique within a project. Because there is no custom WBSMask defined, the task WBS value is the same as the OutlineNumber.

<Task>
   <UID>4</UID>
   <ID>3</ID>
   <Name>T3</Name>
   <Type>1</Type>
   <IsNull>0</IsNull>
   <CreateDate>2007-11-13T14:33:00</CreateDate>
   <WBS>1.2</WBS>
   <WBSLevel>2</WBSLevel>
   <OutlineNumber>1.2</OutlineNumber>
   <OutlineLevel>2</OutlineLevel>
   <Priority>500</Priority>
   <Start>2007-11-14T08:00:00</Start>
   <Finish>2007-11-15T17:00:00</Finish>
   <Duration>PT16H0M0S</Duration>
   <DurationFormat>53</DurationFormat>
   <Work>PT0H0M0S</Work>
   <ResumeValid>0</ResumeValid>
   <EffortDriven>0</EffortDriven>
   <Recurring>0</Recurring>
   <OverAllocated>0</OverAllocated>
   <Estimated>1</Estimated>
   <Milestone>0</Milestone>
   <Summary>1</Summary>
   <Critical>1</Critical>
   <IsSubproject>0</IsSubproject>
   <IsSubprojectReadOnly>0</IsSubprojectReadOnly>
   <ExternalTask>0</ExternalTask>
   <EarlyStart>2007-11-14T08:00:00</EarlyStart>
   <EarlyFinish>2007-11-15T17:00:00</EarlyFinish>
   <LateStart>2007-11-14T08:00:00</LateStart>
   <LateFinish>2007-11-15T17:00:00</LateFinish>
   <StartVariance>0</StartVariance>
   <FinishVariance>0</FinishVariance>
   <WorkVariance>0</WorkVariance>
   <FreeSlack>0</FreeSlack>
   <TotalSlack>0</TotalSlack>
   <FixedCost>0</FixedCost>
   <FixedCostAccrual>3</FixedCostAccrual>
   <PercentComplete>0</PercentComplete>
   <PercentWorkComplete>0</PercentWorkComplete>
   <Cost>0</Cost>
   <OvertimeCost>0</OvertimeCost>
   <OvertimeWork>PT0H0M0S</OvertimeWork>
   <ActualDuration>PT0H0M0S</ActualDuration>
   <ActualCost>0</ActualCost>
   <ActualOvertimeCost>0</ActualOvertimeCost>
   <ActualWork>PT0H0M0S</ActualWork>
   <ActualOvertimeWork>PT0H0M0S</ActualOvertimeWork>
   <RegularWork>PT0H0M0S</RegularWork>
   <RemainingDuration>PT16H0M0S</RemainingDuration>
   <RemainingCost>0</RemainingCost>
   <RemainingWork>PT0H0M0S</RemainingWork>
   <RemainingOvertimeCost>0</RemainingOvertimeCost>
   <RemainingOvertimeWork>PT0H0M0S</RemainingOvertimeWork>
   <ACWP>0</ACWP>
   <CV>0</CV>
   <ConstraintType>0</ConstraintType>
   <CalendarUID>-1</CalendarUID>
   <LevelAssignments>1</LevelAssignments>
   <LevelingCanSplit>1</LevelingCanSplit>
   <LevelingDelay>0</LevelingDelay>
   <LevelingDelayFormat>8</LevelingDelayFormat>
   <IgnoreResourceCalendar>0</IgnoreResourceCalendar>
   <HideBar>0</HideBar>
   <Rollup>1</Rollup>
   <BCWS>0</BCWS>
   <BCWP>0</BCWP>
   <PhysicalPercentComplete>0</PhysicalPercentComplete>
   <EarnedValueMethod>0</EarnedValueMethod>
   <IsPublished>1</IsPublished>
   <CommitmentType>0</CommitmentType>
</Task>

See Also

Concepts

Task Elements and XML Structure

XML Schema for the Tasks Element