Cart Route Editor Tool

Overview

Note

This documentation is maintained for reference and for environments where the Cart Route Editor is enabled.

The Cart Route Editor Tool is a specialized transportation planning and route management system designed for comprehensive cart route creation, documentation, and analysis. This advanced tool integrates sophisticated geometric editing capabilities with detailed route information management, supporting both point and line geometries for complete route planning, hazard documentation, communication channel assignment, and comprehensive route analysis with integrated mapping and reporting capabilities for professional transportation planning workflows.

Quick Reference

For experienced users who need a quick reminder of the workflow:

1. Open the Cart Route Editor from the toolbar.
2. Create or select a cart route name in the information panel.
3. Use point and line tools to draw route elements on the map.
4. Save your route information and geometry.
5. Generate maps and reports as needed.

Complete Workflow

Follow these steps to create and manage cart routes:

1. Create new cart route information.
2. Select a cart route name from the dropdown.
3. Draw point or line geometries on the map.
4. Select the existing cart route name in the panel for printing cart route maps and reports.
5. Print cart route maps and reports.

Getting Started

1. Click the Cart Route Editor icon in the toolbar.
2. The tool will initialize and load existing cart route layers.
3. The editor panel opens with three accordion sections:
   • Cart Route Name Selection — set the active route name and use the Filter by Name toggle
   • Cart Route Information — create or view cart route metadata (hazard, UHF, route description)
   • Geometry editing tools and Save Cart Route — draw, edit, delete, and save geometry

Cart Route Name Selection

The Cart Route Name Selection accordion at the top is where you set the active name before drawing:

1. Use Dropdown: Select an existing cart route name from the Cart Route Names dropdown (refreshes on click)
2. Type New Name: Enter a new cart route name directly in the text field below the dropdown
3. Wait for Activation: Drawing tools and style icons become enabled once a name is set

Filter by Name

The Filter by Name toggle restricts the map display to features belonging to the currently selected cart route:

1. Select an existing name from the Cart Route Names dropdown
2. Toggle Filter by Name on
3. Both point and line layers immediately filter to show only features with that name
4. Toggle off to show all cart route features

WARNING

The filter only responds to names selected from the Cart Route Names dropdown. Typing a name in the text field activates the editor for drawing, but does not apply the filter.

TIP

While the filter is on, changing the dropdown selection automatically re-applies the filter to the new name — no need to toggle off and back on.

INFO

The filter is automatically cleared after printing to prevent stale filter states.

Cart Route Information

The Cart Route Information section allows you to create and manage detailed information about cart routes.

Managing Cart Route Information

1. Select an existing cart route from the dropdown or create a new one.
2. View the last update timestamp for existing routes.
3. The Cart Route Info Name field is automatically synchronised from the selected Cart Route Name — it is read-only and cannot be typed into directly.
4. Enter or edit the following optional information using the rich text editor:
   • Hazard information
   • UHF channel details
   • Route description
5. Use the rich text editor to format text with:
   • Bold formatting
   • Bullet lists
   • Numbered lists
6. Use the same name to update existing cart route information.

Saving Cart Route Information

1. Enter all required information.
2. Click the Save button.
3. A success notification will appear when saved.
4. Use the Clear button to reset all fields.

INFO

The Delete button in the Cart Route Information section permanently removes the complete cart route (all geometry and information). This button is only visible to users with the Cart Admin role.

INFO

Cart Route Information is stored separately from the geometry. You can create information records without drawing routes on the map.

Geometry Types and Styles

The Cart Route Editor supports two geometry types with various style options.

Geometry Types

• Point: Used for marking specific locations such as departure points, destinations, UHF channels, or labels
• Line: Used for drawing the actual route directions

Point Styles

When working with Point geometry, you can choose from the following styles:

#	Icon	Style Name	Description
1		UHF Channel	Mark UHF radio channel locations
2		Coupe	Mark coupe (harvest area) locations
3		One Lane	Indicate single-lane road sections
4		Narrow Bridge	Mark narrow bridge locations
5		Steep Road	Indicate steep road sections
6		Soft Shoulder	Mark soft shoulder areas
7		No UHF	Indicate areas without UHF coverage
8		Railway Crossing	Mark railway crossing locations
9		School Zone	Indicate school zone areas
10		Winding Road	Mark winding road sections
11		Slippery When Wet	Indicate slippery road conditions
12		Phone Coverage	Mark mobile phone coverage areas
13		EMP Location	Mark Emergency Management Point locations
14		Text Point	Add custom text label at a location (font size fixed at 10pt)
99	—	Unknown	Display-only fallback — drawing is disabled when selected

TIP

Each point style is represented by a unique icon on the map, making it easy to visually distinguish between different types of route features and hazards.

Line Styles

When working with Line geometry, you can choose from the following styles:

1. Planned Cart Route - Default route line style for planned routes
2. Route to Coupe - Line style indicating a route leading to a coupe (harvest area)
3. Unknown - Default/unclassified line style

Drawing and Editing Operations

Before You Start

1. Set a cart route name (from the dropdown or by typing in the Cart Route Name Selection accordion)
2. Choose a geometry type (Point or Polyline)
3. Select a point or line style

