Overview
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.
Format
| Panel | ||
|---|---|---|
| ||
|
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. 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 | 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 | No | The predecessors of the task. Click here for more information. | |||
PreviousSiblingTaskIdentity | No | The previous sibling of the task. Can be used to reorder the task among its siblings. Click here for more information. | |||
ProjectTaskTypeIdentity | 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 | No | The users who receives notification on the task. Applies to milestone and not open for time tasks. Click here for more information. | |||
UserDefinedFields | No | The user defined fields associated with this task. Click here for more information. |
Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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> |