Overview

This structure represents a project task, and includes information about the task relevant to time entry.

Format

PwsProjectTask

PwsProjectTask
- ExternalSystemIdentifier: String (50)
- ProjectTaskId: Int32
- ProjectTaskUid: Int64
- Description: String (1000)
- Name: String (512)
- Notes: PwsProjectTaskNoteHistory []
- OpenForTimeFlag: Boolean
- ParentProjectTaskIdentity: PwsProjectTaskRef
- ParentTaskName: String (512)
- PlannedEndDateTime: DateTime
- PlannedStartDateTime: DateTime
- ProjectTaskTypeIdentity: PwsProjectTaskTypeRef
- Roles: PwsProjectTaskRole []
- SequenceNumber: Int16
- WbsCode: String
- ParentTaskWbsCode: String

Elements

Element	Data Type	Description	Sample Data
ExternalSystemIdentifier	String (50)	The external system identifier is a unique identifier for a project task.
ProjectTaskId	Int32	The project task id is a unique identifier for a project task. For internal use only.
ProjectTaskUid	Int64	A unique and immutable identifier for a project task.	1152921504608644258
Description	String	The project task description.
Name	String	The project task name is a unique identifier for a project task. This is the name resources will see when choosing tasks to enter their time against. Multiple tasks in the same task plan may share the same name, as long as they are under different parent tasks. The Work Breakdown Structure (WBS) code will differentiate between like-named tasks.	Task A1
Notes	PwsProjectTaskNoteHistory []	The project task notes
OpenForTimeFlag	Boolean	If set to 'true', resources are able to submit time using this Task.	true
ParentProjectTaskIdentity	PwsProjectTaskRef	The identity of the parent task. This will be null for root-level tasks.
ParentTaskName	String	The name of the parent task.	Task A
PlannedEndDateTime	DateTime	The planned end date of the task (in UTC format). For this purpose, days start at midnight so a time component of 4:00AM indicates that the task ends mid-day (assuming an 8 hour day).	2018-03-30T08:00:00Z
PlannedStartDateTime	DateTime	The planned start date of the task (in UTC format). For this purpose, days start at midnight so a time component of 4:00AM indicates that the task starts mid-day (assuming an 8 hour day).	2018-03-01T00:00:00Z
ProjectTaskTypeIdentity	PwsProjectTaskTypeRef	The project task type associated with the project task.
Roles	PwsProjectTaskRole []	The project role(s) associated with the project task.
SequenceNumber	Int16	This field determines the overall position of the task within the task plan. Tasks are ordered according to their work breakdown structure (WBS code).	1
WbsCode	String	The project task work breakdown structure code is a unique identifier for a project task.	1.1
ParentTaskWbsCode	String	The work breakdown structure of the parent task.	1

Usage Example(s)

Example 01

                      <a:PwsProjectTask>
                        <ExternalSystemIdentifier i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <ProjectTaskId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <ProjectTaskUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504608644258</ProjectTaskUid>
                        <a:Description i:nil="true"/>
                        <a:Name>Task A1</a:Name>
                        <a:Notes/>
                        <a:OpenForTimeFlag>true</a:OpenForTimeFlag>
                        <a:ParentProjectTaskIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectTaskId i:nil="true"/>
                           <b:ProjectTaskUid>1152921504608637335</b:ProjectTaskUid>
                        </a:ParentProjectTaskIdentity>
                        <a:ParentTaskName>Task A</a:ParentTaskName>
                        <a:PlannedEndDateTime>2018-03-30T08:00:00Z</a:PlannedEndDateTime>
                        <a:PlannedStartDateTime>2018-03-01T00:00:00Z</a:PlannedStartDateTime>
                        <a:ProjectTaskTypeIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ExternalSystemIdentifier i:nil="true"/>
                           <b:ProjectTaskTypeId i:nil="true"/>
                           <b:ProjectTaskTypeUid>1152921504608115974</b:ProjectTaskTypeUid>
                        </a:ProjectTaskTypeIdentity>
                        <a:Roles>
                           <a:PwsProjectTaskRole>
                              <ProjectRoleIdentity xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">
                                 <ExternalSystemIdentifier i:nil="true"/>
                                 <ProjectRoleId i:nil="true"/>
                                 <ProjectRoleUid>1152921504609522500</ProjectRoleUid>
                              </ProjectRoleIdentity>
                              <ProjectTaskIdentity xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">
                                 <ExternalSystemIdentifier i:nil="true"/>
                                 <ProjectTaskId i:nil="true"/>
                                 <ProjectTaskUid>1152921504608644258</ProjectTaskUid>
                              </ProjectTaskIdentity>
                              <ProjectTaskRoleId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                              <ProjectTaskRoleUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504608549425</ProjectTaskRoleUid>
                              <a:ActualMinutesSinceAsOfDate>0</a:ActualMinutesSinceAsOfDate>
                              <a:BudgetedMinutes>10560</a:BudgetedMinutes>
                              <a:CompletedFlag>false</a:CompletedFlag>
                              <a:Estimates/>
                              <a:LateFlag>false</a:LateFlag>
                              <a:TotalMinutesToDate>0</a:TotalMinutesToDate>
                              <a:CompletedFlagAtLatestPostAsOfDate i:nil="true"/>
                              <a:LateEligibleFlag>false</a:LateEligibleFlag>
                              <a:LatestAsOfDatePostDateRange i:nil="true"/>
                              <a:RemainingMinutesPostDateRange i:nil="true"/>
                              <a:RemainingMinutesPriorToDateRange>10560</a:RemainingMinutesPriorToDateRange>
                              <a:TotalMinutesPostTimesheet>0</a:TotalMinutesPostTimesheet>
                           </a:PwsProjectTaskRole>
                        </a:Roles>
                        <a:SequenceNumber>1</a:SequenceNumber>
                        <a:WbsCode>1.1</a:WbsCode>
                        <a:ParentTaskWbsCode>1</a:ParentTaskWbsCode>
                     </a:PwsProjectTask>