Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space SCHUD and version 9.3
Panel

...

The sp:EmpOverrideRequest API method can be used to override an operative's shift and/or locations.

 

 

...

On This Page:

...

Table of Contents

Related Pages:

...

Panel

The sp:EmpOverrideRequest API method can be used to override an operative's shift and/or locations.

Description

The sp:EmpOverrideRequest API method allows an operative’s shift and/or locations (start, end, and local knowledge) to be overridden for a required date.

The existing shift (or existing shift override) of an operative (EmpID) is overriden on the supplied Date if ShiftPeriod is supplied (i.e. not NULL).

Similarly, the existing locations (or existing location overrides) of an operative is overridden on the supplied Date if EmpLocs is supplied (not NULL).

Without any options set, a shift override will not be generated (if supplied) for a Date when the operative would not normally be on shift (i.e. has a shift period in their assigned shift pattern or an existing shift override) or is on a public holiday (SP_NO_SHIFT or SP_HOLIDAY will be returned, respectively).

Note

Jobs will be shuffled after the overrides have been applied. This may result in some jobs being shuffled outside their access hours.

Note

If, as a result of an sp:EmpOverrideRequest API call, an operative is left with jobs in non-shift time, they won’t be de-allocated, but, unless they are fixed, or have a status > tentative, the Optimizer may de-allocate them when it next runs if it can not re-allocate them.

Note

This SOAP API is implemented in real time, i.e. the overrides can be assumed to have taken effect on successful return from the call.

The underlying shift from a shift pattern, if there is one, can be restored by using the Shift and Location Restore SOAP API.

Definition

The definition of this API is:

Include Page
_API EmpOverrideRequest Definition
_API EmpOverrideRequest Definition

Return Structure

The API returns the standard return structure.

Return Codes

In addition to the Standard Return Codes, the possible Return Codes from this API are:

Include Page
_API EmpOverrideRequest Return Codes
_API EmpOverrideRequest Return Codes