ApprovalLine

An approval line [ApprovalLine]is an action in the chain of approval for transactions that require approval, such as timesheets or expense reports for example.

For more information about approval routing, see Approval Routing.

XML

SOAP

REST

Database table

Object

ApprovalLine

oaApprovalLine

approval

Supported Commands

Read

read()

The ApprovalLine object has the following standard properties:

XML / SOAP

Database

Description

action

action

[Read-only] The approval action.

  • S - Initial submission for approval

  • P - Pending approval request

  • A - Acceptance of approval request

  • R - Rejection of approval request

  • U - Unapproval action

approvalid

approval_id

[Read-only] ID of the associated approval. Represents a meta-approval, or an 'approval confirmation'.

approvalprocess_ruleid

approvalprocess_rule_id

[Read-only] ID of the approval process rule if this is associated with an approval process.

approvalprocessid

approvalprocess_id

[Read-only] ID of the approval process if this is associated with an approval process.

audit

audit

[Read-only] Audit trail of changes

authorizationid

authorization_id

[Read-only] ID of the associated authorization

booking_requestid

booking_request_id

[Read-only] ID of the associated booking request

bookingid

bookingid

[Read-only] ID of the associated booking

created

created

[Read-only] Time the record was created.

See Date Fields

customerid

customer_id

[Read-only] ID of the associated customer

date

date

[Read-only] Date and time of the action.

See Date Fields

deal_booking_requestid

deal_booking_request_id

[Read-only] ID of the associated deal booking request

delay_action

delay_action

[Read-only] Delayed action

delay_to

delay_to

[Read-only] Delay action until this time

envelopeid

envelope_id

[Read-only] ID of the associated envelope (expense report)

id

id

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

invoiceid

invoice_id

[Read-only] ID of the associated invoice

notes

notes

[Read-only] Notes, reasons, etc.

pending_done

pending_done

[Read-only] If the action is 'P'ending, this flag is set to 1 once an 'A' or 'R' action record is created.

project_budget_groupid

project_budget_group_id

[Read-only] ID of the associated project budget group

project_total

project_total

[Read-only] If this is a project-based approval this holds the total amount (money or hours) that was approved.

projectid

project_id

[Read-only] ID of the associated project if this is a project approval

proposalid

proposal_id

[Read-only] ID of the associated proposal

purchaseorderid

purchaseorder_id

[Read-only] ID of the associated purchase order

purchaserequestid

purchaserequest_id

[Read-only] ID of the associated purchase request

revenue_containerid

revenue_container_id

[Read-only] ID of the associated revenue container

schedule_requestid

schedule_request_id

[Read-only] ID of the associated schedule request

seq_number

seq_number

[Read-only] If this is associated with an approval process, this is the sequence number associated with it.

status

status

[Read-only] The status of the child meta-approval. Only assigned a value if the record has a meta-approval.

  • S - Submitted

  • A - Approved

  • R - Rejected

submitter

submitter

[Read-only] ID of the user submitting the approval. Only valid for a submittal record (action = 'S').

timesheetid

timesheet_id

[Read-only] ID of the associated timesheet.

updated

updated

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

See Date Fields

userid

user_id

[Read-only] ID of the user. A submittal record has the ID of the user whose approvals are to be followed, this is usually the user who submitted the request, but for booking requests, it may be either the submitter or the user for whom the booking request is for depending on setting. All other records have the ID of the approver.