Routes and Waypoints

To deploy the reference groups for routes and waypoints:

1. In Pitram Reference Edit, select Other Actions | Deploy Reference Data on the navigation pane header.
2. Scroll down to Configuration Items | Locations.
3. Make sure that the following groups are selected:

   	Route
   	RouteGroup
   	Waypoint
   	WaypointPair
   	WaypointRuleCriteria
   	WaypointRuleAction
   	WaypointCriteriaCategory
   	WaypointActionType

4. Click OK to save your settings.

5. The following reference data groups are shown under Groups | Configuration Items | Locations:

Before you can work with waypoints, you must define their criteria and actions.

Waypoint rules specify actions that will occur when a unit of equipment or a person enters the zone of influence of a waypoint. Rules are comprised of an action and criteria. All of the criteria configured on a rule must be satisfied before the rule’s action is performed. The action itself will produce an event against the equipment that passed the waypoint.

For example, if a truck hits a given waypoint and is travelling in a given direction the rule action may be to automatically allocate the truck to a particular loader. A waypoint may have multiple rules configured, for example one rule that is specific to truck model A and another to truck model B.

Define Criteria

To define waypoint criteria:

1. Select Groups | Configuration Items | Locations | WaypointCriteriaCategory.
2. On the toolbar, click Checkout.
3. Click New WaypointCriteriaCategory to define waypoint criterion.
4. Define the following set of criteria. Use the same values when specifying Name, Code and Abbreviation tokens.

You must use the same mixture of upper and lower case as shown in the table below:

Name	Code	Abbreviation
AssignedDestination	AssignedDestination	AssignedDestination
CycleStatus	CycleStatus	CycleStatus
Direction	Direction	Direction
Equipment	Equipment	Equipment
PrimaryStatus	PrimaryStatus	PrimaryStatus

For example, the Assigned Destination criterion will be defined as:



When you have finished, all five criterion will look like this:

5. Click Check-in on the toolbar to make the group read-only.

Define Actions

To define waypoint actions:

1. Select Groups | Configuration Items | Locations | WaypointActionType.
2. Click Check-out on the header.
3. Click New WaypointActionType and define the following:

You must use the same mixture of upper and lower case as shown in the table below:

Name	Code and Abbreviation
Allocate Equipment to Equipment	ALLOC_EQ_TO_EQ
Allocate Equipment to Location	ALOC_EQ_TO_LOC
Assign Equipment to Destination	ASSIGN_DEST
Dispatch Truck	DISPATCHTRUCK
Raise Destination Alarm	DESTINATION_ALARM
Raise Exclusion Alarm	EXCLUSION_ALARM
Raise Material Alarm	MATERIAL_ALARM
Record Dump	RECORD_DUMP
Record Load	RECORD_LOAD
Record Dump at Assigned Destination	RECORD_DUMP_DEST
Record Status Change	STATUS_CHANGE
Set Attribute	SET_ATTRIB

The WaypointActionTypes are the actions that will be listed in the Waypoint dialog in Pitram 3D.

4. Click Checkin and then Publish your changes to make them available to other Pitram applications and services.

Once routes and waypoint actions have been deployed, you can Add Waypoints.