Versions Compared

Key

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

...

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). When both ExternalSystemIdentifier or ProjectTaskUid are missing or invalid, a new project task will be created.


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. When both ExternalSystemIdentifier or ProjectTaskUid are missing or invalid, a new project task will be created.

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

???

Luke, it seems that when wbs code is missing, the task is inserted based on parent task, sibling task ..., but I could not pin down the rules here.

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 predecessor of the task. Click here for more information.


PreviousSiblingTaskIdentity

PwsProjectTaskRef

No


The previous sibling of the task. 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 user 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 field 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>

...