...
This structure represents the fields associated with a project task, and includes information about the task relevant to time entry.
Format
| Panel | ||
|---|---|---|
| ||
|
Elements
Element | Data Type | Required? | Default | Description | Sample Data |
|---|---|---|---|---|---|
ExternalSystemIdentifier | String (50) | One of ExternalSystemIdentifier, ProjectTaskTypeUid or ProjectTaskTypeName, WbsCode is required | The external system identifier is a unique identifier for a project task (may be null, but once set can only be updated to a different, non-null value). | ||
ProjectTaskId | Int32No | The project task id is a unique identifier for a project task. For internal use only. | |||
ProjectTaskUid | Int64 | See ExternalSystemIdentifier | A unique and immutable identifier for a project task task. | 1152921504608644258 | |
Description | StringNo | The project task description description. | |||
Name | String | See ExternalSystemIdentifier | The project task name is a unique identifier for a project task. This is the name is resources will see when choosing tasks to enter their time against. Each name is preceded by a 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 [???]No | The project task notes | |||
OpenForTimeFlag | BooleanNo | true | If set to 'true', resources are able to submit time using this Task. Milestone tasks require this box to be unticked | true | |
ParentProjectTaskIdentity | 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 | 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 where the overall position of the task appears in the list of project tasks in the Management Portal. For internal use onlywithin 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)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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> |