Appointment Booking with Mobile Workforce Management

Introduction

Mobile Workforce Management is a scalable optimization framework which conducts advanced workforce scheduling. It comprises a number of separate calculation and optimization engines - one of these is the Appointment Booking Engine (ABE).

The ABE receives Appointment Requests, and then rapidly returns a set of Appointment Offers - time slots that are currently suitable for the work to be performed. Once a particular slot has been selected, as suitable, the Appointment can be confirmed, and the reservations on the remaining unused slots are cancelled.

The Integration between Mobile Workforce Management and IFS Applications

The integration of ABE with IFS Applications provides functionality for the booking of appointments to carry out work orders in order to:

An Activity (separate work order) is sent from IFS Applications to the Appointment Booking Engine using an Appointment Request. The Activity details are accompanied by a set of Availabilities - time slots, over a defined period, that are considered suitable for the work.

The booking engine is required to rapidly return a set of Appointment Offers. To do this, it uses a different set of algorithms to those used by the Dynamic Scheduling Engine (DSE) - optimized to give a quick response, rather than the very best schedule. The offers are constrained by the available resources, skill limitations, travel times, resource and travel ‘costs’. The engine is not trying to find the best overall value for the organization (as the DSE does) - rather it is looking at whether the appointment slot is feasible - and if so - what is the resulting ‘value’ of the slot. The ‘value’ is the difference between the positive ‘revenue value’ attributed to carrying out the activity, minus the associated resource/travel ‘costs’. If the ‘costs’ are greater than the ‘revenue value’, then no offer will be made for the slot.

The ‘values’ are returned to IFS Applications, with the slots, and are then displayed to the user to assist them in choosing an appointment that will maximize the benefit to the organization and that will suit the customer - they are free to choose any proposed offer slot.

Offers will be returned for the period defined in the dataset (Appointment window days + Scheduling window days), or a shorter period, defined by the Period Start/end dates in the Appointment Booking session. There are indicators in the Appointment booking dialog, to distinguish for each offer whether it is in the Scheduling SLA range - subdivided into Primary (meets the required SLA) or Secondary (missed the SLA, still schedulable) periods.

The appointment offer, from the ABE, may be for the whole slot, or can be for a shorter window, within the slot (depending upon the booking session parameters). Shorter windows are used where an appointment (say - 2 hours long) is to be booked within a morning (4 hours) - only one offer is made, per morning - the booking engine decides when the best 2 hour window is, within the 4 hour slot. The appointment start and end dates are transferred to the work order when the appointment booking is accepted - the booking session is then concluded.

Functional Dependencies

The following IFS Applications components must be installed in order to use the Mobile Workforce Management integration:

Furthermore, the following solutions cannot be used together with the Mobile Workforce Management integration at the same time by Mobile Workforce Management scheduled sites:

Appointment Booking Concepts

An appointment request is a message from IFS Applications to the ABE, detailing the activity to be booked, and the possible time slots that should be considered.

An appointment offer is a message from the ABE to IFS Applications, detailing, per requested slot, whether the slot can be offered as an activity booking, and if so - the ‘value’ of the offer. For each slot, the proposed appointment start/end time is defined. When an offer is made, all the offered slots are ‘reserved’ against the request - as this may prevent other activities also being scheduled for the same times, with the same resources, the offer has a timeout - if the offer is not accepted within the timeout, the offer will automatically lapse after the timeout. Typically a timeout should be 10 minutes, or less, to ensure slots are not kept reserved for too long.

An appointment acceptance is a message from IFS Applications to the ABE, telling ABE to accept one of the offered slots, and to unreserve all the other slots.

To decline an appointment offer is to ask the ABE to unreserve all the offered slots. Another request can be made - immediately - and other activities can be freely scheduled, as the resources ‘reserved’ to the requested slots have now been ‘unreserved’

Data Setup in IFS Applications

Scheduling Configuration Parameters for Appointment Booking

For more information on the scheduling parameters related to the Mobile Workforce Management Integration please refer to the activity Define Scheduling Configuration.

Booking Work Order Appointments with Mobile Workforce Management

In order to book an appointment for a work order, the work order must be set to a status less than Assigned. An appointment can be booked on a work order that is at a status less than the transfer status – i.e. the order will not be scheduled normally, but can be appointment booked – once booked, it will stay in the schedule. All information required by the Mobile Workforce Management also needs to be present on the work order.

For an order to be appointment booked, it must

The Appointment Booking session is started from a right mouse action, from the Prepare Work Order form, Service Request form and Active Work Orders form. A new window is created - this stays on top but can be moved around the screen, and other windows can still be accessed (to allow details of the work order/customer etc to be checked, whilst a booking is being made). Depending on the parameter Appointment Booking Layout Mode (Scheduling/Basic Data/Scheduling Configuration), the new window opens either in Grid mode or Calendar mode.

