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	`ProjecttaskEstimate`	`oaProjecttaskEstimate`	—	`project_task_estimate`
Supported Commands	`Add`, `Read`, `Modify`, `Delete`	`add()`, `read()`, `modify()`, `upsert()`, `delete()`	—	—

—

XML

SOAP

REST

Database table

Object

ProjecttaskEstimate

oaProjecttaskEstimate

—

project_task_estimate

Supported Commands

Add, Read, Modify, Delete

add(), read(), modify(), upsert(), delete()

—

The ProjecttaskEstimate object has the following properties:

XML / SOAP	Database	Description
`changed_by`	`changed_by`	[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.
`created`	`created`	[Read-only] Time the record was created. See Date Fields.
`date_changed`	`date_changed`	[Read-only] The date and time the estimate was last changed. See Date Fields.
`deleted`	`deleted`	[Read-only] A "1/0" field indicating if the record was deleted
`hours`	`hours`	[Required] The number of hours estimated to be remaining
`id`	`id`	[Read-only] Unique ID. Automatically assigned by OpenAir.
`project_taskid`	`project_task_id`	[Required] The ID of the associated project_task
`timesheetid`	`timesheet_id`	The ID of the associated timesheet if this was updated from the timesheet
`updated`	`updated`	[Read-only] Time the record was last updated or modified. See Date Fields.
`userid`	`user_id`	[Required] The ID of the user who is assigned to the task

XML / SOAP

Database

Description

changed_by

[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.

created

[Read-only] Time the record was created. See Date Fields.

date_changed

[Read-only] The date and time the estimate was last changed. See Date Fields.

deleted

[Read-only] A "1/0" field indicating if the record was deleted

hours

[Required] The number of hours estimated to be remaining

id

[Read-only] Unique ID. Automatically assigned by OpenAir.

project_taskid

project_task_id

[Required] The ID of the associated project_task

timesheetid

timesheet_id

The ID of the associated timesheet if this was updated from the timesheet

updated

[Read-only] Time the record was last updated or modified. See Date Fields.

userid

user_id

[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 ID timesheet_id.
- The same project task estimate must not already exist. The combination project_taskid, userid, and timesheetid (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.