INFO

Drawing tools and style icons are disabled until a cart route name is set.

Multiple Mode

The Multiple Mode toggle controls whether the drawing tool stays active after each feature is placed.

Multiple OFF (Default):

• Draw one feature, then the tool deactivates
• Click the draw button again to draw another feature

Multiple ON:

• The drawing tool stays active after each feature is completed
• Keep clicking on the map to rapidly place many features
• Click the draw button again to stop

INFO

Regardless of Multiple mode, every drawn shape is always saved as a separate feature in the layer.

INFO

Switching geometry type while Multiple mode is on will reset the toggle to off when you next click the draw button. Turn it off manually if you no longer want continuous drawing after switching types.

Selecting Existing Cart Routes

1. Click the "Select" button.
2. Click on an existing cart route geometry (points, lines) on the map.
3. The selected route will be highlighted and available for editing, and the editing button will be enabled.

Drawing Point Features

1. Select "Point" from the Geometry Types dropdown.
2. Choose a point style.
3. Click the "Draw Point" button.
4. Click on the map to place the point.

Drawing Line Features

1. Select "Line" from the Geometry Types dropdown.
2. Choose a line style.
3. Click the "Draw Line" button.
4. Click on the map to place vertices of the line.
5. Double-click to complete the line.

Editing Features

1. Select a feature using the selection tool.
2. Click the "Edit" button.
3. Click and move if point type or change vertices if line geometry.
4. Click away from the geometry or click "Edit" again to finish.

Deleting Features

1. Select a feature using the selection tool.
2. Click the "Delete" button.
3. The feature will be removed from the map and the database.

Resetting the Editor

1. Click the "Reset" button.
2. All current selections and unsaved edits will be cleared.

Delete Cart Route Dialog

When you delete a cart route, a confirmation dialog appears to prevent accidental deletion.

Dialog Details:

• Heading: "Delete Cart Route?"
• Kind: Danger (red indicator)
• Modal: Yes — you must respond before continuing
• Content: Displays the cart route name and lists everything that will be permanently deleted:
  • All feature layers (points and lines)
  • Cart route information (hazard, UHF, route details)
• Warning: "This action cannot be undone."
• Footer Buttons:
  • Cancel (left) — closes the dialog without changes
  • Delete (right, red) — permanently removes the cart route and all associated data

The dialog prevents closing via the Escape key or clicking outside, ensuring you make an explicit choice.

Saving and Managing Cart Routes

Saving Cart Routes Geometry

1. Ensure a cart route name is set in the Cart Route Name Selection accordion at the top.
2. Draw or edit geometry on the map.
3. Open the Save Cart Route accordion panel.
4. Optionally, enter a Display Label — this is a text label that can be attached to any feature type, not just Text Point.
5. Click the Save button.

Print Cart Routes Map and Reports

1. Switch on the "Include Cart Route Report" toggle.
2. Select the desired cart route name from the dropdown.
3. Click the "Extent" button to set the print extent.
4. Click the "Print" button.

WARNING

A cart route name must be set before geometry can be saved. Set the name in the Cart Route Name Selection accordion — either select from the dropdown or type a new name in the text field.

Troubleshooting

Issue	Solution
Cannot save cart route	Set a cart route name in the Cart Route Name Selection accordion first
Drawing tools not working	Set a cart route name first; ensure no selection or edit mode is active
Cannot edit a feature	Select the feature first using the selection tool
Cannot see saved cart routes	Make sure you have cart route point and line layers on the map
Draw button disabled after style pick	You may have selected the Unknown style — it is display-only; pick a named style
Report not showing in print	Ensure you select a Cart Route Report
Filter by Name shows nothing	Select a cart route name from the dropdown before enabling the filter toggle
Delete button not visible	The Delete button in Cart Route Information is only available to Cart Admin users
Cart Route Info Name not editable	The Info Name field is automatically synced from the Cart Route Name — it is read-only
Filter not clearing after print	The filter is cleared automatically after printing; toggle it on again if needed

Video Tutorials

The following video tutorials demonstrate key workflows for using the Cart Route Editor Tool. Each video provides step-by-step visual instructions to help you master different aspects of the tool.

Basic Workflows

Tutorial	Description
Creating and Saving Information	Learn how to create and save cart route information records
Drawing Route Geometries	See how to draw points and lines on the map
Editing Route Geometries	Discover techniques for modifying existing routes

Creating and Saving Cart Route Information

This video demonstrates how to create new cart route information records and save them to the database.

Editing Cart Routes Geometries

Learn how to add point and line features to create complete cart routes on the map.

Deleting Cart Routes Geometries

This tutorial shows how to select and modify existing cart route features.

Advanced Edit Cart Routes Geometries

Learn how to remove unwanted cart route features from the map.

Printing Cart Routes Maps and Reports

This video demonstrates how to generate printable maps and reports for your cart routes.

See Also

• Road Analysis - Road network analysis and route distance calculations
• Print Panel - Print cart route maps with custom layouts
• Unified Map Editors - Overview of all unified editors

---