Document toolboxDocument toolbox

Configuring ServicePlanner

Owned by Matthew Wren
Jan 29, 2024
3 min read

On This Page:

FRU Region Level Mapping Configuration

With the release of ServiceScheduling 12.1, ServicePlanner can be configured to display either FRU region levels 1, 2, or 3 when displaying maps.

By default, FRU region levels 3 will be displayed.

To change this, update the sp083_system_parameters.planner_region_level database value, and set the desired integer value of either 1, 2, or 3.


Not all ServiceScheduling users will have level 1 or 2 FRU regions in use, and enabling these levels may not be desirable. ServicePower recommends customers discuss their FRU level requirements with the Professional Services team before using anything other than the default setting.

Geographic Data

Geographic Data

With the release of ServiceScheduling 11.2, ServicePlanner utilizes the data from the ServiceOptimizer Travel Matrix installation. Provided a compatible Travel Matrix is installed, then there is no need for any additional geographic data for ServicePlanner.

Other Configurable Properties

There are a number of properties in the service_planner.properties file that can be changed to configure ServicePlanner's functionality

# jobdensity.days - The default number of days that ServicePlanner will inspect when collating data
#                   to plot the density of jobs.
jobdensity.days=14 

# download.image.width & download.image.height - The width and height of the map image created when
#                                                ServicePlanner creates a printable map
download.image.width=2378
download.image.height=1682 

# map.zoom.DEF - The default minimum and maximum zoom levels between which the level 1, 2, and 3
#                region boundaries and labels will be displayed when viewing a map, unless viewing
#                a country map where these defaults have been overridden.
#
#                For the example below, level 1 boundaries and labels will be displayed for zoom
#                levels 7 through 9; level 2 boundaries and labels will be displayed for zoom levels
#                10 through 12; and level 3 boundaries and labels will be displayed for zoom levels
#                13 through 20.
map.zoom.DEF=7,9,10,12,13,20

# map.zoom.XX - Override the default zoom levels used for displaying the level 1, 2, and 3 region
#               boundaries and labels for a given country, based on a 2 letter country code.
#               The example below overrides the map.zoom.DEF default values for the UK.
map.zoom.UK=9,10,11,13,14,20

Configuring GPS for use in ServicePlanner

If ServicePlanner has been installed with geographic data, and a GPS service provider solution is available, then the GPS components for ServicePlanner can be configured.

To configure the GPS, add the following entry to the service_manager.properties file:

gps.implAs=SOAP

Additional support from the ServicePower team will be required to assist you with the integration to your GPS service provider.