Versions Compared

Key

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

...

This structure represents the full details of a project tasktask associated with a project role's scheduled time / booked hours

Format


Panel
titlePwsScheduleProjectTask
  • PwsScheduleProjectTask
    • ExternalSystemIdentifier: String
    • 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
    • BudgetedMinutes: Int32
    • Estimate: PwsProjectTaskRoleRemaining
    • LateFlag: Boolean
    • RemainingMinutesPriorToDateRange: Int32
    • TotalMinutesToDate: Int32

Elements


Element

Data Type

Description

Sample Data

ExternalSystemIdentifier

String

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

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

Task A1

Name

String

The project task name

Task A1

Notes

PwsProjectTaskNoteHistory[???]

The project task notes 

 


OpenForTimeFlag

Boolean

If set to 'true', the project task is open for time

true

ParentProjectTaskIdentity

PwsProjectTaskRef

The identity of the project task's parent

 


ParentTaskName

String

The name of the project task's parent

Task A

PlannedEndDateTime

DateTime

The planned end date for the project task

2018-04-02T08:00:00Z

PlannedStartDateTime

DateTime

The planned start date for the project task

2018-03-01T00:00:00Z

ProjectTaskTypeIdentity

PwsProjectTaskTypeRef

The task type associated with the project task 

 


Roles

PwsProjectTaskRole[???]

The role(s) assigned to the task 

 


SequenceNumber

Int16

The position of the task in the project task list

1

WbsCode

String

The work breakdown structure associated with task 

1.1

ParentTaskWbsCode

String

The work breakdown structure associated with the parent task 

1

BudgetedMinutes

Int32

The total budgeted minutes associated with the project task for a given role

10560 

Estimate

PwsProjectTaskRoleRemaining

The most recent task completion estimate


LateFlag

Boolean

If set to 'true', the project task is marked as late

false

RemainingMinutesPriorToDateRange

Int32

The number of remaining minutes prior to the provided date range (i.e. StartDate and EndDate)

480

TotalMinutesToDate

Int32

The number of total minutes a given role has logged against the task to date

0

Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
                       <a:PwsScheduleProjectTask>
                           <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>Task A1</a:Description>
                           <a:Name>Task A1</a:Name>
                           <a:Notes>
                              <a:PwsProjectTaskNoteHistory>
                                 <a:CreatedByUser xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                                    <b:UserDisplayName>Beth Brown</b:UserDisplayName>
                                    <b:UserId i:nil="true"/>
                                    <b:UserReferenceSystemId>E125</b:UserReferenceSystemId>
                                    <b:UserUid>1152921504607011056</b:UserUid>
                                 </a:CreatedByUser>
                                 <a:CreatedTimestamp>2018-03-07T18:10:20.357Z</a:CreatedTimestamp>
                                 <a:ProjectTaskNotes>This is the first task of this project</a:ProjectTaskNotes>
                              </a:PwsProjectTaskNoteHistory>
                              <a:PwsProjectTaskNoteHistory>
                                 <a:CreatedByUser xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                                    <b:UserDisplayName>Jack Spratt</b:UserDisplayName>
                                    <b:UserId i:nil="true"/>
                                    <b:UserReferenceSystemId>E123</b:UserReferenceSystemId>
                                    <b:UserUid>1152921504607112369</b:UserUid>
                                 </a:CreatedByUser>
                                 <a:CreatedTimestamp>2018-03-07T18:24:42.013Z</a:CreatedTimestamp>
                                 <a:ProjectTaskNotes>Please speak to Jack before starting this task</a:ProjectTaskNotes>
                              </a:PwsProjectTaskNoteHistory>
                           </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-04-02T08: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:SequenceNumber>1</a:SequenceNumber>
                           <a:WbsCode>1.1</a:WbsCode>
                           <a:ParentTaskWbsCode>1</a:ParentTaskWbsCode>
                           <a:BudgetedMinutes>10560</a:BudgetedMinutes>
                           <a:Estimate>
                              <a:CompletedFlag>false</a:CompletedFlag>
                              <a:RemainingAsOfDate>2018-03-05T00:00:00Z</a:RemainingAsOfDate>
                              <a:RemainingMinutes>480</a:RemainingMinutes>
                           </a:Estimate>
                           <a:LateFlag>false</a:LateFlag>
                           <a:RemainingMinutesPriorToDateRange>480</a:RemainingMinutesPriorToDateRange>
                           <a:TotalMinutesToDate>0</a:TotalMinutesToDate>
                        </a:PwsScheduleProjectTask>