...
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 ProjectRoleUid ProjectTaskUid is required | The external system identifier is a unique identifier for a project role task (may be null, but once set can only be updated to a different, non-null value) | #00001 | ProjectRoleId | Int32 | On Insert: No On Update: No | The project role . Specify null when creating new tasks. | |||||||||||||||||||||||||
ProjectTaskId | Int32 | No | Project task id is a unique identifier for a project rolecost baseline. For internal use only. | ||||||||||||||||||||||||||||||
ProjectRoleUidProjectTaskUid | Int64 | See ExternalSystemIdentifier | A unique and immutable identifier for a project role | 1152921504608152048 | BaseRateOnTitleIdentity | On Insert: No On Update: No | If a resource is not billed based on their own title, specify the overriding title using this element. Click here for more information. | CandidateIdentities | On Insert: No On Update: No | A collection of named resource candidates for the role. Click here for more information. | CostCenterAnyFlag | Boolean | On Insert: No On Update: No | a project task. Specify null when creating new tasks. | 1152921504608747355 | ||||||||||||||||||
CompletedFlag | Boolean | No | false | If set to 'true', all cost centers are selected as part of the unnamed candidate search criteriatask status is set as completed. | false | CostCenterCriteria | On Insert: No On Update: No | A collection of cost centers that are selected as part of the unnamed candidate search criteria. Click here for more information. | CostCenterIdentity | On Insert: No On Update: No | The preferred cost center in the unnamed candidate search criteria. Click here for more information. | DefaultSchedulingMode | String (1) | On Insert: No On Update: No | Engagement Type's default setting | The scheduling mode for this role: D: daily W: weekly | Description | String (255) | On Insert: No On Update: No | The description for this role | Business analyst (Web Commerce)_ | Keywords | String (255) | On Insert: No On Update: No | The keywords used in the unnamed candidate search criteria | HTML | |||||||
LocationAnyFlag | Boolean | On Insert: No On Update: No | false | If set to 'true', all locations are selected as part of the unnamed candidate search criteria. | false | ||||||||||||||||||||||||||||
LocationIdentities | On Insert: No On Update: No | A collection of locations that are selected as part of the unnamed candidate search criteria. Click here for more information. | LocationIdentity | On Insert: No On Update: No | The preferred location in the unnamed candidate search criteriaDescription | 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. | NewExternalSystemIdentifier | String | On Insert: No On Update: No | See ExternalSystemIdentifier above. | #00001-1 | ResourceIdentity | On Insert: No On Update: No | The preferred named candidate for this role. Click here for more information. | RoleEndDate | DateTime | On Insert: No On Update: No | The end date of this role | 2018-12-31z | RoleName | String (32) | On Insert: Yes On Update: No | The name of this role | Business Analyst | RoleStartDate | DateTime | On Insert: No On Update: No | The start date of this role | 2018-07-01z | ShareCostCenterIdentity | On Insert: No On Update: No | The identity of shared cost center for this role | |||||
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. | SkillCriteria | ||||||||||||||||||||||||||||||
On Insert: No On Update: PreviousSiblingTaskIdentity | No | The collection of skills that are selected in the unnamed candidate search criteriaprevious sibling of the task. Can be used to reorder the task among its siblings. Click here for more information. | |||||||||||||||||||||||||||||||
TitleIdentitiesProjectTaskTypeIdentity | On Insert: No On Update: No | A collection of Titles that are selected as part of the unnamed candidate search criteriaThe task type of the task. Click here for more information. | TitleIdentity | On Insert: No On Update: No | The preferred title in the unnamed candidate search criteria. Click here for more information. | RdcTransferCurrencyIdentity | |||||||||||||||||||||||||||
PwsCurrencyRefTaskName | String (512) | Yes | The name of the task | Created from WS | |||||||||||||||||||||||||||||
InheritPurchaseOrderNumberFlag | Boolean | On Insert: No On Update: No | Resource's cost center currency | The RDC transfer rate currency for this role. Click here for more information. | RdcTransferHourlyRate | Doubletrue | If set to 'true', project inherits the purchase order number from the project role. | true | |||||||||||||||||||||||||
PurchaseOrderNumber | String (50) | On Insert: No On Update: No | The RDC trasnfer hourly rate for this role. | 35 | RevenueTransferHourlyRate | Double | On Insert: No On Update: No | The revenue trasnfer hourly rate for this role. | 80 | UserDefinedFields | On Insert: No On Update: No | A collection of user defined fields and their values for this role | 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. | |||||||||||||||||||||||||||||||
RateExceptionsUserDefinedFields | On Insert: No On Update: No | Overrides to resource's title based ratesPwsUserDefinedFieldDetail [] | No | The user defined fields associated with this task. Click here for more information. | RdcExceptions | On Insert: No On Update: No | Overrises to resource's RDC rates. Click here for more information. |
Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<sch:ProjectRole>ProjectTask> <com:ExternalSystemIdentifier>R-001<ProjectTaskUid>1152921504608747355</com:ExternalSystemIdentifier>ProjectTaskUid> <!--com:ProjectRoleUid>?<<com:CompletedFlag>false</com:ProjectRoleUid-->CompletedFlag> <com:BaseRateOnTitleIdentity>Description>Task <com:DepartmentIdentity> from WS-001(8)</com:Description> <com:DepartmentName>Management<DurationMinutes>300</com:DepartmentName>DurationMinutes> <<com:EarliestStartDate>2018-01-31z</com:DepartmentIdentity>EarliestStartDate> <com:TitleName>Administrator<FullWbsCode>4</com:TitleName>FullWbsCode> <<com:OpenForTimeFlag>false</com:BaseRateOnTitleIdentity>OpenForTimeFlag> <com:CandidateIdentities> <!--Zero or more repetitions:-->ParentTaskIdentity> <com:PwsResourceRef> <com:ResourceDisplayName>Max Yang<ProjectTaskUid>1152921504608738152</com:ResourceDisplayName> ProjectTaskUid> </com:PwsResourceRef>ParentTaskIdentity> <<com:PlannedEndDateTime>2018-03-05z</com:CandidateIdentities>PlannedEndDateTime> <com:CostCenterAnyFlag>false<PlannedStartDateTime>2018-03-01z</com:CostCenterAnyFlag>PlannedStartDateTime> <com:CostCenterCriteria>Predecessors> <!--Zero or more repetitions:--> <com1:PwsCostCenterCriteria> <com1:CascadeFlag>true</com1:CascadeFlag><com:PwsProjectTaskPredecessor> <com1:CostCenterIdentity> <com:CostCenterName>RevCorp CH</com:CostCenterName> </com1:CostCenterIdentity> </com1:PwsCostCenterCriteria> <com:LagMinutes>12000</com:LagMinutes> </com:CostCenterCriteria> <com:CostCenterIdentity> <com:CostCenterName>RevCorp CA<LinkType>FS</com:CostCenterName> LinkType> </com:CostCenterIdentity> <com:DefaultSchedulingMode>W</com:DefaultSchedulingMode>PredecessorProjectTaskIdentity> <com:Description>Created from PwsSaveProjectRole 1</com:Description> <com:Keywords>Executive<ProjectTaskUid>1152921504608738153</com:Keywords>ProjectTaskUid> <com:LocationAnyFlag>true</com:LocationAnyFlag> <com:LocationIdentities> <!--Zero or more repetitions:--> <com:PwsLocationRef> <com:LocationName>Boston</com:LocationName>PredecessorProjectTaskIdentity> </com:PwsLocationRef>PwsProjectTaskPredecessor> </com:LocationIdentities> <com:LocationIdentity>Predecessors> <com:LocationName>Shanghai</com:LocationName> PreviousSiblingTaskIdentity> </com:LocationIdentity> <com:RoleEndDate>2018-12-31z<ProjectTaskUid>1152921504608738153</com:RoleEndDate>ProjectTaskUid> <com:RoleName>Role-I<</com:RoleName>PreviousSiblingTaskIdentity> <com:RoleStartDate>2018-01-01z</com:RoleStartDate> <com:ShareCostCenterIdentity>ProjectTaskTypeIdentity> <com:CostCenterName>Revcorp CH<ProjectTaskTypeUid>1152921504608111232</com:CostCenterName>ProjectTaskTypeUid> </com:ShareCostCenterIdentity>ProjectTaskTypeIdentity> <com:SkillCriteria> <!--Zero or more repetitions:--> <com:PwsSkillCriteria> <com:SkillIdentity> <com:SkillGroupIdentity> <com:SkillGroupName>Technology</com:SkillGroupName> </com:SkillGroupIdentity> TaskName>WS-004</com:TaskName> <com:SkillName>HTML<InheritPurchaseOrderNumberFlag>false</com:SkillName> InheritPurchaseOrderNumberFlag> </com:SkillIdentity> <com:SkillLevelMask>3<<com:PurchaseOrderNumber>PO-004</com:SkillLevelMask>PurchaseOrderNumber> </com:PwsSkillCriteria> </com:SkillCriteria> <com:TitleIdentities><com:Subscriptions> <!--Zero or more repetitions:--> <com:PwsTitleRef>PwsProjectTaskSubscription> <com:DepartmentIdentity>UserIdentity> <com:DepartmentName>Technology<UserReferenceSystemId>016</com:DepartmentName>UserReferenceSystemId> </com:DepartmentIdentity> UserIdentity> <com:TitleName>Technical Consultant</com:TitleName> </com:PwsTitleRef>PwsProjectTaskSubscription> </com:TitleIdentities>Subscriptions> <com:TitleIdentity> <com:DepartmentIdentity> <com:DepartmentName>Technology</com:DepartmentName> </com:DepartmentIdentity> <com:TitleName>Technical Consultant</com:TitleName>UserDefinedFields> </com:TitleIdentity> <com:RdcTransferCurrencyIdentity> <com:CurrencyCode>USD</com:CurrencyCode> </com:RdcTransferCurrencyIdentity> <com:RdcTransferHourlyRate>7</com:RdcTransferHourlyRate> <com:RevenueTransferHourlyRate>14</com:RevenueTransferHourlyRate> <com:RdcExceptions> <!--Zero or more repetitions:--> <com:PwsProjectRoleRdcException>PwsUserDefinedFieldDetail> <com:BeginDate>2018-02-01z</com:BeginDate> <com:EndDate>2018-02-08z<UdfName>Phase 1 MS</com:EndDate>UdfName> <com:HourlyRate>11<BooleanValue>false</com:HourlyRate>BooleanValue> <com:RdcCurrencyIdentity> <com:CurrencyCode>USD<DataType>B</com:CurrencyCode>DataType> </com:RdcCurrencyIdentity> PwsUserDefinedFieldDetail> </com:PwsProjectRoleRdcException>UserDefinedFields> </com:RdcExceptions> </sch:ProjectRole> ProjectTask> |