Versions Compared

Key

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

...

This structure contains the complete set of information about a project role (less any subordinate entities)task. The structure is used both to retrieve detailed project role task information and to pass information about a project role task back to the server to get updated.

...

Panel
titlePwsProjectTaskDetail
  • PwsProjectTaskDetail
    • ExternalSystemIdentifier: String
    • ProjectTaskId: Int32
    • ProjectTaskUid: Int64
    • CompletedFlag: Boolean
    • Description: String (1000)
    • DurationMinutes: Int32
    • EarliestStartDate: DateTime
    • FullWbsCode: String
    • NewExternalSystemIdentifier: String
    • OpenForTimeFlag: Boolean
    • ParentTaskIdentity: PwsProjectTaskRef
    • PlannedEndDateTime: DateTime
    • PlannedStartDateTime: DateTime
    • Predecessors: PwsProjectTaskPredecessor []
    • PreviousSiblingTaskIdentity: PwsProjectTaskRef
    • ProjectTaskTypeIdentity: PwsProjectTaskTypeRef
    • TaskName: String (512)
    • InheritPurchaseOrderNumberFlag: Boolean
    • PurchaseOrderNumber: String (50)
    • Subscriptions: PwsProjectTaskSubscription []
    • UserDefinedFields: PwsUserDefinedFieldDetail []

Elements

Element

Data Type

Required?

Default

Description

Sample Data

ExternalSystemIdentifier

String (50)

On Insert: No

On Update: One of ExternalSystemIdentifier or ProjectTaskUid 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). Specify null when creating new tasks.


ProjectTaskId

Int32

No


Project task id is a unique identifier for a project cost baseline. For internal use only.  


ProjectTaskUid

Int64

See ExternalSystemIdentifier


A unique and immutable identifier for a project task  task. Specify null when creating new tasks.

1152921504608747355

CompletedFlag

Boolean

No

false

If set to 'true', task status is set as completed.

false

Description

String (1000)

No


The description of the task.


DurationMinutes

Int32

No

0

The duration in minutes of the task.

12000

EarliestStartDate

DateTime

No


The earliest start date of the task.

2018-01-31z

FullWbsCode

String

No


The full wbs code of the task. Only used in retrieving the project task.

4

NewExternalSystemIdentifier

String (50)

No


The new external system identifier of the updated or new task.


OpenForTimeFlag

Boolean

No

true

If set to 'true', this task is open for time entry.

true

ParentTaskIdentity

PwsProjectTaskRef

No


The identity of the parent task. Click here for more information.


PlannedEndDateTime

DateTime

No


The planned end date of the task.

2018-03-05z

PlannedStartDateTime

DateTime

No


The planned start date of the task.

2018-03-01z

Predecessors

PwsProjectTaskPredecessor []

No


The predecessors of the task. Click here for more information.


PreviousSiblingTaskIdentity

PwsProjectTaskRef

No


The previous sibling of the task. Can be used to reorder the task among its siblings. Click here for more information.


ProjectTaskTypeIdentity

PwsProjectTaskTypeRef

No


The task type of the task. Click here for more information.


TaskName

String (512)

Yes


The name of the task

Created from WS

InheritPurchaseOrderNumberFlag

Boolean

On Insert: No

On Update: No

true

If set to 'true', project inherits the purchase order number from the project role.

true

PurchaseOrderNumber

String (50)

On Insert: No

On Update: No

Project role's purchase order number

The purchase order number associated with this project task. Specify only if not inheriting the purchase order number from the project role.

PO-004

Subscriptions

PwsProjectTaskSubscription []

No


The users who receives notification on the task. Applies to milestone and not open for time tasks. Click here for more information.


UserDefinedFields

PwsUserDefinedFieldDetail []

No


The user defined fields associated with this task. Click here for more information.


Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
            <sch:ProjectTask>
               <!--com<com:ProjectTaskUid>1152921504608747355</com:ProjectTaskUid-->ProjectTaskUid>
               <com:CompletedFlag>false</com:CompletedFlag>
               <com:Description>Task from WS-001(8)</com:Description>
               <com:DurationMinutes>300</com:DurationMinutes>
               <com:EarliestStartDate>2018-01-31z</com:EarliestStartDate>
               <com:FullWbsCode>4</com:FullWbsCode>
               <com:OpenForTimeFlag>false</com:OpenForTimeFlag>
               <com:ParentTaskIdentity>
                  <com:ProjectTaskUid>1152921504608738152</com:ProjectTaskUid>
               </com:ParentTaskIdentity>
               <com:PlannedEndDateTime>2018-03-05z</com:PlannedEndDateTime>
               <com:PlannedStartDateTime>2018-03-01z</com:PlannedStartDateTime>
               <com:Predecessors>
                  <!--Zero or more repetitions:-->
                  <com:PwsProjectTaskPredecessor>
                     <com:LagMinutes>12000</com:LagMinutes>
                     <com:LinkType>FS</com:LinkType>
                     <com:PredecessorProjectTaskIdentity>
                        <com:ProjectTaskUid>1152921504608738153</com:ProjectTaskUid>
                     </com:PredecessorProjectTaskIdentity>
                  </com:PwsProjectTaskPredecessor>
               </com:Predecessors>
               <com:PreviousSiblingTaskIdentity>
                  <com:ProjectTaskUid>1152921504608738153</com:ProjectTaskUid>
               </com:PreviousSiblingTaskIdentity>               
               <com:ProjectTaskTypeIdentity>
                  <com:ProjectTaskTypeUid>1152921504608111232</com:ProjectTaskTypeUid>
               </com:ProjectTaskTypeIdentity>
               <com:TaskName>WS-004</com:TaskName>
               <com:InheritPurchaseOrderNumberFlag>false</com:InheritPurchaseOrderNumberFlag>
               <com:PurchaseOrderNumber>PO-004</com:PurchaseOrderNumber>
               <com:Subscriptions>
                  <!--Zero or more repetitions:-->
                  <com:PwsProjectTaskSubscription>
                     <com:UserIdentity>
                        <com:UserReferenceSystemId>016</com:UserReferenceSystemId>
                     </com:UserIdentity>
                  </com:PwsProjectTaskSubscription>
               </com:Subscriptions>
               <com:UserDefinedFields>
                  <!--Zero or more repetitions:-->
                  <com:PwsUserDefinedFieldDetail>
                     <com:UdfName>Phase 1 MS</com:UdfName>
                     <com:BooleanValue>false</com:BooleanValue>
                     <com:DataType>B</com:DataType>
                  </com:PwsUserDefinedFieldDetail>
               </com:UserDefinedFields>
            </sch:ProjectTask>

...