Professional Documents
Culture Documents
Territory Planner Quick Ref
Territory Planner Quick Ref
Roadnet and Territory Planner are registered trademarks of Roadnet Technologies, Inc.
© 2011 by Roadnet Technologies, Inc. 849 Fairmount Avenue, Suite 400, Towson, MD 21286. All
rights reserved.
This manual is the property of Roadnet Technologies, Inc. It may not be reproduced by any method, in
whole or in part, without written permission of the publisher.
Computer Program Code and Screen Displays © Copyright 2011 by Roadnet Technologies, Inc. All
Rights Reserved. The contents of this material are confidential and proprietary to Roadnet Technolo-
gies, Inc. Unauthorized use, disclosure, or reproduction is strictly prohibited. Rights to use are gov-
erned and limited by a license agreement.
Microsoft® Access is a registered trademark or trademarks of Microsoft Corporation in the United
States and/or other countries.
Crystal Reports™ is a registered trademark of Seagate Software Company.
©Geographic Data Technology, Inc.
This product contains proprietary and confidential information of Geographic Data Technology, Inc.
Unauthorized use, including copying for other than testing and standard backup procedures, of this
product is expressly prohibited.
Table of Contents
Table of Contents
Territory Planner Quick Reference Guide.................................................. 1
Importing Location Extensions .................................................................. 2
Creating the Territories............................................................................... 6
Evaluating the Territories ........................................................................... 8
Editing the Territories............................................................................... 13
Assigning Drivers, Equipment, and Other Items to a Territory ............... 15
Creating Routes in the Planning Editor .................................................... 17
Evaluating the Routes in the Planning Editor........................................... 19
Editing Routes in the Planning Editor ...................................................... 24
Letting the Planning Editor Suggest the Territory or Routes ................... 30
Saving the Territories and Routes ............................................................ 34
Finding Territories, Weeks, Routes, Stops, or Location Extensions ....... 35
Anchoring Location Extensions ............................................................... 37
Setting the Previous Days and Weeks............................................... 41
Printing Driver Directions in the Planning Editor.................................... 43
Printing Maps in the Planning Editor ....................................................... 45
Uploading the Planning Routes ................................................................ 46
Printing Reports........................................................................................ 50
Previewing Reports .................................................................................. 51
Printing Report Groups............................................................................. 52
Index ......................................................................................................... 53
Before you import location extensions, click the [Other Options] button
and choose your default service pattern set and default active weeks.
saved, so the next time you open the window you will be able to see all
the information.
Step 5: If you only want to update existing location extensions in the
sessions with new information, check Update Only. If there are new
location extensions in the import file, they will be ignored.
Step 6: Click the [Import] button. If you are importing locations, they will
be imported into all sessions, and the location extensions will be
imported into the selected sessions and the stops placed on routes as
specified.
Note: After importing you can view the import log or any errors that may
have occurred during the import. Click the [View Log] or [View
Errors] button.
Step 7: When all location extensions have been imported, click the Close
box to close the Import Location Extensions window.
Importer →Import → Maintenance →Location Extensions → [Import]
List Windows
The Territory list window provides a lot of information about each territory,
as well as totals information for all the territories. For instance, you can use
the appropriate column to see how well the territories are balanced on your
selected primary criteria. To see the list of location extensions assigned to the
territory, right-click on the territory and select Location Extensions from the
menu that pops up, or click the Location Extension icon on the Territory
toolbar. To see a list of all location extensions that were not assigned to any
territory, click the List menu and select Unassigned.
The Territory list window provides a lot of information about the territories. You can
arrange the columns so you can easily see the information that is important to you.
Map
You can use the map and its features to visually evaluate the territories. To
display a territory on a map, right-click on the territory and select Plot from
the menu that pops up. See Viewing Territories and Routes in the Planning
Editor in the Roadnet Transportation Suite Operations Guide for more
information.
Territory Scoreboard
The Territory Scoreboard, opened by selecting Territory Scoreboard from the
File menu ([Ctrl]+[D]) or clicking the Territory Scoreboard icon on the
General toolbar, provides an easy way to evaluate all the territories in the
planning session. It displays totals, averages, minimum and maximum values,
as well as variance information for all three size aliases, service time, and the
number of locations and stops. The bottom of the window provides geometric
and geographic information about the territories, including the total area, total
overlap, and the extreme latitude and longitude for all the territories.
In addition, there is a score at the top that reflects the primary and secondary
criteria settings in the Make Territories Options notebook. As you move
locations between territories, this score will be updated to reflect the move,
making it easy for you to see if the move improved or lowered the score.
Planning Editor →File → Territory Scoreboard ([Ctrl]+[D])
Note: The Equipment [Options] and Score Weighting Factors [Adjust]
buttons allow you to change the settings of the parameters used to
calculate the score. The Equipment [Options] button enables you to
switch on the option to make territories according to equipment type
and allows you to adjust the primary criteria for scoring. When you
create territories by equipment type, the primary criteria calculations
are expressed in percentages that are determined by how much of the
equipment’s capacity is used. The Score Weighting Factors [Adjust]
button opens a window with the eight slider-bars showing the settings
that were established in the Make Territories Options notebook. You
can change the settings here if desired; the score will be updated to
reflect the changes, which will also appear in the Make Territories
Options notebook. To close these windows without changing any
settings, press the [Esc] key.
Territory Analysis
The Territory Analysis window, opened by right-clicking on a territory and
selecting Territory Analysis from the menu that pops up, provides statistical
and geometric information about a single territory. You can view information
about the territory’s centroid and area, as well as the actual percent value of
the total for each size, service time, number of locations, and stops. The
bottom of the window lists the other territories, and the amount of overlap
between each territory and the territory being analyzed. If you leave the
Territory Analysis window open while editing the territory, it will
automatically be updated with new information.
In addition to viewing this information, you can perform some actions from
this window.
To balance the analyzed territory with another territory from this window,
simply select the other territory(s) in the Overlapping Territories: list and click
the [Balance] button. The territories will be balanced based on the last options
saved in the Make Territories Options notebook.
To print the Territory Analysis window, click the Printer icon.
Scoreboard tells you how much total overlap you have between all your
territories, and the Territory Analysis tells you the amount of overlap between
one territory and the others, but the Territory Overview lets you see the actual
territories and overlap on the map.
Step 1: Open a map with the pertinent territories displayed.
Step 2: Click on the Map View icon and select Territory Overview, or press
[Alt]+[O]. The map changes to show the filled territories on a black
background, making it easy to see any overlap between the territories.
You can use the Account Type Summary to determine how many of each account type
exist on the selected territory.
Note: If you hold down the left mouse button, or the left mouse button and
the [Ctrl] key, when dragging the extension, it is placed on its currently
assigned day. The stop’s sequence on the route is based on the
selection made on the Drag/Drop page of the Options notebook.
To have the Planning Editor suggest which territory to place the location
extensions on, right-click on the location extension and select Suggest
Territory from the menu that pops up. The Suggest Territory window opens.
Choose Unrouted in the Placement in route section. Select the other options as
necessary and click [Suggest]. The Planning Editor will suggest the possible
territories with the best suggestion highlighted. For more information on
letting the Planning Editor suggest the best territory, see Letting the Planning
Editor Suggest the Territory or Routes.
If there are some territories that are unbalanced, you can let the Planning
Editor balance only those territories. When you balance territories, the saved
options in the Make Territories Options notebook are used as guidelines. If
you balance territories when the Use Equipment Type When Creating
Territories option is turned on, the balance will be proportional based on the
equipment types you have selected. In the Territories window, select the
territories you want to balance. Right-click on a selected territory and choose
Balance Territories from the menu that pops up ([Shift]+[B]), or click the
Balance Territories icon on the Territory toolbar.
Note: If you were not granted permission to change Assign Days Options in
the Administration module, you will not be able to open the Assign
Days Options notebook.
Step 4: When the routes have been created, the Assign Days window closes.
You can now evaluate the routes and edit them as needed.
Planning Editor →Tools → Assign Days to all ([Ctrl]+[Y]) → [Start]
List Windows
List windows can be helpful for viewing detail information about the routes,
such as the time, distance, service time, delivery quantity, stops, etc. You can
also view a list of the stops on the route in a list window.
To see the time, distance, quantity, number of stops and other information
about the route, open the Daily Routes window. To open the Daily Routes
window, double-click on the territory in the Territory window; the Weeks
window opens. Double-click on the week in the Weeks window; the Daily
Routes window opens. Arrange the Daily Routes window as necessary so you
can view the columns containing the information you want to see.
To see a list of stops for the route, double-click on the route in the Daily Routes
window. The stop list for the day opens, listing the stops on the route.
Map
While the list window can provide a lot of detail information about the route,
it is sometimes helpful to see how the routes are laid out. The map allows you
to see the actual routes. You can also choose to use the Route Summary
window to easily determine the effect of any changes you make to displayed
routes. For more information on setting up the map to see the routes, see Using
the Maps in the Planning Editor in the Roadnet Transportation Suite
Operations Guide.
To see an individual route on the map, right-click on the route and select
Plot from the menu that pops up ([Ctrl]+[P]), or click the Plot icon on the
Routes toolbar. The map opens with the route displayed.
To see all the routes for a week, right-click on the week in the Weeks
window and select Plot from the menu that pops up ([Ctrl]+[P]). A map opens
in Route View with the week selected; click on the buttons for the days you
want to view.
To see all the routes for a territory, right-click on the territory and select Plot
from the menu that pops up ([Ctrl]+[P]). The map opens in the Territory View,
showing the territory. To see the routes, click on the Map View Mode icon and
select Route View. Click on the buttons for the weeks and days you want to
see.
Notes: The Planning Editor includes some features that make it easier to see a
route on a map, especially if the map already has several routes on it.
You can choose to animate, flash, or locate the route on the map.
Animate highlights the stops in order, flash ([Ctrl]+[H]) flashes the
route several times, and locate ([Ctrl]+[O]) zooms the map to the route.
To use any of these options, right-click on the route and select the
option from the menu that pops up. You can also flash or locate the
route by selecting the route, then selecting the icon on the Routing
toolbar, or pressing the hotkey combination. Flash and locate are also
available from lists of stops or location extensions or the Location
toolbar to help you find individual extensions on the map. In addition,
when you select a territory or week in the list window, it is highlighted
on the map.
To quickly select/deselect all the weeks or days on the map, double-
click on the word Weeks or Days. If all weeks/days are selected they
will be unselected, otherwise all weeks/days will be selected.
To open the Route Summary window and see the effects of changes made
to displayed routes, click the Show/Hide Summary icon. The Route
Summary window will open on the side of the map, attached to the map. Click
the appropriate options to see the information you want to evaluate.
If you open the map’s Route Summary window you can easily see the effects of any
changes you make to the displayed routes.
To change the day that a location extension is routed on, drag the location
to the map button for the new day. If the location extension was already on a
route (you are simply changing its day), it will be routed on the same week. If
you drop an unrouted extension on a day, it will be routed on the first week of
the cycle. You can also drag a location extension to a week button; if the
extension is already routed it will keep its same day on the new week; if it is
unrouted Territory Planner will pick the best day on the week.
Route Summary
The Route Summary is an easy way to see information about all or selected
routes. Any changes you make to your routes will be automatically reflected
in the Route Summary, so if you leave the Route Summary open you can
immediately see the effects of any changes you make to your routes.
The Route Summary provides information about the routes for the territories and weeks
you select.
To open the Route Summary, click on the File menu and select Route
Summary ([Ctrl]+[R]), or click the Route Summary icon on the General
toolbar. Once the window is open, you can choose the territory(s) and week(s)
you want included in the summary.
The top of the Route Summary window displays daily totals about the number
of routes, trips, stops, load (quantity), runtime, distance, and cost. In the
middle of the window, statistical information about the same categories is
displayed. At the bottom of the window, you can see how well the routes are
balanced by looking at the runtime and load variance, displayed in the Route
% Variance box.
Note: You can choose which size alias you want the load displayed as, as well
as whether the statistics are displaying the average, minimum, or
maximum for the selected routes.
Planning Editor →File → Route Summary ([Ctrl]+[R])
the stop you want it to be placed after; to make the stop the first stop on the
new route drop it on a column header (the depot on the map).
To allow the Planning Editor to determine where the stop should be
placed, drag the stop to the Daily Routes window and drop it on the new route.
If you held down the left mouse button while dragging the stop, the stop will
be sequenced as specified on the Drag/Drop page of the Options notebook. If
you held down the right mouse button while dragging the stop, a menu appears
when you drop the stop. Choose the appropriate option. The choices are:
• Insert first
• Insert by best cost
• Insert by best distance
• Insert near closest location
• Insert by best time
• Insert by best time window
• Insert last
Note: If a stop in a time of day restricted area is placed on a route with a
restricted equipment type, driver directions will display directions
using non-restricted time and distance information for that stop.
To have the Planning Editor suggest where the stop should be placed,
right-click on the route and select Suggest Territory from the menu that pops
up. The Suggest Territory window opens. Choose either Closest Location,
Best Distance, Best Cost, Best Time, or Best Time Window in the Placement
in route section. Select the other options as necessary. The Planning Editor
will suggest the possible routes with the best suggestion highlighted. For more
information on letting the Planning Editor suggest the best route, see Letting
the Planning Editor Suggest the Territory or Routes.
To remove the stop from the territory, right-click on the stop in the Stops
window and choose Unassign Completely from the menu that pops up. The
stop will be moved to the Unassigned window.
To remove the stop from the route, but leave it on the territory, right-click
on the stop in the Stops window and select Unroute on Territory from the
menu that pops up. The stop will be moved to the Unrouted window for the
territory.
Notes: If you want to perform one of these actions on all a territory’s routes,
or all the routes for a week, right-click on the territory/week and select
Action, then the action from the menu that pops up. This saves you
from having to work with each route separately.
When sequencing routes, the sequence works separately on each trip
on the route. The mid-route depot(s) will remain where they are and
the sequencing action is only performed on each trip
If you are making changes that leave the location extension on the
current route, and you want the extension to maintain its current
position, check the Try To Maintain Stop Order on Route box.
Step 5: Click the [Assign] button.
Notes: You can also change the delivery quantity or territory for a location
using the Speed Editor. Changing either of these items may require
you to either change the location’s delivery days or service pattern and
service pattern set.
If the delivery days and weeks you assigned do not correspond to a
service pattern in the service pattern set you selected, the Service
Pattern Set Selection window opens. Choose a new service pattern set
and click the [OK] button, or click the [Cancel] button to return to the
Speed Editor. If you are changing multiple location extensions and
decide you do not want to make any of the changes, click the [Cancel
All] button.
If the Service Pattern Set is Manual Load Distribution, you can enter
the delivery quantities for each day of the week, allowing you to have
Step 6: In the Suggest Territory window, click the Placement in route arrow
and select the appropriate option to specify how the location
extension should be placed on the route.
To have the Planning Editor suggest the best possible placement
on the routes, select Closest Location, Best Distance, Best Cost, Best
Time, or Best Time Window.
To have the Planning Editor suggest only the best possible
territories, select Unrouted.
Note: The Daily route will not exceed section will be disabled when you select
Unrouted.
Step 7: To specify the capacity and time restrictions for suggested routes,
choose the appropriate options in the Daily route will not exceed
section.
To prevent the routes from exceeding capacity, check the size
aliases that cannot be exceeded.
Choose the appropriate time restriction.
Step 8: In the Max. no. of suggestions to display, specify the maximum
number of results that will be suggested.
Step 9: Check Show accepted results to open a separate results window
listing the territory/routes that each location extension was placed on.
Step 10: Once you have specified the criteria, click the [Suggest] button to
have the Planning Editor determine the best territories/routes. The
results are displayed in a suggestion list, with the best suggested
territory/routes highlighted.
Notes: To automatically insert the best suggestions for each location
extension without having to manually choose the territory/routes, click
the [Auto Insert] button. The location extensions are moved to the
territories/ routes with the best suggestion score.
The Locate window can save you time, since you don’t have to search through several windows
to find the particular territory, week, route, stop, or location extension you are looking for.
Step 4: Choose whether you want the results displayed as territories, weeks,
routes, stops, or location extensions.
Step 5: Click the Execute Query Using Criteria icon. The entries that match
the search criteria are listed at the top of the window.
To perform multiple searches without losing the results of previous
searches, check Retain Results before doing a subsequent search.
To remove the search criteria, click the Erase icon.
Planning Editor →Tools → Locate ([Ctrl]+[L])
Note: The Previous Days and Previous Weeks columns in the Location
Extensions window show the Previous Days and Weeks for each
location extension.
Upon using the Update Previous Days and Weeks feature, the Previous Days
will become the same as the Delivery Days and the Previous Weeks will become
the same as the Delivery Weeks.
Step 4: To change the name or location of the export file, click the [File
Layout] button and select Edit Layout, then User Upload. The User
Upload Layout window opens. Enter the path and name of the file to
be created.
Step 5: To review or change the position and length of fields in the
destination file, click the [File Layout] arrow and select Edit Layout,
then the name of the layout. See Setting the Import File Layouts, User
Upload Available Fields, Location Available Fields, or Location
Extension Available Fields in the Roadnet Transportation Suite
Operations Guide for more information.
To view a report of the layout being used, including the location and
name of the file being created and the starting position and lengths of
the fields in the file, click the [File Layout] arrow and choose Preview
from the menu that pops up. The report will include the layout
information for all three layouts (import locations, import location
extensions, and user upload). The organization of the three layouts in
the report - separate pages vs. intermingled - will depend on the import
layout report options selected in the Import module.
Step 6: If you specified to include week information in the upload file, such
as active weeks from the location extension layout or previous weeks,
choose whether you want the weeks shown as 1 and 0 (true and false)
or X and space.
For instance, in a four week cycle, if the location extension is delivered
on weeks 1 and 3, the information will appear in one of these formats:
1010
XX
Note: Twenty-four weeks of data will always appear in the upload file, even
if the planning session is less than 24 weeks. The data will simply
repeat to look like 24 weeks. For instance, if your session is 2 weeks,
and a location is delivered the first week, the active weeks will be uploaded
as 101010101010101010101010.
You can change the file layout for the user upload file by clicking the [File
Layout] button and selecting Edit to open the Layout window.
Step 7: If you specified to include day information in the upload file, such as
a day string from the location extension layout or the previous days,
specify whether you want the days indicated by a letter (MTWRFSU)
or 1 and a 0.
For instance, if the location extension is delivered on Monday and
Friday, the information will appear in one of these formats:
M F
010001
Note: When exporting the day string, Sunday is placed in the first position -
the days of the week are UMTWRFS.
Step 8: If you specified to have the latitude and longitude uploaded in the
Locations layout, enter the numbers to the right of the decimal you
Printing Reports
Territory Planner comes with many reports you can preview on the screen or
print directly to the printer. The report will be sent to the printer selected in the
Print Setup (File → PrintSetup). You can preview the reports from either the
Reports module or the Planning Editor. The directions below explain how to
preview the reports from the Reports module; the procedures are the same to
preview the reports from the Planning Editor.
Note: Some report entries may be truncated if the values are too long. For
instance, if the quantity for a session, territory, or week is greater than
9 digits, excluding any decimals or commas, it will appear as #### on
the report. If the quantity for a route, stop, or location extension is
greater than 7 digits, excluding any decimals or commas, it will appear
as ##### on the report.
Step 1: Click on the Reports icon to open the Reports module. The Reports
module opens, with the Reports window listing all available reports.
Step 2: Right-click on the report you want to print. A pop-up menu appears.
Choose Print Report from the pop-up menu. The Selection Criteria
window opens.
Note: You may have to run other program functions before printing some
reports. See the description for each report in the Roadnet
Transportation Suite Operations Guide to determine if any preliminary
steps are necessary for that report.
Step 3: The information contained in the Selection Criteria window will vary
according to the report chosen. Make all necessary selections to set up
your report. Then, click [OK] to print the report.
Reports icon → Reports window → Print → [OK]
Previewing Reports
At times you may want to view a report before it is printed, especially if you
are uncertain how long the report will be or if the report contains the
information you need. Territory allows you to view reports before they are
printed so that you can limit or cancel the printing if necessary. You can
preview the reports from either the Reports module or the Planning Editor.
The directions below explain how to preview the reports from the Reports
module; the procedures are the same to preview the reports from the Planning
Editor.
Note: For a sample of each report, refer to the Report Samples in the Roadnet
Transportation Suite Operations Guide section. For a sample of each
report, click on the report sample link in the report description section.
Step 1: Click on the Reports icon to open the Reports module. The Reports
module opens with the Reports window listing all available reports.
Step 2: Right-click on the report name you want to print. A pop-up menu
appears. Choose Preview Report from the pop-up menu. The
Selection Criteria window opens.
Note: You may have to run other program functions before previewing some
reports. See the description for each report in the Roadnet
Transportation Suite Operations Guide to determine if any preliminary
steps are necessary for that report.
Step 3: The information contained in the Selection Criteria window will vary
according to the report chosen. Make all necessary selections to set up
your report. Then, click [OK] to preview the report.
Step 4: Depending on the report you are previewing, one of two Selection
Criteria windows will open. Enter the dates for the range you want to
view, and if necessary select the routes. Click the [OK] button to
preview the report.
Step 5: The report will open in a Report View Window. For more
information on navigating in the view windows, see Report View
Windows in the Roadnet Transportation Suite Operations Guide.
Reports icon → Reports window → Preview → [OK]
a territory 13
Territory Scoreboard 9
Time windows in the Planning Edi-
tor
sequencing routes 26
Transferring
stops to another route in the
Planning Editor 24
U
Unrouteds
routing in the Planning Editor 24
Update Previous Days and Weeks
general 41
Uploading
routes to a network or mainframe
from the Planning Editor
46
User Upload 46
Using
Territory Scoreboard to evaluate
the territories 9
V
Viewing
account type distribution across
territories 12
overlap between territories 11
W
Working with
a route in the Planning Editor 17
territories 6