Scheduleexception
A schedule exception [Scheduleexception
] is an exception to the normal work pattern in the company's or the employee's work schedule.
Review the Usage Guidelines for the Scheduleexception
object.
— |
XML |
SOAP |
REST |
Database table |
---|---|---|---|---|
Object |
|
|
— |
|
Supported Commands |
— |
— |
A Scheduleexception
object has the following properties:
XML / SOAP |
Database |
Description |
---|---|---|
|
|
[Read-only] Time the record was created. See Date Fields. |
|
|
[Required] The end date for the exception. See Date Fields. Must be after |
|
|
[Read-only] The type of exception. The only possible value is |
|
|
[Read-only] Unique ID. Automatically assigned by OpenAir. |
|
|
[Required] The exception name or description, for example New Years Day. |
|
|
The ID of the schedule change item from a schedule request. |
|
|
[Required] The start date for the exception. See Date Fields. Must be before |
|
|
The ID of the associated time type. The time type must be allowed in schedules. |
|
|
[Read-only] Time the record was last updated or modified. See Date Fields. |
|
|
The ID of the user of this is an exception to the user's work schedule. 0 if this is an exception to an account work schedule. |
|
|
The number of hours per day during this date range. This overrides any work hours on each day of either the account schedule or the account/user schedule. |
|
|
The ID of the corresponding work schedule. |
Usage Guidelines
Review the following guidelines:
-
One of
userid
orworkscheduleid
is required. If the schedule exception is for a user work schedule, the value of one property is derived from the other. -
The date range defined by
startdate
andenddate
must not overlap with the date range for any other schedule exceptions associated with the same work schedule, unless all the following conditions are met:-
The Automatically create schedule exceptions when a time-off request is approved box is checked in the Timesheets application settings in OpenAir (Administration > Application Settings > Timesheets > Other Settings ).
-
The
schedule_request_itemid
value is not empty or0
. -
Your account is configured to allow multiple schedule exceptions on the same day.
-
-
Changes to schedule exceptions trigger a recalculation of the associated work schedule and automatic changes to the
booking_by_day
table.