Projecttaskassign

A project task assignment [Projecttaskassign] is an allocation of work to a user as part of a project task.

Review the Usage Guidelines for the Projecttaskassign object.

—	XML	SOAP	REST	Database table
Object	`Projecttaskassign`	`oaProjecttaskassign`	—	`project_task_assign`
Supported Commands	`Add`, `Read`, `Modify`, `ModifyOnCondition`, `Delete`	`add()`, `read()`, `modify()`, `upsert()`, `delete()`	—	—

—

XML

SOAP

REST

Database table

Object

Projecttaskassign

oaProjecttaskassign

—

project_task_assign

Supported Commands

Add, Read, Modify, ModifyOnCondition, Delete

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

—

The Projecttaskassign object has the following standard properties:

Note:

Projecttaskassign object properties may also include custom fields. The object type supports the custom equal to read method and the enable_custom read attribute.

XML / SOAP	Database	Description
`allocation`	`allocation`	The percentage of time the associated user is allocated to this task.
`booking_id`	`booking_id`	The ID of the associated booking.
`created`	`created`	[Read-only] Time the record was created. See Date Fields.
`externalid`	`external_id`	If the record was imported from an external system you store the unique external record ID here.
`id`	`id`	[Read-only] Unique ID. Automatically assigned by OpenAir.
`job_codeid`	`job_code_id`	The ID of the associated job code.
`pending_booking_id`	`pending_booking_id`	The ID of the associated pending booking.
`planned_hours`	`planned_hours`	The hours for this user if the planned hours at the user level feature is enabled.
`project_assignment_profile_id`	`project_assignment_profile_id`	The ID of the associated project assignment profile.
`project_groupid`	`project_group_id`	The ID of the project group if the user was assigned as part of a project group.
`projecttaskid`	`projecttask_id`	[Required] ID of the project task to which this user is assigned. Th eproject task must be a task and not a phase.
`rule_rate_override`	`rule_rate_override`	Hourly billing rate for the user assigned to the task. Effective only if your company's account configuration allows billing rule rate override on task assignments. Negative values are not allowed.
`rule_rate_override_currency`	`rule_rate_override_currency`	The 3–letter currency code for the billing rate currency. Defaults to the company's base currency if not set. Can be set to any currency specified in Administration > Global Settings > Organization > Currencies > Multi-currency if the Multicurrency feature is enabled for your company's OpenAir account.
`updated`	`updated`	[Read-only] Time the record was last updated or modified. See Date Fields.
`userid`	`user_id`	[Required] The ID of the user assigned to this task. The user must exist, must not be marked as deleted and must be active.

XML / SOAP

Database

Description

allocation

The percentage of time the associated user is allocated to this task.

booking_id

The ID of the associated booking.

created

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

externalid

external_id

If the record was imported from an external system you store the unique external record ID here.

id

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

job_codeid

job_code_id

The ID of the associated job code.

pending_booking_id

The ID of the associated pending booking.

planned_hours

The hours for this user if the planned hours at the user level feature is enabled.

project_assignment_profile_id

The ID of the associated project assignment profile.

project_groupid

project_group_id

The ID of the project group if the user was assigned as part of a project group.

projecttaskid

projecttask_id

[Required] ID of the project task to which this user is assigned. Th eproject task must be a task and not a phase.

rule_rate_override

Hourly billing rate for the user assigned to the task. Effective only if your company's account configuration allows billing rule rate override on task assignments. Negative values are not allowed.

rule_rate_override_currency

The 3–letter currency code for the billing rate currency. Defaults to the company's base currency if not set. Can be set to any currency specified in Administration > Global Settings > Organization > Currencies > Multi-currency if the Multicurrency feature is enabled for your company's OpenAir account.

updated

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

userid

user_id

[Required] The ID of the user assigned to this task. The user must exist, must not be marked as deleted and must be active.

Usage Guidelines

Adding or modifying a Projecttaskassign assign triggers the project recalculation process in OpenAir unless you use the no_recalc attribute (see Add, Update and Upsert Attributes), or unless your company's account is configured never to trigger the project recalculation process in OpenAir when a change is made using the API.