A TaskAssignment contains data associated with a resource or a profile that is assigned to a Wbs element, as described in the ResourceTaskAssignment container documention. A TaskAssignment must be created and deleted through its parent ResourceTaskAssignment, but it can be loaded and updated independently.
Parent is mandatory, allowed parent type is ResourceTaskAssignment.
N/A
The following table lists the fields for this object.
Field | Detail |
---|---|
activities | Type: Activity[] Default value: N/A Description: The activities required to be completed the task assignment Field validation description: N/A Additional field security restrictions: N/A |
actualFinishDate | Type: dateTime Default value: N/A (derived value) Description: The actual finish date of the task assignment, it is set to the date the resource completes his or her portion of the task. Field validation description: This field is read-only Additional field security restrictions: N/A |
actualStartDate | Type: dateTime Default value: N/A Description: The actual start date of the task assignment, it is set once the resource starts the task. Field validation description: This field is read-only Additional field security restrictions: N/A |
actualWork | Type: double Default value: 0.00 Description: The actual amount of work required to complete the task. This value is derived from the resource’s timesheet. This field is editable for all assigned resources once there is a timesheet entry for any of the assigned resources. Field validation description: The Value range is 0.00 and 9000.00 This field is read-only if the actualStartDate field is null. Additional field security restrictions: N/A |
assignmentFinishDate | Type: dateTime Default value:The assignmentStartDate + days of duration of the task + calendar exceptions (such as weekends and holidays) based on the resource’s calendar. Description: The finish date of the assignment. If the assignmentStartDate is modified to be larger than the current assignmentFinishDate, the assignmentFinishDate is modified to become the assignmentStartDate plus the planned days of duration of the task if it exists (WorkElement.planDate). If the planDate does not exist, the proposed days of duration (WorkElement.proposedDate) field is used. Field validation description: This field is read-only. Additional field security restrictions: N/A |
assignmentFinishDateType | Type: DateType Default value: N/A Description: The type of date associated with the assignment finish date. Field validation description: N/A Additional field security restrictions: N/A |
assignmentStartDate | Type: dateTime Default value: The planned start date of the task (WorkElement.planDate) if it exists. Otherwise, the proposed start date of the task (WorkElement.proposedDate) is the default. Description: The start date of the assignment. Once it has a value, the actualStartDate is copied into assignmentStartDate. Field validation description: This field is read-only once actualStartDate is attributed a value. Additional field security restrictions: N/A |
assignmentStartDateType | Type: DateType Default value: N/A Description: The type of date associated with the assignment start date. Field validation description: N/A Additional field security restrictions: N/A |
baselineFinishDate | Type: dateTime Default value: N/A Description: The baseline finish date Field validation description: This field is read-only. Additional field security restrictions: N/A |
baselineStartDate | Type: dateTime Default value: N/A Description: The baselines start date Field validation description: This field is read-only. Additional field security restrictions: N/A |
baselineWork | Type: double Default value: N/A Description: Affected work. Field validation description: This field is read-only. Additional field security restrictions: N/A |
billable | Type: boolean Default value: true Description: Whether or not the task assignment is billable. Field validation description: N/A Additional field security restrictions: N/A |
calculatedLeveledFinishDate | Type: dateTime Default value: N/A Description: The leveled finish date Field validation description: This field is read-only. Additional field security restrictions: N/A |
calculatedLeveledStartDate | Type: dateTime Default value: N/A Description: The leveled start date Field validation description: This field is read-only. Additional field security restrictions: N/A |
calculatedLeveledWork | Type: double Default value: N/A Description: The amount of work performed. Field validation description: This field is read-only. Additional field security restrictions: N/A |
contract | Type: Contract Default value: N/A Description: The contract related to the task assignment. Field validation description: N/A Additional field security restrictions: N/A |
costLaborCode | Type: ChargeCode Default value: N/A Description: The Expense or Capital labor code for the resource assignment. Field validation description: N/A Additional field security restrictions: N/A |
costPerHour | Type: double Default value: The resource’s regular cost per hour (ResourceRates.regularCostPerHour) . Description: The resource's regular cost rate. Field validation description: The value range is 0.00 and 9,999,999,999,999.99. Additional field security restrictions: N/A |
costType | Type: ChargeCode Default value: N/A Description: The type of cost of the task. Field validation description: N/A Additional field security restrictions: N/A |
daysOfDelay | Type: int Default value: The number of days after the task’s assignmentStartDate that the resource will begin to work on the task, based on the resource’s calendar. Description: The number of days the task is delayed. Field validation description: The value range is 0 to 2000. This field is read-only once actualStartDate is attributed a value. Additional field security restrictions: N/A |
defaultLabor | Type: boolean Default value: false Description: Once the defaultLabor code is set to true for a resource assignment, the next time the resource is assigned in this project, the labor codes from the assignment will be used as default . Field validation description: N/A Additional field security restrictions: N/A |
EETCHours | Type: double Default value: The number of hours of duration of the task based on the days of duration from the task’s planned or proposed duration (WorkElement.planDate or WorkElement.proposedDate). Description: Estimated Effort to Complete. The Estimated Effort to Complete. This field is calculated based on the actualWork field, it is the remaining number of hours to completion .((lastScheduleWork * number of work hours per calendar day) – actualWork). Field validation description: Must be less than or equal to the number of hours for which the resource is available ((resourceDiscontinueDate -startDate) * daily calendar hours), where startDate = latest of resource.effectiveStartDate and taskAssignment.expectedStartDate. Cannot be set to 0 if an actualStartDate does not exist. Additional field security restrictions: N/A |
expectedFinishDate | Type: dateTime Default value: The assignmentStartDate + days of duration of the task + calendar exceptions (such as weekends and holidays) based on the resource’s calendar. Description: The date at which the resource is expected to finish the task, based on the resource’s calendar. Field validation description: This field is read-only. Additional field security restrictions: N/A |
expectedStartDate | Type: dateTime Default value: The task’s planned start date (WorkElement.planDate) if it exists. Otherwise, the task’s proposed start date (WorkElement.proposedDate) is the default. Description: The date at which the task is expected to be started. If the task’s planned or proposed start date (WorkElement.planDate or WorkElement.proposedDate) is modified, the value is copied into the expectedStartDate field. Field validation description: This field is read-only. Additional field security restrictions: N/A |
expectedWork | Type: double Default value: The days of duration of the task from the task’s planned or proposed duration (WorkElement.planDate or WorkElement.proposedDate). Description: The expected work from the WorkElement for a resource assignment. Field validation description: This field is read-only. Additional field security restrictions: N/A |
forecastFinishDate | Type: dateTime Default value: N/A Description: The forecasted finish date. Field validation description: This field is read-only. Additional field security restrictions: N/A |
forecastStartDate | Type: dateTime Default value: N/A Description: The forecasted start date Field validation description: This field is read-only. Additional field security restrictions: N/A |
invoices | Type: Invoice[] Default value: N/A Description: The list of invoices related to the task assignment. Field validation description: N/A Additional field security restrictions: N/A |
lastScheduleWork | Type: double Default value: The days of task duration from the task’s planned or proposed duration (WorkElement.planDate or WorkElement.proposedDate). Description: Work in days at last schedule. Recalculated when EETCHours is modified: (EETCHours + actualHours) /hours per calendar day. Field validation description: This field is read-only. Additional field security restrictions: N/A |
percentageComplete | Type: double Default value: N/A Description: The percentage of completion of the task. Calculated field: 100 – (EETCHours / (lastScheduleWork * hours in calendar day) * 100) Editable for all task resources once actualStartDate exists for one resource. Field validation description: The value range is 0.00 and 100. Additional field security restrictions: N/A |
percentageDurationComplete | Type: int Default value: N/A Description: The percentage duration completed of the task. Field validation description: This field is read-only. Additional field security restrictions: N/A |
percentageRateAdjustment | Type: int Default value: 100 Description: The percentage adjustment of regular selling rate. If the sellingRatePerHour is modified, the percentageRateAdjustment is modified to reflect the percentage adjustment from the selling rate per hour defined in the resource’s profile (ResourceRates.sellingRatePerHour). If the percentageRateAdjustment is modified, the sellingRatePerHour is re-calculated to reflect the percentage adjustment. Field validation description: The value range is 0 and 9999. Additional field security restrictions: N/A |
percentageWork | Type: double Default value: N/A Description: Work percentage complete. Field is Calculated: 100 – (EETCHours / (lastScheduleWork * hours in calendar day) * 100) This field becomes editable for all task resources once actualStartDate exists for a resource. Field validation description: The value range is 0.00 and 100. Additional field security restrictions: N/A |
plannedDurationHours | Type: double Default value: N/A Description: Planned hours of duration. Field validation description: N/A Additional field security restrictions: N/A |
remainingHours | Type: double Default value: The hour duration of the task based on the day duration from the task’s planned or proposed duration (WorkElement.planDate or WorkElement.proposedDate) Description: The number of remaining hours to complete the task. This field is calculated based on the actualWork field which represents the remaining number of hours to completion ((lastScheduleWork * number of work hours per calendar day) – actualWork) . When EETCHours is overwritten, remainingHours takes on its value. Field validation description: This field is read-only Additional field security restrictions: N/A |
revenueLaborCode | Type: ChargeCode Default value: N/A Description: The Billable Benefit labor code for the assignment. Field validation description: N/A Additional field security restrictions: N/A |
sellingRatePerHour | Type: double Default value: The resource’s regular selling rate per hour. (ResourceRates.sellingRatePerHour). Description: The resource's regular selling rate per hour. Field validation description: The value range is 0.00 and 9,999,999,999,999.99. Additional field security restrictions: N/A |
specialCostPerHour | Type: double Default value: The resource’s special cost per hour. (ResourceRates.specialCostPerHour). Description: The resource's special (overtime) cost rate. Field validation description: The value range is 0.00 and 9,999,999,999,999.99. Additional field security restrictions: N/A |
specialSellingRatePerHour | Type: double Default value: The resource’s special selling rate per hour. (ResourceRates.specialSellingRatePerHour). Description: The resource's special (overtime) selling rate. Field validation description: The value range is 0.00 and 9,999,999,999,999.99. Additional field security restrictions: N/A |
summaryTimesheets | Type: SummaryTimesheet[] Default value: N/A Description: The list of summary timesheets related to a task. Field validation description: N/A Additional field security restrictions: N/A |
unitsPercentage | Type: double Default value: The percentage the resource is available for this task, based on other assignments. Description: The quantity of a resource assigned to the task. When this field is modified, this forces recalculation of the number of hours to be worked per day on this task (SummaryTimesheet[]). Field validation description: The value range is 0.00 and 999999.00. Additional field security restrictions: N/A |