Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Format


Panel
titlePwsProjectTask
  • 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

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

Int32

No

 

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

String

No

 

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

Boolean

No

true 

If set to 'true', resources are able to submit time using this Task.

Milestone tasks require this box to be unticked 

true

ParentProjectTaskIdentity

PwsProjectTaskRef

No

 

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

where

the overall position of the task

appears in the list of project tasks in the Management Portal. For internal use only. 

within the task plan. Tasks are ordered according to their work breakdown structure (WBS code).

1

WbsCode

String

 

 

 The

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
languagexml
titleExample 01
collapsetrue
                      <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>