Overview

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

Format

PwsProjectTaskDetail

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

Example 01

            <sch:ProjectTask>
               <com:ProjectTaskUid>1152921504608747355</com: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>