Siebel Field Service Guide > Business Service Methods in Siebel Field Service > Business Service Methods for the Dispatch Board >

GetCalculatedDistanceVals Method

GetCalculatedDistanceVals calculates the distance between the selected activity location and the employee location, and produces a list of employee ID and distance value pairs. This method calls the CalculateFromToAddress method and subsequently, the CalculateDistanceVals method.

This method performs the following tasks:

1. Determines the location and starting time of the new activity.
2. Determines the location of the employee by completing the following steps:
   1. Identifies the employee activity with an end time that is closest to the start time of the new activity.
   2. Identifies the location of this employee activity.
   3. If no such activities are found, then selects the employee default location. The Start Shift Location Field Name business service user property defines the address ID.
3. Calculates the linear distance between the 2 locations using the addresses of the unscheduled activity and the employee location.

This method returns a distance of -1 to alert users when there is no valid result from the data provided. Typically, invalid results occur because of a missing address or unmapped ZIP Code.

Invoked From

This method is called by the applet for the Gantt chart of the Dispatch Board.