PwsScheduleProjectTask

Overview


This structure represents the task associated with a project role's scheduled time / booked hours.

Format


PwsScheduleProjectTask
  • 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.


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 considered 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)


Example 01
                       <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>