TaskAssignment

Description

Package: com.ibm.rpm.wbs.containers

Extends: RPMObject

Usage

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.

Supported API Calls

Security Restrictions

N/A

Fields

The following table lists the fields for this object.

Table 1. TaskAssignment Field Description
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

Inherited Fields

Click on object for list of inherited fields:

From RPMObject

Related Objects