The booking form has a header, showing the main appointment parameters, below which is a table area (or calendar) to display and manage the appointment slots and offers. All actions on the form are made via local form buttons, or right mouse menus.

The Appointment session follows a workflow

Status Description
Preliminary An Appointment Booking is started at the status Preliminary. The default parameters are loaded from the Availability, linked to the work order (via the work type). If an Availability is not linked to the order, the booking session remains at this status
Slots Generated If a valid set of Availability/Slot parameters exist for the work order, then the parameters are used to generate appointment slots, and the session is automatically changed to status Slots Generated. The slots are shown in the table/calendar area
Request Sent Once slots have been generated, the Request button is activated. Selecting the Request button sends the status to Request Sent. A message is sent to the ABE - whilst this is in progress the booking form fields cannot be changed.
Offer Received When a set of offers is received from the ABE, the details of the offers are updated against each slot, and the status changes to Offer Received. When a slot has an offer, the offer value, offer rank, and offer times are displayed. If the offers are not acceptable - the offers can be Declined - the status returns to Slots Generated, allowing the parameters to be edited, and a new request made
Offer Accepted If an offer is suitable - the relevant slot line/record can be selected - and Accepted. The form will automatically close. Also in the work order, the Requested Start and Late Start fields get updated with the offer start and end dates if the appointment mode is appointment to start. Req.Start and Req. Finish dates are updated if the appointment mode is appointment to complete. A work order journal entry is also registered.

The Availability parameters on the booking form header can be edited, in states Preliminary and Slots Generated.

Selecting a Slot ID, from a list of values, sets the Slot Length and Slot Window.

The Period Start and End dates default from the Availability (calculated using the Period Start Offset and Period Length) - these can then be edited - the Period End Date must not be later than the end of the Dataset Appointment Window.

The Appointment mode is set from the Availability, but can be changed. An Appointment to Complete assumes that the job has to be started and finished within the slot - if this is selected, a check is made against the activity duration - if the duration is longer than the slot, then a booking cannot be made, and a longer slot needs to be selected.

The Slots are generated based on the Slot Length, and the Availability calendar, for the period defined by the start and end dates - slots are only created for working hours. Slots are defaulted to Available/Unavailable - depending upon the Slot Availability setting on the Availability.

All of the parameters, although derived from the default Availability/default Slot ID, can be edited, either directly, or by choosing a different Slot ID. Once a change has been made, the Apply button is selected to save the changes. The original defaults can be reset, using the Default button. The Refresh button reloads the stored values - used if changes have been made, that should not be saved - so the previously saved values need to be restored.

Once offers have been received, the only fields that can be edited, at Offer Received status, are the Slot Value Factor and the Slot Available checkbox.

If an appointment has already been made (shown on the Scheduling tab of a work order - Appointment Dates and Appointment Mode), then it can be cancelled, if required, by the use of the right mouse button option ‘Cancel Appointment’. This will remove the appointment from the work order and from Mobile Workforce Management.

An appointment can also be rebooked. If an appointment has already been made and a new appointment booking session is initiated, a warning is given- that an existing appointment already exists. No change to the existing appointment is made until a replacement has been booked. If no suitable replacement can be found, then the booking session is closed and the existing appointment is left unchanged.

If a rebooking is made then a work order journal entry is registered to assist with analysis of bookings and ensure that a full record of changes is maintained.

If an offer is accepted, that is outside the Primary SLA period (i.e. it is too late), then a reason code (with optional notes) is a required entry - generally only offers within the SLA should be selected - but sometimes these are not available, or the customer requests a later date - the reason coding allows for these different circumstances to be recorded accurately.

Displacing Scheduled Work Orders with Work Order Appointments with Mobile Workforce Management

It is possible to configure appointment booking to allow work order appointments to move other work orders with less importance or business value. This functionality would typically be used when appointment work orders should be favored over certain low priority work orders.

In order to accomplish this behavior the “MaxDisplaceableActivityPriority” parameter in iSWB (Workspace - Administration) which per default is set to "-1" must be changed to "2".

Below is an example on how the Displacement functionality works:

  1. If the work order has an SLA and Displaceable Until Days has not been set the on the SLA then the work order will not be displaced.
  2. If the work order has an SLA and Displaceable Until Days has been set to 20 days for the work order SLA, then the Work Order may be displaced until 20 days are remaining to the Primary Scheduling Type End Date.
  3. If there is no SLA on the work order and Displaceable Until Days has not been set on Scheduling Activity Type, then the work order will not be displaced.
  4. If there is no SLA on the work order and Displaceable Until Days has been set to 20 days for the work order Scheduling Activity Type, then the work order may be displaced until 20 days are remaining to the Primary Scheduling Type End Date.