Task Element

Articolo
09/16/2021

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

<Task>
  ComplexTypeValue
</Task>

Parent Elements

Tasks

Child Elements

Element	Required / Optional	Description
GUID	Optional	GUID for the task.
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.
NoteContainsObjects	Optional	This value is true if the note for a task contains an object.
EnterpriseExtendedAttribute	Optional	Collection of Enterprise Custom Fields with lookup table values.

The following items were added for Project Online Desktop Client

Element	Required / Optional	Description
BoardStatusColumnOrderingID	Optional	Used for ordering tasks in the Task Board view when the view is arranged by the Board Status column.
SprintColumnOrderingID	Optional	Used for ordering tasks in the Task Board view when the view is arranged by the Board Status column.
NextAvailableBoardStatusColumnOrderingID	Optional	Used internally for ordering tasks in the Task Board view when the view is arranged by the Board Status column.
NextAvailableSprintOrderingID	Optional	Used internally for ordering tasks in the Task Board view when the view is arranged by Sprints.
SprintUID	Optional	The UID of the Sprint value associated with the task.
BoardColumnUID	Optional	The UID of the Board Column value associated with the task.

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>

Condividi tramite

Task Element

Parent Elements

Child Elements

Occurrences

Example

See Also

Concepts

Commenti e suggerimenti

Risorse aggiuntive