ProjecttaskEstimate
A project task estimate [ProjecttaskEstimate
] is a user estimation of the time remaining against a project task. The time remaining estimate is entered on timesheets and drives percent complete calculations against the project.
Review the Usage Guidelines for the ProjecttaskEstimate
object.
— |
XML |
SOAP |
REST |
Database table |
---|---|---|---|---|
Object |
|
|
— |
|
Supported Commands |
— |
— |
The ProjecttaskEstimate
object has the following properties:
XML / SOAP |
Database |
Description |
---|---|---|
|
|
[Read-only] ID of the user who changed the estimate. If this does not have an ID, then the estimate was automatically generated by OpenAir. |
|
|
[Read-only] Time the record was created. See Date Fields. |
|
|
[Read-only] The date and time the estimate was last changed. See Date Fields. |
|
|
[Read-only] A "1/0" field indicating if the record was deleted |
|
|
[Required] The number of hours estimated to be remaining |
|
|
[Read-only] Unique ID. Automatically assigned by OpenAir. |
|
|
[Required] The ID of the associated project_task |
|
|
The ID of the associated timesheet if this was updated from the timesheet |
|
|
[Read-only] Time the record was last updated or modified. See Date Fields. |
|
|
[Required] The ID of the user who is assigned to the task |
Usage Guidelines
Review the following guidelines:
-
To add or modify a project task estimate:
-
The Enable the "Hours remaining" on tasks estimating feature box must be checked in the Timesheets application settings in OpenAir (Administration > Application Settings > Timesheets > other Settings).
-
The user with internal ID
userid
must be assigned to the task. -
There must be a time entry against
project_task_id
in the timesheet with internal IDtimesheet_id
. -
The same project task estimate must not already exist. The combination
project_taskid
,userid
, andtimesheetid
(if set) must be unique.
-
-
By default, you cannot modify a project task estimate associated with an approved or archived timesheet. Your account can be configured to allow using the API to modify approved and archived timesheets. To enable the feature, contact OpenAir Customer Support.
-
By default, updating a project task estimate triggers a recalculation for the project. Your account can be configured to disable recalculation when using the API to modify projects and project tasks. To enable the feature, contact OpenAir Customer Support.